Java自定义注解

概念

  • 作用在类、方法、成员变量上
  • 业务逻辑无关,有类似切面的概念,起辅助作用
  • 可以在编译和运行时起作用

作用

  • 生成文档。@Param, @Return, @Author, 这些是出现在注释里的
  • 编译时检查,如@Override 注在方法上会检查该方法是否覆盖了超类方法
  • 执行特定切面逻辑如 @Entity, @Transactional

原理

  • 本质是一个继承了Annotation的特殊接口,特殊之处在于 定义时用 public @interface AnnotationName
    • @interface 会标志该自定义接口 继承 java.lang.Annotation 接口
  • 再简化上面这句话,即注解是一种接口,而且是特殊接口
  • 既然是接口, 那实际运行时就会是其实现类,而且该实现类我们未定义
  • 注解的实现类是 Java runtime 生成的动态代理对象$Proxy1,
  • 而且,通过扫描所有类,反射判断其是否有annotation,然后创建代理
  • 且代理是JDK 面向接口的代理
  • 通过代理对象Proxy instance 调用 自定义注解(接口)中的方法,最终调用AnnotationInvocationHandler的invoke方法

元注解

  • java.lang.annotation提供4种元注解,注解自定义注解
    • @Documented- 注解是否包含在JavaDoc中??
    • @Retention- 在哪个阶段起作用,结束这个阶段就可以丢弃了,标志注解的生命周期
      • RetentionPolicy.SOURCE, 编译期间起作用,编译结束后不再有任何意义,编译后丢掉不会写入字节码
        • @Override, @SuppressWarnings
      • RetentionPolicy.CLASS, 在类加载时候起作用,在字节码中存在且被需要,类加载结束则被丢弃,运行时获取不到该注解注解默认声明周期
      • Retention.RUNTIME, 始终不丢弃,运行前保留
        • 反射机制终于可以起到作用了,可以读取该注解
        • 我们自定义注解一般使用这种方式
    • @Target- 注解用于什么地方
      • ElementType.Type, 用于接口(包括注解类型)、类、enum
        • 如 @Entity,@Controller, @Target
      • ElementType.METHOD,
        • 如 @Override
      • ElementType.PARAMETER, 方法参数
        • 如 @RequestParam, @RequestBody
    • @Inherited- 类A被注解了,且该注解标明了@Inherited ,那A的子类会同样被注解,继承性

注解分类

  • 标记类注解,如@Override,@Deprecated, 联想 标记接口,如Serializable,Cloneable
  • 非标记接口

自定义注解的规则

  • 类型定义 @interface,且 不能 再去继承其他接口
  • 参数成员只能用 public 联想,注解本质就是一个接口
  • 参数成员只能是 8 大基本类型和String、Enum、Class、Annotation及 这些类型的数组
  • 要获取类、方法、字段的注解信息,必须通过反射
  • 注解也可以没有定义成员,如标记类注解

总结

  • 注解就是一种标志、判断作用,
  • 与@Override 类标记注解不同,Retention.RUNTIME 类注解是在 运行时起 标记作用,从而对其标志的对象(类、变量、方法等)来添加逻辑
  • 为了更好的规定如何对标志对象增强逻辑,在自定义注解类中添加变量进一步作为判断
  • 联想 @RequestMapping(method=GET), @Transactional(isolation=true) 等
  • 即,运行时标记
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容

  • 深入理解Java:注解(Annotation)自定义注解入门 要深入学习注解,我们就必须能定义自己的注解,并使用注...
    _npc_阅读 530评论 0 0
  • 在很多框架中都使用了自定义注解,之前在项目中也用到了自定义注解来对代码做一些解耦,今天就给大家介绍下自定义注解的使...
    monkey01阅读 5,781评论 1 8
  • 本文章涉及代码已放到github上annotation-study 1.Annotation为何而来 What:A...
    zlcook阅读 28,923评论 15 116
  • 一 简介注解是Java 1.5引入的,可以提供代码的额外信息,目前正在被广泛应用。除了Java内置注解,我们也可以...
    Diffey阅读 9,693评论 1 11
  • 什么是注解(Annotation):Annotation(注解)就是Java提供了一种元程序中的元素关联任何信息和...
    九尾喵的薛定谔阅读 3,077评论 0 2