add basic starter code to the project

Author: johnnzhou

app/build.gradle

@@ -8,7 +8,7 @@ android {
 
     defaultConfig {
         applicationId "com.lcl.lclmeasurementtool"
-        minSdkVersion 28
+        minSdkVersion 29
         targetSdkVersion 30
         versionCode 1
         versionName "1.0"

app/src/main/AndroidManifest.xml

@@ -2,6 +2,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.lcl.lclmeasurementtool">
 
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <application
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"

app/src/main/java/com/lcl/lclmeasurementtool/Functionality/Ping.java

@@ -6,4 +6,5 @@
  */
 
 public class Ping {
+
 }

app/src/main/java/com/lcl/lclmeasurementtool/Managers/CellularManager.java

@@ -1,10 +1,29 @@
 package com.lcl.lclmeasurementtool.Managers;
+import android.content.Context;
+import android.telephony.SignalStrength;
 import android.telephony.TelephonyManager;
 
+import com.lcl.lclmeasurementtool.Utils.SignalStrengthLevel;
+
 /**
  * CellularManager monitors changes in device's signal strength and
  * report changes(callback) to front-end UI
  */
 
 public class CellularManager {
+
+    private TelephonyManager telephonyManager;
+
+    public CellularManager(Context context) {
+        this.telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
+    }
+
+    public SignalStrength getSignalStrength() {
+        return this.telephonyManager.getSignalStrength();
+    }
+
+    public SignalStrengthLevel getSignalStrengthLevel() {
+        int level = getSignalStrength().getLevel();
+        return SignalStrengthLevel.init(level);
+    }
 }

app/src/main/java/com/lcl/lclmeasurementtool/Managers/NetworkManager.java

@@ -1,12 +1,47 @@
 package com.lcl.lclmeasurementtool.Managers;
+
 import android.net.ConnectivityManager;
+import android.content.Context;
+import android.net.Network;
+import android.net.NetworkCapabilities;
+import android.net.NetworkInfo;
+import android.os.Build;
+import android.util.Log;
+
+import androidx.annotation.RequiresApi;
 
 /**
  * NetworkManager manages all network related information, including but not limited to
  * connectivity states, active network information(wifi, cellular) and
  * listen to changes in network states.
  */
-
 public class NetworkManager {
 
+    private static final String TAG = "Network Manager Info";
+
+    // TODO: finish comment
+    private ConnectivityManager connectivityManager;
+    private NetworkCapabilities capabilities;
+    private boolean isCellularConnected;
+
+    /**
+     * TODO: finish comment
+     * @param context
+     */
+    public NetworkManager(Context context) {
+        this.connectivityManager =
+                (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
+
+        Network network = this.connectivityManager.getActiveNetwork();
+        this.capabilities = this.connectivityManager.getNetworkCapabilities(network);
+        this.isCellularConnected = capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR);
+    }
+
+    public boolean isCellularConnected() {
+        return isCellularConnected;
+    }
+
+    public int getNumericSignalStrength() {
+        return this.capabilities.getSignalStrength();
+    }
 }

app/src/main/java/com/lcl/lclmeasurementtool/Utils/ConvertUtils.java

@@ -6,22 +6,30 @@ public class ConvertUtils {
     public static final int CONVERSION_RATE = 8;
 
     /**
-     * Convert data in MBps to Mbps
+     * Convert data in MBps to Mbps.
      *
-     * @param MBps the data to be converted in MBps
-     * @return corresponding data in Mbps
+     * @param MBps the data to be converted in MBps.
+     * @throws IllegalArgumentException if MBps is less than 0.
+     * @return corresponding data in Mbps.
      */
     public static double toMbps(double MBps) {
+        if (MBps < 0) {
+            throw new IllegalArgumentException("the input parameter MBps should be greater than 0");
+        }
         return MBps * CONVERSION_RATE;
     }
 
     /**
-     * Convert data in Mbps to MBps
+     * Convert data in Mbps to MBps.
      *
-     * @param Mbps the data to be converted in Mbps
-     * @return corresponding data in MBps
+     * @param Mbps the data to be converted in Mbps.
+     * @throws IllegalArgumentException if Mbps is less than 0.
+     * @return corresponding data in MBps.
      */
     public static double toMBps(double Mbps) {
+        if (Mbps < 0) {
+            throw new IllegalArgumentException("the input parameter Mbps should be greater than 0");
+        }
         return Mbps / CONVERSION_RATE;
     }
 }

app/src/main/java/com/lcl/lclmeasurementtool/Utils/SignalStrength.java renamed to app/src/main/java/com/lcl/lclmeasurementtool/Utils/SignalStrengthLevel.java

@@ -1,6 +1,10 @@
 package com.lcl.lclmeasurementtool.Utils;
 
-public enum SignalStrength {
+/**
+ * The SignalStrength represents the cellular signal strength
+ * received from the mobile network system.
+ */
+public enum SignalStrengthLevel {
     NONE(0),      // the signal strength is none or unknown
     POOR(1),      // the signal strength is poor
     MODERATE(2),  // the signal strength is moderate
@@ -11,10 +15,31 @@ public enum SignalStrength {
     private final int levelCode;
 
     // constructor
-    SignalStrength(int levelCode) {
+    SignalStrengthLevel(int levelCode) {
         this.levelCode = levelCode;
     }
 
+    /**
+     * TODO: finish comment
+     * @param levelCode
+     * @return
+     */
+    public static SignalStrengthLevel init(int levelCode) {
+        switch (levelCode) {
+            case 0:
+                return SignalStrengthLevel.NONE;
+            case 1:
+                return SignalStrengthLevel.POOR;
+            case 2:
+                return SignalStrengthLevel.MODERATE;
+            case 3:
+                return SignalStrengthLevel.GOOD;
+            case 4:
+                return SignalStrengthLevel.GREAT;
+            default: throw new IllegalArgumentException("Signal Strength levelCode should be >=0 and <= 4 ");
+        }
+    }
+
     /**
      * Get the numerical level code corresponding to the signal strength
      * @return an integer associates with the signal strength