引言
在Java开发中，注解是一种非常重要的语言特性，它们可以为代码提供额外的信息和元数据。本文将介绍Java注解的基本概念，并深入探讨自定义注解和AOP自定义注解的应用。
1.1 什么是注解
注解是一种用于为程序代码添加元数据的方式。它们可以用于描述类、方法、字段等程序元素的特性和行为。Java注解使用@符号作为前缀，并可以包含参数和值。
1.2 注解的作用
提供额外的元数据：注解可以为代码提供额外的信息，如作者、版本号、创建日期等。
编译时检查：注解可以在编译时对代码进行静态检查，以确保代码的正确性和一致性。
运行时处理：注解可以在运行时通过反射机制获取和处理，以实现一些特定的功能。
1.3 常见的Java注解
@Override：用于标识方法覆盖父类的方法。
@Deprecated：用于标识已过时的方法或类。
@SuppressWarnings：用于抑制编译器警告。
@FunctionalInterface：用于标识函数式接口。
- Java注解分类
JDK基本注解 JDK元注解 自定义注解 • 1 • 2 • 3
- JDK基本注解
@Override 重写 @SuppressWarnings(value = "unchecked") 压制编辑器警告 • 1 • 2 • 3 • 4 • 5
- JDK元注解
@Retention：定义注解的保留策略 @Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中，在class字节码文件中不包含 @Retention(RetentionPolicy.CLASS) //默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得， @Retention(RetentionPolicy.RUNTIME) //注解会在class字节码文件中存在，在运行时可以通过反射获取到 @Target：指定被修饰的Annotation可以放置的位置(被修饰的目标) @Target(ElementType.TYPE) //接口、类 @Target(ElementType.FIELD) //属性 @Target(ElementType.METHOD) //方法 @Target(ElementType.PARAMETER) //方法参数 @Target(ElementType.CONSTRUCTOR) //构造函数 @Target(ElementType.LOCAL_VARIABLE) //局部变量 @Target(ElementType.ANNOTATION_TYPE) //注解 @Target(ElementType.PACKAGE) //包 注：可以指定多个位置，例如： @Target({ElementType.METHOD, ElementType.TYPE})，也就是此注解可以在方法和类上面使用 @Inherited：指定被修饰的Annotation将具有继承性 @Documented：指定被修饰的该Annotation可以被javadoc工具提取成文档. • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17 • 18 • 19 • 20
- 自定义注解
注解分类（根据Annotation是否包含成员变量,可以把Annotation分为两类）: 标记Annotation: 没有成员变量的Annotation; 这种Annotation仅利用自身的存在与否来提供信息 元数据Annotation: 包含成员变量的Annotation; 它们可以接受(和提供)更多的元数据; • 1 • 2 • 3 • 4 • 5 • 6 • 7
- 如何自定义注解？
使用@interface关键字, 其定义过程与定义接口非常类似, 需要注意的是: Annotation的成员变量在Annotation定义中是以无参的方法形式来声明的, 其方法名和返回值类型定义了该成员变量的名字和类型, 而且我们还可以使用default关键字为这个成员变量设定默认值； • 1 • 2 • 3
2. 自定义注解案例
- 案例一
demo1
package com.yuan.annotation.demo1; /** * * 获取类与方法上的注解值 */ @MyAnnotation1(name = "abc") public class Demo1 { @MyAnnotation1(name = "xyz") private Integer age; @MyAnnotation2(model = TranscationModel.Read) public void list() { System.out.println("list"); } @MyAnnotation3(models = {TranscationModel.Read, TranscationModel.Write}) public void edit() { System.out.println("edit"); } } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17 • 18 • 19 • 20 • 21 • 22 • 23
Demo1Test
package com.yuan.annotation.demo1; import org.junit.Test; public class Demo1Test { @Test public void list() throws Exception { // 获取类上的注解 MyAnnotation1 annotation1 = Demo1.class.getAnnotation(MyAnnotation1.class); System.out.println(annotation1.name());//abc // 获取方法上的注解 MyAnnotation2 myAnnotation2 = Demo1.class.getMethod("list").getAnnotation(MyAnnotation2.class); System.out.println(myAnnotation2.model());//Read // 获取属性上的注解 MyAnnotation1 myAnnotation1 = Demo1.class.getDeclaredField("age").getAnnotation(MyAnnotation1.class); System.out.println(myAnnotation1.name());// xyz } @Test public void edit() throws Exception { MyAnnotation3 myAnnotation3 = Demo1.class.getMethod("edit").getAnnotation(MyAnnotation3.class); for (TranscationModel model : myAnnotation3.models()) { System.out.println(model);//Read,Write } } } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17 • 18 • 19 • 20 • 21 • 22 • 23 • 24 • 25 • 26 • 27 • 28 • 29
MyAnnotation1
package com.yuan.annotation.demo1; import java.lang.annotation.*; /** * MyAnnotation1注解可以用在类、接口、属性、方法上 * 注解运行期也保留 * 不可继承 */ @Target({ElementType.TYPE, ElementType.FIELD,ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @Inherited @Documented public @interface MyAnnotation1 { String name(); } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16
MyAnnotation2
package com.yuan.annotation.demo1; import java.lang.annotation.*; /** * MyAnnotation2注解可以用在方法上 * 注解运行期也保留 * 不可继承 */ @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface MyAnnotation2 { TranscationModel model() default TranscationModel.ReadWrite; } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16
MyAnnotation3
package com.yuan.annotation.demo1; import java.lang.annotation.*; /** * MyAnnotation3注解可以用在方法上 * 注解运行期也保留 * 可继承 */ @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Inherited @Documented public @interface MyAnnotation3 { TranscationModel[] models() default TranscationModel.ReadWrite; } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17
TranscationModel
package com.yuan.annotation.demo1; public enum TranscationModel { Read, Write, ReadWrite } • 1 • 2 • 3 • 4 • 5
测试结果
- 案例二
Demo2
package com.yuan.annotation.demo2; /** * 获取类属性上的注解属性值 */ public class Demo2 { @TestAnnotation(value = "这就是value对应的值_msg1", what = "这就是what对应的值_msg1") private static String msg1; @TestAnnotation("这就是value对应的值1") private static String msg2; @TestAnnotation(value = "这就是value对应的值2") private static String msg3; @TestAnnotation(what = "这就是what对应的值") private static String msg4; } • 1 • 2 • 3 • 4 • 5 • 6 • 7 • 8 • 9 • 10 • 11 • 12 • 13 • 14 • 15 • 16 • 17 • 18 • 19
