1 /* 2 * Copyright (C) 2010 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 17 package com.example.android.apis.app; 18 19 import android.app.Activity; 20 import android.app.FragmentManager; 21 import android.app.ListFragment; 22 import android.app.LoaderManager; 23 import android.content.Context; 24 import android.content.CursorLoader; 25 import android.content.Loader; 26 import android.database.Cursor; 27 import android.net.Uri; 28 import android.os.Bundle; 29 import android.provider.ContactsContract.Contacts; 30 import android.text.TextUtils; 31 import android.util.Log; 32 import android.view.Menu; 33 import android.view.MenuInflater; 34 import android.view.MenuItem; 35 import android.view.View; 36 import android.widget.ListView; 37 import android.widget.SearchView; 38 import android.widget.SearchView.OnCloseListener; 39 import android.widget.SimpleCursorAdapter; 40 import android.widget.SearchView.OnQueryTextListener; 41 42 /** 43 * Demonstration of the use of a CursorLoader to load and display contacts 44 * data in a fragment. 45 */ 46 public class LoaderCursor extends Activity { 47 48 @Override onCreate(Bundle savedInstanceState)49 protected void onCreate(Bundle savedInstanceState) { 50 super.onCreate(savedInstanceState); 51 52 FragmentManager fm = getFragmentManager(); 53 54 // Create the list fragment and add it as our sole content. 55 if (fm.findFragmentById(android.R.id.content) == null) { 56 CursorLoaderListFragment list = new CursorLoaderListFragment(); 57 fm.beginTransaction().add(android.R.id.content, list).commit(); 58 } 59 } 60 61 //BEGIN_INCLUDE(fragment_cursor) 62 public static class CursorLoaderListFragment extends ListFragment 63 implements OnQueryTextListener, OnCloseListener, 64 LoaderManager.LoaderCallbacks<Cursor> { 65 66 // This is the Adapter being used to display the list's data. 67 SimpleCursorAdapter mAdapter; 68 69 // The SearchView for doing filtering. 70 SearchView mSearchView; 71 72 // If non-null, this is the current filter the user has provided. 73 String mCurFilter; 74 onActivityCreated(Bundle savedInstanceState)75 @Override public void onActivityCreated(Bundle savedInstanceState) { 76 super.onActivityCreated(savedInstanceState); 77 78 // Give some text to display if there is no data. In a real 79 // application this would come from a resource. 80 setEmptyText("No phone numbers"); 81 82 // We have a menu item to show in action bar. 83 setHasOptionsMenu(true); 84 85 // Create an empty adapter we will use to display the loaded data. 86 mAdapter = new SimpleCursorAdapter(getActivity(), 87 android.R.layout.simple_list_item_2, null, 88 new String[] { Contacts.DISPLAY_NAME, Contacts.CONTACT_STATUS }, 89 new int[] { android.R.id.text1, android.R.id.text2 }, 0); 90 setListAdapter(mAdapter); 91 92 // Start out with a progress indicator. 93 setListShown(false); 94 95 // Prepare the loader. Either re-connect with an existing one, 96 // or start a new one. 97 getLoaderManager().initLoader(0, null, this); 98 } 99 100 public static class MySearchView extends SearchView { MySearchView(Context context)101 public MySearchView(Context context) { 102 super(context); 103 } 104 105 // The normal SearchView doesn't clear its search text when 106 // collapsed, so we will do this for it. 107 @Override onActionViewCollapsed()108 public void onActionViewCollapsed() { 109 setQuery("", false); 110 super.onActionViewCollapsed(); 111 } 112 } 113 onCreateOptionsMenu(Menu menu, MenuInflater inflater)114 @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { 115 // Place an action bar item for searching. 116 MenuItem item = menu.add("Search"); 117 item.setIcon(android.R.drawable.ic_menu_search); 118 item.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM 119 | MenuItem.SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW); 120 mSearchView = new MySearchView(getActivity()); 121 mSearchView.setOnQueryTextListener(this); 122 mSearchView.setOnCloseListener(this); 123 mSearchView.setIconifiedByDefault(true); 124 item.setActionView(mSearchView); 125 } 126 onQueryTextChange(String newText)127 public boolean onQueryTextChange(String newText) { 128 // Called when the action bar search text has changed. Update 129 // the search filter, and restart the loader to do a new query 130 // with this filter. 131 String newFilter = !TextUtils.isEmpty(newText) ? newText : null; 132 // Don't do anything if the filter hasn't actually changed. 133 // Prevents restarting the loader when restoring state. 134 if (mCurFilter == null && newFilter == null) { 135 return true; 136 } 137 if (mCurFilter != null && mCurFilter.equals(newFilter)) { 138 return true; 139 } 140 mCurFilter = newFilter; 141 getLoaderManager().restartLoader(0, null, this); 142 return true; 143 } 144 onQueryTextSubmit(String query)145 @Override public boolean onQueryTextSubmit(String query) { 146 // Don't care about this. 147 return true; 148 } 149 150 @Override onClose()151 public boolean onClose() { 152 if (!TextUtils.isEmpty(mSearchView.getQuery())) { 153 mSearchView.setQuery(null, true); 154 } 155 return true; 156 } 157 onListItemClick(ListView l, View v, int position, long id)158 @Override public void onListItemClick(ListView l, View v, int position, long id) { 159 // Insert desired behavior here. 160 Log.i("FragmentComplexList", "Item clicked: " + id); 161 } 162 163 // These are the Contacts rows that we will retrieve. 164 static final String[] CONTACTS_SUMMARY_PROJECTION = new String[] { 165 Contacts._ID, 166 Contacts.DISPLAY_NAME, 167 Contacts.CONTACT_STATUS, 168 Contacts.CONTACT_PRESENCE, 169 Contacts.PHOTO_ID, 170 Contacts.LOOKUP_KEY, 171 }; 172 onCreateLoader(int id, Bundle args)173 public Loader<Cursor> onCreateLoader(int id, Bundle args) { 174 // This is called when a new Loader needs to be created. This 175 // sample only has one Loader, so we don't care about the ID. 176 // First, pick the base URI to use depending on whether we are 177 // currently filtering. 178 Uri baseUri; 179 if (mCurFilter != null) { 180 baseUri = Uri.withAppendedPath(Contacts.CONTENT_FILTER_URI, 181 Uri.encode(mCurFilter)); 182 } else { 183 baseUri = Contacts.CONTENT_URI; 184 } 185 186 // Now create and return a CursorLoader that will take care of 187 // creating a Cursor for the data being displayed. 188 String select = "((" + Contacts.DISPLAY_NAME + " NOTNULL) AND (" 189 + Contacts.HAS_PHONE_NUMBER + "=1) AND (" 190 + Contacts.DISPLAY_NAME + " != '' ))"; 191 return new CursorLoader(getActivity(), baseUri, 192 CONTACTS_SUMMARY_PROJECTION, select, null, 193 Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC"); 194 } 195 onLoadFinished(Loader<Cursor> loader, Cursor data)196 public void onLoadFinished(Loader<Cursor> loader, Cursor data) { 197 // Swap the new cursor in. (The framework will take care of closing the 198 // old cursor once we return.) 199 mAdapter.swapCursor(data); 200 201 // The list should now be shown. 202 if (isResumed()) { 203 setListShown(true); 204 } else { 205 setListShownNoAnimation(true); 206 } 207 } 208 onLoaderReset(Loader<Cursor> loader)209 public void onLoaderReset(Loader<Cursor> loader) { 210 // This is called when the last Cursor provided to onLoadFinished() 211 // above is about to be closed. We need to make sure we are no 212 // longer using it. 213 mAdapter.swapCursor(null); 214 } 215 } 216 //END_INCLUDE(fragment_cursor) 217 } 218