注解

最新推荐文章于 2024-07-11 17:01:12 发布

stable_阿甘

最新推荐文章于 2024-07-11 17:01:12 发布

阅读量862

点赞数

分类专栏： Java

本文链接：https://blog.csdn.net/stable_zl/article/details/105623359

版权

Java 专栏收录该内容

16 篇文章 0 订阅

订阅专栏

一、注解概述(Annotation)

1.1 注解是什么

注解就是代码里的特殊标记，这些标记可以在编译、类加载、运行时被读取，并执行相应的处理。通过注解，程序员可以在不改变原有代码逻辑的情况下，在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。

注解可以用来修饰包、类、构造器、方法、成员变量、参数、局部变量的声明。

1.2 用途

1、JavaSE：标记重写、标记过时的功能、忽略警告等。

2、JavaEE：配置应用程序的任何切面，代替 xml 配置等。

3、框架 = 注解 + 反射 + 设计模式

二、JDK 中三个基本注解的使用

2.1 @Override

限定重写父类方法 , 该注解只能用于修饰方法

2.2 @Deprecated

用于表示所修饰的元素 (类, 方法等 )已过时。通常是因为所修饰的结构危险或存在更好选择

2.3 @SuppressWarning

抑制编译器警告

public class AnnotationTest {
    @Override
    public String toString() {
        return "重写的 toString() 方法";
    }
    
    @SuppressWarnings("unused")
    public void unusedFun() {
        System.out.println("未被使用的方法");
        @SuppressWarnings("unused")
        String val = "未被使用的变量";        
    }
    
    @Deprecated
    public void print() {
        System.out.println("过时的方法");
    }
}

三、自定义注解（必须结合反射才有用）

自定义注解参考 @SuppressWarnings 和 @Override 即可

1、用 @interface 来声明一个注解

2、定义成员（如果不定义成员，那么注解只用来做标记，如 @Override）

注意：注解的成员是函数，在使用起来像是属性。

3、可设置成员的默认值

例：

public class MyAnnotationTest {

    @MyAnnotation
    public void defaultAnnotation() throws NoSuchMethodException {
        Class<MyAnnotationTest> clazz = MyAnnotationTest.class;
        //通过反射获得 MyAnnotationTest 的 defaultAnnotation 方法, 再获得该方法的注解
        Annotation a = clazz.getDeclaredMethod("defaultAnnotation").getAnnotation(MyAnnotation.class);
        MyAnnotation m = (MyAnnotation) a;
        String value = m.value();
        System.out.println(value);
    }

    @MyAnnotation(value = "非默认注解")
    public void undefaultAnnotation() throws NoSuchMethodException {
        Class<MyAnnotationTest> clazz = MyAnnotationTest.class;
        //通过反射获得 MyAnnotationTest 的 undefaultAnnotation 方法, 再获得该方法的注解
        Annotation a = clazz.getDeclaredMethod("undefaultAnnotation"). getAnnotation(MyAnnotation.class);
        MyAnnotation m = (MyAnnotation) a;
        String value = m.value();
        System.out.println(value);
    }

    public static void main(String[] args) throws NoSuchMethodException {
        MyAnnotationTest myAnnotationTest = new MyAnnotationTest();
        myAnnotationTest.defaultAnnotation();
        myAnnotationTest.undefaultAnnotation();
    }
}

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value() default "默认注解";
}