这篇文章主要讲解了Java注解的详细解析,内容清晰明了,对此有兴趣的小伙伴可以学习一下,相信大家阅读完之后会有帮助。
基本特性
1、jdk 1.5之后才引入的。
2、用来说明程序的。(注释是给程序员看的,注解就是给电脑看的)
java注解的作用分类
1、编写文档:通过代码标识的注解生成文档。【生成doc文档】
2、代码分析:通过代码标识的注解对代码进行分析。【使用反射】
3、编译检查:通过代码标识的注解让编译器能够实现基本的编译检查。【override】
测试类:
/** * 我的javadoc测试 */ public class TestCode { /** * 计算两个数的和 * @param a 整数a * @param b 整数b * @return 返回两个数的和 */ public int add(int a, int b){ return a+b; } }
对于2、3两点我们应该是知道的。尽管可能不知道里面的原理。但是是平时都在用的。但是对于1点还可以生成doc文档?
测试操作如下:
D:\soft\jdk\bin\javadoc.exe .\TestCode.java -encoding utf-8 -docEncoding utf-8 -charset utf-8
生成了一大堆的东西:
打开TestCode.html可以发现,我们的java api手册就是这样生产的。
注解来源分类
1、jdk自带的注解,如常见的override(重写校验),deprecated(表示弃用)
2、自定义的注解
1)格式, 以override为例:
2)注解的本质
我们编写一个简单的注解
MyAnnotation.java
public @interface MyAnnotation {}
我们通过编译和反编译看下最终是什么样的结果:
D:\soft\jdk\bin\javac.exe MyAnnotation.java
D:\soft\jdk\bin\javap.exe MyAnnotation.class
结果如下:
public interface MyAnnotation extends java.lang.annotation.Annotation {
}
可以发现注解的本质就是接口,这个接口继承了jdk里面的Annotation接口。
3)注解的属性
由于注解本质为接口,那么里面可以定义未实现的方法。这些称为注解的“属性”。
属性的返回类型有(返回值不能为void):
例子:
public enum Person { PS; } public @interface Annotation2 { } public @interface MyAnnotation { String stringValue(); int integerValue(); Person personValue(); Annotation2 myAnnotationValue(); String[] stringArrayValue(); }
属性的使用,需要注意几点:
public @interface MyAnnotation { String stringValue() default "xxx"; int integerValue(); String[] stringArrayValue(); } public @interface Annotation2 { String value(); } @MyAnnotation(integerValue = 1, stringArrayValue = {"aaa", "bbb"}) @Annotation2("default") public class TestCode { /** * 计算两个数的和 * @param a 整数a * @param b 整数b * @return 返回两个数的和 */ public int add(int a, int b){ return a+b; } @Override public String toString() { return super.toString(); } }
元注解
元注解是你在编写注解的时候,上面加的注解,就是注解的注解。主要有4个。
元注解的内容,可以到jdk源码里面看一下,更有利于理解。
解析注解
这个是最关键了,以上加了这么多的属性,并且还为这些属性附了值,那么是希望程序读取这些值,进行使用的。那其实就是要看如何拿到这些注解配置的值。
测试:
MyAnnotition.java:
package annotation_; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) public @interface MyAnnotation { String stringValue() default "xxx"; int integerValue(); }
TestCode.java:
package annotation_; @MyAnnotation(integerValue = 1) public class TestCode { public static void main(String[] args) { Class<TestCode> testCodeClass = TestCode.class; MyAnnotation myAnnotation = testCodeClass.getAnnotation(MyAnnotation.class); int i = myAnnotation.integerValue(); String s = myAnnotation.stringValue(); System.out.printf("i = %d, s = %s\n", i, s); } }
输出结果:
Connected to the target VM, address: '127.0.0.1:49586', transport: 'socket'
i = 1, s = xxx
Disconnected from the target VM, address: '127.0.0.1:49586', transport: 'socket'Process finished with exit code 0
是不是感觉可以当配置文件使用。但是最主要的问题是myAnnotation.integerValue(),myAnnotation.stringValue()为什么可以拿到对应的值,这个也是最核心的问题。
那就是getAnnotation里面返回了一个实现了MyAnnotation注解(注解的本质是接口)的实例。这个类大概是长这样的。
package annotation_; import java.lang.annotation.Annotation; public class MyAnnotationImpl implements MyAnnotation{ public String stringValue() { return "xxx"; } public int integerValue() { return 0; } public Class<? extends Annotation> annotationType() { return null; } }
所以就可以通过抽象方法获取到对应的值。(如何生成这样的一个类,只是学习注解,可以不关心。要不然,只能看里面的源码。因为如果自定义注解,你只会用到这一步,去获取值。)
看完上述内容,是不是对Java注解的详细解析有进一步的了解,如果还想学习更多内容,欢迎关注亿速云行业资讯频道。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。