Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 11166d7d authored by Chalard Jean's avatar Chalard Jean Committed by Automerger Merge Worker
Browse files

Merge "Annotate NSM heavy methods with @WorkerThread" am: db9e8499 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1625859

Change-Id: Id925979c238c8ae482dbb9c78bf7f4e0f27255d6
parents 16e62536 db9e8499

core/api/current.txt

+7 −7
Original line number Diff line number Diff line
@@ -7999,13 +7999,13 @@ package android.app.usage { 
  }















  public class NetworkStatsManager {













    method public android.app.usage.NetworkStats queryDetails(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method public android.app.usage.NetworkStats queryDetailsForUid(int, String, long, long, int) throws java.lang.SecurityException;













    method public android.app.usage.NetworkStats queryDetailsForUidTag(int, String, long, long, int, int) throws java.lang.SecurityException;













    method public android.app.usage.NetworkStats queryDetailsForUidTagState(int, String, long, long, int, int, int) throws java.lang.SecurityException;













    method public android.app.usage.NetworkStats querySummary(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method public android.app.usage.NetworkStats.Bucket querySummaryForDevice(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method public android.app.usage.NetworkStats.Bucket querySummaryForUser(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats queryDetails(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats queryDetailsForUid(int, String, long, long, int) throws java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats queryDetailsForUidTag(int, String, long, long, int, int) throws java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats queryDetailsForUidTagState(int, String, long, long, int, int, int) throws java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats querySummary(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats.Bucket querySummaryForDevice(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;













    method @WorkerThread public android.app.usage.NetworkStats.Bucket querySummaryForUser(int, String, long, long) throws android.os.RemoteException, java.lang.SecurityException;















    method public void registerUsageCallback(int, String, long, android.app.usage.NetworkStatsManager.UsageCallback);















    method public void registerUsageCallback(int, String, long, android.app.usage.NetworkStatsManager.UsageCallback, @Nullable android.os.Handler);















    method public void unregisterUsageCallback(android.app.usage.NetworkStatsManager.UsageCallback);

























core/java/android/app/usage/NetworkStatsManager.java



+15
−0




























Original line number
Diff line number
Diff line








@@ -24,6 +24,7 @@ import android.annotation.RequiresPermission;













import android.annotation.SystemApi;















import android.annotation.SystemService;















import android.annotation.TestApi;













import android.annotation.WorkerThread;















import android.app.usage.NetworkStats.Bucket;















import android.compat.annotation.UnsupportedAppUsage;















import android.content.Context;










@@ -201,6 +202,7 @@ public class NetworkStatsManager {













     * default network {@link NetworkStats.Bucket#DEFAULT_NETWORK_ALL},















     * metered {@link NetworkStats.Bucket#METERED_ALL},















     * and roaming {@link NetworkStats.Bucket#ROAMING_ALL}.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @param networkType As defined in {@link ConnectivityManager}, e.g.















     *            {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI}









@@ -219,6 +221,7 @@ public class NetworkStatsManager {













     * @return Bucket object or null if permissions are insufficient or error happened during















     *         statistics collection.















     */













    @WorkerThread















    public Bucket querySummaryForDevice(int networkType, String subscriberId,















            long startTime, long endTime) throws SecurityException, RemoteException {















        NetworkTemplate template;









@@ -240,6 +243,7 @@ public class NetworkStatsManager {













     * uid {@link NetworkStats.Bucket#UID_ALL}, tag {@link NetworkStats.Bucket#TAG_NONE},















     * metered {@link NetworkStats.Bucket#METERED_ALL}, and roaming















     * {@link NetworkStats.Bucket#ROAMING_ALL}.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @param networkType As defined in {@link ConnectivityManager}, e.g.















     *            {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI}









@@ -258,6 +262,7 @@ public class NetworkStatsManager {













     * @return Bucket object or null if permissions are insufficient or error happened during















     *         statistics collection.















     */













    @WorkerThread















    public Bucket querySummaryForUser(int networkType, String subscriberId, long startTime,















            long endTime) throws SecurityException, RemoteException {















        NetworkTemplate template;









@@ -283,6 +288,7 @@ public class NetworkStatsManager {













     * means buckets' start and end timestamps are going to be the same as the 'startTime' and















     * 'endTime' parameters. State, uid, metered, and roaming are going to vary, and tag is going to















     * be the same.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @param networkType As defined in {@link ConnectivityManager}, e.g.















     *            {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI}









@@ -301,6 +307,7 @@ public class NetworkStatsManager {













     * @return Statistics object or null if permissions are insufficient or error happened during















     *         statistics collection.















     */













    @WorkerThread















    public NetworkStats querySummary(int networkType, String subscriberId, long startTime,















            long endTime) throws SecurityException, RemoteException {















        NetworkTemplate template;









@@ -326,9 +333,11 @@ public class NetworkStatsManager {





























    /**















     * Query network usage statistics details for a given uid.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @see #queryDetailsForUidTagState(int, String, long, long, int, int, int)















     */













    @WorkerThread















    public NetworkStats queryDetailsForUid(int networkType, String subscriberId,















            long startTime, long endTime, int uid) throws SecurityException {















        return queryDetailsForUidTagState(networkType, subscriberId, startTime, endTime, uid,









@@ -344,9 +353,11 @@ public class NetworkStatsManager {





























    /**















     * Query network usage statistics details for a given uid and tag.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @see #queryDetailsForUidTagState(int, String, long, long, int, int, int)















     */













    @WorkerThread















    public NetworkStats queryDetailsForUidTag(int networkType, String subscriberId,















            long startTime, long endTime, int uid, int tag) throws SecurityException {















        return queryDetailsForUidTagState(networkType, subscriberId, startTime, endTime, uid,









@@ -365,6 +376,7 @@ public class NetworkStatsManager {













     * <p>Only includes buckets that atomically occur in the inclusive time range. Doesn't















     * interpolate across partial buckets. Since bucket length is in the order of hours, this















     * method cannot be used to measure data usage on a fine grained time scale.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @param networkType As defined in {@link ConnectivityManager}, e.g.















     *            {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI}









@@ -387,6 +399,7 @@ public class NetworkStatsManager {













     * @return Statistics object or null if an error happened during statistics collection.















     * @throws SecurityException if permissions are insufficient to read network statistics.















     */













    @WorkerThread















    public NetworkStats queryDetailsForUidTagState(int networkType, String subscriberId,















            long startTime, long endTime, int uid, int tag, int state) throws SecurityException {















        NetworkTemplate template;










@@ -425,6 +438,7 @@ public class NetworkStatsManager {













     * <p>Only includes buckets that atomically occur in the inclusive time range. Doesn't















     * interpolate across partial buckets. Since bucket length is in the order of hours, this















     * method cannot be used to measure data usage on a fine grained time scale.













     * This may take a long time, and apps should avoid calling this on their main thread.















     *















     * @param networkType As defined in {@link ConnectivityManager}, e.g.















     *            {@link ConnectivityManager#TYPE_MOBILE}, {@link ConnectivityManager#TYPE_WIFI}









@@ -443,6 +457,7 @@ public class NetworkStatsManager {













     * @return Statistics object or null if permissions are insufficient or error happened during















     *         statistics collection.















     */













    @WorkerThread















    public NetworkStats queryDetails(int networkType, String subscriberId, long startTime,















            long endTime) throws SecurityException, RemoteException {















        NetworkTemplate template;