Java编程思想15——注解

注解(也被称为元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以 在稍后某个时刻非常方便地使用这些数据。

注解在一定程度上是在把元数据与源代码文件结合在一起,而不是保存在外部文档中这一 大的趋势之下所催生的。

注解可以提供用来完整地描述程序所需的倌息,而这些信息是无法用Java来表达的。因此,注解使得我们能够以将由编译器来测试和验证的格式,存储有关程序的额外信息。注解可以用来生成描述符文件,甚至或是新的类定义,并且有助于减轻编写“样板”代码的负担。通过使用注解,我们可以将这些元数据保存在 Java源代码中,并利用annotationAPI为自己的注解构造处理工具,同时,注解的优点还包括:更加干净易读的代码以及编译期类型检查等。

1.基本语法

1.1 定义注解

定义注解时,会需要一些元注解 (meta-annotation) ,如@Target和@Retention。@Target用来定义你的注解将应用于什么地方 (例如是一个方法或者一个域)。@Rectetion用来定义该注解在哪一个级别可用,在源代码中(SOURCE)、类文件中(CLASS)或者运行时(RUNTIME)。

在注解中,一般都会包含一些元素以表示某些值。当分析处理注解时,程序或工具可以利用这些值。注解的元素在使用时表现为名-值对的形式

没有元素的注解称为标记注解(markerannotation) 。

1.2 元注解

Java 目前只内置了三种标准注解(@Override,@Deprecated, @SuppressWarnings), 以及四种元注解。


大多数时候, 程序员主要是定义自己的注解, 并编写自己的处理器来处理它们。

2.编写注解处理器

使用注解的过程中, 很重要的一个部分就是创建与使用注解处理器。Java'SE5扩展了反射机制的API, 以帮助程序员构造这类工具。 同时, 它还提供了一个外部工具apt帮助程序员解析带有注解的Java源代码。

2.1 注解元素

注解元素可用的类型如下所示:

  • 所有基本类型 (int, float, boolean等)
  • String
  • Class
  • enum
  • Annotation
  • 以上类型的数组

2.2 默认值限制

编译器对元素的默认值有些过分挑剔。

  • 首先,元素不能有不确定的值。 也就是说,元素必须要么具有默认值, 要么在使用注解时提供元素的值。
  • 其次,对于非基本类型的元素,无论是在源代码中声明时, 或是在注解接口中定义默认值
    时,都不能以null作为其值。 这个约束使得处理器很难表现一个元素的存在或缺失的状态,因为在每个注解的声明中, 所有的元素都存在,并且都具有相应的值。 为了绕开这个约束,我们只能自己定义一些特殊的值, 例如空字符串或负数, 以此表示某个元素不存在。

2.3 生成外部文件

有些framework需要一些额外的信息才能与你的源代码协同工作,而这种情况最适合注解表现其价值了。

Web Service、自定义标签库以及对象/关系映射工具等, 一般都需要XML描述文件,而这些描述文件脱离于源代码之外。

如果使用注解的话, 你可以将所有信息都保存在JavaBean源文件中。

变通之道

2.4 注解不支持继承

2.5 实现处理器

3.使用apt处理注解

JDK7已经移除了apt和mirror API,取代 APT 的是更优的 JSR 269 API - "Pluggable Annotation Processing API".

4.将观察者模式用于apt

5.基于注解的单元测试

参考JUnit教程

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,188评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,464评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,562评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,893评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,917评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,708评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,430评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,342评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,801评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,976评论 3 337
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,115评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,804评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,458评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,008评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,135评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,365评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,055评论 2 355

推荐阅读更多精彩内容