Android开发之核心特性SearchView的开发使用（源代码分享）

      在Android上，搜索是一个核心用户特性。用户可以搜索可用的任何数据,不管内容是存促于设备本身或者需要通过网络访问。Android提供了一个搜索框架为用户创建一个一致的搜索体验,可以帮助你实现搜索应用程序。搜索框架提供两种搜索模式:一个搜索对话框（Search Dialog）位于搜索屏幕的顶部或窗口小部件(SearchView),可以将其嵌入到你的布局中。在这两种情况下,Android系统将帮助你搜索实现交付执行搜索的任务给一个特定的Activity。效果如下图所示。



       当用户需要执行一个搜索的搜索对话框或搜索小部件,系统创建一个Intent和存储用户Query,然后系统会启动你事先声明的用于执行数据查找的Activity,,使用它进行数据搜寻。总共需要以下三个步骤。
（1）建立一个Search.XML文件在res/xml文件中
     一个XML文件,配置一些search dialog或widget的设置。它包括设置特性,比如语音搜索,搜索建议和提示文本搜索框。

<?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>

 （2）声明一个SearchActivity

          这个Activiy接收搜索用户的数据,并显示搜索结果。特别注意的是为了使调用的Activity找到这个SearchActivity,你必须首先声明Android搜索Activitydao到你的清单文件。如下所示。

<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>

  SearchActivity要完成以下三个步骤。1 接收查询 2 搜索您的数据3 展示结果。

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.search);
handleIntent(getIntent());
}

@Override
protected void onNewIntent(Intent intent) {
setIntent(intent);
handleIntent(intent);
}

private void handleIntent(Intent intent) {
if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
String query = intent.getStringExtra(SearchManager.QUERY);
doMySearch(query);
}
}

     之前看博客又看到有人说onNewIntent（）不知道几时促发的，我研究了下官方文档上面是这么写的。如果我们将android:launchMode设置为“singleTop”,然后SerachActivity接收ACTION_SEARCH intent 会调用 onNewIntent()方法。

（3）建立一个搜索界面
   搜索界面包含两种类型SearchDialog和SearchWidget。SerachDialog:默认情况下,搜索对话框隐藏,我们通过调用onSearchRequested()(当用户按搜索按钮)让他显示在屏幕上端，SearchWidget :允许用户将搜索框放在布局的任意位置，但通常需要跟actionbar结合。
  搜索界面的Activity也需要在清单文件声明

<activity android:name=".OtherActivity" ... >
<!-- enable the search dialog to send searches to SearchableActivity -->
<meta-data android:name="android.app.default_searchable"
android:value=".SearchableActivity" />
</activity>

public class OtherActivity extends Activity{
private Button mStartSearch;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.search_invoke);
//就一个按钮
mStartSearch = (Button)findViewById(R.id.btn_start_search);
//启动搜索框
mStartSearch.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
onSearchRequested();
}
});
}

//重写onSearchRequested方法
@Override
public boolean onSearchRequested() {
//除了输入查询的值，还可额外绑定一些数据
Bundle appSearchData = new Bundle();
appSearchData.putString("demo_key","text");

startSearch(null, false, appSearchData, false);
//必须返回true。否则绑定的数据作废
return true;
}

}