概述
注解是对程序代码进行标注和解释的一种方式。在Java中,注解提供了一种元数据形式,能够在程序中嵌入有关程序的信息,以便进行进一步的处理。注解通过使用@
符号来声明,如@Override
、@Deprecated
等。
注解和注释的区别
- 注释:是给程序员看的,不会对程序产生任何影响。
- 注解:是给编译器或其他工具看的,可以在编译、运行时进行一些特殊操作。
使用注解进行配置的优势
使用注解进行配置能使代码更简洁、方便,而不再需要繁琐的配置文件。注解能够直观地标识出程序中的关键信息,提高代码的可读性和可维护性。
自定义注解
格式
javaCopy codepublic @interface 注解名称 {public 属性类型 属性名() default 默认值;
}
属性类型
- 基本数据类型
- String
- Class
- 注解
- 枚举
- 以上类型的一维数组
示例代码
javaCopy codepublic @interface Anno2 {
}public enum Season {SPRING, SUMMER, AUTUMN, WINTER;
}public @interface Anno1 {// 定义一个基本类型的属性int a() default 23;// 定义一个String类型的属性String name() default "shizhanban";// 定义一个Class类型的属性Class clazz() default Anno2.class;// 定义一个注解类型的属性Anno2 anno() default @Anno2;// 定义一个枚举类型的属性Season season() default Season.SPRING;// 以上类型的一维数组// int数组int[] arr() default {1, 2, 3, 4, 5};// 枚举数组Season[] seasons() default {Season.SPRING, Season.SUMMER};// value。后期我们在使用注解的时候,如果我们只需要给注解的value属性赋值。// 那么value就可以省略String value();
}// 在使用注解的时候如果注解里面的属性没有指定默认值。
// 那么我们就需要手动给出注解属性的设置值。
//@Anno1(name = "shizhanban")
@Anno1("abc")
public class AnnoDemo {
}
注意
如果只有一个属性需要赋值,并且属性的名称是value,则value可以省略,直接定义值即可。
自定义注解案例
需求
自定义一个注解@Test,用于指定类的方法上,如果某一个类的方法上使用了该注解,就执行该方法。
实现步骤
- 自定义一个注解
Test
,并在类的某几个方法上加上注解。 - 在测试类中,获取注解所在类的
Class
对象。 - 获取类中所有的方法对象。
- 遍历每一个方法对象,判断是否有对应的注解。
javaCopy code// 表示Test这个注解的存活时间
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Test {
}public class UseTest {// 没有使用Test注解public void show() {System.out.println("UseTest....show....");}// 使用Test注解@Testpublic void method() {System.out.println("UseTest....method....");}// 没有使用Test注解@Testpublic void function() {System.out.println("UseTest....function....");}
}public class AnnoDemo {public static void main(String[] args) throws ClassNotFoundException, IllegalAccessException, InstantiationException, InvocationTargetException {// 1.通过反射获取UseTest类的字节码文件对象Class clazz = Class.forName("com.shizhanban.UseTest");// 创建对象UseTest useTest = (UseTest) clazz.newInstance();// 2.通过反射获取这个类里面所有的方法对象Method[] methods = clazz.getDeclaredMethods();// 3.遍历数组,得到每一个方法对象for (Method method : methods) {// method依次表示每一个方法对象。// isAnnotationPresent(Class<? extends Annotation> annotationClass)// 判断当前方法上是否有指定的注解。// 参数:注解的字节码文件对象// 返回值:布尔结果。 true 存在 false 不存在if (method.isAnnotationPresent(Test.class)) {method.invoke(useTest);}}}
}
元注解
概述
元注解是描述注解的注解。
元注解介绍
@Target
:指定了注解能在哪里使用。@Retention
:可以理解为保留时间(生命周期)。@Inherited
:表示修饰的自定义注解可以被子类继承。@Documented
:表示该自定义注解会出现在API文档里面。
示例代码
javaCopy code@Target({ElementType.FIELD, ElementType.TYPE, ElementType.METHOD}) // 指定注解使用的位置(成员变量,类,方法)
@Retention(RetentionPolicy.RUNTIME) // 指定该注解的存活时间
// @Inherited // 指定该注解可以被继承
public @interface Anno {
}@Anno
public class Person {
}public class Student extends Person {public void show() {System.out.println("student.......show..........");}
}public class StudentDemo {public static void main(String[] args) throws ClassNotFoundException {// 获取到Student类的字节码文件对象Class clazz = Class.forName("com.shizhanban.Student");// 获取注解。boolean result = clazz.isAnnotationPresent(Anno.class);System.out.println(result);}
}
通过元注解,我们可以更加灵活地定义和使用自定义注解,控制注解的生命周期和作用范围。