1 /* 2 * Copyright (C) 2012 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 package com.example.android.basiccontactables; 17 18 import android.app.Activity; 19 import android.app.LoaderManager; 20 import android.content.Context; 21 import android.content.CursorLoader; 22 import android.content.Loader; 23 import android.database.Cursor; 24 import android.net.Uri; 25 import android.os.Bundle; 26 import android.provider.ContactsContract.CommonDataKinds; 27 import android.util.Log; 28 import android.widget.TextView; 29 30 /** 31 * Helper class to handle all the callbacks that occur when interacting with loaders. Most of the 32 * interesting code in this sample app will be in this file. 33 */ 34 public class ContactablesLoaderCallbacks implements LoaderManager.LoaderCallbacks<Cursor> { 35 36 Context mContext; 37 38 public static final String QUERY_KEY = "query"; 39 40 public static final String TAG = "ContactablesLoaderCallbacks"; 41 42 public ContactablesLoaderCallbacks(Context context) { 43 mContext = context; 44 } 45 46 @Override 47 public Loader<Cursor> onCreateLoader(int loaderIndex, Bundle args) { 48 // Where the Contactables table excels is matching text queries, 49 // not just data dumps from Contacts db. One search term is used to query 50 // display name, email address and phone number. In this case, the query was extracted 51 // from an incoming intent in the handleIntent() method, via the 52 // intent.getStringExtra() method. 53 54 // BEGIN_INCLUDE(uri_with_query) 55 String query = args.getString(QUERY_KEY); 56 Uri uri = Uri.withAppendedPath( 57 CommonDataKinds.Contactables.CONTENT_FILTER_URI, query); 58 // END_INCLUDE(uri_with_query) 59 60 61 // BEGIN_INCLUDE(cursor_loader) 62 // Easy way to limit the query to contacts with phone numbers. 63 String selection = 64 CommonDataKinds.Contactables.HAS_PHONE_NUMBER + " = " + 1; 65 66 // Sort results such that rows for the same contact stay together. 67 String sortBy = CommonDataKinds.Contactables.LOOKUP_KEY; 68 69 return new CursorLoader( 70 mContext, // Context 71 uri, // URI representing the table/resource to be queried 72 null, // projection - the list of columns to return. Null means "all" 73 selection, // selection - Which rows to return (condition rows must match) 74 null, // selection args - can be provided separately and subbed into selection. 75 sortBy); // string specifying sort order 76 // END_INCLUDE(cursor_loader) 77 } 78 79 @Override 80 public void onLoadFinished(Loader<Cursor> arg0, Cursor cursor) { 81 TextView tv = (TextView) ((Activity)mContext).findViewById(R.id.sample_output); 82 if(tv == null) { 83 Log.e(TAG, "TextView is null?!"); 84 } else if (mContext == null) { 85 Log.e(TAG, "Context is null?"); 86 } else { 87 Log.e(TAG, "Nothing is null?!"); 88 } 89 90 // Reset text in case of a previous query 91 tv.setText(mContext.getText(R.string.intro_message) + "\n\n"); 92 93 if (cursor.getCount() == 0) { 94 return; 95 } 96 97 // Pulling the relevant value from the cursor requires knowing the column index to pull 98 // it from. 99 // BEGIN_INCLUDE(get_columns) 100 int phoneColumnIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER); 101 int emailColumnIndex = cursor.getColumnIndex(CommonDataKinds.Email.ADDRESS); 102 int nameColumnIndex = cursor.getColumnIndex(CommonDataKinds.Contactables.DISPLAY_NAME); 103 int lookupColumnIndex = cursor.getColumnIndex(CommonDataKinds.Contactables.LOOKUP_KEY); 104 int typeColumnIndex = cursor.getColumnIndex(CommonDataKinds.Contactables.MIMETYPE); 105 // END_INCLUDE(get_columns) 106 107 cursor.moveToFirst(); 108 // Lookup key is the easiest way to verify a row of data is for the same 109 // contact as the previous row. 110 String lookupKey = ""; 111 do { 112 // BEGIN_INCLUDE(lookup_key) 113 String currentLookupKey = cursor.getString(lookupColumnIndex); 114 if (!lookupKey.equals(currentLookupKey)) { 115 String displayName = cursor.getString(nameColumnIndex); 116 tv.append(displayName + "\n"); 117 lookupKey = currentLookupKey; 118 } 119 // END_INCLUDE(lookup_key) 120 121 // BEGIN_INCLUDE(retrieve_data) 122 // The data type can be determined using the mime type column. 123 String mimeType = cursor.getString(typeColumnIndex); 124 if (mimeType.equals(CommonDataKinds.Phone.CONTENT_ITEM_TYPE)) { 125 tv.append("\tPhone Number: " + cursor.getString(phoneColumnIndex) + "\n"); 126 } else if (mimeType.equals(CommonDataKinds.Email.CONTENT_ITEM_TYPE)) { 127 tv.append("\tEmail Address: " + cursor.getString(emailColumnIndex) + "\n"); 128 } 129 // END_INCLUDE(retrieve_data) 130 131 // Look at DDMS to see all the columns returned by a query to Contactables. 132 // Behold, the firehose! 133 for(String column : cursor.getColumnNames()) { 134 Log.d(TAG, column + column + ": " + 135 cursor.getString(cursor.getColumnIndex(column)) + "\n"); 136 } 137 } while (cursor.moveToNext()); 138 } 139 140 @Override 141 public void onLoaderReset(Loader<Cursor> cursorLoader) { 142 } 143 } 144
