Add Ethernet, TestNetworkSpecifier API am: c5479a0886 (c792424c) · Commits · e / os / android_frameworks_base

core/api/module-lib-current.txt

+8 −0

Original line number	Diff line number	Diff line
		@@ -22,6 +22,14 @@ package android.app.usage {

		package android.net {

		public final class EthernetNetworkSpecifier extends android.net.NetworkSpecifier implements android.os.Parcelable {
		ctor public EthernetNetworkSpecifier(@NonNull String);
		method public int describeContents();
		method @Nullable public String getInterfaceName();
		method public void writeToParcel(@NonNull android.os.Parcel, int);
		field @NonNull public static final android.os.Parcelable.Creator<android.net.EthernetNetworkSpecifier> CREATOR;
		}

		public static final class IpSecManager.UdpEncapsulationSocket implements java.lang.AutoCloseable {
		method public int getResourceId();
		}

core/java/android/net/EthernetNetworkSpecifier.java

0 → 100644

+97 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2021 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;

		import com.android.internal.util.Preconditions;

		import java.util.Objects;

		/**
		* A {@link NetworkSpecifier} used to identify ethernet interfaces.
		*
		* @see EthernetManager
		* @hide
		*/
		@SystemApi(client = SystemApi.Client.MODULE_LIBRARIES)
		public final class EthernetNetworkSpecifier extends NetworkSpecifier implements Parcelable {

		/**
		* Name of the network interface.
		*/
		@NonNull
		private final String mInterfaceName;

		public EthernetNetworkSpecifier(@NonNull String interfaceName) {
		Preconditions.checkStringNotEmpty(interfaceName);
		mInterfaceName = interfaceName;
		}

		// This may be null in the future to support specifiers based on data other than the interface
		// name.
		@Nullable
		public String getInterfaceName() {
		return mInterfaceName;
		}

		@Override
		public boolean canBeSatisfiedBy(@Nullable NetworkSpecifier other) {
		return equals(other);
		}

		@Override
		public boolean equals(@Nullable Object o) {
		if (!(o instanceof EthernetNetworkSpecifier)) return false;
		return TextUtils.equals(mInterfaceName, ((EthernetNetworkSpecifier) o).mInterfaceName);
		}

		@Override
		public int hashCode() {
		return Objects.hashCode(mInterfaceName);
		}

		@Override
		public String toString() {
		return "EthernetNetworkSpecifier (" + mInterfaceName + ")";
		}

		@Override
		public int describeContents() {
		return 0;
		}

		@Override
		public void writeToParcel(@NonNull Parcel dest, int flags) {
		dest.writeString(mInterfaceName);
		}

		public static final @NonNull Parcelable.Creator<EthernetNetworkSpecifier> CREATOR =
		new Parcelable.Creator<EthernetNetworkSpecifier>() {
		public EthernetNetworkSpecifier createFromParcel(Parcel in) {
		return new EthernetNetworkSpecifier(in.readString());
		}
		public EthernetNetworkSpecifier[] newArray(int size) {
		return new EthernetNetworkSpecifier[size];
		}
		};
		}

packages/Connectivity/framework/api/module-lib-current.txt

+8 −0

Original line number	Diff line number	Diff line
		@@ -51,6 +51,14 @@ package android.net {
		field public static final String TEST_TAP_PREFIX = "testtap";
		}

		public final class TestNetworkSpecifier extends android.net.NetworkSpecifier implements android.os.Parcelable {
		ctor public TestNetworkSpecifier(@NonNull String);
		method public int describeContents();
		method @Nullable public String getInterfaceName();
		method public void writeToParcel(@NonNull android.os.Parcel, int);
		field @NonNull public static final android.os.Parcelable.Creator<android.net.TestNetworkSpecifier> CREATOR;
		}

		public final class VpnTransportInfo implements android.os.Parcelable android.net.TransportInfo {
		ctor public VpnTransportInfo(int);
		method public int describeContents();

packages/Connectivity/framework/src/android/net/NetworkRequest.java

+12 −5

Original line number	Diff line number	Diff line
		@@ -31,6 +31,7 @@ import static android.net.NetworkCapabilities.NET_CAPABILITY_PARTIAL_CONNECTIVIT
		import static android.net.NetworkCapabilities.NET_CAPABILITY_TEMPORARILY_NOT_METERED;
		import static android.net.NetworkCapabilities.NET_CAPABILITY_TRUSTED;
		import static android.net.NetworkCapabilities.NET_CAPABILITY_VALIDATED;
		import static android.net.NetworkCapabilities.TRANSPORT_TEST;

		import android.annotation.NonNull;
		import android.annotation.Nullable;
		@@ -387,11 +388,17 @@ public class NetworkRequest implements Parcelable {
		return setNetworkSpecifier(new TelephonyNetworkSpecifier.Builder()
		.setSubscriptionId(subId).build());
		} catch (NumberFormatException nfe) {
		// A StringNetworkSpecifier does not accept null or empty ("") strings. When network
		// specifiers were strings a null string and an empty string were considered
		// equivalent. Hence no meaning is attached to a null or empty ("") string.
		return setNetworkSpecifier(TextUtils.isEmpty(networkSpecifier) ? null
		: new StringNetworkSpecifier(networkSpecifier));
		// An EthernetNetworkSpecifier or TestNetworkSpecifier does not accept null or empty
		// ("") strings. When network specifiers were strings a null string and an empty
		// string were considered equivalent. Hence no meaning is attached to a null or
		// empty ("") string.
		if (TextUtils.isEmpty(networkSpecifier)) {
		return setNetworkSpecifier((NetworkSpecifier) null);
		} else if (mNetworkCapabilities.hasTransport(TRANSPORT_TEST)) {
		return setNetworkSpecifier(new TestNetworkSpecifier(networkSpecifier));
		} else {
		return setNetworkSpecifier(new EthernetNetworkSpecifier(networkSpecifier));
		}
		}
		}

packages/Connectivity/framework/src/android/net/TestNetworkSpecifier.java

0 → 100644

+97 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2021 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;

		import com.android.internal.util.Preconditions;

		import java.util.Objects;

		/**
		* A {@link NetworkSpecifier} used to identify test interfaces.
		*
		* @see TestNetworkManager
		* @hide
		*/
		@SystemApi(client = SystemApi.Client.MODULE_LIBRARIES)
		public final class TestNetworkSpecifier extends NetworkSpecifier implements Parcelable {

		/**
		* Name of the network interface.
		*/
		@NonNull
		private final String mInterfaceName;

		public TestNetworkSpecifier(@NonNull String interfaceName) {
		Preconditions.checkStringNotEmpty(interfaceName);
		mInterfaceName = interfaceName;
		}

		// This may be null in the future to support specifiers based on data other than the interface
		// name.
		@Nullable
		public String getInterfaceName() {
		return mInterfaceName;
		}

		@Override
		public boolean canBeSatisfiedBy(@Nullable NetworkSpecifier other) {
		return equals(other);
		}

		@Override
		public boolean equals(Object o) {
		if (!(o instanceof TestNetworkSpecifier)) return false;
		return TextUtils.equals(mInterfaceName, ((TestNetworkSpecifier) o).mInterfaceName);
		}

		@Override
		public int hashCode() {
		return Objects.hashCode(mInterfaceName);
		}

		@Override
		public String toString() {
		return "TestNetworkSpecifier (" + mInterfaceName + ")";
		}

		@Override
		public int describeContents() {
		return 0;
		}

		@Override
		public void writeToParcel(@NonNull Parcel dest, int flags) {
		dest.writeString(mInterfaceName);
		}

		public static final @NonNull Creator<TestNetworkSpecifier> CREATOR =
		new Creator<TestNetworkSpecifier>() {
		public TestNetworkSpecifier createFromParcel(Parcel in) {
		return new TestNetworkSpecifier(in.readString());
		}
		public TestNetworkSpecifier[] newArray(int size) {
		return new TestNetworkSpecifier[size];
		}
		};
		}