[2021.02.23][Java语言学习]注解

1. 注解的作用

注解有三个作用,分别体现在三个阶段。

  • 第一个阶段是编译阶段,注解可以给编译器提供信息,根据这些信息,编译器可以采取相应的行动,例如检查错误或者取消警告等等。
  • 第二个阶段是编译和部署阶段,在这个过程中,编译器可以根据注解使用反射的手段生成特定的代码。
  • 第三个阶段是运行时,有些注解可以指定在运行时奏效,根据这些注解不同的规则措施等会被应用到程序中。

2. 注解的使用场景

注解的使用场景包括两个:

  • 类,类的成员,变量,方法等等。
  • 类型检测,在定义变量的时候采用注解,可以提供变量有效性合法性的检测,使得程序更加健壮。

3. 注解的定义

注解是一种特殊的接口,与接口定义的形式类似,包括注解名和注解成员,形式如下:

(public) @interface Annotation{
    Type annoMember();
}

在定义注解时,访问控制修饰符只能为public或者package-default

而且注解内的成员只能为特定类型的,包括(参考这篇文章):

  • 所有基本数据类型
  • String
  • Class类型
  • enum类型
  • Annotation类型
  • 以上所有类型的数组形式

4. Java环境中预定义的注解

java.lang包中五个预定义的注解:

注解 使用场景、方法等
@Override 在子类当中对父类中的某个方法进行重写,通过这个注释,编译器可以判断是否确实为方法重写
@SuppressWarning 取消警告,包括两种:unchecked和deprecated,形式为@SuppressWarning("unchecked","deprecation")
@SafeVarargs 用于屏蔽函数当中的参数未检查警告
@Deprecated 用于表明某个变量、方法等等已经不再维护了,在对代码进行@Deprecated注解的时候,需要在/** sth */文档说明中添加@deprecated
@FunctionalInterface 用于表明某个接口作为一个功能性接口而存在,即接口中只存在一个方法声明。

java.lang.annotation包中有六个预定义的注解,这六个注解使用在其他注解之上,用于指定其他注解的特征:

注解 使用场景、方法等
@Documented 用于告知javadoc程序,某个注解要放到自动生成javadoc文件中
@Repeatable 用于指明某个注解是可以重复使用的
@Inherited 如果某个类写携带了使用@Inherited注解的注解,那么这个类的子类也同样会携带
@Retention 一个注解可以体现在不同的阶段,通过@Retention指定某个注解在哪个阶段可以使用,有三个阶段:
· RetentionPolicy.SOURCE
· RetentionPolicy.CLASS
· RetentionPolicy.RUNTIME
@Native 用于表明某个变量可能由native代码调用
@Target 指定注解可以用在程序的哪个片段,包括8中引用场景:
· ElementType.ANNOTATION_TYPE
· ElementType.Field
· ElementType.Method
· ElementType.Class
· ElementType.Package
· ElementType.Constructor
· ElementType.LOCAL_VARIABLE
· ElementType.PARAMETER

5. 类型注解

6. 重复注解

重复注解的形式如下:

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

推荐阅读更多精彩内容