开发者社区> shy丶gril> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

Android开发指南(40) —— Adding Recent Query Suggestions

简介:
+关注继续查看

前言

  本章内容为 Android开发者指南的 Framework Topics/Search/Adding Recent Query Suggestions章节,译为"增加最近查询的建议项",版本为Android 4.0 r1,翻译来自:"呆呆大虾",欢迎访问他的微博:"http://weibo.com/popapa",再次感谢"呆呆大虾" !期待你一起参与翻译Android的相关资料,联系我over140@gmail.com。

 

声明

  欢迎转载,但请保留文章原始出处:) 

    博客园:http://www.cnblogs.com/

Android中文翻译组:http://androidbox.sinaapp.com/

 

 

增加最近查询的建议项

译者署名: 呆呆大虾

译者微博: http://weibo.com/popapa

版本:Android 4.0 r1

原文

         http://developer.android.com/guide/topics/search/adding-recent-query-suggestions.html

 

快速查看

·       Android系统把搜索请求从搜索对话框或widget发送给执行搜索并显示结果的activity

·       可以把搜索widget作为“action view”放入Action Bar中,用于快速访问

在本文中

创建Content Provider

修改搜索配置

保存搜请求

清除建议数据

关键类

SearchRecentSuggestions

SearchRecentSuggestionsProvider

参阅

搜索配置文件

 

使用Android的搜索对话框或者搜索widget时,可能需要根据最近的搜索请求提供搜索建议项。比如,假设用户以前搜索过“puppies”,那么一旦他开始键入同样的请求时,这就可以作为建议项显示出来。图1展示了带有最近求建议的搜索对话框。

1. 带有最近请求建议的搜索对话框截屏

在开始前,需要为应用程序基本的搜索功能实现搜索对话框或搜索widget。如果没有,请参阅创建搜索界面

 

简介

最近请求建议项只是简单地保存了搜索文本。当用户选中一个建议项时,搜索activity 会收到一个ACTION_SEARCH intent,其中附带了作为搜索请求的建议项,该请求以前已经由搜索activity处理过的(如创建搜索界面所述)

要提供最近请求建议功能,需要:

·       实现一个搜索activity,如创建搜索界面中所述。

·       创建一个继承自SearchRecentSuggestionsProvidercontent provider,并在manifest中进行声明。

·       修改搜索配置文件中有关提供搜索建议项的content provider配置。

·       每次执行搜索后把请求保存到content provider中。

Android系统显示搜索对话框时,也就会把搜索建议项显示在对话框或搜索widget下面。所有需要做的事情就是提供数据源,系统能够从中获取建议项。

如果系统识别出activity是支持搜索功能并提供搜索建议的,则用户一旦开始键入搜索请求,就会触发以下动作:

1.     系统读取搜索请求文本(输入多少读取多少)并在存放建议项的content provider中进行检索。

2.     content provider返回一个Cursor,它指向匹配搜索文本的全部建议项。

3.     系统显示该Cursor提供的建议项列表。

一旦最近请求建议项显示完毕,将发生以下事情:

·       如果用户键入其它字符,或者以其它任何方式修改了请求文本,则上述步骤会重复执行,建议项列表将同步更新。

·       如果用户执行了搜索,建议项将被忽略,搜索文本将用正常的ACTION_SEARCH intent发送给搜索activity

·       如果用户选中了某个建议项,ACTION_SEARCH intent将把建议项文本作为请求发送给搜索activity

作为content provider使用的SearchRecentSuggestionsProvider类会自动处理上述工作的,因此实际上只需要编写很少量的代码即可。

 

创建Content Provider

最近请求建议项需要用到的content provider必须是SearchRecentSuggestionsProvider的实现。该类几乎处理了所有的事情,必需实现的只是编写一个包含一行代码的类构造方法。

以下是一个最近请求建议项所需的content provider完整的实现示例:

public class MySuggestionProvider extends SearchRecentSuggestionsProvider { 

    public final static String AUTHORITY = "com.example.MySuggestionProvider"; 

    public final static int MODE = DATABASE_MODE_QUERIES; 

 

    public MySuggestionProvider() { 

        setupSuggestions(AUTHORITY, MODE); 

    } 

}

setupSuggestions()调用参数为搜索authority和数据库模式。搜索authority可以是任何唯一的字符串,但最好是用content provider的完全限定名称(包名加provider类名;比如“com.example.MySuggestionProvider”)。数据库模式必须包括DATABASE_MODE_QUERIES可选项DATABASE_MODE_2LINES会在建议项列表中添加一列,使得每个建议项能提供两条文本。例如,要为每个建议项提供两行文本:

public final static int MODE = DATABASE_MODE_QUERIES | DATABASE_MODE_2LINES;

下面在manifest文件中声明content providerauthority串是与SearchRecentSuggestionsProvider类中(及搜索配置文件中)的相同:

<application> 

    <provider android:name=".MySuggestionProvider" 

              android:authorities="com.example.MySuggestionProvider" /> 

    ... 

</application>

 

为了能够使用建议项provider,需要对系统进行配置,在搜索配置文件的<searchable>元素中添加android:searchSuggestAuthority  android:searchSuggestSelection 属性。例如:

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

    android:searchSuggestAuthority="com.example.MySuggestionProvider" 

    android:searchSuggestSelection=" ?" > 

</searchable>

android:searchSuggestAuthority的值必须是content provider的完全限定名称,它必须与content provider使用的authority完全一致(上例中是AUTHORITY 字符串)。

android:searchSuggestSelection的值必须是空格加问号(" ?"),这只是一个SQLite查询参数的占位符(将自动替换为用户录入的搜索请求文本)。

 

为了构建最近搜索请求的集合,需把搜索activity收到的所有请求都添加到SearchRecentSuggestionsProvider中去。要实现这一目标,请创建一个SearchRecentSuggestions的实例,每当搜索activity接受到请求时都调用一次saveRecentQuery()方法。下面是如何在activityonCreate()方法中保存搜索请求的示例:

@Override 

public void onCreate(Bundle savedInstanceState) { 

    super.onCreate(savedInstanceState); 

    setContentView(R.layout.main); 

 

    Intent intent  = getIntent(); 

 

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

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

        SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this, 

                MySuggestionProvider.AUTHORITY, MySuggestionProvider.MODE); 

        suggestions.saveRecentQuery(query, null); 

    } 

}

SearchRecentSuggestionsProvider 构造方法需要用到与content provider定义相同的authority 和数据库模式。

saveRecentQuery()方法的第一个参数是搜索关键字,第二个参数包含建议项的第二行文本(或为空)。第二个参数只有用DATABASE_MODE_2LINES启用两行模式(two-line mode)时才会用到。如果启用了两行模式(two-line mode),系统在检索建议项时,会同时把请求文本与第二行文本进行匹配。

 

为了保护用户隐私,应该确保向用户提供清除最近搜索建议项的功能。要清除搜索历史记录,调用clearHistory()即可。例如:

SearchRecentSuggestions suggestions = new SearchRecentSuggestions(this, 

        HelloSuggestionProvider.AUTHORITY, HelloSuggestionProvider.MODE); 

suggestions.clearHistory();

可以选择在清除搜索历史菜单项、个人设置项或按钮中执行此操作。还应该提供确认对话框来验证用户真的是需要删除搜索历史记录。


转载:http://www.cnblogs.com/over140/archive/2011/12/28/2304393.html

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Git 取消远程分支关联,并关联到新的远程分支,将代码推上去
在工作中,经常需要将同一份代码传到不同的git仓库中去 如果本地同样一份代码,已经关联了一个与远程分支,那么怎么才能解除原程分支,并关联到一个新的分支将代码提交到新的分支上去呢? 1、如果你已经在远程创建了一个分支,远程分支地址:https://xxxxxxx/wangdong/helloworld.
2083 0
SEAndroid中定义的客体类有哪些?(access_vectors)
版权声明:您好,转载请留下本人博客的地址,谢谢 https://blog.csdn.net/hongbochen1223/article/details/48548059 SEAnd...
905 0
+关注
1876
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载