Java注解详解

剑剑剑剑啊

已于 2022-06-11 15:33:26 修改

阅读量184

点赞数

分类专栏： Java基础文章标签： java java-ee 开发语言

于 2022-06-11 15:31:16 首次发布

本文链接：https://blog.csdn.net/weixin_49454976/article/details/125234983

版权

Java基础专栏收录该内容

9 篇文章 0 订阅

订阅专栏

注解的理解

① jdk 5.0 新增的功能
② Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation,程序员可以在不改变原逻辑的情况下, 在源文件中嵌入一些补充信息。
③在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等。

框架 = 注解 + 反射机制 + 设计模式

注解的使用示例

示例一：生成文档相关的注解
示例二：在编译时进行格式检查(JDK内置的个基本注解)
@Override: 限定重写父类方法, 该注解只能用于方法
@Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择
@SuppressWarnings: 抑制编译器警告
示例：跟踪代码依赖性，实现替代配置文件功能

如何自定义注解：参照@SuppressWarnings定义

① 注解声明为：@interface
② 内部定义成员，通常使用value表示
③ 可以指定成员的默认值，使用default定义
④ 如果自定义注解没成员，表明是一个标识作用。

说明：
如果注解有成员，在使用注解时，需要指明成员的值。
自定义注解必须配上注解的信息处理流程(使用反射)才意义。
自定义注解通过都会指明两个元注解：Retention、Target

代码举例1：

@Inherited
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    String value() default "hello";
}

代码举例2:

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AutoRunMethod {
    /*
        注解可以定义参数。格式:类型 参数名() [default 默认值]
        如下:
            int value()
        当定义了该参数后，那么使用注解时可以为其传递参数值，如:
            @AutoRunMethod(8)   此时value参数值为:8
            
        参数可以声明默认值，如：
            int value() default 1;
        当使用该注解不传入参数时，该参数采取默认值。
            @AutoRunMethod  此时value参数默认值就是1
        如果没有指定默认值，那么参数必须传值！！

        注意:如果当前注解仅指定了一个参数，那么参数名尽量使用value。这样外面给该参数传值时可省去参数名。
        如:
        @AutoRunMethod(8) 此时value参数的值为8
        否则，正常使用注解传参的语法格式为:@注解名(参数名=参数值)
        例如:
        当前注解中指定的参数为:
        int count;
        此时使用当前注解并传参时应当写为:
        @AutoRunMethod(count=2)

        两个以上参数时，无论哪个参数的名字叫value都要用name=value的格式传递参数。
        例如当前注解定义了两个参数:
        int count();
        String name();

        那么使用当前注解传参时的格式:
        @AutoRunMethod(count=7,name="张三")
        注意:这里传参的顺序可以和参数定义的顺序不一致。即:
         @AutoRunMethod(name="张三",count=7)也是允许的。
     */
    int value() default 1;
//    int count();
//    String name();
}

元注解：对现有的注解进行解释说明的注解。

jdk 提供的4种元注解：

Target:用于指定被修饰的 Annotation 能用于修饰哪些程序元素
Retention：指定所修饰的 Annotation 的生命周期：SOURCE\CLASS（默认行为\RUNTIME),只有声明为RUNTIME生命周期的注解，才能通过反射获取。
Documented:表示所修饰的注解在被javadoc解析时，保留下来。
Inherited:被它修饰的 Annotation 将具继承性。