/*
|
* 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 com.android.server.wifi;
|
|
import android.text.TextUtils;
|
|
/**
|
* Class for storing an IMSI (International Mobile Subscriber Identity) parameter. The IMSI
|
* contains number (up to 15) of numerical digits. When an IMSI ends with a '*', the specified
|
* IMSI is a prefix.
|
*/
|
public class IMSIParameter {
|
/**
|
* MCC (Mobile Country Code) is a 3 digit number and MNC (Mobile Network Code) is also a 3
|
* digit number.
|
*/
|
public static final int MCC_MNC_LENGTH = 6;
|
|
private static final int MAX_IMSI_LENGTH = 15;
|
|
private final String mImsi;
|
private final boolean mPrefix;
|
|
public IMSIParameter(String imsi, boolean prefix) {
|
mImsi = imsi;
|
mPrefix = prefix;
|
}
|
|
/**
|
* Build an IMSIParameter object from the given string. A null will be returned for a
|
* malformed string.
|
*
|
* @param imsi The IMSI string
|
* @return {@link IMSIParameter}
|
*/
|
public static IMSIParameter build(String imsi) {
|
if (TextUtils.isEmpty(imsi)) {
|
return null;
|
}
|
if (imsi.length() > MAX_IMSI_LENGTH) {
|
return null;
|
}
|
|
// Detect the first non-digit character.
|
int nonDigit;
|
char stopChar = '\0';
|
for (nonDigit = 0; nonDigit < imsi.length(); nonDigit++) {
|
stopChar = imsi.charAt(nonDigit);
|
if (stopChar < '0' || stopChar > '9') {
|
break;
|
}
|
}
|
|
if (nonDigit == imsi.length()) {
|
// Full IMSI.
|
return new IMSIParameter(imsi, false);
|
}
|
else if (nonDigit == imsi.length()-1 && stopChar == '*') {
|
// IMSI prefix.
|
return new IMSIParameter(imsi.substring(0, nonDigit), true);
|
}
|
return null;
|
}
|
|
/**
|
* Perform matching against the given full IMSI.
|
*
|
* @param fullIMSI The full IMSI to match against
|
* @return true if matched
|
*/
|
public boolean matchesImsi(String fullIMSI) {
|
if (fullIMSI == null) {
|
return false;
|
}
|
|
if (mPrefix) {
|
// Prefix matching.
|
return mImsi.regionMatches(false, 0, fullIMSI, 0, mImsi.length());
|
} else {
|
// Exact matching.
|
return mImsi.equals(fullIMSI);
|
}
|
}
|
|
/**
|
* Perform matching against the given MCC-MNC (Mobile Country Code and Mobile Network
|
* Code) combination.
|
*
|
* @param mccMnc The MCC-MNC to match against
|
* @return true if matched
|
*/
|
public boolean matchesMccMnc(String mccMnc) {
|
if (mccMnc == null) {
|
return false;
|
}
|
if (mccMnc.length() != MCC_MNC_LENGTH) {
|
return false;
|
}
|
int checkLength = MCC_MNC_LENGTH;
|
if (mPrefix && mImsi.length() < MCC_MNC_LENGTH) {
|
checkLength = mImsi.length();
|
}
|
return mImsi.regionMatches(false, 0, mccMnc, 0, checkLength);
|
}
|
|
@Override
|
public boolean equals(Object thatObject) {
|
if (this == thatObject) {
|
return true;
|
}
|
if (!(thatObject instanceof IMSIParameter)) {
|
return false;
|
}
|
|
IMSIParameter that = (IMSIParameter) thatObject;
|
return mPrefix == that.mPrefix && TextUtils.equals(mImsi, that.mImsi);
|
}
|
|
@Override
|
public int hashCode() {
|
int result = mImsi != null ? mImsi.hashCode() : 0;
|
result = 31 * result + (mPrefix ? 1 : 0);
|
return result;
|
}
|
|
@Override
|
public String toString() {
|
if (mPrefix) {
|
return mImsi + '*';
|
}
|
else {
|
return mImsi;
|
}
|
}
|
}
|
