From 1f13872a9447f2bbf8363341629366db2b0ea188 Mon Sep 17 00:00:00 2001
From: jpaoneMines <jpaone@mines.edu>
Date: Wed, 10 May 2023 13:49:57 -0600
Subject: [PATCH] Created .util.network.NetworkConnectionUtility for Issue #3

---
 .gitignore                                    |  4 +-
 .idea/gradle.xml                              |  1 +
 .idea/misc.xml                                |  1 -
 README.md                                     |  4 ++
 csci448/src/main/AndroidManifest.xml          |  2 +-
 .../util/network/NetworkConnectionUtility.kt  | 71 +++++++++++++++++++
 6 files changed, 80 insertions(+), 3 deletions(-)
 create mode 100644 csci448/src/main/java/edu/mines/csci448/util/network/NetworkConnectionUtility.kt

diff --git a/.gitignore b/.gitignore
index dc69825..bd1c36f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,7 +1,9 @@
 *.iml
 .gradle
-.idea
 /local.properties
+.idea
+.idea/gradle.xml
+/.idea
 /.idea/gradle.xml
 /.idea/caches
 /.idea/libraries
diff --git a/.idea/gradle.xml b/.idea/gradle.xml
index 9a61b1d..7cc42c6 100644
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
   <component name="GradleSettings">
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>
diff --git a/.idea/misc.xml b/.idea/misc.xml
index 9f71c83..773fe0f 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="ProjectRootManager" version="2" languageLevel="JDK_17" project-jdk-name="jbr-17" project-jdk-type="JavaSDK">
diff --git a/README.md b/README.md
index 05e54b4..dac7afc 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,10 @@
 
 # Change Log
 
+## v 0.2.0 - 10 May 2023
+
+- Added NetworkConnectionUtility into .util.network package
+
 ## v 0.1.2 - 20 April 2023
 
 - Removed app/ module from github repository
diff --git a/csci448/src/main/AndroidManifest.xml b/csci448/src/main/AndroidManifest.xml
index a5918e6..acf9e6f 100644
--- a/csci448/src/main/AndroidManifest.xml
+++ b/csci448/src/main/AndroidManifest.xml
@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
-
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
 </manifest>
\ No newline at end of file
diff --git a/csci448/src/main/java/edu/mines/csci448/util/network/NetworkConnectionUtility.kt b/csci448/src/main/java/edu/mines/csci448/util/network/NetworkConnectionUtility.kt
new file mode 100644
index 0000000..36b230d
--- /dev/null
+++ b/csci448/src/main/java/edu/mines/csci448/util/network/NetworkConnectionUtility.kt
@@ -0,0 +1,71 @@
+package edu.mines.csci448.util.network
+
+import android.content.Context
+import android.net.ConnectivityManager
+import android.net.Network
+import android.net.NetworkCapabilities
+import android.net.NetworkRequest
+import android.util.Log
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.flow.update
+
+object NetworkConnectionUtility {
+    private const val LOG_TAG = "448.NetworkConnectionUtility"
+
+    fun isNetworkAvailableAndConnected(context: Context): Boolean {
+        val connectivityManager = context.getSystemService(ConnectivityManager::class.java) as ConnectivityManager
+        val activeNetwork = connectivityManager.activeNetwork
+        return activeNetwork != null && (connectivityManager.getNetworkCapabilities(activeNetwork)?.hasCapability(
+            NetworkCapabilities.NET_CAPABILITY_VALIDATED) ?: false)
+    }
+
+    private val mNetworkAvailableStateFlow: MutableStateFlow<Boolean> = MutableStateFlow(false)
+    val networkAvailableStateFlow: StateFlow<Boolean>
+        get() = mNetworkAvailableStateFlow.asStateFlow()
+
+    private val networkRequest = NetworkRequest.Builder()
+        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
+        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
+        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
+        .build()
+
+    private val networkCallback = object : ConnectivityManager.NetworkCallback() {
+        // network is available for use
+        override fun onAvailable(network: Network) {
+            super.onAvailable(network)
+            Log.d(LOG_TAG, "onAvailable() called: network is available for use")
+            mNetworkAvailableStateFlow.update { true }
+        }
+
+        // Network capabilities have changed for the network
+        override fun onCapabilitiesChanged(
+            network: Network,
+            networkCapabilities: NetworkCapabilities
+        ) {
+            super.onCapabilitiesChanged(network, networkCapabilities)
+            val unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
+            val validated = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
+            Log.d(LOG_TAG, "onCapabilitiesChanged() called - validated/unmetered = $validated/$unmetered")
+            mNetworkAvailableStateFlow.update { validated }
+        }
+
+        // lost network connection
+        override fun onLost(network: Network) {
+            super.onLost(network)
+            Log.d(LOG_TAG, "onLost() called: lost network connection")
+            mNetworkAvailableStateFlow.update { false }
+        }
+    }
+
+    fun monitorNetworkStatus(context: Context) {
+        val connectivityManager = context.getSystemService(ConnectivityManager::class.java) as ConnectivityManager
+        connectivityManager.requestNetwork(networkRequest, networkCallback)
+    }
+
+    fun stopMonitoringNetworkStatus(context: Context) {
+        val connectivityManager = context.getSystemService(ConnectivityManager::class.java) as ConnectivityManager
+        connectivityManager.unregisterNetworkCallback(networkCallback)
+    }
+}
\ No newline at end of file