Merge "Cleaning up NetworkStatsManager." into nyc-dev

This commit is contained in:
Antonio Cansado
2016-05-25 22:17:20 +00:00
committed by Android (Google) Code Review
9 changed files with 7 additions and 308 deletions

View File

@@ -6457,7 +6457,7 @@ package android.app.usage {
public class NetworkStatsManager {
method public android.app.usage.NetworkStats queryDetails(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUid(int, java.lang.String, long, long, int) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int);
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int) throws java.lang.SecurityException;
method public android.app.usage.NetworkStats querySummary(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForDevice(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForUser(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;

View File

@@ -31,37 +31,6 @@ package android.app.admin {
}
package android.app.usage {
public class DataUsagePolicy {
field public final int networkType;
field public final java.lang.String[] subscriberIds;
field public final long thresholdInBytes;
field public final int[] uids;
}
public static class DataUsagePolicy.Builder {
ctor public DataUsagePolicy.Builder();
method public android.app.usage.DataUsagePolicy.Builder addSubscriberId(java.lang.String);
method public android.app.usage.DataUsagePolicy.Builder addUid(int);
method public android.app.usage.DataUsagePolicy build();
method public android.app.usage.DataUsagePolicy.Builder setNetworkType(int);
method public android.app.usage.DataUsagePolicy.Builder setThreshold(long);
}
public class NetworkStatsManager {
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.DataUsageCallback, android.os.Handler);
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.UsageCallback, android.os.Handler);
method public void unregisterDataUsageCallback(android.app.usage.NetworkStatsManager.DataUsageCallback);
}
public static abstract class NetworkStatsManager.DataUsageCallback {
ctor public NetworkStatsManager.DataUsageCallback();
method public deprecated void onLimitReached();
}
}
package android.content {
public abstract class Context {

View File

@@ -6738,7 +6738,7 @@ package android.app.usage {
public class NetworkStatsManager {
method public android.app.usage.NetworkStats queryDetails(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUid(int, java.lang.String, long, long, int) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int);
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int) throws java.lang.SecurityException;
method public android.app.usage.NetworkStats querySummary(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForDevice(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForUser(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;

View File

@@ -29,37 +29,6 @@ package android.app.admin {
}
package android.app.usage {
public class DataUsagePolicy {
field public final int networkType;
field public final java.lang.String[] subscriberIds;
field public final long thresholdInBytes;
field public final int[] uids;
}
public static class DataUsagePolicy.Builder {
ctor public DataUsagePolicy.Builder();
method public android.app.usage.DataUsagePolicy.Builder addSubscriberId(java.lang.String);
method public android.app.usage.DataUsagePolicy.Builder addUid(int);
method public android.app.usage.DataUsagePolicy build();
method public android.app.usage.DataUsagePolicy.Builder setNetworkType(int);
method public android.app.usage.DataUsagePolicy.Builder setThreshold(long);
}
public class NetworkStatsManager {
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.DataUsageCallback, android.os.Handler);
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.UsageCallback, android.os.Handler);
method public void unregisterDataUsageCallback(android.app.usage.NetworkStatsManager.DataUsageCallback);
}
public static abstract class NetworkStatsManager.DataUsageCallback {
ctor public NetworkStatsManager.DataUsageCallback();
method public deprecated void onLimitReached();
}
}
package android.content {
public abstract class Context {

View File

@@ -6463,7 +6463,7 @@ package android.app.usage {
public class NetworkStatsManager {
method public android.app.usage.NetworkStats queryDetails(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUid(int, java.lang.String, long, long, int) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int);
method public android.app.usage.NetworkStats queryDetailsForUidTag(int, java.lang.String, long, long, int, int) throws java.lang.SecurityException;
method public android.app.usage.NetworkStats querySummary(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForDevice(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;
method public android.app.usage.NetworkStats.Bucket querySummaryForUser(int, java.lang.String, long, long) throws android.os.RemoteException, java.lang.SecurityException;

View File

@@ -31,37 +31,6 @@ package android.app.admin {
}
package android.app.usage {
public class DataUsagePolicy {
field public final int networkType;
field public final java.lang.String[] subscriberIds;
field public final long thresholdInBytes;
field public final int[] uids;
}
public static class DataUsagePolicy.Builder {
ctor public DataUsagePolicy.Builder();
method public android.app.usage.DataUsagePolicy.Builder addSubscriberId(java.lang.String);
method public android.app.usage.DataUsagePolicy.Builder addUid(int);
method public android.app.usage.DataUsagePolicy build();
method public android.app.usage.DataUsagePolicy.Builder setNetworkType(int);
method public android.app.usage.DataUsagePolicy.Builder setThreshold(long);
}
public class NetworkStatsManager {
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.DataUsageCallback, android.os.Handler);
method public void registerDataUsageCallback(android.app.usage.DataUsagePolicy, android.app.usage.NetworkStatsManager.UsageCallback, android.os.Handler);
method public void unregisterDataUsageCallback(android.app.usage.NetworkStatsManager.DataUsageCallback);
}
public static abstract class NetworkStatsManager.DataUsageCallback {
ctor public NetworkStatsManager.DataUsageCallback();
method public deprecated void onLimitReached();
}
}
package android.content {
public abstract class Context {

View File

@@ -1,175 +0,0 @@
/**
* Copyright (C) 2016 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy
* of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package android.app.usage;
import android.net.ConnectivityManager;
import android.os.Parcel;
import android.os.Parcelable;
import android.util.IntArray;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Iterator;
import java.util.List;
/**
* Defines a policy for data usage callbacks, made through {@link DataUsagePolicy.Builder} and used
* to be notified on data usage via {@link NetworkStatsManager#registerDataUsageCallback}.
* @removed
*/
public class DataUsagePolicy {
/**
* Network type to be monitored, as defined in {@link ConnectivityManager}, e.g.
* {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI} etc.
*/
public final int networkType;
/**
* Set of subscriber ids to be monitored for the given network type. May be empty if not
* applicable.
* <p>Should not be modified once created.
*/
public final String[] subscriberIds;
/**
* Set of UIDs of which to monitor data usage.
*
* <p>If not {@code null}, the caller will be notified when any of the uids exceed
* the given threshold. If empty all uids for which the calling process has access
* to stats will be monitored.
* <p>Should not be modified once created.
*/
public final int[] uids;
/**
* Threshold in bytes to be notified on.
*/
public final long thresholdInBytes;
/**
* @hide
*/
DataUsagePolicy(int networkType, String[] subscriberIds, int[] uids,
long thresholdInBytes) {
this.networkType = networkType;
this.subscriberIds = subscriberIds;
this.uids = uids;
this.thresholdInBytes = thresholdInBytes;
}
/**
* Builder used to create {@link DataUsagePolicy} objects.
*/
public static class Builder {
private static final int INVALID_NETWORK_TYPE = -1;
private int mNetworkType = INVALID_NETWORK_TYPE;
private List<String> mSubscriberList = new ArrayList<>();
private IntArray mUids = new IntArray();
private long mThresholdInBytes;
/**
* Default constructor for Builder.
*/
public Builder() {}
/**
* Build {@link DataUsagePolicy} given the current policies.
*/
public DataUsagePolicy build() {
if (mNetworkType == INVALID_NETWORK_TYPE) {
throw new IllegalArgumentException(
"DataUsagePolicy requires a valid network type to be set");
}
return new DataUsagePolicy(mNetworkType,
mSubscriberList.toArray(new String[mSubscriberList.size()]),
mUids.toArray(), mThresholdInBytes);
}
/**
* Specifies that the given {@code subscriberId} should be monitored.
*
* @param subscriberId the subscriber id of the network interface.
*/
public Builder addSubscriberId(String subscriberId) {
mSubscriberList.add(subscriberId);
return this;
}
/**
* Specifies that the given {@code uid} should be monitored.
*/
public Builder addUid(int uid) {
mUids.add(uid);
return this;
}
/**
* Specifies that the callback should monitor the given network. It is mandatory
* to set one.
*
* @param networkType As defined in {@link ConnectivityManager}, e.g.
* {@link ConnectivityManager#TYPE_MOBILE},
* {@link ConnectivityManager#TYPE_WIFI}, etc.
*/
public Builder setNetworkType(int networkType) {
mNetworkType = networkType;
return this;
}
/**
* Sets the threshold in bytes on which the listener should be called. The framework may
* impose a minimum threshold to avoid too many notifications to be triggered.
*/
public Builder setThreshold(long thresholdInBytes) {
mThresholdInBytes = thresholdInBytes;
return this;
}
}
@Override
public String toString() {
return "DataUsagePolicy [ networkType=" + networkType
+ ", subscriberIds=" + Arrays.toString(subscriberIds)
+ ", uids=" + Arrays.toString(uids)
+ ", thresholdInBytes=" + thresholdInBytes + " ]";
}
@Override
public boolean equals(Object obj) {
if (obj instanceof DataUsagePolicy == false) return false;
DataUsagePolicy that = (DataUsagePolicy) obj;
return that.networkType == this.networkType
&& Arrays.deepEquals(that.subscriberIds, this.subscriberIds)
&& Arrays.equals(that.uids, this.uids)
&& that.thresholdInBytes == this.thresholdInBytes;
}
@Override
public int hashCode() {
// Start with a non-zero constant.
int result = 17;
// Include a hash for each field.
result = 31 * result + networkType;
result = 31 * result + Arrays.deepHashCode(subscriberIds);
result = 31 * result + Arrays.hashCode(uids);
result = 31 * result + (int) (thresholdInBytes ^ (thresholdInBytes >>> 32));
return result;
}
}

View File

@@ -240,18 +240,13 @@ public class NetworkStatsManager {
* {@link java.lang.System#currentTimeMillis}.
* @param uid UID of app
* @param tag TAG of interest. Use {@link NetworkStats.Bucket#TAG_NONE} for no tags.
* @return Statistics object or null if permissions are insufficient or error happened during
* statistics collection.
* @return Statistics object or null if an error happened during statistics collection.
* @throws SecurityException if permissions are insufficient to read network statistics.
*/
public NetworkStats queryDetailsForUidTag(int networkType, String subscriberId,
long startTime, long endTime, int uid, int tag) {
long startTime, long endTime, int uid, int tag) throws SecurityException {
NetworkTemplate template;
try {
template = createTemplate(networkType, subscriberId);
} catch (IllegalArgumentException e) {
if (DBG) Log.e(TAG, "Cannot create template", e);
return null;
}
template = createTemplate(networkType, subscriberId);
NetworkStats result;
try {
@@ -303,17 +298,6 @@ public class NetworkStatsManager {
return result;
}
/** @removed */
public void registerDataUsageCallback(DataUsagePolicy policy, DataUsageCallback callback,
@Nullable Handler handler) {}
/** @removed */
public void registerDataUsageCallback(DataUsagePolicy policy, UsageCallback callback,
@Nullable Handler handler) {}
/** @removed */
public void unregisterDataUsageCallback(DataUsageCallback callback) {}
/**
* Registers to receive notifications about data usage on specified networks.
*
@@ -396,13 +380,6 @@ public class NetworkStatsManager {
}
}
/** @removed */
public static abstract class DataUsageCallback {
/** @removed */
@Deprecated
public void onLimitReached() {}
}
/**
* Base class for usage callbacks. Should be extended by applications wanting notifications.
*/

View File

@@ -190,11 +190,9 @@ class NetworkStatsObservers {
private void handleUpdateStats(StatsContext statsContext) {
if (mDataUsageRequests.size() == 0) {
if (LOGV) Slog.v(TAG, "No registered listeners of data usage");
return;
}
if (LOGV) Slog.v(TAG, "Checking if any registered observer needs to be notified");
for (int i = 0; i < mDataUsageRequests.size(); i++) {
RequestInfo requestInfo = mDataUsageRequests.valueAt(i);
requestInfo.updateStats(statsContext);
@@ -371,9 +369,6 @@ class NetworkStatsObservers {
NetworkStats stats = mCollection.getSummary(template,
Long.MIN_VALUE /* start */, Long.MAX_VALUE /* end */,
mAccessLevel, mCallingUid);
if (LOGV) {
Slog.v(TAG, "Netstats for " + template + ": " + stats);
}
return stats.getTotalBytes();
}
}
@@ -391,11 +386,6 @@ class NetworkStatsObservers {
for (int i = 0; i < uidsToMonitor.length; i++) {
long bytesSoFar = getTotalBytesForNetworkUid(mRequest.template, uidsToMonitor[i]);
if (LOGV) {
Slog.v(TAG, bytesSoFar + " bytes so far since notification for "
+ mRequest.template + " for uid=" + uidsToMonitor[i]);
}
if (bytesSoFar > mRequest.thresholdInBytes) {
return true;
}