blob: 7f000ec6346690e68389bb7584bccbdff30bda5b [file] [log] [blame]
/*
* Copyright (C) 2012 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.contacts;
import android.content.Context;
import android.content.Intent;
import android.graphics.Rect;
import android.net.Uri;
import android.provider.ContactsContract;
import android.telephony.PhoneNumberUtils;
import android.text.TextUtils;
import android.view.View;
import android.widget.TextView;
import com.android.contacts.model.account.AccountType;
import com.google.i18n.phonenumbers.NumberParseException;
import com.google.i18n.phonenumbers.PhoneNumberUtil;
/**
* Shared static contact utility methods.
*/
public class MoreContactUtils {
private static final String WAIT_SYMBOL_AS_STRING = String.valueOf(PhoneNumberUtils.WAIT);
/**
* Returns true if two data with mimetypes which represent values in contact entries are
* considered equal for collapsing in the GUI. For caller-id, use
* {@link android.telephony.PhoneNumberUtils#compare(android.content.Context, String, String)}
* instead
*/
public static boolean shouldCollapse(CharSequence mimetype1, CharSequence data1,
CharSequence mimetype2, CharSequence data2) {
// different mimetypes? don't collapse
if (!TextUtils.equals(mimetype1, mimetype2)) return false;
// exact same string? good, bail out early
if (TextUtils.equals(data1, data2)) return true;
// so if either is null, these two must be different
if (data1 == null || data2 == null) return false;
// if this is not about phone numbers, we know this is not a match (of course, some
// mimetypes could have more sophisticated matching is the future, e.g. addresses)
if (!TextUtils.equals(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE,
mimetype1)) {
return false;
}
return shouldCollapsePhoneNumbers(data1.toString(), data2.toString());
}
// TODO: Move this to PhoneDataItem.shouldCollapse override
private static boolean shouldCollapsePhoneNumbers(String number1, String number2) {
// Work around to address b/20724444. We want to distinguish between #555, *555 and 555.
// This makes no attempt to distinguish between 555 and 55*5, since 55*5 is an improbable
// number. PhoneNumberUtil already distinguishes between 555 and 55#5.
if (number1.contains("#") != number2.contains("#")
|| number1.contains("*") != number2.contains("*")) {
return false;
}
// Now do the full phone number thing. split into parts, separated by waiting symbol
// and compare them individually
final String[] dataParts1 = number1.split(WAIT_SYMBOL_AS_STRING);
final String[] dataParts2 = number2.split(WAIT_SYMBOL_AS_STRING);
if (dataParts1.length != dataParts2.length) return false;
final PhoneNumberUtil util = PhoneNumberUtil.getInstance();
for (int i = 0; i < dataParts1.length; i++) {
// Match phone numbers represented by keypad letters, in which case prefer the
// phone number with letters.
final String dataPart1 = PhoneNumberUtils.convertKeypadLettersToDigits(dataParts1[i]);
final String dataPart2 = dataParts2[i];
// substrings equal? shortcut, don't parse
if (TextUtils.equals(dataPart1, dataPart2)) continue;
// do a full parse of the numbers
final PhoneNumberUtil.MatchType result = util.isNumberMatch(dataPart1, dataPart2);
switch (result) {
case NOT_A_NUMBER:
// don't understand the numbers? let's play it safe
return false;
case NO_MATCH:
return false;
case EXACT_MATCH:
break;
case NSN_MATCH:
try {
// For NANP phone numbers, match when one has +1 and the other does not.
// In this case, prefer the +1 version.
if (util.parse(dataPart1, null).getCountryCode() == 1) {
// At this point, the numbers can be either case 1 or 2 below....
//
// case 1)
// +14155551212 <--- country code 1
// 14155551212 <--- 1 is trunk prefix, not country code
//
// and
//
// case 2)
// +14155551212
// 4155551212
//
// From b/7519057, case 2 needs to be equal. But also that bug, case 3
// below should not be equal.
//
// case 3)
// 14155551212
// 4155551212
//
// So in order to make sure transitive equality is valid, case 1 cannot
// be equal. Otherwise, transitive equality breaks and the following
// would all be collapsed:
// 4155551212 |
// 14155551212 |----> +14155551212
// +14155551212 |
//
// With transitive equality, the collapsed values should be:
// 4155551212 | 14155551212
// 14155551212 |----> +14155551212
// +14155551212 |
// Distinguish between case 1 and 2 by checking for trunk prefix '1'
// at the start of number 2.
if (dataPart2.trim().charAt(0) == '1') {
// case 1
return false;
}
break;
}
} catch (NumberParseException e) {
// This is the case where the first number does not have a country code.
// examples:
// (123) 456-7890 & 123-456-7890 (collapse)
// 0049 (8092) 1234 & +49/80921234 (unit test says do not collapse)
// Check the second number. If it also does not have a country code, then
// we should collapse. If it has a country code, then it's a different
// number and we should not collapse (this conclusion is based on an
// existing unit test).
try {
util.parse(dataPart2, null);
} catch (NumberParseException e2) {
// Number 2 also does not have a country. Collapse.
break;
}
}
return false;
case SHORT_NSN_MATCH:
return false;
default:
throw new IllegalStateException("Unknown result value from phone number " +
"library");
}
}
return true;
}
/**
* Returns the {@link android.graphics.Rect} with left, top, right, and bottom coordinates
* that are equivalent to the given {@link android.view.View}'s bounds. This is equivalent to
* how the target {@link android.graphics.Rect} is calculated in
* {@link android.provider.ContactsContract.QuickContact#showQuickContact}.
*/
public static Rect getTargetRectFromView(View view) {
final int[] pos = new int[2];
view.getLocationOnScreen(pos);
final Rect rect = new Rect();
rect.left = pos[0];
rect.top = pos[1];
rect.right = pos[0] + view.getWidth();
rect.bottom = pos[1] + view.getHeight();
return rect;
}
/**
* Returns a header view based on the R.layout.list_separator, where the
* containing {@link android.widget.TextView} is set using the given textResourceId.
*/
public static TextView createHeaderView(Context context, int textResourceId) {
final TextView textView = (TextView) View.inflate(context, R.layout.list_separator, null);
textView.setText(context.getString(textResourceId));
return textView;
}
/**
* Set the top padding on the header view dynamically, based on whether the header is in
* the first row or not.
*/
public static void setHeaderViewBottomPadding(Context context, TextView textView,
boolean isFirstRow) {
final int topPadding;
if (isFirstRow) {
topPadding = (int) context.getResources().getDimension(
R.dimen.frequently_contacted_title_top_margin_when_first_row);
} else {
topPadding = (int) context.getResources().getDimension(
R.dimen.frequently_contacted_title_top_margin);
}
textView.setPaddingRelative(textView.getPaddingStart(), topPadding,
textView.getPaddingEnd(), textView.getPaddingBottom());
}
/**
* Returns the intent to launch for the given invitable account type and contact lookup URI.
* This will return null if the account type is not invitable (i.e. there is no
* {@link AccountType#getInviteContactActivityClassName()} or
* {@link AccountType#syncAdapterPackageName}).
*/
public static Intent getInvitableIntent(AccountType accountType, Uri lookupUri) {
String syncAdapterPackageName = accountType.syncAdapterPackageName;
String className = accountType.getInviteContactActivityClassName();
if (TextUtils.isEmpty(syncAdapterPackageName) || TextUtils.isEmpty(className)) {
return null;
}
Intent intent = new Intent();
intent.setClassName(syncAdapterPackageName, className);
intent.setAction(ContactsContract.Intents.INVITE_CONTACT);
// Data is the lookup URI.
intent.setData(lookupUri);
return intent;
}
}