Android中全局搜索(QuickSearchBox)详解

时间:2023-12-28 11:04:08

http://blog.csdn.net/mayingcai1987/article/details/6268732

1. 标题:

应用程序如何全面支持搜索

2. 引言:

如果想让某个应用程序支持全局搜索,必须对这个应用程序进行一系列配置,并实现可被外界访问的内容提供者向搜索应用程序 (QuickSearchBox)提供搜索結果,根据配置信息,应用程序可被搜索框架识别为搜索源,搜索应用程序(QuickSearchBox)也可以 通过解析配置信息组拼成URI请求应用的ContentProvider获取搜索結果。

3. 配置实现:

1. 应用程序中应当存在一个Activity,这个Activity在AndroidManifest.xml中的基本配置,如下:

<activity android:name="com.focus.FishMeActivity" android:label="@string/app_name">
  <intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name= "android.intent.category.LAUNCHER" />
  </intent-filter>

<!-- 全局搜索支持  开始 -->
     <!-- 这个intent-filter是搜索框架启动这个Activity时Intent中配置的action见下面Activity作用第二项 -->

  <intent-filter>
<action android:name= "com.focus.FISH_ME"/>
<category android:name="android.intent.category.DEFAULT" />
  </intent-filter>

  <!-- 这个intent-filter是固定配置不需要改变,拷过去直接用-->
  <intent-filter>
<action android:name="android.intent.action.SEARCH" />
<category android:name= "android.intent.category.DEFAULT" />
  </intent-filter>

     <!-- 这个meta-data也是固定配置不需要改动,他需要一个xml文件,下面会有这个xml文件的最标准,最简单的配置,请继续向下看

(searchable.xml)-->
  <meta-data android:name="android.app.searchable" android:resource="@xml/searchable" />
  <!-- 全局搜索支持  结束 -->

</activity>

说一下这个Activity的作用:

第一,这样一个Activity在你的应用程序中是必须存在的,因为你配置了上面我用红色注释标注的代码后,这个Activity可以被识别为搜索源,

你的应用支持全局搜索了。

第二,当搜索出結果信息后单击某一个結果项后会打开这个Activity显示搜索出的内容。

2. searchable.xml最基本,最简单配置:

<?xml version="1.0" encoding="utf-8"?>
  <searchable xmlns:android="http://schemas.android.com/apk/res/android"
<!-- 这两个属性是固定的必须有-->
android:label="@string/search_label"
android:includeInGlobalSearch="true"      
    <!-- 这个authority是你写的ContentProvider的Authority,下面会说到 -->

android:searchSuggestAuthority="com.focus.FISH_ME_AUTHORITY"
    <!--这个action就是上面1中你配置的action-->
    android:searchSuggestIntentAction="com.focus.FISH_ME">
  </searchable>

这个文件的属性介绍会在后面的文章讲到。

3. 在AndroidManifest.xml文件中配置ContentProvider:

<provider

android:name = "FishMeProvider"
<!--这个authority和上面2中配置的authority相对应-->
    android:authorities= "com.focus.FISH_ME_AUTHORITY"

/>

4. 如何构建Content Provider:

在QuickSearchBox中通过ContentResolver调用内容提供者的query(Uri, String[], String, String[], String)方法进行信息搜索,应用程序必须实

现这个方法并且返回搜索到的Cursor对象。

下面将对ContentProvider的query方法的参数进行说明:

第一个参数(uri):

content://authority/suggestion.path/search_suggest_query/queryStr?limit=50

authority:对应searchable.xml文件中的android:searchSuggestAuthority属性。
suggestion.path:对应searchable.xml文件中的android:searchSuggestPath属性。
search_suggest_query : 固定字符串。
queryStr: 查询字符串。
limit : 查询条数。

第二个参数(projection):一直为null。

第三个参数(selection):对应searchable.xml文件中android:searchSuggestSelection属性,ContentProvider的query方法将会调用SQLite数据

库的Query方法,用这个参数组成SQL语句中where后面的条件,如:where name like ?,”name like ? ”就是selection参数的值,注意,

android:searchSuggestSelection属性中配置的查询条件不能用“AND”或“OR”等符号连接多个条件(不能写成:“name like ? AND age like ?”)。

第四个参数(selectionArgs):如果searchable.xml文件中android:searchSuggestSelection属性值不为空,程序会将查询字符串做为这个数组

的第一个元素,也是唯一的元素,在上面第三个参数中定义了查询条件,这个参数的作用是给查询条件中的问号赋值。

第五个参数:一直为null。

该方法将搜索到的数据以cursor对象的形式返回。