在Android中，搜索是一个非常核心的功能，我们可以通过它搜索到任意我们可以获得的信息。这些信息可以是存储在手机中的联系人、文件等信息，也可以是在网络上的资源。
Android为了给用户提供良好的搜索体验，特意提供了一个搜索框架来方便开发者在自己的App中集成搜索功能。那么接下来我就学习一下这个搜索框架。
在Android的搜索框架中为我们提供了两种搜索的UI控件，它们分别是：
- Search Dialog
Search Dialog就是浮动在Activity上方的，由系统管理的搜索控件。它不参与Activity的生命周期。
- Search Widget
Search Wiget这是一个类似于EditView的控件，你可以将它随意摆放在任意你需要的位置。
这里我们主要学习Search Dialog的使用方法，Search Widget的使用方法读者可以在http://developer.android.com/guide/topics/search/index.html中学习，有什么问题也可以跟我讨论。
要使用Search Dialog，我们需要准备一下三个东西：
- A searchable configuration 这是一个xml的配置文件searchable.xml，并将其放在res/xml下
- A searchable activity 这是一个Activity，作用是用来处理用户输入的搜索关键字
- A search interface 这是一个搜索控件提供的接口，对于Search Dialog它提供的接口是onSearchRequested
根据以上三点，我们开始编写一个简单的包含搜索功能的App
1.编写searchable configuration
searchable.xml文件内容如下，并将其放入工程的res/xml下面
<?xml version="1.0" encoding="utf-8"?>
<searchable xmlns:android="http://schemas.android.com/apk/res/android"
android:label="@string/app_label"
android:hint="@string/search_hint" >
</searchable>
app_label一般指定App的名字，使用简单的搜索功能时app_label是不可见的，只有将你的搜索功能加入到quick search box的时候，才会在quick search box的可搜索列表中出现。
search_hint就是当我们没有任何输入是出现在Search Dialog上的字符串
2.创建一个Searchable Activity
假设我们创建的Activity的名称为SearchableActivity，那么在AndroidManifest中的配置如下：
<application ... >
<activity android:name=".SearchableActivity" >
<intent-filter>
<action android:name="android.intent.action.SEARCH" />
</intent-filter>
<meta-data android:name="android.app.searchable"
android:resource="@xml/searchable"/>
</activity>
...
</application>
其中android:name="android.app.searchable"告诉Android系统，SearchableActivity这个界面对android.intent.action.SEARCH敏感。
android:resource="@xml/searchable"则是来指定我们在第一步中的配置文件。
3.调用搜索接口并处理用户输入
上面我们只定义了一个处理搜索关键字的界面，接下来我们还要定义一个调用搜索接口的界面：
这里为了简单期间，我只是在App的第一个界面MainActiviy中添加一个按钮，然后通过按钮来调用Search Dialog的搜索接口。
MainActiviy.onCreate
private Button button ;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
button = (Button)findViewById(R.id.button) ;
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
onSearchRequested() ; //Search Dialog的调用接口
}
});
}
MainActiviy对应的AndroidManifest配置
<activity
android:name=".MainActivity"
android:label="@string/app_name" >
<meta-data android:name="android.app.default_searchable"
android:value=".SearchableActivity" />
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
其中
<meta-data android:name="android.app.default_searchable" android:value=".SearchableActivity" />指定了MainActivity调用Search Dialog的权利，并且指定了搜索处理界面SearchableActivity。
这里当点击MainActivity上的button的时候，就会调用onSearchRequested()，来激活Search Dialog。接着当我在Search Dialog中输入一些关键字并按确定时，系统会替我们发送一个包含了搜索关键字的Intent来启动SearchableActivity这个界面。所以只要在SearchableActivity的onCreate方法中获取intent，接着获取搜索关键字，就能对其进行处理了。
SearchableActivity.onCreate
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent intent = getIntent() ;
if(Intent.ACTION_SEARCH.equals(intent.getAction())){
String query = intent.getStringExtra(SearchManager.QUERY) ; //获取用户输入的关键字
Toast.makeText(this,"the query key is " + query,Toast.LENGTH_LONG).show(); //弹出用户输入的关键字，模拟搜索处理
}
}
完成以上三步后，一个简单的搜索Demo就做好了。效果图如下:
MainActivity进行搜索
SearchableActivity处理关键字
源码下载http://pan.baidu.com/s/1o6DTcs6