在上一篇教程<<為Android應用添加搜索功能>>中，我們學習了如何在android應用中其搜索框架的基本功能，在本講中，將繼續學習在搜索應用中增加搜索提示建議的功能。

什么是搜索建議

首先我們來看下什么是搜索建議。在Android應用中，當用戶輸入搜索字符串是，系統會根據輸入的字符串的部分或整體，以下拉框的方式列出含有用戶輸入字符串的列表，這樣用戶就可以不必輸入完所有字符，可以直接從下拉列表中選擇，方便了用戶。如果能在APP應用的搜索模塊中加入這個功能，對用戶來說無疑是十分方便的，下圖是在搜索應用中使用搜索建議的圖：

搜索建議的兩類模式

要讓搜索應用支持搜索建議，必須在應用中增加一個自定義的content provider，并且要設置配置文件中的搜索元數據。

Android支持兩種類型的搜索建議模式：

· 基于用戶輸入的搜索建議

· 基于APP應用本身數據庫的搜索建議，即從APP應用數據庫中提取數據做搜索建議

下面分別講解兩種搜索建議方式是如何配置的：

基于用戶輸入的搜索建議

這種方式相對比較容易，先來介紹下。在Android中，提供了SearchRecentSuggestionsProvider這個類，可以實現從用戶最近輸入的內容中進行檢索，開發者只需要做的，只需要繼承這個類，并且在構造函數中進行如下設置：

import android.content.SearchRecentSuggestionsProvider; 
publicclass SampleRecentSuggestionsProvider 
extends SearchRecentSuggestionsProvider { 
public static final String AUTHORITY = 
SampleRecentSuggestionsProvider.class.getName(); 
public static final int MODE =DATABASE_MODE_QUERIES; 
public SampleRecentSuggestionsProvider() { 
setupSuggestions(AUTHORITY, MODE); 
} 
} 

在上面的這個類中，繼承了SearchRecentSuggestionsProvider，并且在構造函數中進行了設置，這樣這個自定義的contentprovider就擁有了查詢用戶最近輸入檢索的能力了。

但必須同時保存用戶曾經的檢索輸入，這樣就能在用戶再次輸入時，重新顯示出來，這個必須在search的activity中，寫入如下代碼：

SearchRecentSuggestions suggestions = 
newSearchRecentSuggestions(this, 
SampleRecentSuggestionsProvider.AUTHORITY, 
SampleRecentSuggestionsProvider.MODE); 
suggestions.saveRecentQuery(query, null); 

上面的代碼中可以看到，使用了SearchRecentSuggestionsProvider的

saveRecentQuery方法進行了搜索記錄的保存。

接下來，在配置文件中必須對這個contentprovider進行配置，如下：

<provider 
android:authorities="de.openminds.SampleRecentSuggestionsProvider" 
android:name=".SampleRecentSuggestionsProvider"> 
</provider> 

***，在searchable.xml中進行配置即可使用，如下：

<? xml version="1.0"encoding="utf-8"?> 
<searchablexmlns:androidsearchablexmlns:android="http://schemas.android.com/apk/res/android" 
android:label="@string/search_label" 
android:hint="@string/search_hint" 
android:searchSettingsDescription="@string/search_settings_description" 
android:searchSuggestAuthority="com.grokkingandroid.SampleRecentSuggestionsProvider " 
android:searchSuggestIntentAction="android.intent.action.SEARCH" 
android:searchSuggestThreshold="1" 
android:includeInGlobalSearch="true" 
android:searchSuggestSelection=" ?" 
> 
</searchable> 

其中的一些參數說明如下：

android:searchSuggestAuthorith

此屬性的值就是SearchSuggestAuthorith中的AUTHORITH了。

android:searchSuggestIntentAction

此屬性定義了當我們選中搜索提示的內容時發生的目的動作。

android:searchSuggestThreshold

此屬性定義了至少輸入幾個字符時才會彈出提示

android:includeInGlobalSearch

是否將內容加入android的全局搜索。true，加入。

android:searchSuggestSelection

定義搜索時參數的占位符

Android中數據庫保存的搜索記錄

SearchRecentSuggestionsProvider將用戶最近的搜索記錄保存在suggestions.db中，這個db保存了id,query查詢項，一個顯示的文本和搜索時候的時間戳。注意的是這個時間戳是必須的，因為所有的搜索記錄都是按時間排序的。

作為開發者來說，應該考慮定期清理搜索記錄，或者提供給用戶手動清除搜索記錄的機會，以讓用戶定期從搜索建議列表中看到更多的搜索建議項。清除搜索建議記錄是十分容易的，只需要調用SearchRecentSuggestions對象的clearHistory()方法即可。Android會默認保留250個搜索建議項在系統中。

基于應用的搜索建議

在更多情況下，開發者希望是提供給用戶基于app應用本身的搜索功能，這樣用戶在搜索時，將基于APP應用本身的內容提供給用戶搜索建議。這個時候，在自定義provider中，只需要關注query()和getContentType()就可以了。

首先，在應用中必須獲得用戶在搜索文本框中輸入的內容，然后再調用query()方法去搜索app應用。這個可以通過如下兩類方法去獲得用戶的輸入內容

· 默認的是通過URI的方式獲得用戶的輸入內容

· 在配置文件中的查詢字符串

先看下如何過URI的方式獲得用戶的輸入內容。系統都會通過query()函數在Content Provider中進行查詢，然后用Cursor返回對應的suggestion。系統對用戶的輸入，構造成如下的URI：

content://authority/optionalPath/SUGGEST_URI_PATH_QUERY /queryText

注意這里的Uri末尾的querytext是用URL方式進行編碼的，所以你需要解碼。

一般都是采用如下的方式取得它：Stringquery = uri.getLastPathSegment().toLowerCase();

這里的optional.suggest.path就是在searchable配置文件中設置的android:searchSuggestPath，如果在searchable配置文件沒有設置它，optional.suggest.path當然也不會包括在uri中。只有需要一個ContentProvider為多個searchable activities提供suggestions查詢的時候，才需要設置android:searchSuggestPath，這時它用于區分是哪個searchableactivities。

注意:SUGGEST_URI_PATH_QUERY 并不是URI的字面字符串,它是一個靜態成員常量，表示是把該常量的值加到uri中

下面是相關的使用方法代碼：

public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder){ 
String query = uri.getLastPathSegment(); 
if (SearchManager.SUGGEST_URI_PATH_QUERY.equals(query)) { 
//如果找到符合用戶輸入的記錄 
} 
else { 
//如果找不到符合用戶輸入的記錄 
} 
} 

接著看下如何在配置文件中進行查詢字符串的設置。可以在配置文件中進行如下配置，增加android:searchSuggestSelection選項，如下：

android:searchSuggestSelection="namelike ?"

那么query()方法代碼如下：

public Cursor query(Uri uri, String[]projection, String selection, 
String[]selectionArgs, String sortOrder) { 
if (selectionArgs!= null && selectionArgs.length > 0 &&selectionArgs[0].length() > 0) { 
// 用戶輸入內容保存在 selectionArgs[0] 中 
} 
else { 
// 用戶沒輸入任何內容 
} 
} 

此外，還可以在配置文件中配置搜索建議的最短字符數，比如android:searchSuggestThreshold="3"，則表明，用戶至少輸入3個字符后，才開始調用搜索建議項。

處理返回的結果

下面講解如何處理搜索建議返回給前端界面的問題。首先要在配置文件中，配置使用哪個action并且使用哪一個URI（這個URI其實就是搜索建議項的***數據來源列表），配置如下：

android:searchSuggestIntentAction = "android.intent.action.VIEW" android:searchSuggestIntentData = "content://someAuthority/somePath"

對返回的搜索建議項，是以一個cursor的方式返回的，各個列必須嚴格遵守相關的規定，下面是幾個重要的列的列表：

常量	用法
SUGGEST_COLUMN_TEXT_1	要在***行顯示的文本
SUGGEST_COLUMN_TEXT_2	在第二行顯示的文字
SUGGEST_COLUMN_INTENT_DATA_ID	添加到data_uri的額外的id

雖然說只有Searchmanager.SUGGEST_COLUMN_TEXT_1是強制要求的，但由于要知道用戶選擇的是哪一個選項，因此一般來說,id選項也是需要的。

此外，還需要將查詢出來的搜索數據轉換為cursor的數據格式，這個需要進行一點轉換工作。這可以使用SQLITEQueryBuilder的setprojectionMap方法進行轉換，在下一篇教程中，將會具體講解其用法，這里先列出相關代碼如下：

Map<String, String> projectionMap = newHashMap<String, String>(); 
 
projectionMap.put(COL_BAND, COL_BAND +" AS " + SearchManager.SUGGEST_COLUMN_TEXT_1); 
 
projectionMap.put(COL_ID, COL_ID); 
 
projectionMap.put(COL_ROW_ID,COL_ROW_ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA_ID); 
 
projectionMap.put(COL_LOCATION,COL_LOCATION + " AS " + SearchManager.SUGGEST_COLUMN_TEXT_2); 
 
projectionMap.put(COL_DATE, COL_DATE); 
 
builder.setProjectionMap(projectionMap); 

響應用戶搜索的intent

當用戶輸入搜索詞后，Android的搜索框架將調用manifest文件中配置的搜索的activity,這其中會使用顯式的intent去實現。就在app中搜索用的搜索建議而言，這個intent會包括在配置文件中的數據和從cursor中返回的數據。

對用戶搜索的響應的具體處理，取決于使用的是基于用戶已經輸入過的搜索詞的搜索建議，還是基于APP應用本身數據提供的搜索建議。

如果使用了基于用戶已經輸入過的搜索詞的搜索建議，那么intent的action就是Intent.ACTION_SEARCH ，這和上一篇教程中談到的是一樣的。

對于基于APP應用本身數據提供的搜索建議的情況，用戶大多數情況下，希望看到的是數據的詳細的情況，所以點了提供的搜索建議后，期望跳轉看到數據的詳情，這個可以通過設置Intent.ACTION_VIEW來實現。

由于搜索的activity一般會繼承ListActivity，所以一般情況下需要另外打開一個activity去查看某項數據的具體內容，代碼如下：

private void handleIntent(Intentintent) { 
 
if(Intent.ACTION_SEARCH.equals(intent.getAction())) { 
 
String query =intent.getStringExtra(SearchManager.QUERY); 
 
doSearch(query); 
 
} else if(Intent.ACTION_VIEW.equals(intent.getAction())) { 
 
Uri detailUri =intent.getData(); 
 
String id = detailUri.getLastPathSegment(); 
 
Intent detailsIntent =new Intent(getApplicationContext(), DetailsActivity.class); 
 
detailsIntent.putExtra("ID", id); 
 
startActivity(detailsIntent); 
 
finish(); 
 
} 
 
} 

全局搜索

對于全局搜索的設置，只需要在配置文件中進行如下設置：

android:includeInGlobalSearch="true"

但問題是如何將你的APP應用能放置到Android本身的搜索列表中去呢？如下圖：

你的APP應用本身不能改變這些值，但Android提供了

android.app.SearchManager.INTENT_ACTION_GLOBAL_SEARCH

的方法，可以將你的APP應用添加到搜索列表中去，這樣的話，在搜索列表中，可以象如下圖的樣子進行搜索：

關于搜索建議***的問題

要注意的是關于搜索建議***的問題，在于開發者很難在樣式上進行控制，這將會是一個很大的問題。特別對于APP中如果搜索建議展示的樣式跟APP中其他的樣式很不同的話，將會影響用戶體驗。

另外，如果要在搜索建議中展示不同的數據 ，有的時候也會變得麻煩。比如在一個關于音樂會的app應用中，可能會出現位置和樂團或樂隊的相關信息，開發者企圖將它們在搜索建議中明確劃分開來，以方便用戶選擇，但可惜除非開發者進行自定義開發，否則無法實現這樣的功能。

小結

在本篇教程中，重點講解了如何在APP應用中加入搜索建議的兩種方法和注意點，在下一篇教程中，將講解如何使用搜索的快捷方式，敬請期待。

【51CTO譯稿，非經授權謝絕轉載，合作媒體轉載請注明原文出處、作者及51CTO譯者！】