Java注解全面解析

1.基本语法

注解定义看起来很像接口的定义。事实上,与其他任何接口一样,注解也将会编译成class文件。

@Target(ElementType.Method)@Retention(RetentionPolicy.RUNTIME)public @interface Test {}

除了@符号以外,@Test的定义很像一个空的接口。定义注解时,需要一些元注解(meta-annotation),如@Target和@Retention

@Target用来定义注解将应用于什么地方(如一个方法或者一个域)

@Retention用来定义注解在哪一个级别可用,在源代码中(source),类文件中(class)或者运行时(runtime)

在注解中,一般都会包含一些元素以表示某些值。当分析处理注解时,程序可以利用这些值。没有元素的注解称为标记注解(marker annotation)

四种元注解,元注解专职负责注解其他的注解,所以这四种注解的Target值都是ElementType.ANNOTATION_TYPE

 

注解说明
@Target表示该注解可以用在什么地方,由ElementType枚举定义
CONSTRUCTOR:构造器的声明
FIELD:域声明(包括enum实例)
LOCAL_VARIABLE:局部变量声明
METHOD:方法声明
PACKAGE:包声明
PARAMETER:参数声明
TYPE:类、接口(包括注解类型)或enum声明
ANNOTATION_TYPE:注解声明(应用于另一个注解上)
TYPE_PARAMETER:类型参数声明(1.8新加入)
TYPE_USE:类型使用声明(1.8新加入)
PS:当注解未指定Target值时,此注解可以使用任何元素之上,就是上面的类型
@Retention表示需要在什么级别保存该注解信息,由RetentionPolicy枚举定义
SOURCE:注解将被编译器丢弃(该类型的注解信息只会保留在源码里,源码经过编译后,注解信息会被丢弃,不会保留在编译好的class文件里)
CLASS:注解在class文件中可用,但会被VM丢弃(该类型的注解信息会保留在源码里和class文件里,在执行的时候,不会加载到虚拟机(JVM)中)
RUNTIME:VM将在运行期也保留注解信息,因此可以通过反射机制读取注解的信息(源码、class文件和执行的时候都有注解的信息)
PS:当注解未定义Retention值时,默认值是CLASS
@Documented表示注解会被包含在javaapi文档中
@Inherited允许子类继承父类的注解

2. 注解元素

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

– 所有基本类型(int,float,boolean,byte,double,char,long,short)

– String

– Class

– enum

– Annotation

– 以上类型的数组

如果使用了其他类型,那编译器就会报错。也不允许使用任何包装类型。注解也可以作为元素的类型,也就是注解可以嵌套。

元素的修饰符,只能用public或default。

– 默认值限制

编译器对元素的默认值有些过分挑剔。首先,元素不能有不确定的值。也就是说,元素必须要么具有默认值,要么在使用注解时提供元素的值。

其次,对于非基本类型的元素,无论是在源代码中声明,还是在注解接口中定义默认值,都不能以null作为值。这就是限制,这就造成处理器很难表现一个元素的存在或缺失状态,因为每个注解的声明中,所有的元素都存在,并且都具有相应的值。为了绕开这个限制,只能定义一些特殊的值,例如空字符串或负数,表示某个元素不存在。

复制代码

@Target(ElementType.Method)@Retention(RetentionPolicy.RUNTIME)public @interface MockNull {public int id() default -1;public String description() default “”;}

复制代码

3. 快捷方式

何为快捷方式呢?先来看下springMVC中的Controller注解

复制代码

@Target({ElementType.TYPE})@Retention(RetentionPolicy.RUNTIME)@Documented@Componentpublic @interface Controller {String value() default “”;}

复制代码

可以看见Target应用于类、接口、注解和枚举上,Retention策略为RUNTIME运行时期,有一个String类型的value元素。平常使用的时候基本都是这样的:

@Controller(“/your/path”)public class MockController { }

这就是快捷方式,省略了名-值对的这种语法。下面给出详细解释:

注解中定义了名为value的元素,并且在应用该注解的时候,如果该元素是唯一需要赋值的一个元素,那么此时无需使用名-值对的这种语法,而只需在括号内给出value元素所需的值即可。这可以应用于任何合法类型的元素,当然了,这限制了元素名必须为value。

4. JDK1.8注解增强

TYPE_PARAMETER和TYPE_USE

在JDK1.8中ElementType多了两个枚举成员,TYPE_PARAMETER和TYPE_USE,他们都是用来限定哪个类型可以进行注解。举例来说,如果想要对泛型的类型参数进行注解:

public class AnnotationTypeParameter<@TestTypeParam T> {}

那么,在定义@TestTypeParam时,必须在@Target设置ElementType.TYPE_PARAMETER,表示这个注解可以用来标注类型参数。例如:

@Target(ElementType.TYPE_PARAMETER)@Retention(RetentionPolicy.RUNTIME)public @interface TestTypeParam {}

ElementType.TYPE_USE用于标注各种类型,因此上面的例子也可以将TYPE_PARAMETER改为TYPE_USE,一个注解被设置为TYPE_USE,只要是类型名称,都可以进行注解。例如有如下注解定义:

@Target(ElementType.TYPE_USE)@Retention(RetentionPolicy.RUNTIME)public @interface Test {}

那么以下的使用注解都是可以的:

复制代码

List<@Test Comparable> list1 = new ArrayList<>();List<? extends Comparable> list2 = new ArrayList<@Test Comparable>();@Test String text;text = (@Test String)new Object();java.util. @Test Scanner console;console = new java.util.@Test Scanner(System.in);

复制代码

PS:以上@Test注解都是在类型的右边,要注意区分1.8之前的枚举成员,例如:

@Test java.lang.String text;

在上面这个例子中,显然是在进行text变量标注,所以还使用当前的@Target会编译错误,应该加上ElementType.LOCAL_VARIABLE。

@Repeatable注解

@Repeatable注解是JDK1.8新加入的,从名字意思就可以大概猜出他的意思(可重复的)。可以在同一个位置重复相同的注解。举例:

复制代码

@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)public @interface Filter {String [] value();}

复制代码

如下进行注解使用:

@Filter({“/admin”,”/main”})public class MainFilter { }

换一种风格:

@Filter(“/admin”)@Filter(“/main”)public class MainFilter {}

在JDK1.8还没出现之前,没有办法到达这种“风格”,使用1.8,可以如下定义@Filter:

复制代码

@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)@Repeatable(Filters.class)public @interface Filter {String  value();}@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)public @interface Filters {Filter [] value();}

复制代码

实际上这是编译器的优化,使用@Repeatable时告诉编译器,使用@Filters来作为收集重复注解的容器,而每个@Filter存储各自指定的字符串值。JDK1.8在AnnotatedElement接口新增了getDeclaredAnnotationsByType和getAnnotationsByType,在指定@Repeatable的注解时,会寻找重复注解的容器中。相对于,getDeclaredAnnotation和getAnnotation就不会处理@Repeatable注解。举例如下:

复制代码

@Filter(“/admin”)@Filter(“/filter”)public class FilterClass {public static void main(String[] args) {Class<FilterClass> filterClassClass = FilterClass.class;Filter[] annotationsByType = filterClassClass.getAnnotationsByType(Filter.class);if (annotationsByType != null) {for (Filter filter : annotationsByType) {System.out.println(filter.value());}}System.out.println(filterClassClass.getAnnotation(Filter.class));}}

复制代码

日志如下:

/admin/filternull

 

怀有希望!!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/439970.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

ubuntu18.04下安装grafana6和简单使用

ubuntu18.04下安装grafana6 环境 ubuntu18.04 下载 sudo apt-get install -y adduser libfontconfig1 # 使用wget 下载会很慢 # 推荐百度网盘&#xff1a;链接&#xff1a;https://pan.baidu.com/s/1y2I4LwuslB5kHAZwV8RNxw 提取码&#xff1a;o19t # 或者csdn&#xff1a;[gr…

【POJ - 1364】King(差分约束判无解)

题干&#xff1a; Once, in one kingdom, there was a queen and that queen was expecting a baby. The queen prayed: If my child was a son and if only he was a sound king. After nine months her child was born, and indeed, she gave birth to a nice son. Unfortu…

VMware虚拟机下安装Ubuntu16.04镜像完整教程

目录 1&#xff09;安装前准备 2&#xff09;安装Ubuntu 16.04镜像 3&#xff09;One More Thing 1&#xff09;安装前准备 PC电脑操作系统是WIN7&#xff0c;已正确安装虚拟机VMware 12。 2&#xff09;安装Ubuntu 16.04镜像 下载Ubuntu镜像文件&#xff0c;下载链接为…

JAVA 注解的基本原理

以前&#xff0c;『XML』是各大框架的青睐者&#xff0c;它以松耦合的方式完成了框架中几乎所有的配置&#xff0c;但是随着项目越来越庞大&#xff0c;『XML』的内容也越来越复杂&#xff0c;维护成本变高。 于是就有人提出来一种标记式高耦合的配置方式&#xff0c;『注解』…

查看ubuntu系统的版本信息

目录 1&#xff09;查看linux内核、gcc版本、ubuntu版本 2&#xff09;显示linux的内核版本和系统是多少位 1&#xff09;查看linux内核、gcc版本、ubuntu版本 显示如下 Linux version 4.15.0-29-generic (builddlcy01-amd64-024) linux内核版本号 gcc version 5.4…

数字证书原理

基础知识 1. 公钥密码体制 公钥密码体制分为三个部分&#xff0c;公钥、私钥、加密解密算法&#xff0c;它的加密解密过程如下&#xff1a; 加密&#xff1a;通过加密算法和公钥对明文进行加密&#xff0c;得到密文。解密&#xff1a;通过解密算法和私钥对密文进行解密&…

【POJ - 1087】A Plug for UNIX(建图,网络流最大流)

题干&#xff1a; You are in charge of setting up the press room for the inaugural meeting of the United Nations Internet eXecutive (UNIX), which has an international mandate to make the free flow of information and ideas on the Internet as cumbersome and …

框架基础——全面解析Java注解

阅读目录 一、概念二、Java中的常见注解三、注解的分类四、自定义注解五、注解的项目实战六、注解总结 为什么学习注解&#xff1f; 学习注解有什么好处&#xff1f; 学完能做什么&#xff1f; 答&#xff1a;1. 能够读懂别人写的代码&#xff0c;特别是框架相关的代码&…

CS231n Convolutional Neural Networks for Visual Recognition------Scipy and MatplotlibTutorial

源链接为&#xff1a;http://cs231n.github.io/python-numpy-tutorial/。 这篇指导书是由Justin Johnson编写的。 在这门课程中我们将使用Python语言完成所有变成任务&#xff01;Python本身就是一种很棒的通用编程语言&#xff0c;但是在一些流行的库帮助下&#xff08;numpy&…

自签名CA认证

自签名CA认证 用openssl命令生成自己的根证书&#xff0c;让用户安装信任它&#xff0c;之后所有用这个根证书签名的证书&#xff0c;就可以被信任。 生成根证书 创建文件并配置环境mkdir /root/ca cd /root/ca mkdir certs crl newcerts private chmod 700 private touch i…

注解由谁读取并解析的?

问题&#xff1a; 注解由谁读取并解析的&#xff1f;描述: java web 开发&#xff0c;使用ssh框架。在dao层&#xff0c;定义的类的头上有Component("GzDAO")注解&#xff0c;在service层&#xff0c; 定义的类的头上有Service(value "GzService")&…

Python之Numpy入门实战教程(1):基础篇

Numpy、Pandas、Matplotlib是Python的三个重要科学计算库&#xff0c;今天整理了Numpy的入门实战教程。NumPy是使用Python进行科学计算的基础库。 NumPy以强大的N维数组对象为中心&#xff0c;它还包含有用的线性代数&#xff0c;傅里叶变换和随机数函数。 强烈建议大家将本文中…

Go初识与问题

变量&#xff06;常量 变量 命名 由字母、数字、下划线组成&#xff0c;首个字符不能是数字关键字、保留字不能作为变量名变量名字区分大小写驼峰命名声明 1. var : 全局变量var 变量名称 类型var 变量名称1,变量名称2 类型 (同一种类型)var (变量名称1 类型1变量名称2 类型…

【HDU - 4597】Play Game(博弈dp)

题干&#xff1a; Alice and Bob are playing a game. There are two piles of cards. There are N cards in each pile, and each card has a score. They take turns to pick up the top or bottom card from either pile, and the score of the card will be added to his …

1.3)深度学习笔记------浅层神经网络

目录 1&#xff09;Neural Network Overview 2&#xff09;Neural Network Representation 3&#xff09;Computing a Neural Network’s Output&#xff08;重点&#xff09; 4&#xff09;Vectorizing across multiple examples 5&#xff09;Activation functions 6&a…

git 实战

配置ssh git config --global user.name "用户名" git config --global user.email "邮箱"ssh-keygen -t rsa -C "邮箱"需要进行确认:1. 确认秘钥的保存路径(不需要改直接回车)2. 如果上一步置顶的保存路径下已经有秘钥文件&…

SpringMVC 的执行流程

SpringMVC 的执行流程 1&#xff09;用户向服务器发送请求&#xff0c;请求被 Spring 前端控制 Servelt DispatcherServlet捕获&#xff1b; 2&#xff09;DispatcherServlet 对请求 URL 进行解析&#xff0c;得到请求资源标识符&#xff08;URI&#xff09;。然后根据该 URI&…

【POJ - 2987】Firing(最大权闭合图,网络流最小割,输出方案最小,放大权值法tricks)

题干&#xff1a; You’ve finally got mad at “the world’s most stupid” employees of yours and decided to do some firings. You’re now simply too mad to give response to questions like “Don’t you think it is an even more stupid decision to have signed …

kafka初识

kafka中文文档 本文环境&#xff1a;ubuntu:18.04 kafka安装、配置与基本使用(单节点) 安装kafka 下载 0.10.0.1版本并解压缩 > tar -xzf kafka_2.11-0.10.0.1.tgz > cd kafka_2.11-0.10.0.1.tgzkafka简单配置 > vi config/server.properties主要注意三个地方&a…

1.4)深度学习笔记------深层神经网络

目录 1&#xff09;Deep L-layer neural network 2&#xff09;Forward Propagation in a Deep Network(重点) 3&#xff09;Getting your matrix dimensions right 4&#xff09;Building blocks of deep neural networks 5&#xff09;Forward and Backward Propagation…