core/java/android/app/SuggestionsAdapter.java - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2009 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 android.app;

 import android.content.ContentResolver;
 import android.content.Context;
 import android.content.res.Resources.NotFoundException;
 import android.database.Cursor;
 import android.graphics.drawable.Drawable;
 import android.net.Uri;
 import android.os.Bundle;
 import android.server.search.SearchableInfo;
 import android.text.Html;
 import android.text.TextUtils;
 import android.util.Log;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.ImageView;
 import android.widget.ResourceCursorAdapter;
 import android.widget.TextView;

 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InputStream;
 import java.util.WeakHashMap;

 /**
  * Provides the contents for the suggestion drop-down list.in {@link SearchDialog}.
  *
  * @hide
  */
 class SuggestionsAdapter extends ResourceCursorAdapter {
     // The value used to query a cursor whether it is still expecting more input,
     // so we can correctly display (or not display) the 'working' spinner in the search dialog.
     public static final String IS_WORKING = "isWorking";

     // The value used to tell a cursor to display the corpus selectors, if this is global
     // search. Also returns the index of the more results item to allow the SearchDialog
     // to tell the ListView to scroll to that list item.
     public static final String SHOW_CORPUS_SELECTORS = "showCorpusSelectors";

     private static final boolean DBG = false;
     private static final String LOG_TAG = "SuggestionsAdapter";

     private SearchDialog mSearchDialog;
     private SearchableInfo mSearchable;
     private Context mProviderContext;
     private WeakHashMap<String, Drawable> mOutsideDrawablesCache;
     private boolean mGlobalSearchMode;

     // Cached column indexes, updated when the cursor changes.
     private int mFormatCol;
     private int mText1Col;
     private int mText2Col;
     private int mIconName1Col;
     private int mIconName2Col;

     // This value is stored in SuggestionsAdapter by the SearchDialog to indicate whether
     // a particular list item should be selected upon the next call to notifyDataSetChanged.
     // This is used to indicate the index of the "More results..." list item so that when
     // the data set changes after a click of "More results...", we can correctly tell the
     // ListView to scroll to the right line item. It gets reset to NO_ITEM_TO_SELECT every time it
     // is consumed.
     private int mListItemToSelect = NO_ITEM_TO_SELECT;
     static final int NO_ITEM_TO_SELECT = -1;

     public SuggestionsAdapter(Context context, SearchDialog searchDialog, SearchableInfo searchable,
             WeakHashMap<String, Drawable> outsideDrawablesCache, boolean globalSearchMode) {
         super(context,
                 com.android.internal.R.layout.search_dropdown_item_icons_2line,
                 null,   // no initial cursor
                 true);  // auto-requery
         mSearchDialog = searchDialog;
         mSearchable = searchable;

         // set up provider resources (gives us icons, etc.)
         Context activityContext = mSearchable.getActivityContext(mContext);
         mProviderContext = mSearchable.getProviderContext(mContext, activityContext);

         mOutsideDrawablesCache = outsideDrawablesCache;
         mGlobalSearchMode = globalSearchMode;
     }

     /**
      * Overridden to always return <code>false</code>, since we cannot be sure that
      * suggestion sources return stable IDs.
      */
     @Override
     public boolean hasStableIds() {
         return false;
     }

     /**
      * Use the search suggestions provider to obtain a live cursor.  This will be called
      * in a worker thread, so it's OK if the query is slow (e.g. round trip for suggestions).
      * The results will be processed in the UI thread and changeCursor() will be called.
      */
     @Override
     public Cursor runQueryOnBackgroundThread(CharSequence constraint) {
         if (DBG) Log.d(LOG_TAG, "runQueryOnBackgroundThread(" + constraint + ")");
         String query = (constraint == null) ? "" : constraint.toString();
         try {
             return SearchManager.getSuggestions(mContext, mSearchable, query);
         } catch (RuntimeException e) {
             Log.w(LOG_TAG, "Search suggestions query threw an exception.", e);
             return null;
         }
     }

     /**
      * Cache columns.
      */
     @Override
     public void changeCursor(Cursor c) {
         if (DBG) Log.d(LOG_TAG, "changeCursor(" + c + ")");
         super.changeCursor(c);
         if (c != null) {
             mFormatCol = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_FORMAT);
             mText1Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_TEXT_1);
             mText2Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_TEXT_2);
             mIconName1Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_ICON_1);
             mIconName2Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_ICON_2);
         }
         updateWorking();
     }

     @Override
     public void notifyDataSetChanged() {
         super.notifyDataSetChanged();
         updateWorking();
         if (mListItemToSelect != NO_ITEM_TO_SELECT) {
             mSearchDialog.setListSelection(mListItemToSelect);
             mListItemToSelect = NO_ITEM_TO_SELECT;
         }
     }

     /**
      * Specifies the list item to select upon next call of {@link #notifyDataSetChanged()},
      * in order to let us scroll the "More results..." list item to the top of the screen
      * (or as close as it can get) when clicked.
      */
     public void setListItemToSelect(int index) {
         mListItemToSelect = index;
     }

     /**
      * Updates the search dialog according to the current working status of the cursor.
      */
     private void updateWorking() {
         if (!mGlobalSearchMode || mCursor == null) return;

         Bundle request = new Bundle();
         request.putString(SearchManager.RESPOND_EXTRA_PENDING_SOURCES, "DUMMY");
         Bundle response = mCursor.respond(request);

         mSearchDialog.setWorking(response.getBoolean(SearchManager.RESPOND_EXTRA_PENDING_SOURCES));
     }

     /**
      * Tags the view with cached child view look-ups.
      */
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
         View v = super.newView(context, cursor, parent);
         v.setTag(new ChildViewCache(v));
         return v;
     }

     /**
      * Cache of the child views of drop-drown list items, to avoid looking up the children
      * each time the contents of a list item are changed.
      */
     private final static class ChildViewCache {
         public final TextView mText1;
         public final TextView mText2;
         public final ImageView mIcon1;
         public final ImageView mIcon2;

         public ChildViewCache(View v) {
             mText1 = (TextView) v.findViewById(com.android.internal.R.id.text1);
             mText2 = (TextView) v.findViewById(com.android.internal.R.id.text2);
             mIcon1 = (ImageView) v.findViewById(com.android.internal.R.id.icon1);
             mIcon2 = (ImageView) v.findViewById(com.android.internal.R.id.icon2);
         }
     }

     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         ChildViewCache views = (ChildViewCache) view.getTag();
         boolean isHtml = false;
         if (mFormatCol >= 0) {
             String format = cursor.getString(mFormatCol);
             isHtml = "html".equals(format);
         }
         setViewText(cursor, views.mText1, mText1Col, isHtml);
         setViewText(cursor, views.mText2, mText2Col, isHtml);
         setViewIcon(cursor, views.mIcon1, mIconName1Col);
         setViewIcon(cursor, views.mIcon2, mIconName2Col);
     }

     private void setViewText(Cursor cursor, TextView v, int textCol, boolean isHtml) {
         if (v == null) {
             return;
         }
         CharSequence text = null;
         if (textCol >= 0) {
             String str = cursor.getString(textCol);
             text = (str != null && isHtml) ? Html.fromHtml(str) : str;
         }
         // Set the text even if it's null, since we need to clear any previous text.
         v.setText(text);

         if (TextUtils.isEmpty(text)) {
             v.setVisibility(View.GONE);
         } else {
             v.setVisibility(View.VISIBLE);
         }
     }

     private void setViewIcon(Cursor cursor, ImageView v, int iconNameCol) {
         if (v == null) {
             return;
         }
         if (iconNameCol < 0) {
             return;
         }
         String value = cursor.getString(iconNameCol);
         Drawable drawable = getDrawableFromResourceValue(value);
         // Set the icon even if the drawable is null, since we need to clear any
         // previous icon.
         v.setImageDrawable(drawable);

         if (drawable == null) {
             v.setVisibility(View.GONE);
         } else {
             v.setVisibility(View.VISIBLE);

             // This is a hack to get any animated drawables (like a 'working' spinner)
             // to animate. You have to setVisible true on an AnimationDrawable to get
             // it to start animating, but it must first have been false or else the
             // call to setVisible will be ineffective. We need to clear up the story
             // about animated drawables in the future, see http://b/1878430.
             drawable.setVisible(false, false);
             drawable.setVisible(true, false);
         }
     }

     /**
      * Gets the text to show in the query field when a suggestion is selected.
      *
      * @param cursor The Cursor to read the suggestion data from. The Cursor should already
      *        be moved to the suggestion that is to be read from.
      * @return The text to show, or <code>null</code> if the query should not be
      *         changed when selecting this suggestion.
      */
     @Override
     public CharSequence convertToString(Cursor cursor) {
         if (cursor == null) {
             return null;
         }

         String query = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_QUERY);
         if (query != null) {
             return query;
         }

         if (mSearchable.shouldRewriteQueryFromData()) {
             String data = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_INTENT_DATA);
             if (data != null) {
                 return data;
             }
         }

         if (mSearchable.shouldRewriteQueryFromText()) {
             String text1 = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_TEXT_1);
             if (text1 != null) {
                 return text1;
             }
         }

         return null;
     }

     /**
      * This method is overridden purely to provide a bit of protection against
      * flaky content providers.
      *
      * @see android.widget.ListAdapter#getView(int, View, ViewGroup)
      */
     @Override
     public View getView(int position, View convertView, ViewGroup parent) {
         try {
             return super.getView(position, convertView, parent);
         } catch (RuntimeException e) {
             Log.w(LOG_TAG, "Search suggestions cursor threw exception.", e);
             // Put exception string in item title
             View v = newView(mContext, mCursor, parent);
             if (v != null) {
                 ChildViewCache views = (ChildViewCache) v.getTag();
                 TextView tv = views.mText1;
                 tv.setText(e.toString());
             }
             return v;
         }
     }

     /**
      * Gets a drawable given a value provided by a suggestion provider.
      *
      * This value could be just the string value of a resource id
      * (e.g., "2130837524"), in which case we will try to retrieve a drawable from
      * the provider's resources. If the value is not an integer, it is
      * treated as a Uri and opened with
      * {@link ContentResolver#openOutputStream(android.net.Uri, String)}.
      *
      * All resources and URIs are read using the suggestion provider's context.
      *
      * If the string is not formatted as expected, or no drawable can be found for
      * the provided value, this method returns null.
      *
      * @param drawableId a string like "2130837524",
      *        "android.resource://com.android.alarmclock/2130837524",
      *        or "content://contacts/photos/253".
      * @return a Drawable, or null if none found
      */
     private Drawable getDrawableFromResourceValue(String drawableId) {
         if (drawableId == null || drawableId.length() == 0 || "0".equals(drawableId)) {
             return null;
         }

         // First, check the cache.
         Drawable drawable = mOutsideDrawablesCache.get(drawableId);
         if (drawable != null) {
             if (DBG) Log.d(LOG_TAG, "Found icon in cache: " + drawableId);
             return drawable;
         }

         try {
             // Not cached, try using it as a plain resource ID in the provider's context.
             int resourceId = Integer.parseInt(drawableId);
             drawable = mProviderContext.getResources().getDrawable(resourceId);
             if (DBG) Log.d(LOG_TAG, "Found icon by resource ID: " + drawableId);
         } catch (NumberFormatException nfe) {
             // The id was not an integer resource id.
             // Let the ContentResolver handle content, android.resource and file URIs.
             try {
                 Uri uri = Uri.parse(drawableId);
                 InputStream stream = mProviderContext.getContentResolver().openInputStream(uri);
                 if (stream != null) {
                     try {
                         drawable = Drawable.createFromStream(stream, null);
                     } finally {
                         try {
                             stream.close();
                         } catch (IOException ex) {
                             Log.e(LOG_TAG, "Error closing icon stream for " + uri, ex);
                         }
                     }
                 }
                 if (DBG) Log.d(LOG_TAG, "Opened icon input stream: " + drawableId);
             } catch (FileNotFoundException fnfe) {
                 if (DBG) Log.d(LOG_TAG, "Icon stream not found: " + drawableId);
                 // drawable = null;
             }

             // If we got a drawable for this resource id, then stick it in the
             // map so we don't do this lookup again.
             if (drawable != null) {
                 mOutsideDrawablesCache.put(drawableId, drawable);
             }
         } catch (NotFoundException nfe) {
             if (DBG) Log.d(LOG_TAG, "Icon resource not found: " + drawableId);
             // drawable = null;
         }

         return drawable;
     }

     /**
      * Gets the value of a string column by name.
      *
      * @param cursor Cursor to read the value from.
      * @param columnName The name of the column to read.
      * @return The value of the given column, or <code>null</null>
      *         if the cursor does not contain the given column.
      */
     public static String getColumnString(Cursor cursor, String columnName) {
         int col = cursor.getColumnIndex(columnName);
         if (col == NO_ITEM_TO_SELECT) {
             return null;
         }
         return cursor.getString(col);
     }

 }
	/*
	* Copyright (C) 2009 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 android.app;

	import android.content.ContentResolver;
	import android.content.Context;
	import android.content.res.Resources.NotFoundException;
	import android.database.Cursor;
	import android.graphics.drawable.Drawable;
	import android.net.Uri;
	import android.os.Bundle;
	import android.server.search.SearchableInfo;
	import android.text.Html;
	import android.text.TextUtils;
	import android.util.Log;
	import android.view.View;
	import android.view.ViewGroup;
	import android.widget.ImageView;
	import android.widget.ResourceCursorAdapter;
	import android.widget.TextView;

	import java.io.FileNotFoundException;
	import java.io.IOException;
	import java.io.InputStream;
	import java.util.WeakHashMap;

	/**
	* Provides the contents for the suggestion drop-down list.in {@link SearchDialog}.
	*
	* @hide
	*/
	class SuggestionsAdapter extends ResourceCursorAdapter {
	// The value used to query a cursor whether it is still expecting more input,
	// so we can correctly display (or not display) the 'working' spinner in the search dialog.
	public static final String IS_WORKING = "isWorking";

	// The value used to tell a cursor to display the corpus selectors, if this is global
	// search. Also returns the index of the more results item to allow the SearchDialog
	// to tell the ListView to scroll to that list item.
	public static final String SHOW_CORPUS_SELECTORS = "showCorpusSelectors";

	private static final boolean DBG = false;
	private static final String LOG_TAG = "SuggestionsAdapter";

	private SearchDialog mSearchDialog;
	private SearchableInfo mSearchable;
	private Context mProviderContext;
	private WeakHashMap<String, Drawable> mOutsideDrawablesCache;
	private boolean mGlobalSearchMode;

	// Cached column indexes, updated when the cursor changes.
	private int mFormatCol;
	private int mText1Col;
	private int mText2Col;
	private int mIconName1Col;
	private int mIconName2Col;

	// This value is stored in SuggestionsAdapter by the SearchDialog to indicate whether
	// a particular list item should be selected upon the next call to notifyDataSetChanged.
	// This is used to indicate the index of the "More results..." list item so that when
	// the data set changes after a click of "More results...", we can correctly tell the
	// ListView to scroll to the right line item. It gets reset to NO_ITEM_TO_SELECT every time it
	// is consumed.
	private int mListItemToSelect = NO_ITEM_TO_SELECT;
	static final int NO_ITEM_TO_SELECT = -1;

	public SuggestionsAdapter(Context context, SearchDialog searchDialog, SearchableInfo searchable,
	WeakHashMap<String, Drawable> outsideDrawablesCache, boolean globalSearchMode) {
	super(context,
	com.android.internal.R.layout.search_dropdown_item_icons_2line,
	null, // no initial cursor
	true); // auto-requery
	mSearchDialog = searchDialog;
	mSearchable = searchable;

	// set up provider resources (gives us icons, etc.)
	Context activityContext = mSearchable.getActivityContext(mContext);
	mProviderContext = mSearchable.getProviderContext(mContext, activityContext);

	mOutsideDrawablesCache = outsideDrawablesCache;
	mGlobalSearchMode = globalSearchMode;
	}

	/**
	* Overridden to always return <code>false</code>, since we cannot be sure that
	* suggestion sources return stable IDs.
	*/
	@Override
	public boolean hasStableIds() {
	return false;
	}

	/**
	* Use the search suggestions provider to obtain a live cursor. This will be called
	* in a worker thread, so it's OK if the query is slow (e.g. round trip for suggestions).
	* The results will be processed in the UI thread and changeCursor() will be called.
	*/
	@Override
	public Cursor runQueryOnBackgroundThread(CharSequence constraint) {
	if (DBG) Log.d(LOG_TAG, "runQueryOnBackgroundThread(" + constraint + ")");
	String query = (constraint == null) ? "" : constraint.toString();
	try {
	return SearchManager.getSuggestions(mContext, mSearchable, query);
	} catch (RuntimeException e) {
	Log.w(LOG_TAG, "Search suggestions query threw an exception.", e);
	return null;
	}
	}

	/**
	* Cache columns.
	*/
	@Override
	public void changeCursor(Cursor c) {
	if (DBG) Log.d(LOG_TAG, "changeCursor(" + c + ")");
	super.changeCursor(c);
	if (c != null) {
	mFormatCol = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_FORMAT);
	mText1Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_TEXT_1);
	mText2Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_TEXT_2);
	mIconName1Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_ICON_1);
	mIconName2Col = c.getColumnIndex(SearchManager.SUGGEST_COLUMN_ICON_2);
	}
	updateWorking();
	}

	@Override
	public void notifyDataSetChanged() {
	super.notifyDataSetChanged();
	updateWorking();
	if (mListItemToSelect != NO_ITEM_TO_SELECT) {
	mSearchDialog.setListSelection(mListItemToSelect);
	mListItemToSelect = NO_ITEM_TO_SELECT;
	}
	}

	/**
	* Specifies the list item to select upon next call of {@link #notifyDataSetChanged()},
	* in order to let us scroll the "More results..." list item to the top of the screen
	* (or as close as it can get) when clicked.
	*/
	public void setListItemToSelect(int index) {
	mListItemToSelect = index;
	}

	/**
	* Updates the search dialog according to the current working status of the cursor.
	*/
	private void updateWorking() {
	if (!mGlobalSearchMode \|\| mCursor == null) return;

	Bundle request = new Bundle();
	request.putString(SearchManager.RESPOND_EXTRA_PENDING_SOURCES, "DUMMY");
	Bundle response = mCursor.respond(request);

	mSearchDialog.setWorking(response.getBoolean(SearchManager.RESPOND_EXTRA_PENDING_SOURCES));
	}

	/**
	* Tags the view with cached child view look-ups.
	*/
	@Override
	public View newView(Context context, Cursor cursor, ViewGroup parent) {
	View v = super.newView(context, cursor, parent);
	v.setTag(new ChildViewCache(v));
	return v;
	}

	/**
	* Cache of the child views of drop-drown list items, to avoid looking up the children
	* each time the contents of a list item are changed.
	*/
	private final static class ChildViewCache {
	public final TextView mText1;
	public final TextView mText2;
	public final ImageView mIcon1;
	public final ImageView mIcon2;

	public ChildViewCache(View v) {
	mText1 = (TextView) v.findViewById(com.android.internal.R.id.text1);
	mText2 = (TextView) v.findViewById(com.android.internal.R.id.text2);
	mIcon1 = (ImageView) v.findViewById(com.android.internal.R.id.icon1);
	mIcon2 = (ImageView) v.findViewById(com.android.internal.R.id.icon2);
	}
	}

	@Override
	public void bindView(View view, Context context, Cursor cursor) {
	ChildViewCache views = (ChildViewCache) view.getTag();
	boolean isHtml = false;
	if (mFormatCol >= 0) {
	String format = cursor.getString(mFormatCol);
	isHtml = "html".equals(format);
	}
	setViewText(cursor, views.mText1, mText1Col, isHtml);
	setViewText(cursor, views.mText2, mText2Col, isHtml);
	setViewIcon(cursor, views.mIcon1, mIconName1Col);
	setViewIcon(cursor, views.mIcon2, mIconName2Col);
	}

	private void setViewText(Cursor cursor, TextView v, int textCol, boolean isHtml) {
	if (v == null) {
	return;
	}
	CharSequence text = null;
	if (textCol >= 0) {
	String str = cursor.getString(textCol);
	text = (str != null && isHtml) ? Html.fromHtml(str) : str;
	}
	// Set the text even if it's null, since we need to clear any previous text.
	v.setText(text);

	if (TextUtils.isEmpty(text)) {
	v.setVisibility(View.GONE);
	} else {
	v.setVisibility(View.VISIBLE);
	}
	}

	private void setViewIcon(Cursor cursor, ImageView v, int iconNameCol) {
	if (v == null) {
	return;
	}
	if (iconNameCol < 0) {
	return;
	}
	String value = cursor.getString(iconNameCol);
	Drawable drawable = getDrawableFromResourceValue(value);
	// Set the icon even if the drawable is null, since we need to clear any
	// previous icon.
	v.setImageDrawable(drawable);

	if (drawable == null) {
	v.setVisibility(View.GONE);
	} else {
	v.setVisibility(View.VISIBLE);

	// This is a hack to get any animated drawables (like a 'working' spinner)
	// to animate. You have to setVisible true on an AnimationDrawable to get
	// it to start animating, but it must first have been false or else the
	// call to setVisible will be ineffective. We need to clear up the story
	// about animated drawables in the future, see http://b/1878430.
	drawable.setVisible(false, false);
	drawable.setVisible(true, false);
	}
	}

	/**
	* Gets the text to show in the query field when a suggestion is selected.
	*
	* @param cursor The Cursor to read the suggestion data from. The Cursor should already
	* be moved to the suggestion that is to be read from.
	* @return The text to show, or <code>null</code> if the query should not be
	* changed when selecting this suggestion.
	*/
	@Override
	public CharSequence convertToString(Cursor cursor) {
	if (cursor == null) {
	return null;
	}

	String query = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_QUERY);
	if (query != null) {
	return query;
	}

	if (mSearchable.shouldRewriteQueryFromData()) {
	String data = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_INTENT_DATA);
	if (data != null) {
	return data;
	}
	}

	if (mSearchable.shouldRewriteQueryFromText()) {
	String text1 = getColumnString(cursor, SearchManager.SUGGEST_COLUMN_TEXT_1);
	if (text1 != null) {
	return text1;
	}
	}

	return null;
	}

	/**
	* This method is overridden purely to provide a bit of protection against
	* flaky content providers.
	*
	* @see android.widget.ListAdapter#getView(int, View, ViewGroup)
	*/
	@Override
	public View getView(int position, View convertView, ViewGroup parent) {
	try {
	return super.getView(position, convertView, parent);
	} catch (RuntimeException e) {
	Log.w(LOG_TAG, "Search suggestions cursor threw exception.", e);
	// Put exception string in item title
	View v = newView(mContext, mCursor, parent);
	if (v != null) {
	ChildViewCache views = (ChildViewCache) v.getTag();
	TextView tv = views.mText1;
	tv.setText(e.toString());
	}
	return v;
	}
	}

	/**
	* Gets a drawable given a value provided by a suggestion provider.
	*
	* This value could be just the string value of a resource id
	* (e.g., "2130837524"), in which case we will try to retrieve a drawable from
	* the provider's resources. If the value is not an integer, it is
	* treated as a Uri and opened with
	* {@link ContentResolver#openOutputStream(android.net.Uri, String)}.
	*
	* All resources and URIs are read using the suggestion provider's context.
	*
	* If the string is not formatted as expected, or no drawable can be found for
	* the provided value, this method returns null.
	*
	* @param drawableId a string like "2130837524",
	* "android.resource://com.android.alarmclock/2130837524",
	* or "content://contacts/photos/253".
	* @return a Drawable, or null if none found
	*/
	private Drawable getDrawableFromResourceValue(String drawableId) {
	if (drawableId == null \|\| drawableId.length() == 0 \|\| "0".equals(drawableId)) {
	return null;
	}

	// First, check the cache.
	Drawable drawable = mOutsideDrawablesCache.get(drawableId);
	if (drawable != null) {
	if (DBG) Log.d(LOG_TAG, "Found icon in cache: " + drawableId);
	return drawable;
	}

	try {
	// Not cached, try using it as a plain resource ID in the provider's context.
	int resourceId = Integer.parseInt(drawableId);
	drawable = mProviderContext.getResources().getDrawable(resourceId);
	if (DBG) Log.d(LOG_TAG, "Found icon by resource ID: " + drawableId);
	} catch (NumberFormatException nfe) {
	// The id was not an integer resource id.
	// Let the ContentResolver handle content, android.resource and file URIs.
	try {
	Uri uri = Uri.parse(drawableId);
	InputStream stream = mProviderContext.getContentResolver().openInputStream(uri);
	if (stream != null) {
	try {
	drawable = Drawable.createFromStream(stream, null);
	} finally {
	try {
	stream.close();
	} catch (IOException ex) {
	Log.e(LOG_TAG, "Error closing icon stream for " + uri, ex);
	}
	}
	}
	if (DBG) Log.d(LOG_TAG, "Opened icon input stream: " + drawableId);
	} catch (FileNotFoundException fnfe) {
	if (DBG) Log.d(LOG_TAG, "Icon stream not found: " + drawableId);
	// drawable = null;
	}

	// If we got a drawable for this resource id, then stick it in the
	// map so we don't do this lookup again.
	if (drawable != null) {
	mOutsideDrawablesCache.put(drawableId, drawable);
	}
	} catch (NotFoundException nfe) {
	if (DBG) Log.d(LOG_TAG, "Icon resource not found: " + drawableId);
	// drawable = null;
	}

	return drawable;
	}

	/**
	* Gets the value of a string column by name.
	*
	* @param cursor Cursor to read the value from.
	* @param columnName The name of the column to read.
	* @return The value of the given column, or <code>null</null>
	* if the cursor does not contain the given column.
	*/
	public static String getColumnString(Cursor cursor, String columnName) {
	int col = cursor.getColumnIndex(columnName);
	if (col == NO_ITEM_TO_SELECT) {
	return null;
	}
	return cursor.getString(col);
	}

	}