1/*
2 * Copyright (C) 2013 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16package com.android.contacts.util;
17
18import android.telephony.PhoneNumberUtils;
19import android.util.Log;
20
21/**
22 * This class wraps several PhoneNumberUtil calls and TelephonyManager calls. Some of them are
23 * the same as the ones in the framework's code base. We can remove those once they are part of
24 * the public API.
25 */
26public class PhoneNumberHelper {
27
28    private static final String LOG_TAG = PhoneNumberHelper.class.getSimpleName();
29
30    private static final String KOREA_ISO_COUNTRY_CODE = "KR";
31    /**
32     * Determines if the specified number is actually a URI (i.e. a SIP address) rather than a
33     * regular PSTN phone number, based on whether or not the number contains an "@" character.
34     *
35     * @param number Phone number
36     * @return true if number contains @
37     *
38     * TODO: Remove if PhoneNumberUtils.isUriNumber(String number) is made public.
39     */
40    public static boolean isUriNumber(String number) {
41        // Note we allow either "@" or "%40" to indicate a URI, in case
42        // the passed-in string is URI-escaped.  (Neither "@" nor "%40"
43        // will ever be found in a legal PSTN number.)
44        return number != null && (number.contains("@") || number.contains("%40"));
45    }
46
47    /**
48     * Normalize a phone number by removing the characters other than digits. If
49     * the given number has keypad letters, the letters will be converted to
50     * digits first.
51     *
52     * @param phoneNumber The number to be normalized.
53     * @return The normalized number.
54     *
55     * TODO: Remove if PhoneNumberUtils.normalizeNumber(String phoneNumber) is made public.
56     */
57    public static String normalizeNumber(String phoneNumber) {
58        StringBuilder sb = new StringBuilder();
59        int len = phoneNumber.length();
60        for (int i = 0; i < len; i++) {
61            char c = phoneNumber.charAt(i);
62            // Character.digit() supports ASCII and Unicode digits (fullwidth, Arabic-Indic, etc.)
63            int digit = Character.digit(c, 10);
64            if (digit != -1) {
65                sb.append(digit);
66            } else if (i == 0 && c == '+') {
67                sb.append(c);
68            } else if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')) {
69                return normalizeNumber(PhoneNumberUtils.convertKeypadLettersToDigits(phoneNumber));
70            }
71        }
72        return sb.toString();
73    }
74
75    /**
76     * @return the "username" part of the specified SIP address, i.e. the part before the "@"
77     * character (or "%40").
78     *
79     * @param number SIP address of the form "username@domainname" (or the URI-escaped equivalent
80     * "username%40domainname")
81     *
82     * TODO: Remove if PhoneNumberUtils.getUsernameFromUriNumber(String number) is made public.
83     */
84    public static String getUsernameFromUriNumber(String number) {
85        // The delimiter between username and domain name can be
86        // either "@" or "%40" (the URI-escaped equivalent.)
87        int delimiterIndex = number.indexOf('@');
88        if (delimiterIndex < 0) {
89            delimiterIndex = number.indexOf("%40");
90        }
91        if (delimiterIndex < 0) {
92            Log.w(LOG_TAG,
93                    "getUsernameFromUriNumber: no delimiter found in SIP addr '" + number + "'");
94            return number;
95        }
96        return number.substring(0, delimiterIndex);
97    }
98}
99