Merge "update API name to requestBandwidthUpdate()"

1 files changed, 10 insertions, 6 deletions

diff --git a/core/java/android/net/ConnectivityManager.java b/core/java/android/net/ConnectivityManager.java
index 3e9b3d6..b80d91f 100644
--- a/core/java/android/net/ConnectivityManager.java
+++ b/core/java/android/net/ConnectivityManager.java
@@ -2441,17 +2441,21 @@ public class ConnectivityManager {
     }
 
     /**
-     * Request connectivityservice to refresh network capabilities for the given
-     * {@link network}. This method returns true if the network is still active, false
-     * otherwise. Notice the method call assumes the caller has registered for
-     * listening NetworkCapabilities updates.
+     * Requests bandwidth update for a given {@link Network} and returns whether the update request
+     * is accepted by ConnectivityService. Once accepted, ConnectivityService will poll underlying
+     * network connection for updated bandwidth information. The caller will be notified via
+     * {@link ConnectivityManager.NetworkCallback} if there is an update. Notice that this
+     * method assumes that the caller has previously called {@link #registerNetworkCallback} to
+     * listen for network changes.
      *
      * @param network{@link Network} specifying which network you're interested.
+     * @return {@code true} on success, {@code false} if the {@link Network} is no longer valid.
+     *
      * @hide
      */
-    public boolean requestBwUpdate(Network network) {
+    public boolean requestBandwidthUpdate(Network network) {
         try {
-            return mService.requestBwUpdate(network);
+            return mService.requestBandwidthUpdate(network);
         } catch (RemoteException e) {
             return false;
         }