1/*
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
17package com.android.contacts;
18
19import android.content.Context;
20import android.content.Intent;
21import android.database.Cursor;
22import android.provider.ContactsContract.CommonDataKinds.Im;
23import android.provider.ContactsContract.DisplayPhoto;
24import android.telephony.PhoneNumberUtils;
25import android.text.TextUtils;
26
27import com.android.contacts.common.model.account.AccountWithDataSet;
28import com.android.contacts.common.test.NeededForTesting;
29import com.android.contacts.common.model.AccountTypeManager;
30
31import java.util.List;
32
33public class ContactsUtils {
34    private static final String TAG = "ContactsUtils";
35
36    private static int sThumbnailSize = -1;
37
38    // TODO find a proper place for the canonical version of these
39    public interface ProviderNames {
40        String YAHOO = "Yahoo";
41        String GTALK = "GTalk";
42        String MSN = "MSN";
43        String ICQ = "ICQ";
44        String AIM = "AIM";
45        String XMPP = "XMPP";
46        String JABBER = "JABBER";
47        String SKYPE = "SKYPE";
48        String QQ = "QQ";
49    }
50
51    /**
52     * This looks up the provider name defined in
53     * ProviderNames from the predefined IM protocol id.
54     * This is used for interacting with the IM application.
55     *
56     * @param protocol the protocol ID
57     * @return the provider name the IM app uses for the given protocol, or null if no
58     * provider is defined for the given protocol
59     * @hide
60     */
61    public static String lookupProviderNameFromId(int protocol) {
62        switch (protocol) {
63            case Im.PROTOCOL_GOOGLE_TALK:
64                return ProviderNames.GTALK;
65            case Im.PROTOCOL_AIM:
66                return ProviderNames.AIM;
67            case Im.PROTOCOL_MSN:
68                return ProviderNames.MSN;
69            case Im.PROTOCOL_YAHOO:
70                return ProviderNames.YAHOO;
71            case Im.PROTOCOL_ICQ:
72                return ProviderNames.ICQ;
73            case Im.PROTOCOL_JABBER:
74                return ProviderNames.JABBER;
75            case Im.PROTOCOL_SKYPE:
76                return ProviderNames.SKYPE;
77            case Im.PROTOCOL_QQ:
78                return ProviderNames.QQ;
79        }
80        return null;
81    }
82
83    /**
84     * Test if the given {@link CharSequence} contains any graphic characters,
85     * first checking {@link TextUtils#isEmpty(CharSequence)} to handle null.
86     */
87    public static boolean isGraphic(CharSequence str) {
88        return !TextUtils.isEmpty(str) && TextUtils.isGraphic(str);
89    }
90
91    /**
92     * Returns true if two objects are considered equal.  Two null references are equal here.
93     */
94    @NeededForTesting
95    public static boolean areObjectsEqual(Object a, Object b) {
96        return a == b || (a != null && a.equals(b));
97    }
98
99    /**
100     * Returns true if two {@link Intent}s are both null, or have the same action.
101     */
102    public static final boolean areIntentActionEqual(Intent a, Intent b) {
103        if (a == b) {
104            return true;
105        }
106        if (a == null || b == null) {
107            return false;
108        }
109        return TextUtils.equals(a.getAction(), b.getAction());
110    }
111
112    public static boolean areContactWritableAccountsAvailable(Context context) {
113        final List<AccountWithDataSet> accounts =
114                AccountTypeManager.getInstance(context).getAccounts(true /* writeable */);
115        return !accounts.isEmpty();
116    }
117
118    public static boolean areGroupWritableAccountsAvailable(Context context) {
119        final List<AccountWithDataSet> accounts =
120                AccountTypeManager.getInstance(context).getGroupWritableAccounts();
121        return !accounts.isEmpty();
122    }
123
124    /**
125     * Returns the size (width and height) of thumbnail pictures as configured in the provider. This
126     * can safely be called from the UI thread, as the provider can serve this without performing
127     * a database access
128     */
129    public static int getThumbnailSize(Context context) {
130        if (sThumbnailSize == -1) {
131            final Cursor c = context.getContentResolver().query(
132                    DisplayPhoto.CONTENT_MAX_DIMENSIONS_URI,
133                    new String[] { DisplayPhoto.THUMBNAIL_MAX_DIM }, null, null, null);
134            try {
135                c.moveToFirst();
136                sThumbnailSize = c.getInt(0);
137            } finally {
138                c.close();
139            }
140        }
141        return sThumbnailSize;
142    }
143
144}
145