Merge changes from topic "networkagent"
* changes: Add a Builder to NetworkAgentConfig, and make it SystemApi. Rename NetworkMisc to NetworkAgentConfig.
This commit is contained in:
@@ -3173,8 +3173,8 @@ public class ConnectivityManager {
|
||||
*/
|
||||
@RequiresPermission(android.Manifest.permission.NETWORK_FACTORY)
|
||||
public Network registerNetworkAgent(Messenger messenger, NetworkInfo ni, LinkProperties lp,
|
||||
NetworkCapabilities nc, int score, NetworkMisc misc) {
|
||||
return registerNetworkAgent(messenger, ni, lp, nc, score, misc, NetworkProvider.ID_NONE);
|
||||
NetworkCapabilities nc, int score, NetworkAgentConfig config) {
|
||||
return registerNetworkAgent(messenger, ni, lp, nc, score, config, NetworkProvider.ID_NONE);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -3184,9 +3184,10 @@ public class ConnectivityManager {
|
||||
*/
|
||||
@RequiresPermission(android.Manifest.permission.NETWORK_FACTORY)
|
||||
public Network registerNetworkAgent(Messenger messenger, NetworkInfo ni, LinkProperties lp,
|
||||
NetworkCapabilities nc, int score, NetworkMisc misc, int providerId) {
|
||||
NetworkCapabilities nc, int score, NetworkAgentConfig config, int providerId) {
|
||||
|
||||
try {
|
||||
return mService.registerNetworkAgent(messenger, ni, lp, nc, score, misc, providerId);
|
||||
return mService.registerNetworkAgent(messenger, ni, lp, nc, score, config, providerId);
|
||||
} catch (RemoteException e) {
|
||||
throw e.rethrowFromSystemServer();
|
||||
}
|
||||
|
||||
@@ -20,9 +20,9 @@ import android.app.PendingIntent;
|
||||
import android.net.ConnectionInfo;
|
||||
import android.net.LinkProperties;
|
||||
import android.net.Network;
|
||||
import android.net.NetworkAgentConfig;
|
||||
import android.net.NetworkCapabilities;
|
||||
import android.net.NetworkInfo;
|
||||
import android.net.NetworkMisc;
|
||||
import android.net.NetworkQuotaInfo;
|
||||
import android.net.NetworkRequest;
|
||||
import android.net.NetworkState;
|
||||
@@ -153,7 +153,8 @@ interface IConnectivityManager
|
||||
void declareNetworkRequestUnfulfillable(in NetworkRequest request);
|
||||
|
||||
Network registerNetworkAgent(in Messenger messenger, in NetworkInfo ni, in LinkProperties lp,
|
||||
in NetworkCapabilities nc, int score, in NetworkMisc misc, in int factorySerialNumber);
|
||||
in NetworkCapabilities nc, int score, in NetworkAgentConfig config,
|
||||
in int factorySerialNumber);
|
||||
|
||||
NetworkRequest requestNetwork(in NetworkCapabilities networkCapabilities,
|
||||
in Messenger messenger, int timeoutSec, in IBinder binder, int legacy);
|
||||
|
||||
@@ -221,8 +221,8 @@ public abstract class NetworkAgent {
|
||||
this(looper, context, logTag, ni, nc, lp, score, null, NetworkProvider.ID_NONE);
|
||||
}
|
||||
public NetworkAgent(Looper looper, Context context, String logTag, NetworkInfo ni,
|
||||
NetworkCapabilities nc, LinkProperties lp, int score, NetworkMisc misc) {
|
||||
this(looper, context, logTag, ni, nc, lp, score, misc, NetworkProvider.ID_NONE);
|
||||
NetworkCapabilities nc, LinkProperties lp, int score, NetworkAgentConfig config) {
|
||||
this(looper, context, logTag, ni, nc, lp, score, config, NetworkProvider.ID_NONE);
|
||||
}
|
||||
|
||||
public NetworkAgent(Looper looper, Context context, String logTag, NetworkInfo ni,
|
||||
@@ -231,7 +231,7 @@ public abstract class NetworkAgent {
|
||||
}
|
||||
|
||||
public NetworkAgent(Looper looper, Context context, String logTag, NetworkInfo ni,
|
||||
NetworkCapabilities nc, LinkProperties lp, int score, NetworkMisc misc,
|
||||
NetworkCapabilities nc, LinkProperties lp, int score, NetworkAgentConfig config,
|
||||
int providerId) {
|
||||
mHandler = new NetworkAgentHandler(looper);
|
||||
LOG_TAG = logTag;
|
||||
@@ -245,7 +245,7 @@ public abstract class NetworkAgent {
|
||||
ConnectivityManager cm = (ConnectivityManager)mContext.getSystemService(
|
||||
Context.CONNECTIVITY_SERVICE);
|
||||
network = cm.registerNetworkAgent(new Messenger(mHandler), new NetworkInfo(ni),
|
||||
new LinkProperties(lp), new NetworkCapabilities(nc), score, misc,
|
||||
new LinkProperties(lp), new NetworkCapabilities(nc), score, config,
|
||||
providerId);
|
||||
}
|
||||
|
||||
|
||||
230
core/java/android/net/NetworkAgentConfig.java
Normal file
230
core/java/android/net/NetworkAgentConfig.java
Normal file
@@ -0,0 +1,230 @@
|
||||
/*
|
||||
* Copyright (C) 2014 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.annotation.NonNull;
|
||||
import android.annotation.Nullable;
|
||||
import android.annotation.SystemApi;
|
||||
import android.os.Parcel;
|
||||
import android.os.Parcelable;
|
||||
import android.text.TextUtils;
|
||||
|
||||
/**
|
||||
* Allows a network transport to provide the system with policy and configuration information about
|
||||
* a particular network when registering a {@link NetworkAgent}. This information cannot change once
|
||||
* the agent is registered.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
@SystemApi
|
||||
public final class NetworkAgentConfig implements Parcelable {
|
||||
|
||||
/**
|
||||
* If the {@link Network} is a VPN, whether apps are allowed to bypass the
|
||||
* VPN. This is set by a {@link VpnService} and used by
|
||||
* {@link ConnectivityManager} when creating a VPN.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean allowBypass;
|
||||
|
||||
/**
|
||||
* Set if the network was manually/explicitly connected to by the user either from settings
|
||||
* or a 3rd party app. For example, turning on cell data is not explicit but tapping on a wifi
|
||||
* ap in the wifi settings to trigger a connection is explicit. A 3rd party app asking to
|
||||
* connect to a particular access point is also explicit, though this may change in the future
|
||||
* as we want apps to use the multinetwork apis.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean explicitlySelected;
|
||||
|
||||
/**
|
||||
* Set if the user desires to use this network even if it is unvalidated. This field has meaning
|
||||
* only if {@link explicitlySelected} is true. If it is, this field must also be set to the
|
||||
* appropriate value based on previous user choice.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean acceptUnvalidated;
|
||||
|
||||
/**
|
||||
* Whether the user explicitly set that this network should be validated even if presence of
|
||||
* only partial internet connectivity.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean acceptPartialConnectivity;
|
||||
|
||||
/**
|
||||
* Set to avoid surfacing the "Sign in to network" notification.
|
||||
* if carrier receivers/apps are registered to handle the carrier-specific provisioning
|
||||
* procedure, a carrier specific provisioning notification will be placed.
|
||||
* only one notification should be displayed. This field is set based on
|
||||
* which notification should be used for provisioning.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean provisioningNotificationDisabled;
|
||||
|
||||
/**
|
||||
*
|
||||
* @return whether the sign in to network notification is enabled by this configuration.
|
||||
*/
|
||||
public boolean isProvisioningNotificationEnabled() {
|
||||
return !provisioningNotificationDisabled;
|
||||
}
|
||||
|
||||
/**
|
||||
* For mobile networks, this is the subscriber ID (such as IMSI).
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public String subscriberId;
|
||||
|
||||
/**
|
||||
* @return the subscriber ID, or null if none.
|
||||
*/
|
||||
@Nullable
|
||||
public String getSubscriberId() {
|
||||
return subscriberId;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set to skip 464xlat. This means the device will treat the network as IPv6-only and
|
||||
* will not attempt to detect a NAT64 via RFC 7050 DNS lookups.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean skip464xlat;
|
||||
|
||||
/**
|
||||
* @return whether NAT64 prefix detection is enabled.
|
||||
*/
|
||||
public boolean isNat64DetectionEnabled() {
|
||||
return !skip464xlat;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set to true if the PRIVATE_DNS_BROKEN notification has shown for this network.
|
||||
* Reset this bit when private DNS mode is changed from strict mode to opportunistic/off mode.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public boolean hasShownBroken;
|
||||
|
||||
/** @hide */
|
||||
public NetworkAgentConfig() {
|
||||
}
|
||||
|
||||
/** @hide */
|
||||
public NetworkAgentConfig(@Nullable NetworkAgentConfig nac) {
|
||||
if (nac != null) {
|
||||
allowBypass = nac.allowBypass;
|
||||
explicitlySelected = nac.explicitlySelected;
|
||||
acceptUnvalidated = nac.acceptUnvalidated;
|
||||
subscriberId = nac.subscriberId;
|
||||
provisioningNotificationDisabled = nac.provisioningNotificationDisabled;
|
||||
skip464xlat = nac.skip464xlat;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Builder class to facilitate constructing {@link NetworkAgentConfig} objects.
|
||||
*/
|
||||
public static class Builder {
|
||||
private final NetworkAgentConfig mConfig = new NetworkAgentConfig();
|
||||
|
||||
/**
|
||||
* Sets the subscriber ID for this network.
|
||||
*
|
||||
* @return this builder, to facilitate chaining.
|
||||
*/
|
||||
@NonNull
|
||||
public Builder setSubscriberId(@Nullable String subscriberId) {
|
||||
mConfig.subscriberId = subscriberId;
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Disables active detection of NAT64 (e.g., via RFC 7050 DNS lookups). Used to save power
|
||||
* and reduce idle traffic on networks that are known to be IPv6-only without a NAT64.
|
||||
*
|
||||
* @return this builder, to facilitate chaining.
|
||||
*/
|
||||
@NonNull
|
||||
public Builder disableNat64Detection() {
|
||||
mConfig.skip464xlat = true;
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Disables the "Sign in to network" notification. Used if the network transport will
|
||||
* perform its own carrier-specific provisioning procedure.
|
||||
*
|
||||
* @return this builder, to facilitate chaining.
|
||||
*/
|
||||
@NonNull
|
||||
public Builder disableProvisioningNotification() {
|
||||
mConfig.provisioningNotificationDisabled = true;
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the constructed {@link NetworkAgentConfig} object.
|
||||
*/
|
||||
@NonNull
|
||||
public NetworkAgentConfig build() {
|
||||
return mConfig;
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public int describeContents() {
|
||||
return 0;
|
||||
}
|
||||
|
||||
@Override
|
||||
public void writeToParcel(@NonNull Parcel out, int flags) {
|
||||
out.writeInt(allowBypass ? 1 : 0);
|
||||
out.writeInt(explicitlySelected ? 1 : 0);
|
||||
out.writeInt(acceptUnvalidated ? 1 : 0);
|
||||
out.writeString(subscriberId);
|
||||
out.writeInt(provisioningNotificationDisabled ? 1 : 0);
|
||||
out.writeInt(skip464xlat ? 1 : 0);
|
||||
}
|
||||
|
||||
public static final @NonNull Creator<NetworkAgentConfig> CREATOR =
|
||||
new Creator<NetworkAgentConfig>() {
|
||||
@Override
|
||||
public NetworkAgentConfig createFromParcel(Parcel in) {
|
||||
NetworkAgentConfig networkAgentConfig = new NetworkAgentConfig();
|
||||
networkAgentConfig.allowBypass = in.readInt() != 0;
|
||||
networkAgentConfig.explicitlySelected = in.readInt() != 0;
|
||||
networkAgentConfig.acceptUnvalidated = in.readInt() != 0;
|
||||
networkAgentConfig.subscriberId = in.readString();
|
||||
networkAgentConfig.provisioningNotificationDisabled = in.readInt() != 0;
|
||||
networkAgentConfig.skip464xlat = in.readInt() != 0;
|
||||
return networkAgentConfig;
|
||||
}
|
||||
|
||||
@Override
|
||||
public NetworkAgentConfig[] newArray(int size) {
|
||||
return new NetworkAgentConfig[size];
|
||||
}
|
||||
};
|
||||
}
|
||||
@@ -1,133 +0,0 @@
|
||||
/*
|
||||
* Copyright (C) 2014 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.os.Parcel;
|
||||
import android.os.Parcelable;
|
||||
|
||||
/**
|
||||
* A grab-bag of information (metadata, policies, properties, etc) about a
|
||||
* {@link Network}. Since this contains PII, it should not be sent outside the
|
||||
* system.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public class NetworkMisc implements Parcelable {
|
||||
|
||||
/**
|
||||
* If the {@link Network} is a VPN, whether apps are allowed to bypass the
|
||||
* VPN. This is set by a {@link VpnService} and used by
|
||||
* {@link ConnectivityManager} when creating a VPN.
|
||||
*/
|
||||
public boolean allowBypass;
|
||||
|
||||
/**
|
||||
* Set if the network was manually/explicitly connected to by the user either from settings
|
||||
* or a 3rd party app. For example, turning on cell data is not explicit but tapping on a wifi
|
||||
* ap in the wifi settings to trigger a connection is explicit. A 3rd party app asking to
|
||||
* connect to a particular access point is also explicit, though this may change in the future
|
||||
* as we want apps to use the multinetwork apis.
|
||||
*/
|
||||
public boolean explicitlySelected;
|
||||
|
||||
/**
|
||||
* Set if the user desires to use this network even if it is unvalidated. This field has meaning
|
||||
* only if {@link explicitlySelected} is true. If it is, this field must also be set to the
|
||||
* appropriate value based on previous user choice.
|
||||
*/
|
||||
public boolean acceptUnvalidated;
|
||||
|
||||
/**
|
||||
* Whether the user explicitly set that this network should be validated even if presence of
|
||||
* only partial internet connectivity.
|
||||
*/
|
||||
public boolean acceptPartialConnectivity;
|
||||
|
||||
/**
|
||||
* Set to avoid surfacing the "Sign in to network" notification.
|
||||
* if carrier receivers/apps are registered to handle the carrier-specific provisioning
|
||||
* procedure, a carrier specific provisioning notification will be placed.
|
||||
* only one notification should be displayed. This field is set based on
|
||||
* which notification should be used for provisioning.
|
||||
*/
|
||||
public boolean provisioningNotificationDisabled;
|
||||
|
||||
/**
|
||||
* For mobile networks, this is the subscriber ID (such as IMSI).
|
||||
*/
|
||||
public String subscriberId;
|
||||
|
||||
/**
|
||||
* Set to skip 464xlat. This means the device will treat the network as IPv6-only and
|
||||
* will not attempt to detect a NAT64 via RFC 7050 DNS lookups.
|
||||
*/
|
||||
public boolean skip464xlat;
|
||||
|
||||
/**
|
||||
* Set to true if the PRIVATE_DNS_BROKEN notification has shown for this network.
|
||||
* Reset this bit when private DNS mode is changed from strict mode to opportunistic/off mode.
|
||||
*/
|
||||
public boolean hasShownBroken;
|
||||
|
||||
public NetworkMisc() {
|
||||
}
|
||||
|
||||
public NetworkMisc(NetworkMisc nm) {
|
||||
if (nm != null) {
|
||||
allowBypass = nm.allowBypass;
|
||||
explicitlySelected = nm.explicitlySelected;
|
||||
acceptUnvalidated = nm.acceptUnvalidated;
|
||||
subscriberId = nm.subscriberId;
|
||||
provisioningNotificationDisabled = nm.provisioningNotificationDisabled;
|
||||
skip464xlat = nm.skip464xlat;
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public int describeContents() {
|
||||
return 0;
|
||||
}
|
||||
|
||||
@Override
|
||||
public void writeToParcel(Parcel out, int flags) {
|
||||
out.writeInt(allowBypass ? 1 : 0);
|
||||
out.writeInt(explicitlySelected ? 1 : 0);
|
||||
out.writeInt(acceptUnvalidated ? 1 : 0);
|
||||
out.writeString(subscriberId);
|
||||
out.writeInt(provisioningNotificationDisabled ? 1 : 0);
|
||||
out.writeInt(skip464xlat ? 1 : 0);
|
||||
}
|
||||
|
||||
public static final @android.annotation.NonNull Creator<NetworkMisc> CREATOR = new Creator<NetworkMisc>() {
|
||||
@Override
|
||||
public NetworkMisc createFromParcel(Parcel in) {
|
||||
NetworkMisc networkMisc = new NetworkMisc();
|
||||
networkMisc.allowBypass = in.readInt() != 0;
|
||||
networkMisc.explicitlySelected = in.readInt() != 0;
|
||||
networkMisc.acceptUnvalidated = in.readInt() != 0;
|
||||
networkMisc.subscriberId = in.readString();
|
||||
networkMisc.provisioningNotificationDisabled = in.readInt() != 0;
|
||||
networkMisc.skip464xlat = in.readInt() != 0;
|
||||
return networkMisc;
|
||||
}
|
||||
|
||||
@Override
|
||||
public NetworkMisc[] newArray(int size) {
|
||||
return new NetworkMisc[size];
|
||||
}
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user