Java自定义注解Annotation的实现原理
文章目录
- 1、什么是注解?
- 2、注解的用处:
- 3、注解的原理:
- 4、元注解:
- 5、常见标准的Annotation:
- 6、自定义注解:
- 7、自定义注解实例:
1、什么是注解?
对于很多初次接触的开发者来说应该都有这个疑问?Annontation是Java5开始引入的新特征,中文名称叫注解。它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。为程序的元素(类、方法、成员变量)加上更直观更明了的说明,这些说明信息是与程序的业务逻辑无关,并且供指定的工具或框架使用。Annontation像一种修饰符一样,应用于包、类型、构造方法、方法、成员变量、参数及本地变量的声明语句中。
Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。注解不会也不能影响代码的实际逻辑,仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。
2、注解的用处:
1、生成文档。这是最常见的,也是java 最早提供的注解。常用的有@param @return 等
2、跟踪代码依赖性,实现替代配置文件功能。比如Dagger 2 依赖注入,未来java 开发,将大量注解配置,具有很大用处;
3、在编译时进行格式检查。如@override 放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出。
3、注解的原理:
注解本质是一个继承了Annotation 的特殊接口,其具体实现类是Java 运行时生成的动态代理类。而我们通过反射获取注解时,返回的是Java 运行时生成的动态代理对象$Proxy1。通过代理对象调用自定义注解(接口)的方法,会最终调用AnnotationInvocationHandler 的invoke 方法。该方法会从memberValues 这个Map 中索引出对应的值。而memberValues 的来源是Java 常量池。
4、元注解:
java.lang.annotation
提供了四种元注解,专门注解其他的注解(在自定义注解的时候,需要使用到元注解):
@Documented
– 注解是否将包含在JavaDoc中
@Retention
– 什么时候使用该注解
@Target
– 注解用于什么地方
@Inherited
– 是否允许子类继承该注解
1.)@Retention
– 定义该注解的生命周期
● RetentionPolicy.SOURCE
: 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义,所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
● RetentionPolicy.CLASS
: 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式
● RetentionPolicy.RUNTIME
: 始终不会丢弃,运行期也保留该注解,因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。
2.)Target
– 表示该注解用于什么地方。默认值为任何元素,表示该注解用于什么地方。可用的ElementType 参数包括
● ElementType.CONSTRUCTOR
: 用于描述构造器
● ElementType.FIELD
: 成员变量、对象、属性(包括enum实例)
● ElementType.LOCAL_VARIABLE
: 用于描述局部变量
● ElementType.METHOD
: 用于描述方法
● ElementType.PACKAGE
: 用于描述包
● ElementType.PARAMETER
: 用于描述参数
● ElementType.TYPE
: 用于描述类、接口(包括注解类型) 或enum声明
3.)@Documented
– 一个简单的Annotations 标记注解,表示是否将注解信息添加在java 文档中。
4.)@Inherited
– 定义该注释和子类的关系
@Inherited 元注解是一个标记注解,@Inherited 阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited 修饰的annotation 类型被用于一个class,则这个annotation 将被用于该class 的子类。
5、常见标准的Annotation:
1)@Override
java.lang.Override 是一个标记类型注解,它被用作标注方法。它说明了被标注的方法重载了父类的方法,起到了断言的作用。如果我们使用了这种注解在一个没有覆盖父类方法的方法时,java 编译器将以一个编译错误来警示。
2)@Deprecated
Deprecated 也是一种标记类型注解。当一个类型或者类型成员使用@Deprecated 修饰的话,编译器将不鼓励使用这个被标注的程序元素。所以使用这种修饰具有一定的“延续性”:如果我们在代码中通过继承或者覆盖的方式使用了这个过时的类型或者成员,虽然继承或者覆盖后的类型或者成员并不是被声明为@Deprecated,但编译器仍然要报警。
3)@SuppressWarnings
SuppressWarning 不是一个标记类型注解。它有一个类型为String[] 的成员,这个成员的值为被禁止的警告名。对于javac 编译器来讲,被-Xlint 选项有效的警告名也同样对@SuppressWarings
有效,同时编译器忽略掉无法识别的警告名。
@SuppressWarnings(“unchecked”)
6、自定义注解:
自定义注解类编写的一些规则:
1、Annotation 型定义为@interface, 所有的Annotation 会自动继承java.lang.Annotation这一接口,并且不能再去继承别的类或是接口.
2、参数成员只能用public 或默认(default) 这两个访问权修饰
3、参数成员只能用基本类型byte、short、char、int、long、float、double、boolean八种基本数据类型和String、Enum、Class、annotations等数据类型,以及这一些类型的数组.
4、要获取类方法和字段的注解信息,必须通过Java的反射技术来获取 Annotation 对象,因为你除此之外没有别的获取注解对象的方法
5、注解也可以没有定义成员,,不过这样注解就没啥用了
PS:自定义注解需要使用到元注解
7、自定义注解实例:
FruitName.java
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;/*** 水果名称注解*/
@Target(FIELD)
@Retention(RUNTIME)
@Documented
public @interface FruitName {String value() default "";
}
FruitColor.java
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;/*** 水果颜色注解*/
@Target(FIELD)
@Retention(RUNTIME)
@Documented
public @interface FruitColor {/*** 颜色枚举*/public enum Color{ BLUE,RED,GREEN};/*** 颜色属性*/Color fruitColor() default Color.GREEN;}
FruitProvider.java
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.RetentionPolicy.RUNTIME;/*** 水果供应者注解*/
@Target(FIELD)
@Retention(RUNTIME)
@Documented
public @interface FruitProvider {/*** 供应商编号*/public int id() default -1;/*** 供应商名称*/public String name() default "";/*** 供应商地址*/public String address() default "";
}
FruitInfoUtil.java
import java.lang.reflect.Field;/*** 注解处理器*/
public class FruitInfoUtil {public static void getFruitInfo(Class<?> clazz){String strFruitName=" 水果名称:";String strFruitColor=" 水果颜色:";String strFruitProvicer="供应商信息:";Field[] fields = clazz.getDeclaredFields();for(Field field :fields){if(field.isAnnotationPresent(FruitName.class)){FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class);strFruitName=strFruitName+fruitName.value();System.out.println(strFruitName);}else if(field.isAnnotationPresent(FruitColor.class)){FruitColor fruitColor= (FruitColor) field.getAnnotation(FruitColor.class);strFruitColor=strFruitColor+fruitColor.fruitColor().toString();System.out.println(strFruitColor);}else if(field.isAnnotationPresent(FruitProvider.class)){FruitProvider fruitProvider= (FruitProvider) field.getAnnotation(FruitProvider.class);strFruitProvicer=" 供应商编号:"+fruitProvider.id()+" 供应商名称:"+fruitProvider.name()+" 供应商地址:"+fruitProvider.address();System.out.println(strFruitProvicer);}}}
}
Apple.java
import test.FruitColor.Color;/*** 注解使用*/
public class Apple {@FruitName("Apple")private String appleName;@FruitColor(fruitColor=Color.RED)private String appleColor;@FruitProvider(id=1,name="陕西红富士集团",address="陕西省西安市延安路89号红富士大厦")private String appleProvider;public void setAppleColor(String appleColor) {this.appleColor = appleColor;}public String getAppleColor() {return appleColor;}public void setAppleName(String appleName) {this.appleName = appleName;}public String getAppleName() {return appleName;}public void setAppleProvider(String appleProvider) {this.appleProvider = appleProvider;}public String getAppleProvider() {return appleProvider;}public void displayName(){System.out.println("水果的名字是:苹果");}
}
FruitRun.java
/*** 输出结果*/
public class FruitRun {public static void main(String[] args) {FruitInfoUtil.getFruitInfo(Apple.class);}
}
运行结果是:
水果名称:Apple水果颜色:RED供应商编号:1 供应商名称:陕西红富士集团 供应商地址:陕西省西安市延安路89号红富士大厦
Java自定义注解Annotation的实现原理相关推荐
- java自定义注解annotation记录操作日志
说到注解我们平常用的可以说非常多啦,说几个常用的的注解 @RestController @Service @Autowired 这些都是我们平常使用spring框架最常见的注解了,我们只知道它们非常好 ...
- java中注解动态传参_Java自定义注解源码+原理解释(使用Java自定义注解校验bean传入参数合法性)...
Java自定义注解源码+原理解释(使用Java自定义注解校验bean传入参数合法性)java 前言:因为前段时间忙于写接口,在接口中须要作不少的参数校验,本着简洁.高效的原则,便写了这个小工具供本身使 ...
- springboot项目中自定义注解的使用总结、java自定义注解实战(常用注解DEMO)
初学spring的时候使用注解总觉得使用注解很神奇,加一个注解就能实现想要的功能,很好奇,也想自己根据需要写一些自己实现的自定义注解.问题来了,自定义注解到底是什么?肯定会有人和我一样有这个疑惑,我根 ...
- java自定义注解实现前后台参数校验
其实是可以通过@Constraint来限定自定义注解的方法. @Constraint(validatedBy = xxxx.class) 下面是我做的 java自定义注解实现前后台参数校验 的代码示例 ...
- java自定义注解类
一.前言 今天阅读帆哥代码的时候,看到了之前没有见过的新东西, 比如java自定义注解类,如何获取注解,如何反射内部类,this$0是什么意思? 于是乎,学习并整理了一下. 二.代码示例 import ...
- spring中自定义注解(annotation)与AOP中获取注解___使用aspectj的@Around注解实现用户操作和操作结果日志
spring中自定义注解(annotation)与AOP中获取注解 一.自定义注解(annotation) 自定义注解的作用:在反射中获取注解,以取得注解修饰的类.方法或属性的相关解释. packag ...
- Java 自定义注解及使用场景
文章目录 1 什么是注解(Annotation) 2 元注解 2.1 @Target 2.2 @Retention 2.3 @Repeatable 2.4 @Inherited 示例1 反射获取注解 ...
- Java 自定义注解简单使用
Java 自定义注解简单使用 文章目录 Java 自定义注解简单使用 第一步:在 pom.xml 下引入反射框架 第二步:自定义注解 第三步:写两个测试实体类 第四步:写个工具类扫描被注解的类(核心) ...
- Java基础 --- 注解 Annotation
Java基础 --- 注解 Annotation Java注解 Java自带的标准注解 自定义注解 Java注解 Java注解它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadat ...
最新文章
- MBProgressHUD 使用详解
- Grpc+Grpc Gateway实践二 有些复杂的Hello World
- java thread join_java中thread的join方法为什么能让线程插队
- mini2440 uboot使用
- mongodb first
- 达观数据分析平台架构和Hive实践
- mysql mgr简介_mysql8.0初探:(二)MySQL Group Replication-MGR集群简介
- 算法—回溯法桥本分数式
- java hibernate 插入数据_[Java教程]hibernate 返回新插入数据的Id
- 面试官问我什么是「栈」,我随手画了 10 张图来解释
- 换种思路去理解设计模式(上)
- 十二月份找工作好找吗_人民大学在职研究生将来好找工作吗?
- 只要7步,就能将任何魔方6面还原(留着以后教孩子玩)
- Java学习者常用软件与学习网站
- Python爬虫爬下IT之家图片
- 【原创达人】ZUK HD-1 双发声单元圈铁耳机
- 软件测试是干什么的 通过各种方式检查软件的质量问题
- 华为鸿蒙怎么玩,刷爆朋友圈的华为鸿蒙,到底是什么?
- 用python抓取淘宝相关产品的价格及销量数据
- 51单片机--实现跑马灯的两种办法
热门文章
- ABAP程序系统字段中英文详解
- update module
- python编程,外星人飞船
- linux 合计文件大小,linux下对符合条件的文件大小和行数做汇总统计的简单命令...
- c 后台输出easyui html,EasyUI——实现展示后台数据代码
- 浏览器中xhr选项是做什么用的呢_XHR和AJAX终于搞懂了!!
- php获得指定位置中间的数据库,PHP 在5.1.* 和5.2.*之间 PDO数据库操作中的不同之处小结...
- BUUCTF--[VN2020 公开赛]拉胯的三条命令
- mysql select from user_mysql查询[select * from user limit 0, 10;]
- python 多继承的实现