/** * 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.net; import android.net.NetworkTemplate; import android.os.Parcel; import android.os.Parcelable; import java.util.Arrays; import java.util.Objects; /** * Defines a request to register a callbacks. Used to be notified on data usage via * {@link android.app.usage.NetworkStatsManager#registerDataUsageCallback}. * If no {@code uid}s are set, callbacks are restricted to device-owners, * carrier-privileged apps, or system apps. */ public final class DataUsageRequest implements Parcelable { /** * @hide */ public static final String PARCELABLE_KEY = "DataUsageRequest"; /** * @hide */ public static final int REQUEST_ID_UNSET = 0; /** * Identifies the request. {@link DataUsageRequest}s should only be constructed by * the Framework and it is used internally to identify the request. * @hide */ public final int requestId; /** * Set of {@link NetworkTemplate}s describing the networks to monitor. * @hide */ public final NetworkTemplate[] templates; /** * Set of UIDs of which to monitor data usage. * *
If not {@code null}, the caller will be notified when any of the uids exceed
* the given threshold. If {@code null} all uids for which the calling process has access
* to stats will be monitored.
* @hide
*/
public final int[] uids;
/**
* Threshold in bytes to be notified on.
* @hide
*/
public final long thresholdInBytes;
/**
* @hide
*/
public DataUsageRequest(int requestId, NetworkTemplate[] templates, int[] uids,
long thresholdInBytes) {
this.requestId = requestId;
this.templates = templates;
this.uids = uids;
this.thresholdInBytes = thresholdInBytes;
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel dest, int flags) {
dest.writeInt(requestId);
dest.writeTypedArray(templates, flags);
dest.writeIntArray(uids);
dest.writeLong(thresholdInBytes);
}
public static final Creator