博客园_农民伯伯

Android中文API合集(7) + 开发者指南合集(2) (chm格式)

2012-01-31T01:54:00Z

前言

Android中文翻译组是一个非盈利性质的开源组织，至今已超过300人报名参与，关于翻译组的介绍，请看这里。欢迎更多朋友加入，发邮件到over140@gmail.com申请加入或直接参与Wiki编辑。

Android中文翻译组WIKI网站：http://wikidroid.sinaapp.com/。不管是否加入我们，请与我们一起自由编辑和分享相关中文资料。

Android中文翻译组官方网站：http://androidbox.sinaapp.com/。有在线的中文API、开发者指南、开源项目以及Android视频专栏。

本合集发布日期：2012年1月31日，涵盖历次合集内容，最新版请关注翻译组微博：http://weibo.com/android2。

截图

下载

本站

Android中文翻译组——Android开发者指南（2）.chm

Android中文翻译组——Android中文API合集（7）.chm

结束

由于精力有限，目前暂停了自动更新客户端的维护，内部组织结构还在调整，推荐想参与的朋友直接参与到WIKI编辑。

本文链接

Android应用开发提高系列（3）——《Effective Java 中文版》读书笔记

2012-01-29T06:32:00Z

声明

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

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

　　　　农民伯伯： http://over140.cnblogs.com

书籍

《Effective Java 中文版》　　03版　　潘爱民译　　

本书介绍了57条极具实用价值的经验规则。这些经验规则涵盖了大多数开发人员每天所面临的问题的解决方案，通过对Java平台设计专家所使用的技术的全面描述，揭示了应坐什么和不应做什么，才能产生清晰、健壮和高效的代码。

正文

　　注意：条目和用语可能与书籍有所出入，但尽量保持原样加一些自己的理解。

1. 构造函数一定不能调用可被覆写的方法，无论是直接还是间接进行。

2. 接口应该只是被用来定义类型的，它们不应被用来导出常量。（备注：不要再接口中定义常量）P/89

3. 一个安全而保守的策略是，永远不要导出两个具有相同参数数目的重载方法。

4. 返回零长度的数组而不是null。

5. 嵌套类

嵌套类(nested class)是指被定义在另一个类的内部的类，其存在的目的应该只是为它的外围类提供服务。嵌套类分为四种：

5.1　　静态成员类(static member class)

最简单的嵌套类，最好把它看做一个普通的类。它可以访问外围类的所有成员，包括那些声明为私有的成员。与其他类静态成员一样，也遵守同样的可访问性规则。

其通常用法是作为公有的辅助类，仅当与它外部类一起使用时才有意义。

私有静态成员类的一种通常用法是用来代表外围类对象的组件。例如，Map实例的内部通常有一个Entry对象对应与Map中每一对键值对，虽然每一个Entry都与一个Map关联，但Entry上的方法(getKey、getValue、setValue)并不需要访问该Map。因此使用非静态成员来表示Entry是浪费的，私有静态成员类是最佳的选择。

5.2　　非静态成员类(nonstatic member class)

非静态成员类的每一个实例都包含一个额外指向外部类对象的引用。维护这份引用要消耗时间和空间。

其通常用法是定义一个Adapter，它允许外围类的一个实例被看做另一个不相关的类的实例。例如，Map接口的实现往往使用非静态成员类来实现它们的集合视图。

5.3　　匿名类(anonymous class)

没有名字，它不是外围类的一个成员，在使用的同时被声明和实例化。可以出现在代码中任何允许表达式出现的地方。通常只实现了其接口中或超类中的方法，不会声明任何新的方法，它们应该非常简短。

用法1 是创建一个函数对象(function object)，比如Comparator实例。例如：

        Arrays.sort(args, new Comparator<String>() {
            @Override
            public int compare(String obj1, String obj2) {
                return obj1.length() - obj2.length();
            }
        });

用法2 创建一个过程对象(process object)，比如Thread、Runable或者TimeTask实例。

用法3 在一个静态工厂方法的内部，如：

    static List intArrayList(final int[] a){
        return new AbstractList<Integer>() {

            @Override
            public Integer get(int location) {
                return a[location];
            }

            @Override
            public int size() {
                return a.length;
            }};
    }

用法4 在复杂的类型安全枚举类型中，用于公有的静态final域的初始化器中，例如：

    public abstract class Operation {
        private final String name;

        Operation(String name) {
            this.name = name;
        }

        public String toString() {
            return this.name;
        }

        abstract double eval(double x, double y);

        public static final Operation PLUS = new Operation("+") {
            @Override
            double eval(double x, double y) {
                return x + y;
            }
        };
    }

5.4　　局部类(local class)

使用最少，在任何“可以声明局部变量”的地方，都可以声明局部类，也遵守同样的作用域规则。与匿名类一样，它们必须非常简短。

简而言之，如果一个嵌套类需要在单个方法之外仍然是可见的，或者它太长了，不适合放在一个方法内部，那么应该使用成员类。如果成员类的每个实例都需要一个指向其外围实例的引用，则把成员类做成非静态的；否则就做成静态的。假设一个嵌套类属于一个方法的内部，如果你只需要在一个地方创建它的实例，并且已经有了一个预先存放的类型可以说明这个类的特征，则把它做成匿名类；否则就做成局部类。

6. 了解和使用库

应该熟悉java.lang、java.util以及java.io中的内容。

6.1 Random.nextInt(int) 　　产生随机整数。

6.2 Collections.sort(v)　　字符串组成的Vector排序

6.3 Collections.sort(v, String.CASE_INSENSITIVE_ORDER)　　字符串组成的Vector排序，忽略大小写

6.4 System.out.println(Arrays.asList(a))　　循环打印一个数组中所有的元素

6.5 获取两个Hashtable包含相同映射键值的所有键：

        Map tmp = new HashMap(h1);
        tmp.entrySet().retainAll(h2.entrySet());
        Set result = tmp.keySet();

6.6 Arrays.toString(a)　　打印数组每一个元素

6.7 Arrays.equals(a1, a2)　　比较两个数组长度、每一个元素是否相等。

7. 使用异常

7.1　　被检查的异常(checked exception)

通过抛出一个被检查的异常，强迫调用者在一个catch子句中处理异常，或者将它传播到外面。

7.2　　运行时异常(run-time exception)

大多数的运行时异常都是指API的客户没有遵守API规范建立的约定。例如数组越界。

总而言之，对于可恢复的条件，使用被检查的异常；对于程序错误，使用运行时异常。

8. 尽量使用标准的异常

8.1　　IllegalArgumentException　　调用者传递的参数不合适

8.2　　NullPointException　　空指针异常

8.3　　IndexOutOfBoundsException　　下标越界

8.4　　ConcurrentModificationException　　在禁止并发修改的情况下，对象检测到并发修改

8.5　　UnsupportedOperationException　　对象不支持所请求的方法

结束

　　由于先读的《Practical Java》，与本书内容有部分相似，所以看得比较快，仍然值得一读，也终于弄懂关于嵌套类这块的内容。

本文链接

Android开发指南(43) —— Location and Maps

2012-01-20T06:34:00Z

前言

本章内容为 Android开发者指南的 Framework Topics/Location and Maps章节，译为"位置和地图"，版本为Android 4.0 r1，翻译来自："太阳火神的美丽人生"，欢迎访问他的微博："http://alot.sinaapp.com"，再次感谢他！期待你一起参与翻译Android的相关资料，联系我over140@gmail.com。

声明

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

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

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

位置和地图

译者署名：太阳火神的美丽人生

译者链接：http://alot.sinaapp.com

版本：Android 4.0 r1

原文

http://developer.android.com/guide/topics/location/index.html

基于位置和地图的应用对移动设备用户来说更引人注目。你可以使用android.location包的类和谷歌地图扩展库将这种能力构建到你的应用中。以下各部分提供细节信息。

位置服务

Android 通过 android.location 包中的类使你的应用可以访问由设备来支撑的位置服务。位置框架的核心组件是 LocationManager 系统服务，它提供了一些应用编程接口来确定位置和测定底层设备的方向（如果可用）。

和其它系统服务一样，你不要直接实例化LocationManager。当然，你可以通过调用getSystemService(Context.LOCATION_SERVICE)从系统请求一个实例。该方法返回指向一个新的 LocationManager 实例的句柄。

一旦你的应用有了一个 LocationManager ，就可以做如下三件事了：

查询到所有的LocationProvider 的列表，以获得最新的用户位置。
从某个位置提供者注册/注销定期更新用户的当前位置（通过条件或名称指定）。
注册/注销在设备接近给定经/纬度范围（由米为单位的半径指定）内时要被激活的指定意向。

要获得更多信息，阅读获得用户位置指南。

谷歌地图扩展库

为了使你添加强大的地图能力到应用中更容易，谷歌提供了包含com.google.android.maps 包的地图扩展库。com.google.android.maps包的类提供了内置的下载、渲染和缓存地图碎片能力，以及各种显示选项和控件。

地图包中的主要类是com.google.android.maps.MapView，它是一个 ViewGroup的子类。MapView显示承载从谷歌地图服务获得的数据的地图。当MapView获得焦点时，它会自动捕获键盘按键和触摸手势来平移和缩放地图，包括处理网络请求获得额外的地图碎片。它也提供了所有必需的用户界面元素给用户来控制地图。你的应用也可以使用MapView类方法来编程控制MapView并在地图上绘制一定数量的修饰样式。

通常，MapView类提供一个谷歌地图应用编程接口的包装，它使你的应用可以通过类方法操作谷歌地图数据，并且当你想要其它类型的视图时它可以让你使用地图数据。

地图扩展库不是标准Android 库的一部分，所以它可能在某些兼容的Android设备上不存在。同样，地图扩展库也未包含在SDK 提供的标准Android库中。地图扩展库作为Android SDK谷歌应用编程接口插件的一部分提供给你使用，以便你可以使用

要了解更多有关地图扩展库的信息以及如何下载和使用谷歌应用编程接口插件，访问
http://code.google.com/android/add-ons/google-apis

为了您的方便，谷歌应用编程接口插件也可以作为可下载的组件从Android SDK 和 AVD Manager中下载使用（参见Adding SDK 组件）。

注意：要在一个MapView中显示谷歌地图数据，你必须注册谷歌地图服务并获得一个Maps API Key（地图应用编程接口密钥）。要了解有关如何获得一个Maps API Key（地图应用编程接口密钥）的信息，参见获得一个地图应用编程接口密钥（btaining a Maps API Key)。

本文链接

Android中文API（146） —— Display

2012-01-20T06:31:00Z

前言

本章内容android.view.Display章节，版本为Android 4.0 r1，翻译来自："州伟"，再次感谢他！期待你一起参与翻译Android的相关资料，联系我over140@gmail.com。

声明

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

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

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

Display

译者署名：州伟

译者邮箱：guozwhero@gmail.com

版本：Android 4.0 r1

结构

继承关系

public class Display extends Object

java.lang.Object

android.view.Display

类概述

Display类提供关于屏幕尺寸和分辨率的信息。

常量

public static final int DEFAULT_DISPLAY

缺省的Display id.

常量值：0 (0x00000000)

公共方法

public int getDisplayId ()

返回此屏幕的索引。此方法目前未定义，请不要使用。

public int getHeight ()

此方法不建议使用

请使用getSize(Point) 代替

public void getMetrics (DisplayMetrics outMetrics)

获取描述此屏幕尺寸和分辨率的DisplayMetrics对象。

此大小是基于当前屏幕旋转而调整的。

此方法返回的大小并不一定代表实际屏幕的原始大小（原始分辨率）。返回的大小可能会有所调整，以排除某些总是可见的系统布置元素。这也可能是被调整以提供与旧的为较小的初始的应用一致，初始应用最初是为较小的屏幕而设计的。

参数

outMetrics 一个 DisplayMetrics 对象接收 metrics.

public int getOrientation ()

此方法不建议使用

请使用getRotation()代替

返回值

屏幕的方向

public int getPixelFormat ()

返回本机屏幕像素格式。返回值可能是一个int类型的PixelFormat的常量。

可能是一个int类型的PixelFormat的常量

public void getRectSize (Rect outSize)

获取屏幕矩形的大小，以像素为单位

参数

OutSize 一个Rect对象接受大小的信息

参见

getSize(Point)

public float getRefreshRate ()

返回屏幕帧每秒的刷新率。

public int getRotation ()

返回从“自然”(natural)方向的屏幕旋转度数。返回值可能Surface.ROTATION_0（不旋转），Surface.ROTATION_90，Surface.ROTATION_180，或Surface.ROTATION_270。例如：如果设备有一个宽的屏幕，使用者转动进入横向，此时返回值可能是Surface.ROTATION_90 或者 Surface.ROTATION_270，取决于它旋转的方向。角度是绘制图形在屏幕的旋转，这是设备物理旋转的相反方向。例如：如果该设备是逆时针旋转90度，以弥补渲染会顺时针旋转90度，从而这里的返回值将会是Surface.ROTATION_90。

public void getSize (Point outSize)

获取屏幕的尺寸，以像素为单位。

注意，此值不应被用于计算布局，因为一个设备沿着显示通常有屏幕装饰(例如状态栏)，减少的应用空间使得原尺寸与之不符。布局应该改用窗口的大小。

此大小是基于当前屏幕旋转而调整的。

此方法返回的大小并不一定代表实际屏幕的原始大小（原始分辨率）。返回的大小可能会有所调整，以排除某些系统总是可见的装饰元素。这也可能是缩放，提供与旧，最初是为小屏幕设计的应用程序的兼容性。

参数

outsize Point对象接收大小的信息。

public int getWidth ()

此方法不建议使用

请使用getSize(Point) 代替

补充

文章精选

关于Android的nodpi,xhdpi,hdpi,mdpi,ldpi

本文链接

我的2011

2012-01-18T14:54:00Z

前言祝语

今年是自己的Android年，忙忙碌碌在各个项目上，翻译组和上课固定的占据了每周业余时间的一部分时间，还会挤时间看电影、看书、自己做饭，尽可能的均衡生活、学习和工作。这里记录分享这一年的点滴历程，也祝大家在新的一年里龙马精神！

往年回顾

伯伯2010年终总结 [ 程序 | 电影 | 书籍 | 游玩 ... ]

农民伯伯2009年夜总结

程序人生

　　本博值得推荐的文章：

Android中文API合集(6) + 开发者指南合集(1) (chm格式)

Android应用开发提高系列（1）——《Practical Java 中文版》读书笔记（上）

Android应用开发提高系列（2）——《Practical Java 中文版》读书笔记（下）

Android动态加载jar/dex

[Android]文本框实现搜索和清空效果

[Android]ListView性能优化之视图缓存(续)

新浪微博布局学习——妙用TabHost

新浪微博布局学习——活用RelativeLayout

推荐Android站点

谦虚的天下

蝈蝈俊Android

tuhuolong的专栏

Android中文翻译组

http://androidbox.sinaapp.com/

电影动漫

国内、港台

非诚勿扰2　　也没有传说的那么烂，演技在这里，还可以吧:)

80后　　还不错，不知与山楂花之恋比哪个显得更青涩一些 :)

飞砂风中转　　古惑仔搞笑版，看起来蛮不习惯的，古惑仔系列片影响几代人，不是一部搞笑版能抹掉的...

单身男女　　失去才懂得珍惜

关云长　　

不是闹着玩的　　　　

人在囧途

建国伟业　　皮影戏...

大唐双龙传[04版][42集]　　好堕落，果然是武侠迷

钢的琴　　想说三点：1. 年轻人，孩子是压力也是动力；2. 确实是钢的琴，钢做的琴，坚持、执着和团结等等都是困难的克星，试问一个这么多克星怎么能不被战胜？ 3. 怀念、想念以及期盼能有一群战友、一群工友、一群同学能一条心的办一件事。

[推荐]盲井　　感谢好友推荐！

[推荐]盲山　　知识改变命运——这是我看完的感受，如果不是那个小孩帮忙寄信恐怕就没希望了。

[推荐]最爱　　郭富城+章子怡，演技派的实力不容置疑。有感：活着就是一种态度。

失恋33天　　还不错

龙门飞甲[电影院]　　

国外

怒海争锋　　海贼王的关系，对海战挺感兴趣的

[推荐]接触未来　　值得一看，相信和不相信都是一种信仰。

欲望都市2　　除了人老了一点还是蛮不错的。

仙境之桥　　有点烂尾，当你看到相信幻境存在的时候，女主角死了，非得去强调这是幻境干什么。。。

洛杉矶之战　　还行吧！期待的大场面还真只有封面的那一小段，成本七千万美元。

范海辛　　吸血鬼题材的电影，虽然比较早但特效还行。据说吸血鬼类型的片子还分文艺型的?!

赤焰战场　　几个老家伙，嘿嘿~~~

[推荐]新熟女时代　　日剧　　低俗的电影名，不俗的内容。——[转评]离不开你但她却突然消失；你以为她可以追求但她却有男友；你以为她只喜欢你但她谁都可以；当你后悔想把她追回时她已嫁作人妇；你觉得她过于日常过于繁琐但失去后却发现日子没法继续。

雷神　　3D　　还行，有些画面挺好看的，但3D效果不是很好。

金馆长对金馆长对金馆长　　韩片，申贤俊经典的哈哈哈表情的电影

功夫熊猫2　　UME安贞影院　　还不错，武术打斗挺好玩的。

天国王朝　　电影频道佳片有约，领略宗教的力量

[推荐]初恋这件小事　　励志片，看完这片对泰国有很大改观。

创世纪　　效果还不错

天际浩劫

　　　　[推荐]三个大傻大闹宝莱坞　　在高铁上看的，好电影

太空运输

女巫季节　　

[推荐]深夜食堂(日剧、连续剧)　　很温馨，强烈推荐！

[推荐]泰诺星球 - 第一季　　我是科幻迷，非常好看

[推荐]斯巴达克斯 - 竞技场之神、血与沙　　

动漫

凯尔经的秘密　　宗教电影，画面很精美，不懂装懂中...

哈尔的移动城堡　　宫崎骏　　最喜欢里面的火——阿尔法特。

借东西的小人阿莉埃蒂　　宫崎骏　　守护传说

浪客剑心--追忆篇　　让我想起了甲贺忍法帖，凄美...

古城荆棘王　　梦幻由于某些介质也能成真。

书籍阅读

《历史是个什么玩意儿1》　　历史是死的，人是活的，就看怎么来说这事了。

　　《制胜策略》　　微软研发、制胜策略　　

《复乐园》　　渡边淳一的书，抛开里面情色部分，对老人的关注还是很值得参考的。让我想起了曾经在网吧当网管时老板娘的父亲找我要A片的事，请多多体谅身边的老年人:)

《走出软件作坊》　　书很好，里面谈到的问题很常见，适合成长中的团队。

《北京法源寺》　　李敖的小说，不敢妄加评论

《大败局2》　　了解中国政商文化，不做体验式的企业家。

《明朝那些事》　　共七部，以史为鉴。

《与"鬼"为邻》　　想了解日本的朋友不妨一看。

《电影中不可能的物理学》　　科幻迷必看书籍 :)

《激荡三十年》

户外游玩

云台山、郭亮洞　　十一跟的团，在绿野找的，非常漂亮！

说说语录

1. 女孩的胃都是葫芦胃吗？

　　　　吃一点就撑，过一会又饿了

　　2. 不管你投不投票，结果在那里，不改不变。

　　3. 乘客您好！车厢内人多拥挤，请没有挤下车的同志等候下站下车。

　　4. 空气是时间的执行者，腐蚀着这世间万物。

　　5. 山下的老虎是女人，遇见了千万要躲开

　　6. 交流不是只问不答，也不是不问也不答，如果仅此而已，只有搜索引擎愿意和你交流。

　　7. [生活小经验]早上起床很困？做20+个俯卧撑吧，效果谁做谁知道 :)

　　8. 味千：味道的味，老千的千。

　　9. 知道有知道的好处，不知道有不知道的好处；知道了就不能不知道了，但是不知道可以知道。

　　10. 坚持让普通人也能做平凡而伟大的事。

　　11. 我是争取帝。
　　　　总是争取这个、争取那个

重要事件

第一次个人购买正版软件　　2011-3-25

360版ESET NOD32

订婚　　2012-1-18（农历腊月25日）

今年去女朋友家过年，然后订婚。

还钱

2010年老家买房欠下的钱今年已经还掉三分之二。

Android翻译组

人数超过300人，官网搭建（开发者指南、API、开源项目、视频专区四个频道），多个合集发布。

工作

太平洋保险神行太保项目成功上线，实践证明俺是个靠谱的人 :)

新年展望

1. 至少在App市场上发布两款个人应用。

2. 尝试将翻译组现有模式（翻译-审核-发布-合集）转向Wiki模式，本身转向平台作用。

本文链接

Android应用开发提高系列（2）——《Practical Java 中文版》读书笔记（下）

2012-01-09T01:52:00Z

声明

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

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

　　　　农民伯伯： http://over140.cnblogs.com

系列

Android应用开发提高系列（1）——《Practical Java 中文版》读书笔记（上）

正文

　　注意：条目和用语可能与书籍有所出入，但尽量保持原样加一些自己的理解。

　　一、性能

1. 先把焦点放在设计、数据结构和算法身上

备注：良好的设计、明智的选择数据结构和算法可能比高效代码更重要。

2. 不要依赖编译器优化技术

3. 理解运行时(runtime)代码优化

备注：JIT将bytecode于运行时转换为本地二进制码，从而提高性能。因此编译后代码被执行次数越多，本机代码生成代价就很合算。

4. 连接字符串使用StringBuffer要比String快，尤其是大量字符串拼接

5. 将对象创建成本降至最小

备注：复用既有对象，不要创建非必要的对象，只在需要的时候才创建它们。

6. 将同步化(synchronization)降至最低

备注：如果synchronized函数抛出异常，则在异常离开函数之前，锁会自动释放。如果整个函数都需要被同步化，为了产生体积较小且执行速度较快的代码，请优先使用函数修饰符，而不是在函数内使用synchronized代码块。

7. 尽可能使用stack变量

备注：如果在函数中频繁访问成员变量、静态变量，可以用本地(local)变量替代，最后操作完后再赋值给成员/静态变量。

8. 尽可能的使用static、final和private函数

备注：此类函数可以在编译期间被静态决议(statically resolved)，而不需要动态议决(dynamic resolved)。（子类无法覆写）

9. 类的成员变量、静态变量都有缺省值，务须重复初始化

备注：记住，本地变量没有缺省值（例如函数内定义的变量）。

10. 尽可能的使用基本数据类型

备注：如int、short、char、boolean，使得代码更快更小。

11. 不要使用枚举器(Enumeration)和迭代器(Iterator)来遍历Vector

备注：使用for循环+get()

12. 使用System.arraycopy()来复制数组

备注：使用System.arraycopy()代替for循环，可以产生更快的代码。如：

        public void copyArray(int[] src, int[] dest) {
            int size = src.length;
            System.arraycopy(src, 0, dest, 0, size);
        }

System.arraycopy()是以native method实现的，可以直接、高效的移动原始数组到目标数组，因此它执行速度更快。

13. 优先使用数组，然后才考虑Vector和ArrayList，理由：

a).　　Vector的get()是同步的

b).　　ArrayList基本上就是一个非线程同步的Vector，比Vector要快

c).　　ArrayList和Vector添加元素或移除元素都需要重新整理数组。

备注：不要仅仅因为手上有个数不定的数据需要存储，就毫无选择的使用Vector或ArrayList。可以考虑创建一个足够大的数组，通常这样可能会浪费内存，但性能上的收益可能超过内存方面的代价。

14. 手工优化代码

a).　　剔除空白函数和无用代码

　　　　　　b).　　削减强度

备注：以更高效的操作替换成本昂贵的操作。一个常见的优化手法是使用复式复制操作符(如+=、-=)。

c).　　合并常量

备注：将变量声明为final，使得操作在编译器就进行。

d).　　删减相同的子表达式

备注：可用一个临时变量代替重复的表达式。

e).　　展开循环

备注：如循环次数少且已知循环次数，可展开去掉循环结构，直接访问数组元素。缺点是会产生更多代码。

f).　　简化代数

备注：使用数学技巧来简化表达式。（例如从1+..+100的问题）

g).　　搬移循环内的不变式

备注：循环内不变化的表达式可用移至循环外，不必重复计算表达式。

15. 编译为本机代码

备注：将程序的某部分编译为本机二进制代码，然后通过JNI访问。

二、多线程

1. 对于实例(instance)函数，同步机制锁定的是对象，而不是函数和代码块。

备注：函数或代码块被声明为synchronized并非意味它在同一时刻只能有一个线程执行（同一对象不同线程调用会阻塞）。Java语言不允许将构造函数声明为synchronized。

2. 同步实例函数和同步静态函数争取的是不同的locks。

备注：两者均非多线程安全，可以使用实例变量进行同步控制，如(byte[] lock = new byte[0])，比其他任何对象都经济。

3. 对于synchronized函数中可被修改的数据，应使之成为private，并根据需要提供访问函数。如果访问函数返回的是可变对象，那么可以先克隆该对象。

4. 避免无谓的同步控制

备注：过度的同步控制可能导致代码死锁或执行缓慢。再次提醒，当一个函数声明为synchronized，所获得的lock是隶属于调用此函数的那个对象。

5. 访问共享变量时请使用synchronized或volatile

备注：如果并发性很重要，而且不需要更新很多变量，则可以考虑使用volatile。一旦变量被声明为volatile，在每次访问它们时，它们就与主内存进行一致化。如果使用synchronized，只在取得lock和释放lock时候才一致化。

6. 在单一操作(single operation)中锁定所有用到的对象

备注：如果某个同步函数调用了某个非同步实例函数来修改对象，它是线程安全的。使用同步控制时，一定要对关键字synchronized所作所为牢记在心。它锁定的是对象而非函数或代码。

7. 以固定而全局性的顺序取得多个locks(机制)以避免死锁。P/181~P/185

备注：嵌入[锁定顺序]需要额外的一些工作、内存和执行时间。

8. 优先使用notifyAll()而非notify()

备注：notify()和notifyAll()用以唤醒处以等待状态的线程，waite()则让线程进入等待状态。notify()仅仅唤醒一个线程。

9. 针对wait()和notifyAll()使用旋转锁(spin locks)

备注：旋转锁模式(spin-lock pattern)简洁、廉价，而且能确保等待着某个条件变量的代码能循规蹈矩。

10. 使用wait()和notifyAll()替代轮询(polling loops)

备注：调用wait()时会释放同步对象锁，暂停（虚悬，suspend）此线程。被暂停的线程不会占用CPU时间，直到被唤醒。如：

            public void run()
            {
                int data;
                while(true){
                    synchronized (pipe) {
                        while((data = pipe.getDate()) == 0){
                            try{
                                pipe.waite();
                            }
                            catch(InterruptedException e){}
                        }
                    }

                    //Process Data
                }
            }

11. 不要对已锁定对象的对象引用重新赋值。

12. 不要调用stop()和suspend()

备注：stop()中止一个线程时，会释放线程持有的所有locks，有搅乱内部数据的风险；suspend()暂时悬挂起一个线程，但不会释放持有的locks，可能带来死锁的风险。两种都会引发不可预测的行为和不正确的行为。

当线程的run()结束时，线程就中止了运行。可以用轮询+变量来控制，如下代码：

            private volatile boolean stop;

            public void stopThread()
            {
                stop = true;
            }

            public void run()
            {
                while(!stop){
                    //Process Data
                }
            }

注意：这里使用了关键字volatile，由于Java允许线程在其私有专用内存中保留主内存变量的副本（可以优化），线程1对线程2调用了stopThread()，但线程2可能不会及时察觉到stop主内存变量已变化，导致不能及时中止线程。

三、类与接口

1. 实现一个final类(immutable class 不可变类)时，请遵循下列规则：

a).　声明所有数据为private

b). 只提供取值函数(getter)，不提供赋值函数(setter)

c). 在构造函数中设置有实例数据

d). 如果函数返回、接受引用final对象，请克隆这个对象。

e). 区别浅层拷贝和深层拷贝应用场景。如拷贝Vector需要使用深层拷贝。

2. 实现clone()时记得调用super.clone()

备注：不管是浅层拷贝还是深层拷贝都需要调用super.clone()。

3. 别只依赖finalize()清理内存以外的资源

备注：finalize()函数只有在垃圾回收器释放对象占用的空间之前才会被调用，回收时可能并非所有符合回收条件的对象都被回收，也无法保证是否被调用、何时调用。实现finalize()方法时记得调用super.finalize()。

4. 在构造函数内应避免调用非final函数，以免被覆写而改变初衷。

结束

书是从朋友那边借过来的，拿到手也有一段时间，磨磨唧唧好多天才看了几十页，而余下部分从上篇文章到这篇文章也不过才3-5天。发现以这种方式来看书也不错，一方面能加快速度，一方面由于要写文章更加认真细读，还能提炼把书读薄记录分享出来，实在是很适合我这样的 :)

本文链接

Android中文API（145） —— NotificationManager

2012-01-09T01:45:00Z

前言

本章内容android.app.NotifacationManager章节，版本为Android 4.0 r1，翻译来自："liliang1222"，再次感谢他！期待你一起参与翻译Android的相关资料，联系我over140@gmail.com。

声明

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

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

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

NotificationManager

译者署名： liliang1222

版本：Android 4.0 r1

结构

继承关系

public class NotificationManager extends Object

java.lang.Object

android.app.NotificationManager

类概述

该类用来向用户通知发生的事情。用来告诉用户在后台发生的某些事情。

通知有下列一些形式：

* 在状态栏中显示一个图片，可以通过launcher来访问（当用户点击该图片会启动一个预先定义好的intent）

* 打开或者闪烁设备上的LED灯

* 或者通知用户通过闪烁的背光灯、播放声音或者震动

每个通知方法接受一个整型的id，还有一个字符串的标签参数可选，该参数可以为空。这两个参数被用来组成一对（tag，id）或者如果标签没有指定则为（null，id）。这对参数用来在应用程序和系统中标识该通知。所以这对参数在你的程序中应该唯一。

如果你在通知方法时传递该参数对（tag，id）和一些新的通知参数，如果（tag，id）对应的通知应经在运行，则对应的通知会被更新。举个例子来说：如果你传递一个新的状态栏图片，状态栏中老的图片会被新的图片所替换。该（tag，id）也用来传递给cancel（Id）或者cancel（String，int）方法来清除这些通知。

NotificationManager不用实例化，可以通过getSystemService（String）方法来获得。

开发者指南：创建一个通知，请阅读Status Bar Notifications开发者指南。

公共方法

public void cancel (int id)

移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。

参数

id 通知的id

public void cancel (String tag，int id)

移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。

参数

tag 通知的标签

id 通知的id

public void cancelAll ()

移除所有的已经显示的通知，详细行为见cancel(int)。

public void notify (int id，Notification notification)

提交一个通知在状态栏中显示。如果拥有相同id的通知已经被提交而且没有被移除，该方法会用新的信息来替换之前的通知。

参数

id 应用中通知的唯一标识

notification 一个通知对象用来描述向用户展示什么信息，不能为空

public void notify (String tag，int id，Notification notification)

提交一个通知在状态栏中显示。如果拥有相同标签和相同id的通知已经被提交而且没有被移除，该方法会用更新的信息来替换之前的通知。

参数

tag 用来标识通知的字符串，可以为空。

id 应用中通知的唯一标识。

notification 一个通知对象用来描述向用户展示什么信息，不能为空。

补充

文章精选

Android中Notification详解【android进化三十五】

本文链接

Android开发指南(42) —— Adding Custom Suggestions

2012-01-06T03:02:00Z

前言

本章内容为 Android开发者指南的 Framework Topics/Search/Adding Custom 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-custom-suggestions.html

在本文中

关键类

SearchRecentSuggestionsProvider

相关示例

参阅

利用Android的搜索对话框或搜索widget，可以提供自定义搜索建议项，它的数据来源于应用程序自身。比如，假设应用程序是一个字典应用，可以把字典中最匹配已录入文本的单词作为建议项。由于能有效预测用户所查文本并能让用户直接获得字典中的释义，这种建议项是最有价值的。图1展示了使用自定义建议项的搜索对话框示例：

图1. 使用自定义对话框的搜索对话框截屏

一旦提供了自定义建议项，就可以同时让它应用于系统级的“快速搜索框”，从应用程序之外访问搜索内容。

在添加自定义建议项之前，需要先在应用程序中实现一个Android搜索对话框或搜索widget。如果还没有的话，请参阅创建搜索界面。

简介

如果用户选中了某个自定义建议项，Android系统将向搜索activity发送一个Intent。标准的搜索请求将会发送一个附带ACTION_SEARCH action的intent，不过仍可让自定义建议项使用ACTION_VIEW（或者任何其它action），并放入相应的选中建议项数据。接着上面的字典应用示例，用户选中一个建议项时，应用程序可以立即显示单词的释义，而不是去字典检索匹配项。

为了提供自定义建议项功能，请按以下步骤操作：

· 实现一个基本的搜索activity，如创建搜索界面所述。

· 修改搜索配置文件中有关content provider的信息，用于提供自定义建议项的数据。

· 建立存放建议项的数据表（比如在SQLiteDatabase库中），根据所需数据列定义表结构。

· 创建访问建议项数据表的Content Provider，并在manifest文件中声明provider。

· 声明Intent的类型，用户选中某个建议项时可用于发送数据（包括自定义action和自定义数据）。

当搜索对话框显示出来时，Android系统同时也会显示搜索建议项。需要提供的只是系统能从中读取建议项的content provider。如果对创建content provider还不很熟悉，请先阅读Content Providers开发者指南再往下继续吧。

一旦系统识别出activity支持搜索功能且已提供搜索建议项，用户键入搜索请求时会执行以下步骤：

1. 系统读取搜索请求文本（录入了多少就读取多少），并在存放建议项的content provider中进行检索。

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

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

显示完毕，将发生以下事情：

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

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

· 如果用户选中了某个建议项，带有自定义action和自定义数据的intent将会发送给搜索activity，应用程序可以打开建议项内容。

修改搜索配置文件

要加入对自定义建议项的支持，请在搜索配置文件的<searchable>元素中添加android:searchSuggestAuthority属性。例如：

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

</searchable>

根据建议项相关的intent类型，以及如何组织提交给content provider的请求文本，可能还需要用到其它一些属性。其它可选的属性将在后续章节中讨论。

创建Content Provider

要为自定义建议项创建content provider，需要具备content provider的相关知识，这在Content Provider开发者指南中描述。自定义建议项所需的content provider绝大部分都与其它content provider相同。不过，Cursor中对应每个建议项的数据行都必须包含系统可解析的数据列，用于组织建议项数据。

用户开始在搜索对话框或搜索widget里输入文本时，每键入一个字符，系统都将调用一次query()，并在content provider中检索建议项。在query()中，必须实现对content provider建议项数据的检索，并返回一个指向最佳建议项数据行的Cursor。

关于为自定义建议项创建content provider的详情，将在以下章节讨论：

处理建议项请求

系统如何向content provider发送请求及如何处理。

建立建议项数据表

如何定义数据列，系统用于在每次搜索时返回Cursor 。

处理建议项请求

当系统向content provider发送建议项检索请求时，将会调用content provider的query()方法。必须在该方法中实现搜索建议项数据并返回指向最匹配建议项的Cursor。

以下是系统传给query()方法的所有参数（按照调用顺序排列）：

uri

通常是content Uri，格式如下：

content://your.authority/optional.suggest.path/SUGGEST_URI_PATH_QUERY

系统的默认行为是传递URI并后跟搜索请求文本。例如：

content://your.authority/optional.suggest.path/SUGGEST_URI_PATH_QUERY/puppies

末尾的请求文本是用URI 编码规则编码过的，因此可能要在执行搜索前进行解码。

仅当搜索配置文件中用android:searchSuggestPath属性设置了路径时，URI中才要包含optional.suggest.path部分。只有多个搜索activity需共用同一个content provider时，才需要用到该配置。在这种情况下，需要解析建议项请求的来源。

注意：SUGGEST_URI_PATH_QUERY 并不属于URI的一部分，而应是用于指向此路径的常量。

projection

总为null

selection

该值由搜索配置文件中的android:searchSuggestSelection属性提供，如果未声明android:searchSuggestSelection属性则为null。更多使用信息请参见下文读取请求。

selectionArgs

如果已在搜索配置文件中声明了android:searchSuggestSelection属性，那么数组的第一个（也只有一个）元素包含了搜索请求。如果未声明android:searchSuggestSelection，则本参数将为null。更多使用信息请参见下文读取请求。

sortOrder

总为null。

系统可以用两种方式发送搜索请求文本。默认的方式是作为content URI路径的末尾部分（last segment）在uri参数中传递。不过，假如在搜索配置文件的android:searchSuggestSelection属性中包含了选项值，那么请求文本将作为字符串数组selectionArgs的第一个元素传递。这两种方式将在下文中一起讨论。

读取Uri中的搜索请求

默认情况下，请求文本是附加在uri参数（Uri对象）的末尾的。这时只要简单地用getLastPathSegment()即可读取请求文本了。例如：

String query = uri.getLastPathSegment().toLowerCase();

这将返回Uri的末尾部分（last segment），也就是用户录入的请求文本。

读取selection参数中的搜索请求

与URI不同，还可以采用更智能的方式，query()方法能够接收执行搜索所需的任何信息，selection和selectionArgs属性也能够传递合适的值。这种情况下，只要把SQLite查询语句作为android:searchSuggestSelection属性加入到搜索配置文件中去即可。在查询语句中，问号用作占位符，代表实际的查询请求。系统将用该查询语句作为selection参数，搜索请求作为selectionArgs数组的第一个元素，对query()进行调用。

以下是如何定义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.MyCustomSuggestionProvider"

android:searchSuggestIntentAction="android.intent.action.VIEW"

android:searchSuggestSelection="word MATCH ?">

</searchable>

通过以上配置，query()方法会把selection参数赋为"word MATCH ?" ，selectionArgs参数赋为搜索请求。当这些信息作为参数传给SQLite query() 方法时，会被组合在一起（问号由搜索请求文本代替）。如果选择以这种方式接收建议项请求并需要在请求文本中加入通配符，可以在selectionArgs参数的后面（或前面）加入即可，因为该值将用引号包裹并整体插入到问号所在位置。

以上例子中新出现的属性是android:searchSuggestIntentAction，用于定义用户每次选中建议项时所发送intent的action。这将在后续章节为建议项声明Intent讨论。

提示：如果不需要在android:searchSuggestSelection属性中定义查询语句，但还要在selectionArgs参数中接收请求文本，则只要简单地把android:searchSuggestSelection属性赋成非空值即可。这将导致请求文本传递给selectionArgs，并且selection参数可被忽略。这样就可以不用定义实际的底层查询语句，content provider也不必再对其进行处理。

建立建议项数据表

创建脱离数据库表的Cursor

如果搜索建议项不是按照系统要求的数据列存储在数据库表中的（比如SQLite表），那可以在每次发起请求时检索匹配的建议项数据并把它们格式化后保存到必要的表中。要实现这一目标，用系统要求的列名创建一个MatrixCursor，并用addRow(Object[])为每个建议项创建一行数据。Content Provider的query()方法将返回最终结果。

用Cursor向系统返回建议项时，每一行数据的列格式都是系统规定的。因此，无论是要把建议项数据存储在本地或Web服务器的SQLite数据库中，还是要以本地或web的其它格式存储，都必须把建议项格式化为表的一行数据，并用Cursor来表示。系统可以识别多个列，但有两列是必需的：

整数类型的行ID，唯一标识建议项。在ListView中显示建议项时，系统会用到该值。

SUGGEST_COLUMN_TEXT_1

代表建议项的字符串。

以下各列是可选的（大部分都会在后续章节中讨论）：

SUGGEST_COLUMN_TEXT_2

字符串。如果Cursor包含该列，那么所有的建议项都提供两行模式。本列中的字符串将会显示为第二行，它的字体较小并显示主建议项文本的下方。也可以为null或空串，表示没有第二行文本。

SUGGEST_COLUMN_ICON_1

drawable资源、content或文件URI串。如果Cursor包含该列，那么所有建议项都提供图标加文字模式，图标居左显示。该项可以为null或0，表示本行没有图标。

SUGGEST_COLUMN_ICON_2

drawable资源、content或文件URI串。如果Cursor包含该列，那么所有建议项都提供图标加文本模式，图标居右显示。该项可以为null或0，表示本行没有图标。

SUGGEST_COLUMN_INTENT_ACTION

intent action字符串。如果给定行中存在本列并且有值，那么此处定义的action将用于格式化建议项的intent。如果未提供本值，则会采用搜索配置文件中的android:searchSuggestIntentAction部分。如果所有建议项的action都是相同的，则更有效的方式是用android:searchSuggestIntentAction 指定action并省略本列。

SUGGEST_COLUMN_INTENT_DATA

数据URI字符串。如果给定行中存在本列并且有值，那么此值在格式化建议项时将作为intent的data部分来使用。如果未提供本值，则会采用搜索配置文件中的android:searchSuggestIntentData部分。如果前面两处都未提供值，则intent的data部分将为null。如果所有建议项的数据都是相同的，或者能用固定部分+ID来描述的，那么更有效的的方式是用android:searchSuggestIntentData指定，并省略本列。

SUGGEST_COLUMN_INTENT_DATA_ID

URI路径字符串。如果给定行中存在本列并且有值，那么“/”加上本值将会添加到intent的data之后。仅当搜索配置文件中的android:searchSuggestIntentData属性已经设置了适当的基础数据字符串时，本项才会用到。

SUGGEST_COLUMN_INTENT_EXTRA_DATA

任何数据。如果给定行中存在本列并且有值，则表示格式化建议项intent时需要用到的extra data。如果未提供本值，则intent的extra data部分为null。本列允许建议项附带额外的数据，包含于intent的EXTRA_DATA_KEY键内。

SUGGEST_COLUMN_QUERY

如果给定行中存在本列并且有值，则为格式化建议项请求时需要用到的数据，包含于intent的QUERY键内。当建议项的action是ACTION_SEARCH时需要用到本值，否则则是可选列。

SUGGEST_COLUMN_SHORTCUT_ID

仅当向“快速搜索框”提供建议项时才会用到。本列标明了搜索建议项是否要存储为快捷方式，以及是否需要验证有效性。快捷方式一般是在用户从“快速搜索框”中点击建议项时生成。如果本ID缺失的话，结果将会存储为快捷方式且不再会更新。如果设置为SUGGEST_NEVER_MAKE_SHORTCUT，结果将不会存储为快捷方式。否则，快捷方式的ID将用于检查并更新建议项，这时还会用到SUGGEST_URI_PATH_SHORTCUT.。

SUGGEST_COLUMN_SPINNER_WHILE_REFRESHING

仅用于向“快速搜索框”提供建议项。本列指明当“快速搜索框”内建议项的快捷方式更新后，是否用进度滚轮（spinner）替代SUGGEST_COLUMN_ICON_2所设的图标。

以上各列中的一部分将会在后续章节中继续讨论。

声明建议项所需的Intent

当用户在搜索对话框或widget下方的列表内选中某个建议项时，系统会向搜索activity发送一个自定义的Intent。intent必须定义好action和data部分。

声明intent的action

自定义建议项最常用的intent action是ACTION_VIEW，适用于要启动某些应用的场合，类似单词的释义、联系人信息、网页等。当然，intent action也可以是其它任何action，甚至每个建议项的action都可以不同。

根据全部建议项是否共用同一种intent action，可以用以下两种方式来定义action：

a. 利用搜索配置文件的android:searchSuggestIntentAction 属性来定义所有建议项的action。

例如：

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

android:searchSuggestIntentAction="android.Intent.action.VIEW" >

</searchable>

b. 利用SUGGEST_COLUMN_INTENT_ACTION 列来定义单个建议项的action。

在建议项表中添加SUGGEST_COLUMN_INTENT_ACTION 列，并把每个建议项所用到的action放入其中（类似"android.Intent.action.VIEW"）。

也可以混合使用以上两种方式。比如，可以包含android:searchSuggestIntentAction属性，为所有建议项提供默认action。然后在某些建议项的SUGGEST_COLUMN_INTENT_ACTION列中声明另一个action，以覆盖默认action。如果SUGGEST_COLUMN_INTENT_ACTION列中未包含值，将会采用android:searchSuggestIntentAction属性提供的intent。

注意：如果搜索配置文件中未包含android:searchSuggestIntentAction属性，则必须为每个建议项的SUGGEST_COLUMN_INTENT_ACTION列指定值，否则，intent将会启动失败。

声明intent的data

当用户选中一个建议项时，搜索activity将会接收到附带指定action（如上节所述）的intent，但该intent还必须同时携带data才行，这样搜索activity才能识别出选中的建议项。有一点尤为重要，data应该是能唯一标识每个建议项的信息，比如SQLite表中的行ID。在收到intent时，可以利用getData()或getDataString().来读取附带的data。

可以用以下两种方式来定义intent中的data：

a. 在建议项表的SUGGEST_COLUMN_INTENT_DATA列中为每个建议项都定义一个data。

在建议项表中包含SUGGEST_COLUMN_INTENT_DATA列，以便为每个intent 都提供必要的data信息，然后把每行的唯一信息填入。该列中的值将会原封不动地附加到intent 中。可以利用getData()或getDataString()来读取它们。

提示： 通常表的行ID最容易被用作Intent data，因为它总是唯一的。最简便的方式就是用SUGGEST_COLUMN_INTENT_DATA列名作为行ID的别名。具体示例请参阅支持检索的字典例程，其中SQLiteQueryBuilder创建了一个列名和别名的映射关系。

b. 把data URI分解为两部分：所有建议项公共的部分和每个建议项唯一的部分。把这两部分分别放入搜索配置文件的android:searchSuggestintentData属性和建议项表的SUGGEST_COLUMN_INTENT_DATA_ID 列中。

在搜索配置文件的android:searchSuggestIntentData属性中声明全部建议项公共的URI部分。例如：

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

android:searchSuggestIntentAction="android.intent.action.VIEW"

android:searchSuggestIntentData="content://com.example/datatable" >

</searchable>

然后在建议项表中的SUGGEST_COLUMN_INTENT_DATA_ID列中放入每个建议项的final path（唯一部分）。用户选中建议项后，系统会把android:searchSuggestIntentData中指定的字符串加上斜杠 ("/")，再加入各自SUGGEST_COLUMN_INTENT_DATA_ID列中的值，组成一个完整的content URI。然后就可以用getData()读取Uri 了。

附加更多的数据

如果需要在intent中表示更多信息，可以添加另一列SUGGEST_COLUMN_INTENT_EXTRA_DATA来存放与建议项相关的附加数据。在此列中存放的数据将被置于intent附带Bundle的EXTRA_DATA_KEY 部分中。

处理Intent

现在已经能利用自定义intent提供自定义的搜索建议项，用户选中某建议项时，需要用搜索activity来处理这些intent。在这之前，搜索activity已经对ACTION_SEARCH intent进行了处理。下面是如何在activity的onCreate()回调方法中处理intent的示例：

Intent intent = getIntent();

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

// 处理正常的搜索请求

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

doSearch(query);

} else if (Intent.ACTION_VIEW.equals(intent.getAction())) {

// 处理对建议项的点击操作（因为建议项都是使用ACTION_VIEW的）

Uri data = intent.getData();

showResult(data);

}

在上例中，intent action是ACTION_VIEW，并且通过组合android:searchSuggestIntentData字符串和SUGGEST_COLUMN_INTENT_DATA_ID列，数据已包含了指向建议项的完整URI。该URI传给本地的showResult()方法，对URI指定的建议项在content provider中执行查询。

注意：在Android manifest文件中，不需要对android:searchSuggestIntentAction属性或SUGGEST_COLUMN_INTENT_ACTION列设定的intent action添加intent 过滤器。系统将根据名称启动搜索activity并传递建议项的intent，因此activity不需要对可接受的action进行声明。

改写搜索请求文本

如果用户使用方向控制设备（比如轨迹球或d-pad）来浏览建议项列表，则默认情况下搜索请求文本不会被更新。不过可以暂时用当前焦点所在的建议项来改写用户请求文本，让它显示在搜索文本框中。这样就能让用户看到建议的请求文本（假如合适的话）并能在发送请求之前选中搜索框来编辑请求文本。

可以通过以下方式来改写搜索请求文本：

a. 在搜索配置文件中添加android:searchMode 属性，并赋值为"queryRewriteFromText" 。这种情况下，建议项表的SUGGEST_COLUMN_TEXT_1列中的内容将会用于改写请求文本。

b. 在搜索配置文件中添加android:searchMode 属性，并赋值为"queryRewriteFromData" 。这种情况下，建议项表的SUGGEST_COLUMN_INTENT_DATA列中的内容将会用于改写请求文本。这只适用于用户需要能看见URI或其它格式数据的场合，比如HTTP URL。内部的URI格式不应该使用这种方式来改写请求文本。

c. 在建议项表的SUGGEST_COLUMN_QUERY列内提供唯一的请求文本串。如果当前建议项的该列存在并且包含值，将被用于改写请求文本（并且覆盖上面的两种方式）。

向“快速搜索框”提供搜索建议项

一旦把应用程序配置成提供自定义搜索建议项的话，让它适用于全局访问的“快速搜索框”是很容易的，只要修改一下搜索配置文件，让其包含值为"true"的android:includeInGlobalSearch属性即可。

唯一要进行额外工作的情况，就是需要向content provider请求读权限的时候。这种情况下，需要添加<path-permission>元素，赋予“快速搜索框”对content provider的读权限。例如：

<provider android:name="MySuggestionProvider"

android:authorities="com.example.MyCustomSuggestionProvider"

android:readPermission="com.example.provider.READ_MY_DATA"

android:writePermission="com.example.provider.WRITE_MY_DATA">

<path-permission android:pathPrefix="/search_suggest_query"

android:readPermission="android.permission.GLOBAL_SEARCH" />

</provider>

在上例中，provider先规定了对content的读和写权限。<path-permission>元素修改了这个规定，当存在"android.permission.GLOBAL_SEARCH"权限时，允许对路径前缀为"/search_suggest_query"的内容进行读取访问。这样就对“快速搜索框”赋予向content provider查询建议项的权限。

如果content provider未明确指定读权限，默认情况下“快速搜索框”是可以读取其中内容的。

启用设备上的建议项

即使已经把应用程序配置为向“快速搜索框”提供建议项，缺省情况下也不会真正生效。是否要在“快速搜索框”中包含应用程序所提供的建议项，是需要由用户选择的。为了启用应用程序提供的搜索建议项，必须打开“可搜索的项”（在“搜索”的“搜索设置”菜单中）并指定应用程序为可搜索项。

每个可用于“快速搜索框”的应用程序都会在“可搜索的项”设置页面中有一个条目。条目中包含了应用程序名称和简要描述信息，这些信息描述了应用程序能够搜索并提交给“快速搜索框”作为建议项的内容。通过在搜索配置文件中添加android:searchSettingsDescription属性，可以定义可搜索应用程序的这些描述文字信息。例如：

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

android:searchSuggestIntentAction="android.intent.action.VIEW"

android:includeInGlobalSearch="true"

android:searchSettingsDescription="@string/search_description" >

</searchable>

android:searchSettingsDescription的值应该尽可能地简明扼要，能表明可搜索的内容即可。比如：音乐程序可以用“艺术家、专辑和音轨”，记事本程序则可用“已保存的记录”。提供这些描述信息是非常重要的，这样用户就知道有哪些建议项可用。当android:includeInGlobalSearch的值为“true”时，应该确保能包含该属性。

请记住，用户必须访问设置菜单并为应用程序启用搜索建议项，然后搜索建议项才能出现在“快速搜索框中”。因此，假如搜索是应用程序的重要特性之一，则可能需要考虑通过某种方式提醒用户进行设置——可以在第一次启动应用程序时提醒一下，告诉用户如何启用“快速搜索框”中的搜索建议项。

管理“快速搜索框”建议项的快捷方式

用户在“快速搜索框”选中的建议项可以自动变为快捷方式。这些快捷方式是系统从content provider中复制过来的建议项，这样就能快速访问建议项，而不必再次查询content provider。

默认情况下，“快速搜索框”所读取的全部建议项都能启用快捷方式。如果建议项数据经过一段时间后发生了变化，可以发起刷新快捷方式的请求。举例来说，如果建议项指向动态数据，比如联系人的在线状态，那就应该在显示给用户的时候刷新建议项的快捷方式。只要在建议项表中包含SUGGEST_COLUMN_SHORTCUT_ID列即可实现这一目标。利用该列可以把每个建议项的快捷方式配置为以下动作：

a. 让“快速搜索框”重新查询content provider ，以获取建议项快捷方式的最新版本。
在SUGGEST_COLUMN_SHORTCUT_ID列中指定一个值，每次显示快捷方式时都会去查询建议项的最新版本。刷新请求返回后，快捷方式将会与最新数据一起显示出来，这时建议项已经用最新信息刷新。刷新请求利用SUGGEST_URI_PATH_SHORTCUT的URI路径发送至content provider，（而不是SUGGEST_URI_PATH_QUERY）。
返回的Cursor应该包含数据列与原来相同的一条建议项，或者为空——表示快捷方式不可用了（这时，建议项将会消失，快捷方式也会被删除）。
如果建议项指向数据的刷新可能需要耗费很长时间，比如基于网络的的刷新，则可以在建议项表中添加SUGGEST_COLUMN_SPINNER_WHILE_REFRESHING列并赋值为“true”，这样刷新时就会显示为进度滚轮图标。除“true”以外的任何值都不会显示进度滚轮。

b. 完全阻止把建议项复制为快捷方式。
把SUGGEST_COLUMN_SHORTCUT_ID列赋值为SUGGEST_NEVER_MAKE_SHORTCUT。这时，建议项就不会复制为快捷方式了。仅当确实不想让以前复制过的建议项显示出来，才会这么做。（如果在该列中提供正常的值并重新调用的话，建议项快捷方式将在刷新请求返回后才显示出来。）

c. 使用默认的快捷方式动作。

建议项不会变化且可以保存为快捷方式，则保持SUGGEST_COLUMN_SHORTCUT_ID列为空即可。

如果建议项全都不会发生变化，那就根本不需要SUGGEST_COLUMN_SHORTCUT_ID列。

注意：上述值只是被视作应用程序的需求而已，“快速搜索框”有权最终确定是否建立建议项的快捷方式，它并不保证指定的建议项快捷方式动作一定会实现。

关于“快速搜索框”建议项的级别

一旦应用程序的搜索建议项能够用于“快速搜索框”，则“快速搜索框”将会对其评级，并确定如何根据请求把建议项展现给用户。这可能会依赖于有多少其它应用程序也对该请求返回了结果，也可能会根据用户选中哪个应用程序来返回结果的频度。建议项的评级并没有固定的规则，对于给定的搜索请求是否显示应用程序的建议项也是不能保证的。可以大致这么认为，高质量的结果会增加建议项显示在显著位置的可能性，而低质的建议项则更可能会获得较低的级别或者干脆就不会显示。

关于自定义搜索建议项的完整范例，请参阅支持检索的字典例程。

本文链接

Android应用开发提高系列（1）——《Practical Java 中文版》读书笔记（上）

2012-01-04T03:08:00Z

前言

从开始学习Android到现在，囫囵吞枣学了许多控件、布局的使用方法和技巧，看了许多相关的文章，也积累了不少项目经验。藉此通过归纳、总结和梳理相关知识，扎实基础，进一步提高Android开发技能。学好Android需要扎实的Java功底，所以将本文作为系列文章的开篇。本系列文章面向有一定Android开发经验的读者，欢迎交流！

声明

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

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

　　　　农民伯伯： http://over140.cnblogs.com

书籍

《Practical Java 中文版》　　03版　　侯捷、刘永丹译　　

本书和《Effective Java》，对前述重要而基础的技术细微处有着详尽、深刻、实用的介绍、剖析和范例，又以独立条款之姿展现，在内容的扎实度、可读性及易读性上的表现均十分良好。

本书围绕Java编程中遇到的实际问题展开。可以说书中所列专题正是那些令许多Java程序员困惑不已的FAQ。作者擅长采用恰如其分的示例来阐释问题，以平时的语言娓娓道出中肯的建议。这些建议往往一语中的，能直接融入编程工作中，可见它们确实是出自作者从实践中获得的真知灼见。

正文

注意：条目和用语可能与书籍有所出入，但尽量保持原样加一些自己的理解。

一、一般技术

1. Java唯一一种参数传递机制：by value（传值）。

备注：当参数为对象时，以传值方式传递对象的引用。（个人理解：传递指针的拷贝）

2. 对不变的data和object references使用final

备注：当声明一个对象为final时，不能改变其指向，但能改变其对象的值。

3. 缺省情况下所有非私有(non-private)、非静态(non-static)函数都可被覆写。

3.1　　如果函数不想被子类覆写，将函数声明为final即可。

　　　　　　3.2　　如果类不想被子类覆写，将类声明为final即可，从而禁止覆写该类所有函数。还能提高性能。

4. 在数组和Vectors之间慎重选择。

	数组	Vector
存储数据类型	基本类型、引用类型	引用类型
元素默认值	Yes	No
自动改变大小	固定不变	动态增长
速度快	Yes	No

备注： Vector内部实际是以数组实现的。

5. 多态优于instanceof，必要时才使用instanceof。

备注：例如从父类转型为派生类时，需要使用instanceof。

6. 一旦不需要的对象引用，就将它设为null。

备注：如果局部变量的引用使用完离函数结束前还需要执行较大代码，可在使用完后设置为null，以便或许能使其在垃圾回收器下次运行时被回收。

二、 对象与相等性

1. 区别 == 和 equals()

备注：请使用 == 测试两个基本类型是否完全相同，或测试两个对象引用是否指向同一个对象；使用equals()比较两个对象的内容是否相等。

2. 不要依赖equals()缺省实现

备注：所有Java对象都隐含继承了java.lang.Object，默认的equals()只是检查对象引用是否指向同一个对象。

3. 实现equals()建议：

3.1 请检查是否等于this

备注：测试是否指向同一个对象

3.2 优先考虑使用getClass()

备注：getClass()返回某个对象的运行期类(runtime class)。确保只有相同class所产生的对象才有机会被视为相等。范例：

    public class Base {

        @Override
        public boolean equals(Object obj) {
            if(obj != null && getClass() == obj.getClass()){
                //继续比较相等性或直接返回true
            }
            return false;
        }
    }

　　　　　　3.3 调用super.equals()唤起父类的相关行为

备注：当你为一个派生类撰写equals()时，你必须检查除java.lang.Object之外所有父类，看看它们是否都实现了equals()。如果有，那么一定要调用super.equals()。

3.4 在equals()函数中谨慎使用instanceof

备注：如果允许派生类和父类进行比较，可能要采用instanceof（getClass()会恒返回false）。注意instanceof类似于is-a语义，需要注意位置，即(子类 instanceof 父类 -> 返回true；反之为false)。

　　三、 异常处理

1. 认识异常流程机制

备注：try区段 -> [catch捕获区段][可选] -> finally终结区段。

2. 处理异常

如果异常产生却未被捕获，发生异常的线程将中断。处理异常：

a). 捕获并处理它，防止进一步传播。

b). 捕获并抛出一个新的异常给调用端。

备注：应确保新抛出的异常包含原异常相关信息，以保证不丢失重要信息。

c). 不捕获，任其传播给调用端。

输出错误信息：

a). 日志文件记录曾经发生过的异常

b). 输出异常

输出到标准错误串流：如e.printStackTrace()。

3. 防止出现异常覆盖

备注：如果在catch或finally区段又抛出了未捕获的异常，新的异常将覆盖try抛出的异常，只有一个异常可被传播到调用段。

4. throws子句

备注：提供throws子句的用意在于，提醒函数调用者，告知可能发生的异常。编译器会强迫调用端捕捉这些被列出的异常，所以不要再开发周期的最后才添加。

如果覆写对象（某个父类函数）没有抛出任何异常，那么覆写函数因为增加了代码而引发异常，那么你必须在新函数中捕捉异常并处理。

5. 使用finally避免资源泄漏

备注：finally区段代码无论是否发生异常都将执行，尤其适合维护对象内部状态和清理non-memory资源。

6. 使用建议：

a). 不要从try区段执行return、break或continue语句离开try区段

备注：如果try区段和finally区段都return 数据，将返回finally区段return的数据。

b). 将try/catch区段置于循环之外

备注：异常对代码性能产生负面影响

c). 不要将异常用于流程控制

d). 在构造函数中抛出异常

e). 抛出异常之前将对象恢复为有效状态

备注：考虑下次执行这段代码时会发生什么事情，代码是否还能正常运行。

结束

预计本系列前几篇文章为《Practical Java》和《Effective Java》的读书笔记，后续内容还在规划当中，也欢迎大家把感兴趣的内容反馈给我作为潜在的系列文章。

本文链接

Android开发指南(41) —— Searchable Configuration

2011-12-29T02:03:00Z

前言

本章内容为 Android开发者指南的 Framework Topics/Search/Searchable Configuration章节，译为"搜索配置文件"，版本为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/searchable-config.html

参阅

创建搜索界面

添加最近请求建议项

添加自定义建议项

为了能在Android系统的辅助下（发送搜索请求到activity并提供搜索建议项）实现搜索功能，应用程序必须提供一个XML格式的搜索配置文件。

本文描述了搜索配置文件的语法和使用方式。关于应用程序如何实现搜索特性的详细信息，在开发者指南的创建搜索界面中进行描述。

文件位置：

res/xml/filename.xml
Android用文件名作为资源ID。

语法：

<?xml version="1.0" encoding="utf-8"?>

<searchable xmlns:android="http://schemas.android.com/apk/res/android"

android:label="string resource"

android:hint="string resource"

android:searchMode=["queryRewriteFromData" | "queryRewriteFromText"]

android:searchButtonText="string resource"

android:inputType="inputType"

android:imeOptions="imeOptions"

android:searchSuggestAuthority="string"

android:searchSuggestPath="string"

android:searchSuggestSelection="string"

android:searchSuggestIntentAction="string"

android:searchSuggestIntentData="string"

android:searchSuggestThreshold="int"

android:includeInGlobalSearch=["true" | "false"]

android:searchSettingsDescription="string resource"

android:queryAfterZeroResults=["true" | "false"]

android:voiceSearchMode=["showVoiceSearchButton" | "launchWebSearch" | "launchRecognizer"]

android:voiceLanguageModel=["free-form" | "web_search"]

android:voicePromptText="string resource"

android:voiceLanguage="string"

android:voiceMaxResults="int"

<actionkey

android:keycode="KEYCODE"

android:queryActionMsg="string"

android:suggestActionMsg="string"

android:suggestActionMsgColumn="string" >

</searchable>

元素：

定义了Android系统为了支持搜索所需的全部搜索配置信息。

属性：

android:label

字符串资源。（必填项。）应用程序的名称。应该是与<activity> 或manifest中<application>元素的android:label属性相一致。仅当android:includeInGlobalSearch设为“true”时，用户才能看见本文本标签。这时标签用于标识本应用程序，并作为可搜索项显示在系统的搜索设置菜单中。

android:hint

字符串资源。（建议项。）在没有录入文字时，显示在搜索文本框中的文本。它向用户提示了可搜索的内容。为了与其它Android 应用保持一致，应该把android:hint定义的文本写成“搜索<内容-或-产品>”的格式。例如，“搜索歌曲和艺术家”或“搜索YouTube”。

android:searchMode

关键字。设置控制搜索显示的其它模式。目前可用的模式定义了自定义建议项获得焦点时搜索文本的改写方式。以下列出了可用的模式：

值	描述
"queryRewriteFromText"	用SUGGEST_COLUMN_TEXT_1 列中的值改写查询请求文本。
"queryRewriteFromData"	用SUGGEST_COLUMN_INTENT_DATA列中的值改写查询请求文本。仅当SUGGEST_COLUMN_INTENT_DATA中的值符合用户的要求并开始编辑时才会用到，典型的场合是HTTP URI 。

详情请参阅添加自定义建议项中关于改写请求文本的部分。

android:searchButtonText

字符串资源。显示在执行搜索按钮上的文本。默认情况下，按钮上会显示一个搜索图标（放大镜），这是理想的国际化方案。除非某些时候不是要执行搜索操作（比如Web浏览器中的URL请求），否则不应该使用本属性来改变按钮的显示。

android:inputType

关键字。定义了要使用的录入方式（比如软键盘）。大多数搜索都需要能录入任意字符，也就不必用到本属性。本属性可用值的清单请参阅inputType。

android:imeOptions

关键字。提供录入方式的其它选项。大多数搜索都需要能录入任意字符，也就不必用到本属性。缺省的IME 是“actionSearch”（在软键盘上提供“搜索”按钮并取代回车）。本属性可用值的清单请参阅imeOptions。

搜索建议项的属性

如果定义了content provider来提供搜索建议项，则需要定义更多的属性来对content provider的交互进行配置。当提供自定义建议项时，需要以下<searchable>属性：

android:searchSuggestAuthority

字符串。（提供搜索建议项时需要。）本属性值必须符合Android manifest文件中<provider>元素的android:authorities属性所提供的权限。

android:searchSuggestPath

字符串。该路径用作建议项请求Uri的组成部分，位于前缀和权限之后，但在标准建议项路径之前。仅当只有一个content provider来提供多种建议项时（比如不同数据类型），才需要用到该属性，并且需要采取必要措施来消除歧义的建议项请求（区分出不同的建议项请求）。

android:searchSuggestSelection

字符串。该值将作为selection参数传给查询函数。典型的情况是一个数据库WHERE语句，并应包含一个问号作为用户录入的实际查询字符的占位符（比如"query=?"）。当然也可以通过在selectionArgs参数中指定任何非空值来触发查询文本的传递（这样就会忽略selection参数）。

android:searchSuggestIntentAction

字符串。 用户点击自定义搜索建议项时（比如"android.intent.action.VIEW"）默认使用的intent action。如果未被选中建议项覆盖（通过SUGGEST_COLUMN_INTENT_ACTION列），则用户点击建议项时本属性值将被放入Intent的action部分。

android:searchSuggestIntentData

字符串。用户点击自定义搜索建议项时默认使用的intent data。如果未被选中建议项覆盖（通过SUGGEST_COLUMN_INTENT_DATA列），则用户点击建议项时本属性值将被放入Intent的data部分。

android:searchSuggestThreshold

整数。请求文本的字符数量至少要大于该数值才会触发建议项的查询。系统只保证不会向content provider 提交任何短于该阈值的查询请求。默认值是0。

关于以上搜索建议项属性的详情，请参阅开发者指南的添加最近请求建议项和添加自定义建议项部分。

“快速搜索框”的属性

为了让自定义建议项能被用于“快速搜索框”，需要以下<searchable> 属性：

android:includeInGlobalSearch

布尔值。（在“快速搜索框”中提供搜索建议项时需要。）如果建议项需被用于全局访问的“快速搜索框”，则设为“true”。用户还是必须先在系统的搜索配置菜单中启用应用程序对应的可搜索项，然后建议项才能出现在“快速搜索框”中。

android:searchSettingsDescription

字符串。为提交给“快速搜索框”的搜索建议项提供简要描述信息，这些信息将显示在应用程序对应的可搜索项条目中（搜索配置菜单内）。描述信息应该简要描述可搜索的内容。比如：音乐程序可以是“艺术家、专辑名和音轨”，记事本程序则可以是“已保存的记录”。

android:queryAfterZeroResults

布尔值。如果需要让content provider能够接受搜索请求的超集，则设置为“true”，这些请求在以前搜索时返回结果为零。比如，如果content provider对“bo”返回0个结果，则应该要搜索“bob”。如果设为“false”，同一个会话中将忽略超集（“bob”将不会再次发起请求）。不过这只会维持至搜索对话框生命周期结束，如果使用搜索widget则是到activity生命周期结束（当搜索对话框或activity重新被打开时，“bo”会再次向content provider提交请求）。默认值是false。

语音搜索的属性

为了启用语音搜索功能，需要以下<searchable>属性中的一些：

android:voiceSearchMode

关键字。（提供语音搜索功能时需要。）启用语音搜索功能，并同时指定搜索模式。（某些设备可能不支持语音搜索，那这些标记就无效。）可以接受以下模式值：

值	描述
"showVoiceSearchButton"	如果设备支持语音搜索，则显示一个语音搜索按钮。如果设置此值，则必须同时设置"launchWebSearch"或"launchRecognizer"（用管道符“\|”分隔）。
"launchWebSearch"	语音搜索按钮让用户直接使用内置的语音web搜索activity。绝大部分应用程序不需要用到本标记，因为它会使得用户离开提交搜索的当前activity。
"launchRecognizer"	语音搜索按钮让用户直接使用内置的录音activity。该activity将会引导用户说话，把语音转译为文本，并把结果作为请求文本提交给搜索activity，就如同用户在搜索界面录入并点击搜索按钮一样。

android:voiceLanguageModel

关键字。语音识别系统使用的语言模式。可接受以下值：

值	描述
"free_form"	语音识别使用自由模式（free-form）。这种模式主要是为英语优化的。这是缺省值。
"web_search"	语音识别使用web检索词（web-search-term）模式，用于简短的、类似检索关键词的短语。该模式可用的语言比上述自由模式“free_form”多一些。

详情请参阅EXTRA_LANGUAGE_MODEL。

android:voicePromptText

字符串。 显示在语音输入对话框中的其它信息。

android:voiceLanguage

字符串。 期望的语言，用Locale中的字符串常量表示（比如“de”表示德语，“”表示法语）。仅当所用语言与Locale.getDefault()获得的当前值不同时，才需要用到本值。

android:voiceMaxResults

整数。 指定最多返回几个结果，其中的“最佳”结果将用于ACTION_SEARCH intent的主要请求文本。本值必须大于等于1。用EXTRA_RESULTS可以从intent获取这些结果。如果未提供本值，则语音识别程序将会确定返回结果的数量。

为搜索action指定一个设备上的按键及动作。在触摸屏幕按钮时，根据当前搜索请求或当前获得焦点的建议项，搜索action将能执行设定的操作。比如，联系人应用程序在按下通话按钮时能够执行启动电话的搜索action，与当前获得焦点的联系人建议项进行通话。

并不是每台设备都支持全部的action键，也不是所有键都允许用这种方式覆盖。比如，“Home”键就不行，它必须保证能返回初始屏幕。还必须确保不要指定为录入搜索请求时可能会用到的键。本属性基本上仅限于指定为通话按钮和菜单按钮。请记住action键通常不是很显眼，因此不应该把它作为核心功能来提供给用户。

必须定义android:keycode来指定键，并至少要同时指定另外三个属性中的一个，才能完成搜索action的定义。

属性：

android:keycode

字符串。（必填项）KeyEvent中定义的键值，代表所响应的action键（比如“KEYCODE_CALL”）。本值将附在ACTION_SEARCH intent中传递给搜索activity。用getIntExtra(SearchManager.ACTION_KEY)可以获取本值。并非所有键都可用于搜索action，多数键是用于录入键盘或者系统功能键的。

android:queryActionMsg

字符串。 在用户录入搜索请求文本时，按下action键所附带的action信息。本值将附在ACTION_SEARCH intent中传递给搜索activity。用getStringExtra(SearchManager.ACTION_MSG)可以获取本值。

android:suggestActionMsg

字符串。 在建议项获得焦点时，按下action键所附带的action信息。本值将附在系统传递给搜索activity 的intent中（使用预先定义的建议项对应的action）。用getStringExtra(SearchManager.ACTION_MSG)可以获取本值。仅当所有建议项都支持本action 键时才能使用本属性。如果不是所有建议项都能处理同一个action键，必须换用下面的android:suggestActionMsgColumn属性。

android:suggestActionMsgColumn

字符串。 content provider中的数据列名，用于提供本action键对应的action信息，在建议项获得焦点时，按下action键将发送该action信息。本属性可以控制每个建议项各自的action 键，content provider中的每一条数据都有自己的action 信息。本属性可以取代android:suggestActionMsg属性，因为它为所有建议项指定相同的action信息。

首先，必须在content provider中为每个建议项定义数据列，用于提供action信息，然后在本属性中给出列名。系统会用本属性给出的字符串在建议项cursor中查找，选中action信息列，并读取Cursor 中的action信息。本值将附在系统传递给搜索activity 的intent中（使用预先定义的建议项对应的action）。用getStringExtra(SearchManager.ACTION_MSG)可以获取本值。如果选定建议项对应的数据不存在，action键将被忽略。

示例：

保存于res/xml/searchable.xml的XML文件：

<?xml version="1.0" encoding="utf-8"?>

<searchable xmlns:android="http://schemas.android.com/apk/res/android"

android:label="@string/search_label"

android:hint="@string/search_hint"

android:searchSuggestAuthority="dictionary"

android:searchSuggestIntentAction="android.intent.action.VIEW"

android:includeInGlobalSearch="true"

android:searchSettingsDescription="@string/settings_description" >

</searchable>

本文链接