/* * Copyright (C) 2013 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.dialer.phonenumberutil; import android.content.Context; import android.provider.CallLog; import android.support.annotation.Nullable; import android.telecom.PhoneAccountHandle; import android.telephony.PhoneNumberUtils; import android.telephony.TelephonyManager; import android.text.TextUtils; import com.android.dialer.common.LogUtil; import com.android.dialer.telecom.TelecomUtil; import com.google.i18n.phonenumbers.NumberParseException; import com.google.i18n.phonenumbers.PhoneNumberUtil; import com.google.i18n.phonenumbers.Phonenumber; import com.google.i18n.phonenumbers.geocoding.PhoneNumberOfflineGeocoder; import java.util.Arrays; import java.util.HashSet; import java.util.Locale; import java.util.Set; public class PhoneNumberHelper { private static final String TAG = "PhoneNumberUtil"; private static final Set LEGACY_UNKNOWN_NUMBERS = new HashSet<>(Arrays.asList("-1", "-2", "-3")); /** Returns true if it is possible to place a call to the given number. */ public static boolean canPlaceCallsTo(CharSequence number, int presentation) { return presentation == CallLog.Calls.PRESENTATION_ALLOWED && !TextUtils.isEmpty(number) && !isLegacyUnknownNumbers(number); } /** * Returns true if the given number is the number of the configured voicemail. To be able to * mock-out this, it is not a static method. */ public static boolean isVoicemailNumber( Context context, PhoneAccountHandle accountHandle, CharSequence number) { if (TextUtils.isEmpty(number)) { return false; } return TelecomUtil.isVoicemailNumber(context, accountHandle, number.toString()); } /** * Returns true if the given number is a SIP address. To be able to mock-out this, it is not a * static method. */ public static boolean isSipNumber(CharSequence number) { return number != null && isUriNumber(number.toString()); } public static boolean isUnknownNumberThatCanBeLookedUp( Context context, PhoneAccountHandle accountHandle, CharSequence number, int presentation) { if (presentation == CallLog.Calls.PRESENTATION_UNKNOWN) { return false; } if (presentation == CallLog.Calls.PRESENTATION_RESTRICTED) { return false; } if (presentation == CallLog.Calls.PRESENTATION_PAYPHONE) { return false; } if (TextUtils.isEmpty(number)) { return false; } if (isVoicemailNumber(context, accountHandle, number)) { return false; } if (isLegacyUnknownNumbers(number)) { return false; } return true; } public static boolean isLegacyUnknownNumbers(CharSequence number) { return number != null && LEGACY_UNKNOWN_NUMBERS.contains(number.toString()); } /** * @return a geographical description string for the specified number. * @see com.android.i18n.phonenumbers.PhoneNumberOfflineGeocoder */ public static String getGeoDescription(Context context, String number) { LogUtil.v("PhoneNumberHelper.getGeoDescription", "" + LogUtil.sanitizePii(number)); if (TextUtils.isEmpty(number)) { return null; } PhoneNumberUtil util = PhoneNumberUtil.getInstance(); PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance(); Locale locale = context.getResources().getConfiguration().locale; String countryIso = getCurrentCountryIso(context, locale); Phonenumber.PhoneNumber pn = null; try { LogUtil.v( "PhoneNumberHelper.getGeoDescription", "parsing '" + LogUtil.sanitizePii(number) + "' for countryIso '" + countryIso + "'..."); pn = util.parse(number, countryIso); LogUtil.v( "PhoneNumberHelper.getGeoDescription", "- parsed number: " + LogUtil.sanitizePii(pn)); } catch (NumberParseException e) { LogUtil.e( "PhoneNumberHelper.getGeoDescription", "getGeoDescription: NumberParseException for incoming number '" + LogUtil.sanitizePii(number) + "'"); } if (pn != null) { String description = geocoder.getDescriptionForNumber(pn, locale); LogUtil.v("PhoneNumberHelper.getGeoDescription", "- got description: '" + description + "'"); return description; } return null; } /** * @return The ISO 3166-1 two letters country code of the country the user is in based on the * network location. If the network location does not exist, fall back to the locale setting. */ public static String getCurrentCountryIso(Context context, Locale locale) { // Without framework function calls, this seems to be the most accurate location service // we can rely on. final TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE); String countryIso = telephonyManager.getNetworkCountryIso(); if (TextUtils.isEmpty(countryIso)) { countryIso = locale.getCountry(); LogUtil.i( "PhoneNumberHelper.getCurrentCountryIso", "No CountryDetector; falling back to countryIso based on locale: " + countryIso); } countryIso = countryIso.toUpperCase(); return countryIso; } /** * @return Formatted phone number. e.g. 1-123-456-7890. Returns the original number if formatting * failed. */ public static String formatNumber(@Nullable String number, Context context) { // The number can be null e.g. schema is voicemail and uri content is empty. if (number == null) { return null; } String formattedNumber = PhoneNumberUtils.formatNumber( number, PhoneNumberHelper.getCurrentCountryIso(context, Locale.getDefault())); return formattedNumber != null ? formattedNumber : number; } /** * Determines if the specified number is actually a URI (i.e. a SIP address) rather than a regular * PSTN phone number, based on whether or not the number contains an "@" character. * * @param number Phone number * @return true if number contains @ *

TODO: Remove if PhoneNumberUtils.isUriNumber(String number) is made public. */ public static boolean isUriNumber(String number) { // Note we allow either "@" or "%40" to indicate a URI, in case // the passed-in string is URI-escaped. (Neither "@" nor "%40" // will ever be found in a legal PSTN number.) return number != null && (number.contains("@") || number.contains("%40")); } /** * @param number SIP address of the form "username@domainname" (or the URI-escaped equivalent * "username%40domainname") *

TODO: Remove if PhoneNumberUtils.getUsernameFromUriNumber(String number) is made public. * @return the "username" part of the specified SIP address, i.e. the part before the "@" * character (or "%40"). */ public static String getUsernameFromUriNumber(String number) { // The delimiter between username and domain name can be // either "@" or "%40" (the URI-escaped equivalent.) int delimiterIndex = number.indexOf('@'); if (delimiterIndex < 0) { delimiterIndex = number.indexOf("%40"); } if (delimiterIndex < 0) { LogUtil.i( "PhoneNumberHelper.getUsernameFromUriNumber", "getUsernameFromUriNumber: no delimiter found in SIP address: " + LogUtil.sanitizePii(number)); return number; } return number.substring(0, delimiterIndex); } private static boolean isVerizon(Context context) { // Verizon MCC/MNC codes copied from com/android/voicemailomtp/res/xml/vvm_config.xml. // TODO: Need a better way to do per carrier and per OEM configurations. switch (context.getSystemService(TelephonyManager.class).getSimOperator()) { case "310004": case "310010": case "310012": case "310013": case "310590": case "310890": case "310910": case "311110": case "311270": case "311271": case "311272": case "311273": case "311274": case "311275": case "311276": case "311277": case "311278": case "311279": case "311280": case "311281": case "311282": case "311283": case "311284": case "311285": case "311286": case "311287": case "311288": case "311289": case "311390": case "311480": case "311481": case "311482": case "311483": case "311484": case "311485": case "311486": case "311487": case "311488": case "311489": return true; default: return false; } } /** * Gets the label to display for a phone call where the presentation is set as * PRESENTATION_RESTRICTED. For Verizon we want this to be displayed as "Restricted". For all * other carriers we want this to be be displayed as "Private number". */ public static CharSequence getDisplayNameForRestrictedNumber(Context context) { if (isVerizon(context)) { return context.getString(R.string.private_num_verizon); } else { return context.getString(R.string.private_num_non_verizon); } } }