add apis to read the performance data

src/main/java/io/appium/java_client/MobileCommand.java

@@ -48,6 +48,10 @@ public class MobileCommand {
     protected static final String GET_DEVICE_TIME;
     protected static final String GET_SESSION;
 
+    protected static final String GET_PERFORMANCE_DATA;
+    protected static final String GET_SUPPORTED_PERFORMANCE_DATA_TYPES;
+
+
     protected static final String HIDE_KEYBOARD;
     protected static final String LOCK;
     //iOS
@@ -92,6 +96,9 @@ public class MobileCommand {
         GET_DEVICE_TIME = "getDeviceTime";
         GET_SESSION = "getSession";
 
+        GET_PERFORMANCE_DATA = "getPerformanceData";
+        GET_SUPPORTED_PERFORMANCE_DATA_TYPES = "getSuppportedPerformanceDataTypes";
+
         HIDE_KEYBOARD = "hideKeyboard";
         LOCK = "lock";
         SHAKE = "shake";
@@ -136,6 +143,11 @@ public class MobileCommand {
         commandRepository.put(SET_SETTINGS, postC("/session/:sessionId/appium/settings"));
         commandRepository.put(GET_DEVICE_TIME, getC("/session/:sessionId/appium/device/system_time"));
         commandRepository.put(GET_SESSION,getC("/session/:sessionId/"));
+        commandRepository.put(GET_SUPPORTED_PERFORMANCE_DATA_TYPES,
+            postC("/session/:sessionId/appium/performanceData/types"));
+        commandRepository.put(GET_PERFORMANCE_DATA,
+            postC("/session/:sessionId/appium/getPerformanceData"));
+
         //iOS
         commandRepository.put(SHAKE, postC("/session/:sessionId/appium/device/shake"));
         commandRepository.put(TOUCH_ID, postC("/session/:sessionId/appium/simulator/touch_id"));

src/main/java/io/appium/java_client/android/AndroidDriver.java

@@ -17,6 +17,8 @@
 package io.appium.java_client.android;
 
 import static io.appium.java_client.android.AndroidMobileCommandHelper.endTestCoverageCommand;
+import static io.appium.java_client.android.AndroidMobileCommandHelper.getPerformanceDataCommand;
+import static io.appium.java_client.android.AndroidMobileCommandHelper.getSupportedPerformanceDataTypesCommand;
 import static io.appium.java_client.android.AndroidMobileCommandHelper.openNotificationsCommand;
 import static io.appium.java_client.android.AndroidMobileCommandHelper.toggleLocationServicesCommand;
 
@@ -31,9 +33,11 @@
 import org.openqa.selenium.Capabilities;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.remote.HttpCommandExecutor;
+import org.openqa.selenium.remote.Response;
 import org.openqa.selenium.remote.http.HttpClient;
 
 import java.net.URL;
+import java.util.List;
 
 /**
  * @param <T> the required type of class which implement {@link org.openqa.selenium.WebElement}.
@@ -152,6 +156,51 @@ public AndroidDriver(Capabilities desiredCapabilities) {
         super(substituteMobilePlatform(desiredCapabilities, ANDROID_PLATFORM));
     }
 
+    /**
+     * returns the information type of the system state which is supported to read
+     * as like cpu, memory, network traffic, and battery.
+     * @return output - array like below
+     *                  [cpuinfo, batteryinfo, networkinfo, memoryinfo]
+     *
+     */
+    public List<String> getSupportedPerformanceDataTypes() {
+        return CommandExecutionHelper.execute(this, getSupportedPerformanceDataTypesCommand());
+    }
+
+    /**
+     * returns the resource usage information of the application. the resource is one of the system state
+     * which means cpu, memory, network traffic, and battery.
+     *
+     * @param packageName the package name of the application
+     * @param dataType the type of system state which wants to read.
+     *                 It should be one of the supported performance data types,
+     *                 the return value of the function "getSupportedPerformanceDataTypes"
+     * @param dataReadTimeout the number of attempts to read
+     * @return table of the performance data, The first line of the table represents the type of data.
+     *          The remaining lines represent the values of the data.
+     *          in case of battery info : [[power], [23]]
+     *          in case of memory info :
+     *              [[totalPrivateDirty, nativePrivateDirty, dalvikPrivateDirty, eglPrivateDirty, glPrivateDirty,
+     *                        totalPss, nativePss, dalvikPss, eglPss, glPss, nativeHeapAllocatedSize, nativeHeapSize],
+     *                        [18360, 8296, 6132, null, null, 42588, 8406, 7024, null, null, 26519, 10344]]
+     *          in case of network info :
+     *              [[bucketStart, activeTime, rxBytes, rxPackets, txBytes, txPackets, operations, bucketDuration,],
+     *                        [1478091600000, null, 1099075, 610947, 928, 114362, 769, 0, 3600000],
+     *                        [1478095200000, null, 1306300, 405997, 509, 46359, 370, 0, 3600000]]
+     *          in case of network info :
+     *              [[st, activeTime, rb, rp, tb, tp, op, bucketDuration],
+     *                        [1478088000, null, null, 32115296, 34291, 2956805, 25705, 0, 3600],
+     *                        [1478091600, null, null, 2714683, 11821, 1420564, 12650, 0, 3600],
+     *                        [1478095200, null, null, 10079213, 19962, 2487705, 20015, 0, 3600],
+     *                        [1478098800, null, null, 4444433, 10227, 1430356, 10493, 0, 3600]]
+     *          in case of cpu info : [[user, kernel], [0.9, 1.3]]
+     * @throws if the performance data type is not supported, thows Error
+     */
+    public List<List<Object>> getPerformanceData(String packageName, String dataType, int dataReadTimeout) {
+        return CommandExecutionHelper.execute(this,
+                                                getPerformanceDataCommand(packageName, dataType, dataReadTimeout));
+    }
+
     /**
      * This method is deprecated. It is going to be removed
      */

src/main/java/io/appium/java_client/android/AndroidMobileCommandHelper.java

@@ -26,6 +26,7 @@
 import org.openqa.selenium.internal.HasIdentity;
 
 import java.util.AbstractMap;
+import java.util.List;
 import java.util.Map;
 
 /**
@@ -63,6 +64,55 @@ public class AndroidMobileCommandHelper extends MobileCommand {
                 END_TEST_COVERAGE, prepareArguments(parameters, values));
     }
 
+    /**
+     * returns the information type of the system state which is supported to read
+     * as like cpu, memory, network traffic, and battery.
+     * @return output - array like below
+     *                  [cpuinfo, batteryinfo, networkinfo, memoryinfo]
+     *
+     */
+    public static Map.Entry<String, Map<String, ?>> getSupportedPerformanceDataTypesCommand() {
+        return new AbstractMap.SimpleEntry<>(
+            GET_SUPPORTED_PERFORMANCE_DATA_TYPES, ImmutableMap.<String, Object>of());
+    }
+
+    /**
+     * returns the resource usage information of the application. the resource is one of the system state
+     * which means cpu, memory, network traffic, and battery.
+     *
+     * @param packageName the package name of the application
+     * @param dataType the type of system state which wants to read.
+     *                 It should be one of the supported performance data types,
+     *                 the return value of the function "getSupportedPerformanceDataTypes"
+     * @param dataReadTimeout the number of attempts to read
+     * @return table of the performance data, The first line of the table represents the type of data.
+     *          The remaining lines represent the values of the data.
+     *          in case of battery info : [[power], [23]]
+     *          in case of memory info :
+     *              [[totalPrivateDirty, nativePrivateDirty, dalvikPrivateDirty, eglPrivateDirty, glPrivateDirty,
+     *                        totalPss, nativePss, dalvikPss, eglPss, glPss, nativeHeapAllocatedSize, nativeHeapSize],
+     *                        [18360, 8296, 6132, null, null, 42588, 8406, 7024, null, null, 26519, 10344]]
+     *          in case of network info :
+     *              [[bucketStart, activeTime, rxBytes, rxPackets, txBytes, txPackets, operations, bucketDuration,],
+     *                        [1478091600000, null, 1099075, 610947, 928, 114362, 769, 0, 3600000],
+     *                        [1478095200000, null, 1306300, 405997, 509, 46359, 370, 0, 3600000]]
+     *          in case of network info :
+     *              [[st, activeTime, rb, rp, tb, tp, op, bucketDuration],
+     *                        [1478088000, null, null, 32115296, 34291, 2956805, 25705, 0, 3600],
+     *                        [1478091600, null, null, 2714683, 11821, 1420564, 12650, 0, 3600],
+     *                        [1478095200, null, null, 10079213, 19962, 2487705, 20015, 0, 3600],
+     *                        [1478098800, null, null, 4444433, 10227, 1430356, 10493, 0, 3600]]
+     *          in case of cpu info : [[user, kernel], [0.9, 1.3]]
+     * @throws if the performance data type is not supported, thows Error
+     */
+    public static Map.Entry<String, Map<String, ?>> getPerformanceDataCommand(
+                    String packageName, String dataType, int dataReadTimeout) {
+        String[] parameters = new String[] {"packageName", "dataType", "dataReadTimeout"};
+        Object[] values = new Object[] {packageName, dataType, dataReadTimeout};
+        return new AbstractMap.SimpleEntry<>(
+            GET_PERFORMANCE_DATA, prepareArguments(parameters, values));
+    }
+
     /**
      * This method forms a {@link java.util.Map} of parameters to
      * Retrieve the display density of the Android device.

src/test/java/io/appium/java_client/android/AndroidDriverTest.java

@@ -30,6 +30,7 @@
 
 import java.io.File;
 import java.util.Map;
+import java.util.List;
 
 public class AndroidDriverTest extends BaseAndroidTest {
 
@@ -140,4 +141,33 @@ public class AndroidDriverTest extends BaseAndroidTest {
         assertNotNull(driver.getDisplayDensity());
         assertNotEquals(0, driver.getSystemBars().size());
     }
+
+    @Test public void getSupportedPerformanceDataTypesTest() {
+        driver.startActivity("io.appium.android.apis", ".ApiDemos");
+
+        List<String> supportedPerformanceDataTypes = driver.getSupportedPerformanceDataTypes();
+        assert(supportedPerformanceDataTypes.size() == 4);
+
+    }
+
+    @Test public void getPerformanceDataTest() {
+        driver.startActivity("io.appium.android.apis", ".ApiDemos");
+
+        List<String> supportedPerformanceDataTypes = driver.getSupportedPerformanceDataTypes();
+
+        for(int i = 0 ; i < supportedPerformanceDataTypes.size() ;  ++ i){
+
+            String dataType = supportedPerformanceDataTypes.get(i);
+
+            List<List<Object>> valueTable = driver.getPerformanceData("com.example.android.apis", dataType, 60000);
+
+            int valueTableHeadLength = valueTable.get(0).size();
+
+            for(int j = 1 ; j < valueTable.size() ; ++ j){
+                assert(valueTableHeadLength == valueTable.get(j).size());
+            }
+        }
+
+    }
+
 }