blob: 64dfaef42cb7311a6f489e5e597d87b0fe8ab5c5 [file] [log] [blame]
Evan Millar45e0ed32009-06-01 16:44:38 -07001/*
2 * Copyright (C) 2009 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 */
16
Evan Millar66388be2009-05-28 15:41:07 -070017package com.android.contacts;
18
Makoto Onuki6f74c0f2011-09-27 13:47:15 -070019import com.android.contacts.model.AccountType;
Isaac Katzenelsona1bbf612011-08-15 16:49:41 -070020import com.android.contacts.model.AccountTypeManager;
21import com.android.contacts.model.AccountWithDataSet;
Hugo Hudsone86b7532011-09-08 17:16:52 +010022import com.android.contacts.test.NeededForTesting;
Shaopeng Jia8cebd7f2011-08-12 13:41:42 +020023import com.android.i18n.phonenumbers.PhoneNumberUtil;
Daisuke Miyakawa0a393872011-03-09 10:17:23 -080024
Evan Millar45e0ed32009-06-01 16:44:38 -070025import android.content.Context;
Jeff Sharkey3f0b7b82009-08-12 11:28:53 -070026import android.content.Intent;
Bai Taoba344222010-07-28 17:50:23 -070027import android.location.CountryDetector;
Katherine Kuan08bcf712011-10-09 13:43:53 -070028import android.net.Uri;
29import android.provider.ContactsContract;
Evan Millar66388be2009-05-28 15:41:07 -070030import android.provider.ContactsContract.CommonDataKinds.Im;
Evan Millar66388be2009-05-28 15:41:07 -070031import android.provider.ContactsContract.CommonDataKinds.Phone;
Makoto Onukic710b0e2009-10-13 15:43:24 -070032import android.telephony.PhoneNumberUtils;
Evan Millar66388be2009-05-28 15:41:07 -070033import android.text.TextUtils;
Katherine Kuanf7689c32011-10-24 11:05:55 -070034import android.view.View;
35import android.widget.TextView;
Neel Parekh2ad90a32009-09-20 19:08:50 -070036
Isaac Katzenelsona1bbf612011-08-15 16:49:41 -070037import java.util.List;
38
Evan Millar66388be2009-05-28 15:41:07 -070039public class ContactsUtils {
Evan Millar11d628c2009-09-02 08:55:01 -070040 private static final String TAG = "ContactsUtils";
Daniel Lehmannd8b0a052010-03-25 17:41:00 -070041 private static final String WAIT_SYMBOL_AS_STRING = String.valueOf(PhoneNumberUtils.WAIT);
Jeff Sharkey39261272009-06-03 19:15:09 -070042
Evan Millar2c1cc832009-07-13 11:08:06 -070043
Jeff Hamilton1bf258e2009-12-15 16:55:49 -060044 // TODO find a proper place for the canonical version of these
45 public interface ProviderNames {
46 String YAHOO = "Yahoo";
47 String GTALK = "GTalk";
48 String MSN = "MSN";
49 String ICQ = "ICQ";
50 String AIM = "AIM";
51 String XMPP = "XMPP";
52 String JABBER = "JABBER";
53 String SKYPE = "SKYPE";
54 String QQ = "QQ";
55 }
56
Evan Millar66388be2009-05-28 15:41:07 -070057 /**
58 * This looks up the provider name defined in
Jeff Hamiltoneffb7ff2009-12-17 16:29:40 -060059 * ProviderNames from the predefined IM protocol id.
Evan Millar66388be2009-05-28 15:41:07 -070060 * This is used for interacting with the IM application.
61 *
62 * @param protocol the protocol ID
63 * @return the provider name the IM app uses for the given protocol, or null if no
64 * provider is defined for the given protocol
65 * @hide
66 */
67 public static String lookupProviderNameFromId(int protocol) {
68 switch (protocol) {
69 case Im.PROTOCOL_GOOGLE_TALK:
70 return ProviderNames.GTALK;
71 case Im.PROTOCOL_AIM:
72 return ProviderNames.AIM;
73 case Im.PROTOCOL_MSN:
74 return ProviderNames.MSN;
75 case Im.PROTOCOL_YAHOO:
76 return ProviderNames.YAHOO;
77 case Im.PROTOCOL_ICQ:
78 return ProviderNames.ICQ;
79 case Im.PROTOCOL_JABBER:
80 return ProviderNames.JABBER;
81 case Im.PROTOCOL_SKYPE:
82 return ProviderNames.SKYPE;
83 case Im.PROTOCOL_QQ:
84 return ProviderNames.QQ;
85 }
86 return null;
87 }
88
Jeff Sharkeye31dac82009-10-08 11:13:47 -070089 /**
90 * Test if the given {@link CharSequence} contains any graphic characters,
91 * first checking {@link TextUtils#isEmpty(CharSequence)} to handle null.
92 */
93 public static boolean isGraphic(CharSequence str) {
94 return !TextUtils.isEmpty(str) && TextUtils.isGraphic(str);
95 }
Makoto Onukic710b0e2009-10-13 15:43:24 -070096
97 /**
98 * Returns true if two objects are considered equal. Two null references are equal here.
99 */
Hugo Hudsone86b7532011-09-08 17:16:52 +0100100 @NeededForTesting
Makoto Onukic710b0e2009-10-13 15:43:24 -0700101 public static boolean areObjectsEqual(Object a, Object b) {
102 return a == b || (a != null && a.equals(b));
103 }
104
105 /**
106 * Returns true if two data with mimetypes which represent values in contact entries are
Daniel Lehmannd8b0a052010-03-25 17:41:00 -0700107 * considered equal for collapsing in the GUI. For caller-id, use
108 * {@link PhoneNumberUtils#compare(Context, String, String)} instead
Makoto Onukic710b0e2009-10-13 15:43:24 -0700109 */
Dave Santoro01a9fac2011-09-15 16:08:29 -0700110 public static final boolean shouldCollapse(CharSequence mimetype1, CharSequence data1,
111 CharSequence mimetype2, CharSequence data2) {
Daniel Lehmanndabe1232011-09-07 11:51:13 -0700112 // different mimetypes? don't collapse
113 if (!TextUtils.equals(mimetype1, mimetype2)) return false;
Daniel Lehmannd8b0a052010-03-25 17:41:00 -0700114
Daniel Lehmanndabe1232011-09-07 11:51:13 -0700115 // exact same string? good, bail out early
116 if (TextUtils.equals(data1, data2)) return true;
Daniel Lehmannd8b0a052010-03-25 17:41:00 -0700117
Daniel Lehmanndabe1232011-09-07 11:51:13 -0700118 // so if either is null, these two must be different
119 if (data1 == null || data2 == null) return false;
120
121 // if this is not about phone numbers, we know this is not a match (of course, some
122 // mimetypes could have more sophisticated matching is the future, e.g. addresses)
123 if (!TextUtils.equals(Phone.CONTENT_ITEM_TYPE, mimetype1)) return false;
124
125 // Now do the full phone number thing. split into parts, seperated by waiting symbol
126 // and compare them individually
127 final String[] dataParts1 = data1.toString().split(WAIT_SYMBOL_AS_STRING);
128 final String[] dataParts2 = data2.toString().split(WAIT_SYMBOL_AS_STRING);
129 if (dataParts1.length != dataParts2.length) return false;
130 final PhoneNumberUtil util = PhoneNumberUtil.getInstance();
131 for (int i = 0; i < dataParts1.length; i++) {
132 final String dataPart1 = dataParts1[i];
133 final String dataPart2 = dataParts2[i];
134
135 // substrings equal? shortcut, don't parse
136 if (TextUtils.equals(dataPart1, dataPart2)) continue;
137
138 // do a full parse of the numbers
139 switch (util.isNumberMatch(dataPart1, dataPart2)) {
140 case NOT_A_NUMBER:
141 // don't understand the numbers? let's play it safe
142 return false;
143 case NO_MATCH:
144 return false;
145 case EXACT_MATCH:
146 case SHORT_NSN_MATCH:
147 case NSN_MATCH:
148 break;
149 default:
150 throw new IllegalStateException("Unknown result value from phone number " +
151 "library");
Makoto Onukic710b0e2009-10-13 15:43:24 -0700152 }
Makoto Onukic710b0e2009-10-13 15:43:24 -0700153 }
Daniel Lehmanndabe1232011-09-07 11:51:13 -0700154 return true;
Makoto Onukic710b0e2009-10-13 15:43:24 -0700155 }
156
157 /**
158 * Returns true if two {@link Intent}s are both null, or have the same action.
159 */
160 public static final boolean areIntentActionEqual(Intent a, Intent b) {
161 if (a == b) {
162 return true;
163 }
164 if (a == null || b == null) {
165 return false;
166 }
167 return TextUtils.equals(a.getAction(), b.getAction());
168 }
Bai Taoba344222010-07-28 17:50:23 -0700169
170 /**
171 * @return The ISO 3166-1 two letters country code of the country the user
172 * is in.
173 */
174 public static final String getCurrentCountryIso(Context context) {
175 CountryDetector detector =
176 (CountryDetector) context.getSystemService(Context.COUNTRY_DETECTOR);
Bai Tao09eb04f2010-09-01 15:34:16 +0800177 return detector.detectCountry().getCountryIso();
Bai Taoba344222010-07-28 17:50:23 -0700178 }
Isaac Katzenelsona1bbf612011-08-15 16:49:41 -0700179
Makoto Onuki6f74c0f2011-09-27 13:47:15 -0700180 public static boolean areContactWritableAccountsAvailable(Context context) {
Isaac Katzenelsona1bbf612011-08-15 16:49:41 -0700181 final List<AccountWithDataSet> accounts =
182 AccountTypeManager.getInstance(context).getAccounts(true /* writeable */);
183 return !accounts.isEmpty();
184 }
185
Makoto Onuki6f74c0f2011-09-27 13:47:15 -0700186 public static boolean areGroupWritableAccountsAvailable(Context context) {
187 final List<AccountWithDataSet> accounts =
188 AccountTypeManager.getInstance(context).getGroupWritableAccounts();
189 return !accounts.isEmpty();
190 }
Katherine Kuan08bcf712011-10-09 13:43:53 -0700191
192 /**
193 * Returns the intent to launch for the given invitable account type and contact lookup URI.
194 * This will return null if the account type is not invitable (i.e. there is no
195 * {@link AccountType#getInviteContactActivityClassName()} or
196 * {@link AccountType#resPackageName}).
197 */
198 public static Intent getInvitableIntent(AccountType accountType, Uri lookupUri) {
199 String resPackageName = accountType.resPackageName;
200 String className = accountType.getInviteContactActivityClassName();
201 if (TextUtils.isEmpty(resPackageName) || TextUtils.isEmpty(className)) {
202 return null;
203 }
204 Intent intent = new Intent();
205 intent.setClassName(resPackageName, className);
206
207 intent.setAction(ContactsContract.Intents.INVITE_CONTACT);
208
209 // Data is the lookup URI.
210 intent.setData(lookupUri);
211 return intent;
212 }
Katherine Kuanf7689c32011-10-24 11:05:55 -0700213
214 /**
215 * Returns a header view based on the R.layout.list_separator, where the
216 * containing {@link TextView} is set using the given textResourceId.
217 */
218 public static View createHeaderView(Context context, int textResourceId) {
219 View view = View.inflate(context, R.layout.list_separator, null);
220 TextView textView = (TextView) view.findViewById(R.id.title);
221 textView.setText(context.getString(textResourceId));
222 return view;
223 }
Evan Millar66388be2009-05-28 15:41:07 -0700224}