Java tutorial
/* * Copyright (C) 2011 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 cm.confide.ex.chips; import android.accounts.Account; import android.content.ContentResolver; import android.content.Context; import android.database.Cursor; import android.database.MatrixCursor; import android.net.Uri; import android.provider.ContactsContract; import android.support.v4.widget.CursorAdapter; import android.text.TextUtils; import android.text.util.Rfc822Token; import android.text.util.Rfc822Tokenizer; import android.util.Log; import android.view.LayoutInflater; import android.view.View; import android.view.ViewGroup; import android.widget.ImageView; import android.widget.TextView; import java.util.ArrayList; import java.util.HashMap; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.Set; import cm.confide.ex.chips.BaseRecipientAdapter.DirectoryListQuery; import cm.confide.ex.chips.BaseRecipientAdapter.DirectorySearchParams; import cm.confide.ex.chips.Queries.Query; import cm.confide.recipienttextview.app.R; /** * RecipientAlternatesAdapter backs the RecipientEditTextView for managing contacts * queried by email or by phone number. */ public class RecipientAlternatesAdapter extends CursorAdapter { static final int MAX_LOOKUPS = 50; private final LayoutInflater mLayoutInflater; private final long mCurrentId; private int mCheckedItemPosition = -1; private OnCheckedItemChangedListener mCheckedItemChangedListener; private static final String TAG = "RecipAlternates"; public static final int QUERY_TYPE_EMAIL = 0; public static final int QUERY_TYPE_PHONE = 1; private Query mQuery; public interface RecipientMatchCallback { public void matchesFound(Map<String, RecipientEntry> results); /** * Called with all addresses that could not be resolved to valid recipients. */ public void matchesNotFound(Set<String> unfoundAddresses); } public static void getMatchingRecipients(Context context, BaseRecipientAdapter adapter, ArrayList<String> inAddresses, Account account, RecipientMatchCallback callback) { getMatchingRecipients(context, adapter, inAddresses, QUERY_TYPE_EMAIL, account, callback); } /** * Get a HashMap of address to RecipientEntry that contains all contact * information for a contact with the provided address, if one exists. This * may block the UI, so run it in an async task. * * @param context Context. * @param inAddresses Array of addresses on which to perform the lookup. * @param callback RecipientMatchCallback called when a match or matches are found. * @return HashMap<String,RecipientEntry> */ public static void getMatchingRecipients(Context context, BaseRecipientAdapter adapter, ArrayList<String> inAddresses, int addressType, Account account, RecipientMatchCallback callback) { Queries.Query query; if (addressType == QUERY_TYPE_EMAIL) { query = Queries.EMAIL; } else { query = Queries.PHONE; } int addressesSize = Math.min(MAX_LOOKUPS, inAddresses.size()); HashSet<String> addresses = new HashSet<String>(); StringBuilder bindString = new StringBuilder(); // Create the "?" string and set up arguments. for (int i = 0; i < addressesSize; i++) { Rfc822Token[] tokens = Rfc822Tokenizer.tokenize(inAddresses.get(i).toLowerCase()); addresses.add(tokens.length > 0 ? tokens[0].getAddress() : inAddresses.get(i)); bindString.append("?"); if (i < addressesSize - 1) { bindString.append(","); } } if (Log.isLoggable(TAG, Log.DEBUG)) { Log.d(TAG, "Doing reverse lookup for " + addresses.toString()); } String[] addressArray = new String[addresses.size()]; addresses.toArray(addressArray); HashMap<String, RecipientEntry> recipientEntries = null; Cursor c = null; try { c = context.getContentResolver().query(query.getContentUri(), query.getProjection(), query.getProjection()[Queries.Query.DESTINATION] + " IN (" + bindString.toString() + ")", addressArray, null); recipientEntries = processContactEntries(c); callback.matchesFound(recipientEntries); } finally { if (c != null) { c.close(); } } // See if any entries did not resolve; if so, we need to check other // directories final Set<String> matchesNotFound = new HashSet<String>(); if (recipientEntries.size() < addresses.size()) { final List<DirectorySearchParams> paramsList; Cursor directoryCursor = null; try { directoryCursor = context.getContentResolver().query(DirectoryListQuery.URI, DirectoryListQuery.PROJECTION, null, null, null); if (directoryCursor == null) { paramsList = null; } else { paramsList = BaseRecipientAdapter.setupOtherDirectories(context, directoryCursor, account); } } finally { if (directoryCursor != null) { directoryCursor.close(); } } // Run a directory query for each unmatched recipient. HashSet<String> unresolvedAddresses = new HashSet<String>(); for (String address : addresses) { if (!recipientEntries.containsKey(address)) { unresolvedAddresses.add(address); } } matchesNotFound.addAll(unresolvedAddresses); if (paramsList != null) { Cursor directoryContactsCursor = null; for (String unresolvedAddress : unresolvedAddresses) { for (int i = 0; i < paramsList.size(); i++) { try { directoryContactsCursor = doQuery(unresolvedAddress, 1, paramsList.get(i).directoryId, account, context.getContentResolver(), query); } finally { if (directoryContactsCursor != null && directoryContactsCursor.getCount() == 0) { directoryContactsCursor.close(); directoryContactsCursor = null; } else { break; } } } if (directoryContactsCursor != null) { try { final Map<String, RecipientEntry> entries = processContactEntries( directoryContactsCursor); for (final String address : entries.keySet()) { matchesNotFound.remove(address); } callback.matchesFound(entries); } finally { directoryContactsCursor.close(); } } } } } // If no matches found in contact provider or the directories, try the extension // matcher. // todo (aalbert): This whole method needs to be in the adapter? if (adapter != null) { final Map<String, RecipientEntry> entries = adapter.getMatchingRecipients(matchesNotFound); if (entries != null && entries.size() > 0) { callback.matchesFound(entries); for (final String address : entries.keySet()) { matchesNotFound.remove(address); } } } callback.matchesNotFound(matchesNotFound); } private static HashMap<String, RecipientEntry> processContactEntries(Cursor c) { HashMap<String, RecipientEntry> recipientEntries = new HashMap<String, RecipientEntry>(); if (c != null && c.moveToFirst()) { do { String address = c.getString(Queries.Query.DESTINATION); final RecipientEntry newRecipientEntry = RecipientEntry.constructTopLevelEntry( c.getString(Queries.Query.NAME), c.getInt(Queries.Query.DISPLAY_NAME_SOURCE), c.getString(Queries.Query.DESTINATION), c.getInt(Queries.Query.DESTINATION_TYPE), c.getString(Queries.Query.DESTINATION_LABEL), c.getLong(Queries.Query.CONTACT_ID), c.getLong(Queries.Query.DATA_ID), c.getString(Queries.Query.PHOTO_THUMBNAIL_URI), true, false /* isGalContact TODO(skennedy) We should look these up eventually */); /* * In certain situations, we may have two results for one address, where one of the * results is just the email address, and the other has a name and photo, so we want * to use the better one. */ final RecipientEntry recipientEntry = getBetterRecipient(recipientEntries.get(address), newRecipientEntry); recipientEntries.put(address, recipientEntry); if (Log.isLoggable(TAG, Log.DEBUG)) { Log.d(TAG, "Received reverse look up information for " + address + " RESULTS: " + " NAME : " + c.getString(Queries.Query.NAME) + " CONTACT ID : " + c.getLong(Queries.Query.CONTACT_ID) + " ADDRESS :" + c.getString(Queries.Query.DESTINATION)); } } while (c.moveToNext()); } return recipientEntries; } /** * Given two {@link RecipientEntry}s for the same email address, this will return the one that * contains more complete information for display purposes. Defaults to <code>entry2</code> if * no significant differences are found. */ static RecipientEntry getBetterRecipient(final RecipientEntry entry1, final RecipientEntry entry2) { // If only one has passed in, use it if (entry2 == null) { return entry1; } if (entry1 == null) { return entry2; } // If only one has a display name, use it if (!TextUtils.isEmpty(entry1.getDisplayName()) && TextUtils.isEmpty(entry2.getDisplayName())) { return entry1; } if (!TextUtils.isEmpty(entry2.getDisplayName()) && TextUtils.isEmpty(entry1.getDisplayName())) { return entry2; } // If only one has a display name that is not the same as the destination, use it if (!TextUtils.equals(entry1.getDisplayName(), entry1.getDestination()) && TextUtils.equals(entry2.getDisplayName(), entry2.getDestination())) { return entry1; } if (!TextUtils.equals(entry2.getDisplayName(), entry2.getDestination()) && TextUtils.equals(entry1.getDisplayName(), entry1.getDestination())) { return entry2; } // If only one has a photo, use it if ((entry1.getPhotoThumbnailUri() != null || entry1.getPhotoBytes() != null) && (entry2.getPhotoThumbnailUri() == null && entry2.getPhotoBytes() == null)) { return entry1; } if ((entry2.getPhotoThumbnailUri() != null || entry2.getPhotoBytes() != null) && (entry1.getPhotoThumbnailUri() == null && entry1.getPhotoBytes() == null)) { return entry2; } // Go with the second option as a default return entry2; } private static Cursor doQuery(CharSequence constraint, int limit, Long directoryId, Account account, ContentResolver resolver, Query query) { final Uri.Builder builder = query.getContentFilterUri().buildUpon().appendPath(constraint.toString()) .appendQueryParameter(ContactsContract.LIMIT_PARAM_KEY, String.valueOf(limit + BaseRecipientAdapter.ALLOWANCE_FOR_DUPLICATES)); if (directoryId != null) { builder.appendQueryParameter(ContactsContract.DIRECTORY_PARAM_KEY, String.valueOf(directoryId)); } if (account != null) { builder.appendQueryParameter(BaseRecipientAdapter.PRIMARY_ACCOUNT_NAME, account.name); builder.appendQueryParameter(BaseRecipientAdapter.PRIMARY_ACCOUNT_TYPE, account.type); } final Cursor cursor = resolver.query(builder.build(), query.getProjection(), null, null, null); return cursor; } public RecipientAlternatesAdapter(Context context, long contactId, long currentId, OnCheckedItemChangedListener listener) { this(context, contactId, currentId, QUERY_TYPE_EMAIL, listener); } public RecipientAlternatesAdapter(Context context, long contactId, long currentId, int queryMode, OnCheckedItemChangedListener listener) { super(context, getCursorForConstruction(context, contactId, queryMode), 0); mLayoutInflater = LayoutInflater.from(context); mCurrentId = currentId; mCheckedItemChangedListener = listener; if (queryMode == QUERY_TYPE_EMAIL) { mQuery = Queries.EMAIL; } else if (queryMode == QUERY_TYPE_PHONE) { mQuery = Queries.PHONE; } else { mQuery = Queries.EMAIL; Log.e(TAG, "Unsupported query type: " + queryMode); } } private static Cursor getCursorForConstruction(Context context, long contactId, int queryType) { final Cursor cursor; if (queryType == QUERY_TYPE_EMAIL) { cursor = context.getContentResolver().query(Queries.EMAIL.getContentUri(), Queries.EMAIL.getProjection(), Queries.EMAIL.getProjection()[Queries.Query.CONTACT_ID] + " =?", new String[] { String.valueOf(contactId) }, null); } else { cursor = context.getContentResolver().query(Queries.PHONE.getContentUri(), Queries.PHONE.getProjection(), Queries.PHONE.getProjection()[Queries.Query.CONTACT_ID] + " =?", new String[] { String.valueOf(contactId) }, null); } return removeDuplicateDestinations(cursor); } /** * @return a new cursor based on the given cursor with all duplicate destinations removed. * * It's only intended to use for the alternate list, so... * - This method ignores all other fields and dedupe solely on the destination. Normally, * if a cursor contains multiple contacts and they have the same destination, we'd still want * to show both. * - This method creates a MatrixCursor, so all data will be kept in memory. We wouldn't want * to do this if the original cursor is large, but it's okay here because the alternate list * won't be that big. */ // Visible for testing /* package */ static Cursor removeDuplicateDestinations(Cursor original) { final MatrixCursor result = new MatrixCursor(original.getColumnNames(), original.getCount()); final HashSet<String> destinationsSeen = new HashSet<String>(); original.moveToPosition(-1); while (original.moveToNext()) { final String destination = original.getString(Query.DESTINATION); if (destinationsSeen.contains(destination)) { continue; } destinationsSeen.add(destination); result.addRow(new Object[] { original.getString(Query.NAME), original.getString(Query.DESTINATION), original.getInt(Query.DESTINATION_TYPE), original.getString(Query.DESTINATION_LABEL), original.getLong(Query.CONTACT_ID), original.getLong(Query.DATA_ID), original.getString(Query.PHOTO_THUMBNAIL_URI), original.getInt(Query.DISPLAY_NAME_SOURCE) }); } return result; } @Override public long getItemId(int position) { Cursor c = getCursor(); if (c.moveToPosition(position)) { c.getLong(Queries.Query.DATA_ID); } return -1; } public RecipientEntry getRecipientEntry(int position) { Cursor c = getCursor(); c.moveToPosition(position); return RecipientEntry.constructTopLevelEntry(c.getString(Queries.Query.NAME), c.getInt(Queries.Query.DISPLAY_NAME_SOURCE), c.getString(Queries.Query.DESTINATION), c.getInt(Queries.Query.DESTINATION_TYPE), c.getString(Queries.Query.DESTINATION_LABEL), c.getLong(Queries.Query.CONTACT_ID), c.getLong(Queries.Query.DATA_ID), c.getString(Queries.Query.PHOTO_THUMBNAIL_URI), true, false /* isGalContact TODO(skennedy) We should look these up eventually */); } @Override public View getView(int position, View convertView, ViewGroup parent) { Cursor cursor = getCursor(); cursor.moveToPosition(position); if (convertView == null) { convertView = newView(parent); } if (cursor.getLong(Queries.Query.DATA_ID) == mCurrentId) { mCheckedItemPosition = position; if (mCheckedItemChangedListener != null) { mCheckedItemChangedListener.onCheckedItemChanged(mCheckedItemPosition); } } bindView(convertView, convertView.getContext(), cursor); return convertView; } // TODO: this is VERY similar to the BaseRecipientAdapter. Can we combine // somehow? @Override public void bindView(View view, Context context, Cursor cursor) { int position = cursor.getPosition(); TextView display = (TextView) view.findViewById(android.R.id.title); ImageView imageView = (ImageView) view.findViewById(android.R.id.icon); RecipientEntry entry = getRecipientEntry(position); if (position == 0) { display.setText(cursor.getString(Queries.Query.NAME)); display.setVisibility(View.VISIBLE); // TODO: see if this needs to be done outside the main thread // as it may be too slow to get immediately. imageView.setImageURI(entry.getPhotoThumbnailUri()); imageView.setVisibility(View.VISIBLE); } else { display.setVisibility(View.GONE); imageView.setVisibility(View.GONE); } TextView destination = (TextView) view.findViewById(android.R.id.text1); destination.setText(cursor.getString(Queries.Query.DESTINATION)); TextView destinationType = (TextView) view.findViewById(android.R.id.text2); if (destinationType != null) { destinationType.setText( mQuery.getTypeLabel(context.getResources(), cursor.getInt(Queries.Query.DESTINATION_TYPE), cursor.getString(Queries.Query.DESTINATION_LABEL)).toString().toUpperCase()); } } @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { return newView(parent); } private View newView(ViewGroup parent) { return mLayoutInflater.inflate(R.layout.chips_recipient_dropdown_item, parent, false); } /*package*/ static interface OnCheckedItemChangedListener { public void onCheckedItemChanged(int position); } }