| /* |
| * Copyright (C) 2011 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 static android.net.ConnectivityManager.TYPE_ETHERNET; |
| import static android.net.ConnectivityManager.TYPE_WIFI; |
| import static android.net.ConnectivityManager.TYPE_WIFI_P2P; |
| import static android.net.ConnectivityManager.TYPE_WIMAX; |
| import static android.net.NetworkIdentity.scrubSubscriberId; |
| import static android.telephony.TelephonyManager.NETWORK_CLASS_2_G; |
| import static android.telephony.TelephonyManager.NETWORK_CLASS_3_G; |
| import static android.telephony.TelephonyManager.NETWORK_CLASS_4_G; |
| import static android.telephony.TelephonyManager.NETWORK_CLASS_UNKNOWN; |
| import static android.telephony.TelephonyManager.getNetworkClass; |
| import static com.android.internal.util.ArrayUtils.contains; |
| |
| import android.content.res.Resources; |
| import android.os.Parcel; |
| import android.os.Parcelable; |
| |
| import com.android.internal.util.Objects; |
| |
| /** |
| * Template definition used to generically match {@link NetworkIdentity}, |
| * usually when collecting statistics. |
| * |
| * @hide |
| */ |
| public class NetworkTemplate implements Parcelable { |
| |
| /** {@hide} */ |
| public static final int MATCH_MOBILE_ALL = 1; |
| /** {@hide} */ |
| public static final int MATCH_MOBILE_3G_LOWER = 2; |
| /** {@hide} */ |
| public static final int MATCH_MOBILE_4G = 3; |
| /** {@hide} */ |
| public static final int MATCH_WIFI = 4; |
| /** {@hide} */ |
| public static final int MATCH_ETHERNET = 5; |
| |
| /** |
| * Set of {@link NetworkInfo#getType()} that reflect data usage. |
| */ |
| private static final int[] DATA_USAGE_NETWORK_TYPES; |
| |
| static { |
| DATA_USAGE_NETWORK_TYPES = Resources.getSystem().getIntArray( |
| com.android.internal.R.array.config_data_usage_network_types); |
| } |
| |
| /** |
| * Template to combine all {@link ConnectivityManager#TYPE_MOBILE} style |
| * networks together. Only uses statistics for requested IMSI. |
| */ |
| public static NetworkTemplate buildTemplateMobileAll(String subscriberId) { |
| return new NetworkTemplate(MATCH_MOBILE_ALL, subscriberId); |
| } |
| |
| /** |
| * Template to combine all {@link ConnectivityManager#TYPE_MOBILE} style |
| * networks together that roughly meet a "3G" definition, or lower. Only |
| * uses statistics for requested IMSI. |
| */ |
| public static NetworkTemplate buildTemplateMobile3gLower(String subscriberId) { |
| return new NetworkTemplate(MATCH_MOBILE_3G_LOWER, subscriberId); |
| } |
| |
| /** |
| * Template to combine all {@link ConnectivityManager#TYPE_MOBILE} style |
| * networks together that meet a "4G" definition. Only uses statistics for |
| * requested IMSI. |
| */ |
| public static NetworkTemplate buildTemplateMobile4g(String subscriberId) { |
| return new NetworkTemplate(MATCH_MOBILE_4G, subscriberId); |
| } |
| |
| /** |
| * Template to combine all {@link ConnectivityManager#TYPE_WIFI} style |
| * networks together. |
| */ |
| public static NetworkTemplate buildTemplateWifi() { |
| return new NetworkTemplate(MATCH_WIFI, null); |
| } |
| |
| /** |
| * Template to combine all {@link ConnectivityManager#TYPE_ETHERNET} style |
| * networks together. |
| */ |
| public static NetworkTemplate buildTemplateEthernet() { |
| return new NetworkTemplate(MATCH_ETHERNET, null); |
| } |
| |
| private final int mMatchRule; |
| private final String mSubscriberId; |
| |
| /** {@hide} */ |
| public NetworkTemplate(int matchRule, String subscriberId) { |
| this.mMatchRule = matchRule; |
| this.mSubscriberId = subscriberId; |
| } |
| |
| private NetworkTemplate(Parcel in) { |
| mMatchRule = in.readInt(); |
| mSubscriberId = in.readString(); |
| } |
| |
| /** {@inheritDoc} */ |
| public void writeToParcel(Parcel dest, int flags) { |
| dest.writeInt(mMatchRule); |
| dest.writeString(mSubscriberId); |
| } |
| |
| /** {@inheritDoc} */ |
| public int describeContents() { |
| return 0; |
| } |
| |
| @Override |
| public String toString() { |
| final String scrubSubscriberId = scrubSubscriberId(mSubscriberId); |
| return "NetworkTemplate: matchRule=" + getMatchRuleName(mMatchRule) + ", subscriberId=" |
| + scrubSubscriberId; |
| } |
| |
| @Override |
| public int hashCode() { |
| return Objects.hashCode(mMatchRule, mSubscriberId); |
| } |
| |
| @Override |
| public boolean equals(Object obj) { |
| if (obj instanceof NetworkTemplate) { |
| final NetworkTemplate other = (NetworkTemplate) obj; |
| return mMatchRule == other.mMatchRule |
| && Objects.equal(mSubscriberId, other.mSubscriberId); |
| } |
| return false; |
| } |
| |
| /** {@hide} */ |
| public int getMatchRule() { |
| return mMatchRule; |
| } |
| |
| /** {@hide} */ |
| public String getSubscriberId() { |
| return mSubscriberId; |
| } |
| |
| /** |
| * Test if given {@link NetworkIdentity} matches this template. |
| */ |
| public boolean matches(NetworkIdentity ident) { |
| switch (mMatchRule) { |
| case MATCH_MOBILE_ALL: |
| return matchesMobile(ident); |
| case MATCH_MOBILE_3G_LOWER: |
| return matchesMobile3gLower(ident); |
| case MATCH_MOBILE_4G: |
| return matchesMobile4g(ident); |
| case MATCH_WIFI: |
| return matchesWifi(ident); |
| case MATCH_ETHERNET: |
| return matchesEthernet(ident); |
| default: |
| throw new IllegalArgumentException("unknown network template"); |
| } |
| } |
| |
| /** |
| * Check if mobile network with matching IMSI. |
| */ |
| private boolean matchesMobile(NetworkIdentity ident) { |
| if (ident.mType == TYPE_WIMAX) { |
| // TODO: consider matching against WiMAX subscriber identity |
| return true; |
| } else { |
| return (contains(DATA_USAGE_NETWORK_TYPES, ident.mType) |
| && Objects.equal(mSubscriberId, ident.mSubscriberId)); |
| } |
| } |
| |
| /** |
| * Check if mobile network classified 3G or lower with matching IMSI. |
| */ |
| private boolean matchesMobile3gLower(NetworkIdentity ident) { |
| if (ident.mType == TYPE_WIMAX) { |
| return false; |
| } else if (matchesMobile(ident)) { |
| switch (getNetworkClass(ident.mSubType)) { |
| case NETWORK_CLASS_UNKNOWN: |
| case NETWORK_CLASS_2_G: |
| case NETWORK_CLASS_3_G: |
| return true; |
| } |
| } |
| return false; |
| } |
| |
| /** |
| * Check if mobile network classified 4G with matching IMSI. |
| */ |
| private boolean matchesMobile4g(NetworkIdentity ident) { |
| if (ident.mType == TYPE_WIMAX) { |
| // TODO: consider matching against WiMAX subscriber identity |
| return true; |
| } else if (matchesMobile(ident)) { |
| switch (getNetworkClass(ident.mSubType)) { |
| case NETWORK_CLASS_4_G: |
| return true; |
| } |
| } |
| return false; |
| } |
| |
| /** |
| * Check if matches Wi-Fi network template. |
| */ |
| private boolean matchesWifi(NetworkIdentity ident) { |
| switch (ident.mType) { |
| case TYPE_WIFI: |
| case TYPE_WIFI_P2P: |
| return true; |
| default: |
| return false; |
| } |
| } |
| |
| /** |
| * Check if matches Ethernet network template. |
| */ |
| private boolean matchesEthernet(NetworkIdentity ident) { |
| if (ident.mType == TYPE_ETHERNET) { |
| return true; |
| } |
| return false; |
| } |
| |
| private static String getMatchRuleName(int matchRule) { |
| switch (matchRule) { |
| case MATCH_MOBILE_3G_LOWER: |
| return "MOBILE_3G_LOWER"; |
| case MATCH_MOBILE_4G: |
| return "MOBILE_4G"; |
| case MATCH_MOBILE_ALL: |
| return "MOBILE_ALL"; |
| case MATCH_WIFI: |
| return "WIFI"; |
| case MATCH_ETHERNET: |
| return "ETHERNET"; |
| default: |
| return "UNKNOWN"; |
| } |
| } |
| |
| public static final Creator<NetworkTemplate> CREATOR = new Creator<NetworkTemplate>() { |
| public NetworkTemplate createFromParcel(Parcel in) { |
| return new NetworkTemplate(in); |
| } |
| |
| public NetworkTemplate[] newArray(int size) { |
| return new NetworkTemplate[size]; |
| } |
| }; |
| } |