Android提高 - 浮动搜索框

浮动搜索框（SearchManager）的使用其实并不难，而是在于它的配置非常之繁琐，对于它的使用主要是方便开发者对于程序中有搜索业务时，更好的设计UI。

SearchManager具体使用步骤如下：

（1）配置search bar的相关信息，新建一个位于res/xml下的一个searchable.xml的配置文件，如默认值、是否有搜索建议或者语音搜索。

<searchable
    android:hint="@string/search_hint"
    android:label="@string/search_label"
    android:searchMode="showSearchLabelAsBadge"
    android:searchSuggestAuthority="com.android.cbin.SearchSuggestionSampleProvider"
    android:searchSuggestSelection=" ? "
    android:voiceLanguageModel="free_form"
    android:voicePromptText="@string/search_invoke"
    android:voiceSearchMode="showVoiceSearchButton|launchRecognizer" />

label为搜索框上方的文本，hint搜索框里面的提示文本，显示label。voiceSearchMode、voicePromptText和voiceLanguageModel是语音搜索配置。searchSuggestAuthority和searchSuggestSelection是配置搜索建议，配置错误将不会显示，这里的searchSuggestAuthority的值必须是继承自SearchRecentSuggestionsProvider的完整路径名。

（2）manifest.xml配置，搜索结果处理的Activity将出现两种情况，一种是从其他Activity中的search bar打开一个Activtiy专门处理搜索结果，第二种是就在当前Activity就是处理结果的Activity，先介绍第一种配置：

<activity android:name="SearchResultActivity" >
    <intent-filter>
        <action android:name="android.intent.action.SEARCH" >
        </action>
    </intent-filter>
    <!-- 指定上面的searchable.xml文件 -->
    <meta-data
        android:name="android.app.searchable"
        android:resource="@xml/searchable" >
    </meta-data>
</activity>
<!-- 为了使每一个Activity都能使用search bar,一定要将这个标签放到启动Activity中，里面的value指定 的是前面的搜索结果 Activity -->
<metadata
    android:name="android.app.default_searchable"
    android:value=".SearchResultActivity" />

（3）搜索建议在manifest.xml中相关的配置。之前searchable.xml中有一个searchSuggestAuthority的值，其实和这里的authorities指向的都是name中所关联的SearchSuggestionSampleProvider，他是一个SearchRecentSuggestionsProvider的子类。

<provider
    android:name="SearchSuggestionSampleProvider"
    android:authorities="com.android.cbin.SearchSuggestionSampleProvider" />

import android.content.SearchRecentSuggestionsProvider;

public class SearchSuggestionSampleProvider extends
		SearchRecentSuggestionsProvider {
	final static String AUTHORITY = "com.android.cbin.SearchSuggestionSampleProvider";
	final static int MODE = DATABASE_MODE_QUERIES;

	public SearchSuggestionSampleProvider() {
		super();
		setupSuggestions(AUTHORITY, MODE);
	}
}

（4）为了能够使用search bar 我们必须重写Activity的onSearchRequested的方法，在界面上启动一个searchbar但是这个动作不会自动触发，必须通过一个按钮或者菜单的点击事件触发；

@Override
public boolean onSearchRequested() {
	String text = etdata.getText().toString();
	Bundle bundle = new Bundle();
	bundle.putString("data", text);
	// 打开浮动搜索框（第一个参数默认添加到搜索框的值）
	// bundle为传递的数据
	startSearch("mm", false, bundle, false);
	// 这个地方一定要返回真 如果只是super.onSearchRequested方法不但
	// onSearchRequested（搜索框默认值）无法添加到搜索框中,bundle也无法传递出去
	return true;
}

（5）接收query和bundle，保存query值（即搜索建议的列表值）

public void doSearchQuery() {
	final Intent intent = getIntent();
	// 获得搜索框里值
	Stringquery = intent.getStringExtra(SearchManager.QUERY);
	tvquery.setText(query);
	// 保存搜索记录
	SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
			SearchSuggestionSampleProvider.AUTHORITY,
			SearchSuggestionSampleProvider.MODE);
	suggestions.saveRecentQuery(query, null);
	if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
		// 获取传递的数据
		Bundlebundled = intent.getBundleExtra(SearchManager.APP_DATA);
		if (bundled != null) {
			String ttdata = bundled.getString("data");
			tvdata.setText(ttdata);
		} else {
			tvdata.setText("no data");
		}
	}
}

之前说到了处理结果的Activity将可能出现的两种情况的两种，现在就处理第二种状况，就是假如invoke search bar的Activity同时也是处理搜索结果的Activity，如果按照之前的方式处理则会出现一种情况，搜索一次就实例化一次Activity，当按返回键的时候会发现老是同一个Activity，其实为了使它只有一个实例化对象，只需简单的配置和代码就能实现：

第一：在处理搜索结果Activity的manifest.xml中添加android:launchMode="singleTop"属性。

第二：重写Activity的onNewIntent(Intentintent)。

@Override
public void onNewIntent(Intent intent) {
	super.onNewIntent(intent);
	// 获得搜索框里值
	Stringquery = intent.getStringExtra(SearchManager.QUERY);
	tvquery.setText(query);
	// 保存搜索记录
	SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
			SearchSuggestionSampleProvider.AUTHORITY,
			SearchSuggestionSampleProvider.MODE);
	suggestions.saveRecentQuery(query, null);
	if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
		// 获取传递的数据
		Bundle bundled = intent.getBundleExtra(SearchManager.APP_DATA);
		if (bundled != null) {
			String ttdata = bundled.getString("data");
			tvdata.setText(ttdata);
		} else {
			tvdata.setText("no data");
		}
	}
}

相关知识：上面讲到了将最近的搜索值添加到搜索建议中，但却没有提到如果清理搜索建议中的值，与保存相似，SearchRecentSuggestion对象提供了一个clearHistory()方法。

private void clearSearchHistory() {
	SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this,
			SearchSuggestionSampleProvider.AUTHORITY,
			SearchSuggestionSampleProvider.MODE);
	suggestions.clearHistory();
}