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

    }