SearchRecentSuggestionsProvider

Class Overview

This superclass can be used to create a simple search suggestions provider for your application. It creates suggestions (as the user types) based on recent queries and/or recent views.

In order to use this class, you must do the following.

• Implement and test query search, as described in SearchManager. (This provider will send any suggested queries via the standard ACTION_SEARCH Intent, which you'll already support once you have implemented and tested basic searchability.)
• Create a Content Provider within your application by extending SearchRecentSuggestionsProvider. The class you create will be very simple - typically, it will have only a constructor. But the constructor has a very important responsibility: When it calls setupSuggestions(String, int), it configures the provider to match the requirements of your searchable activity.
• Create a manifest entry describing your provider. Typically this would be as simple as adding the following lines:

       <!-- Content provider for search suggestions -->
       <provider android:name="YourSuggestionProviderClass"
                 android:authorities="your.suggestion.authority" />

• Please note that you do not instantiate this content provider directly from within your code. This is done automatically by the system Content Resolver, when the search dialog looks for suggestions.
• In order for the Content Resolver to do this, you must update your searchable activity's XML configuration file with information about your content provider. The following additions are usually sufficient:

       android:searchSuggestAuthority="your.suggestion.authority"
       android:searchSuggestSelection=" ? "

• In your searchable activities, capture any user-generated queries and record them for future searches by calling SearchRecentSuggestions.saveRecentQuery().

Summary

[Expand] Inherited Methods
From class android.content.ContentProvider void attachInfo(Context context, ProviderInfo info) After being instantiated, this is called to tell the content provider about itself. int bulkInsert(Uri uri, ContentValues[] values) Implement this to insert a set of new rows, or the default implementation will iterate over the values and call insert(Uri, ContentValues) on each of them. abstract int delete(Uri uri, String selection, String[] selectionArgs) A request to delete one or more rows. final Context getContext() Retrieve the Context this provider is running in. final String getReadPermission() Return the name of the permission required for read-only access to this content provider. abstract String getType(Uri uri) Return the MIME type of the data at the given URI. final String getWritePermission() Return the name of the permission required for read/write access to this content provider. abstract Uri insert(Uri uri, ContentValues values) Implement this to insert a new row. boolean isTemporary() Returns true if this instance is a temporary content provider. void onConfigurationChanged(Configuration newConfig) Called by the system when the device configuration changes while your component is running. abstract boolean onCreate() Called when the provider is being started. void onLowMemory() This is called when the overall system is running low on memory, and would like actively running process to try to tighten their belt. AssetFileDescriptor openAssetFile(Uri uri, String mode) This is like openFile(Uri, String), but can be implemented by providers that need to be able to return sub-sections of files, often assets inside of their .apk. ParcelFileDescriptor openFile(Uri uri, String mode) Open a file blob associated with a content URI. final ParcelFileDescriptor openFileHelper(Uri uri, String mode) Convenience for subclasses that wish to implement openFile(Uri, String) by looking up a column named "_data" at the given URI. abstract Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) Receives a query request from a client in a local process, and returns a Cursor. final void setReadPermission(String permission) Change the permission required to read data from the content provider. final void setWritePermission(String permission) Change the permission required to read and write data in the content provider. abstract int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) Update a content URI.
From class java.lang.Object Object clone() Creates and returns a copy of this Object. boolean equals(Object o) Compares this instance with the specified object and indicates if they are equal. void finalize() Is called before the object's memory is being reclaimed by the VM. final Class<? extends Object> getClass() Returns the unique instance of Class which represents this object's class. int hashCode() Returns an integer hash code for this object. final void notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. final void notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. String toString() Returns a string containing a concise, human-readable description of this object. final void wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires. final void wait(long millis) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires. final void wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.
From interface android.content.ComponentCallbacks abstract void onConfigurationChanged(Configuration newConfig) Called by the system when the device configuration changes while your component is running. abstract void onLowMemory() This is called when the overall system is running low on memory, and would like actively running process to try to tighten their belt.