Searchable（二）

四、创建Searchable Activity

searchable activity根据搜索关键字进行搜索，并显示搜索结果。

当我们在search dialog or widget执行搜索的时候，系统就启动你的searchable activity ，并把搜索关键字用一个aciton为ACTION_SEARCH的Intent传给你的searchable activity.你的searchable activity在Intent中通过extra的QUERY来提取搜索关键字，执行搜索并显示搜索结果.

我们需要在AndroidManifest.xml文件中声明Searchable Activity，以便在search dialog or widget执行搜索的时候，系统启动该searchable activity并把搜索关键字传给它。

4.1、声明searchable activity

如何在AndroidManifest.xml文件中声明Searchable Activity

1.在activity的<intent-filter> 中添加一个可以接受action为ACTION_SEARCH的intent。

2.在<meta-data>中指明search dialog or widget的配置文件（即searchable.xml）

比如，示例2：

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

<meta-data>必须包括android:name这个属性，而且其值必须为"android.app.searchable"，

还必须包括android:resource这个属性，它指定了我们的search dialog的配置文件。(示例2中指定是the res/xml/searchable.xml).

注意:<intent-filter> 没有必要加入<category android:name="android.intent.category.DEFAULT" /> ，

因为系统是通过component name把ACTION_SEARCH intent explicitly显示的传递给searchable activity的。

4.2、执行搜索

当你在manifest文件中，声明好了searchable activity，在你的searchable activity，就可以参照下面的3步执行搜索了。

（1），提取搜索关键字

（2），在你的数据中进行搜索

（3），显示搜索结果

一般来说，你的搜索结果需要要在ListView进行显示，所有你的searchable activity需要继承ListActivity。

它包括了一个拥有单一ListView的layout，它为我们使用ListView提供了方便。

4.2.1、提取搜索关键字

当用户在search dialog or widget界面开始搜索的时候，系统将查找一个合适的searchable activity，并给它传送一个ACTION_SEARCH的intent，该intent把搜索关键字保存在extra的QUERY中。当activity的时候，我们必须检查保存在extra的QUERY中的搜索关键字，并提取它。

比如，示例3:

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.search);

// Get the intent, verify the action and get the query

Intent intent = getIntent();

if (Intent.ACTION_SEARCH.equals(intent.getAction())) {

String query = intent.getStringExtra(SearchManager.QUERY);

doMySearch(query);

}

}

在Action为ACTION_SEARCH的intent中，extra的QUERY总是被包含。在示例3提取处理了搜索关键字，然后让doMySearch()函数在执行真正的搜索的。

4.2.2、数据搜索

数据的存储和搜索都是和你的程序相关的。你可以以各种方式进行数据的存储和搜索，它才是你的程序更需要关注的。

但是还是有几点需要注意的：

（1），当你的数据存储在手机的数据库中时，执行full-text search (using FTS3, rather than a LIKE query)

能提供在文本数据中得到更健壮且速度更快的search。在sqlite.org中可以得到FTS3的更多信息， 在SQLiteDatabase可以看到Android上的SQLite更多信息 . 可以在Searchable Dictionary看到一个用FTS3实现搜索的示例。

（2），如果的数据来自互联网，那么你的搜索将受制于用户的数据连接情况。这时我们就需要显示一个进度条，直到从网路返回搜索结果。

. 在android.net可一看到更多的network APIs ，在Creating a Progress Dialog可以到看到如何显示一个进度条。

如果想让的数据和搜索变得透明，那么我建议你用一个Adapter返回搜索结果。这种方式，你更容易在ListView中显示搜索结果。如果你的数据在自于数据库，那么通过CursorAdapter向ListView提供搜索结果，如果你的数据来自于其他方式，可以扩展一个BaseAdapter来使用。

4.2.3、结果显示

正如上面讨论的一样，显示搜索结果建议使用的UI是ListView,所以你的searchable activity最好继承于ListActivity，然后是使用setListAdapter()来设置和搜索结果绑定了的Adapter。这样你的搜索结果就可以显示在ListView中了。

你可以参考Searchable Dictionary示例，它展示了怎么进行数据库查询，怎么使用Adapter向ListView提供搜索结果。

<wbr style="line-height:25px"></wbr>