From 2fd97117b7a325f256279a9c7ea02b48b1e57632 Mon Sep 17 00:00:00 2001 From: Daisuke Miyakawa Date: Wed, 1 Jun 2011 09:26:34 -0700 Subject: Introduce utility library for sending usage feedback. It allows each app to conveniently send data usage feedback to ContactsProvider, which includes TIMES_CONTACTED/LAST_TIME_CONTACTED existing before ICS and DataUsageFeedback stuff introduced in ICS. This library checks API version and update relevant data appropriately, so each application doesn't need to take care of details of API (and possible API change in ICS) TODO: - need test for this. Must be after I602c0b83afca674904946f59bbdfc4dca07d46e4 Bug: 4371572 Change-Id: Id84ef81392c48d8c59eb89e0407eec0c592f3b31 --- .../common/contacts/DataUsageStatUpdater.java | 263 +++++++++++++++++++++ 1 file changed, 263 insertions(+) create mode 100644 common/java/com/android/common/contacts/DataUsageStatUpdater.java diff --git a/common/java/com/android/common/contacts/DataUsageStatUpdater.java b/common/java/com/android/common/contacts/DataUsageStatUpdater.java new file mode 100644 index 0000000..bc1f8ea --- /dev/null +++ b/common/java/com/android/common/contacts/DataUsageStatUpdater.java @@ -0,0 +1,263 @@ +/* + * 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 com.android.common.contacts; + +import android.content.ContentResolver; +import android.content.ContentValues; +import android.content.Context; +import android.database.Cursor; +import android.net.Uri; +import android.os.Build; +import android.provider.ContactsContract; +import android.provider.ContactsContract.CommonDataKinds.Email; +import android.provider.ContactsContract.CommonDataKinds.Phone; +import android.provider.ContactsContract.Data; +import android.text.TextUtils; +import android.text.util.Rfc822Token; +import android.text.util.Rfc822Tokenizer; +import android.util.Log; +import android.widget.TextView; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collection; +import java.util.HashSet; +import java.util.Set; + +/** + * Convenient class for updating usage statistics in ContactsProvider. + * + * Applications like Email, Sms, etc. can promote recipients for better sorting with this class + * + * @see ContactsContract.Contacts + */ +public class DataUsageStatUpdater { + private static final String TAG = DataUsageStatUpdater.class.getSimpleName(); + + /** + * Copied from API in ICS (not available before it). You can use values here if you are sure + * it is supported by the device. + */ + public static final class DataUsageFeedback { + private static final Uri FEEDBACK_URI = + Uri.withAppendedPath(Data.CONTENT_URI, "usagefeedback"); + + private static final String USAGE_TYPE = "type"; + public static final String USAGE_TYPE_CALL = "call"; + public static final String USAGE_TYPE_LONG_TEXT = "long_text"; + public static final String USAGE_TYPE_SHORT_TEXT = "short_text"; + } + + private final ContentResolver mResolver; + + public DataUsageStatUpdater(Context context) { + mResolver = context.getContentResolver(); + } + + /** + * Updates usage statistics using comma-separated RFC822 address like + * "Joe , Due ". + * + * This will cause Disk access so should be called in a background thread. + * + * @return true when update request is correctly sent. False when the request fails, + * input has no valid entities. + */ + public boolean updateWithRfc822Address(Collection texts){ + if (texts == null) { + return false; + } else { + final Set addresses = new HashSet(); + for (CharSequence text : texts) { + Rfc822Token[] tokens = Rfc822Tokenizer.tokenize(text.toString().trim()); + for (Rfc822Token token : tokens) { + addresses.add(token.getAddress()); + } + } + return updateWithAddress(addresses); + } + } + + /** + * Update usage statistics information using a list of email addresses. + * + * This will cause Disk access so should be called in a background thread. + * + * @see #update(Collection, Collection, String) + * + * @return true when update request is correctly sent. False when the request fails, + * input has no valid entities. + */ + public boolean updateWithAddress(Collection addresses) { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "updateWithAddress: " + Arrays.toString(addresses.toArray())); + } + if (addresses != null && !addresses.isEmpty()) { + final ArrayList whereArgs = new ArrayList(); + final StringBuilder whereBuilder = new StringBuilder(); + final String[] questionMarks = new String[addresses.size()]; + + whereArgs.addAll(addresses); + Arrays.fill(questionMarks, "?"); + // Email.ADDRESS == Email.DATA1. Email.ADDRESS can be available from API Level 11. + whereBuilder.append(Email.DATA1 + " IN (") + .append(TextUtils.join(",", questionMarks)) + .append(")"); + final Cursor cursor = mResolver.query(Email.CONTENT_URI, + new String[] {Email.CONTACT_ID, Email._ID}, whereBuilder.toString(), + whereArgs.toArray(new String[0]), null); + + if (cursor == null) { + Log.w(TAG, "Cursor for Email.CONTENT_URI became null."); + } else { + final Set contactIds = new HashSet(cursor.getCount()); + final Set dataIds = new HashSet(cursor.getCount()); + try { + cursor.move(-1); + while(cursor.moveToNext()) { + contactIds.add(cursor.getLong(0)); + dataIds.add(cursor.getLong(1)); + } + } finally { + cursor.close(); + } + return update(contactIds, dataIds, DataUsageFeedback.USAGE_TYPE_LONG_TEXT); + } + } + + return false; + } + + /** + * Update usage statistics information using a list of phone numbers. + * + * This will cause Disk access so should be called in a background thread. + * + * @see #update(Collection, Collection, String) + * + * @return true when update request is correctly sent. False when the request fails, + * input has no valid entities. + */ + public boolean updateWithPhoneNumber(Collection numbers) { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "updateWithPhoneNumber: " + Arrays.toString(numbers.toArray())); + } + if (numbers != null && !numbers.isEmpty()) { + final ArrayList whereArgs = new ArrayList(); + final StringBuilder whereBuilder = new StringBuilder(); + final String[] questionMarks = new String[numbers.size()]; + + whereArgs.addAll(numbers); + Arrays.fill(questionMarks, "?"); + // Phone.NUMBER == Phone.DATA1. NUMBER can be available from API Level 11. + whereBuilder.append(Phone.DATA1 + " IN (") + .append(TextUtils.join(",", questionMarks)) + .append(")"); + final Cursor cursor = mResolver.query(Phone.CONTENT_URI, + new String[] {Phone.CONTACT_ID, Phone._ID}, whereBuilder.toString(), + whereArgs.toArray(new String[0]), null); + + if (cursor == null) { + Log.w(TAG, "Cursor for Phone.CONTENT_URI became null."); + } else { + final Set contactIds = new HashSet(cursor.getCount()); + final Set dataIds = new HashSet(cursor.getCount()); + try { + cursor.move(-1); + while(cursor.moveToNext()) { + contactIds.add(cursor.getLong(0)); + dataIds.add(cursor.getLong(1)); + } + } finally { + cursor.close(); + } + return update(contactIds, dataIds, DataUsageFeedback.USAGE_TYPE_SHORT_TEXT); + } + } + return false; + } + + /** + * @return true when one or more of update requests are correctly sent. + * False when all the requests fail. + */ + private boolean update(Collection contactIds, Collection dataIds, String type) { + final long currentTimeMillis = System.currentTimeMillis(); + + boolean successful = false; + + // From ICS we can use per-contact-method structure. We'll check if the device supports it + // and call the API. + // + // STOPSHIP: Use 13 or later when we're sure ICS has correct SDK version + if (Build.VERSION.SDK_INT >= 12) { + if (dataIds.isEmpty()) { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "Given list for data IDs is null. Ignoring."); + } + } else { + final Uri uri = DataUsageFeedback.FEEDBACK_URI.buildUpon() + .appendPath(TextUtils.join(",", dataIds)) + .appendQueryParameter(DataUsageFeedback.USAGE_TYPE, type) + .build(); + if (mResolver.update(uri, new ContentValues(), null, null) > 0) { + successful = true; + } else { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "update toward data rows " + dataIds + " failed"); + } + } + } + } else { + // Use older API. + if (contactIds.isEmpty()) { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "Given list for contact IDs is null. Ignoring."); + } + } else { + final StringBuilder whereBuilder = new StringBuilder(); + final ArrayList whereArgs = new ArrayList(); + final String[] questionMarks = new String[contactIds.size()]; + for (long contactId : contactIds) { + whereArgs.add(String.valueOf(contactId)); + } + Arrays.fill(questionMarks, "?"); + whereBuilder.append(ContactsContract.Contacts._ID + " IN ("). + append(TextUtils.join(",", questionMarks)). + append(")"); + + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "contactId where: " + whereBuilder.toString()); + Log.d(TAG, "contactId selection: " + whereArgs); + } + + final ContentValues values = new ContentValues(); + values.put(ContactsContract.Contacts.LAST_TIME_CONTACTED, currentTimeMillis); + if (mResolver.update(ContactsContract.Contacts.CONTENT_URI, values, + whereBuilder.toString(), whereArgs.toArray(new String[0])) > 0) { + successful = true; + } else { + if (Log.isLoggable(TAG, Log.DEBUG)) { + Log.d(TAG, "update toward raw contacts " + contactIds + " failed"); + } + } + } + } + + return successful; + } +} -- cgit v1.2.3