什么是注解

转载 于 2021-07-28 08:22:26 发布 · 140 阅读 · 0 ·
CC 4.0 BY-SA版权
原文链接：https://blog.youkuaiyun.com/leyi520/article/details/118994416

什么是注解
从JDK5开始，Java增加对元数据的支持，也就是注解，注解与注释是有一定区别的，可以把注解理解为代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过注解开发人员可以在不改变原有代码和逻辑的情况下在源代码中嵌入补充信息。

内置的注解
二当家的发现在 IDE 中如果创建一个类并实现一个接口之后，那些实现接口的方法上面会自动帮我添加 @Override 的标记。

而这个标记就是注解，像@Override这样JDK内置的注解还有好几个呢，他们都在java.lang包下面，我们分别看看。

@Override
当子类重写父类方法时，子类可以加上这个注解，那这有什么什么用？这可以确保子类确实重写了父类的方法，避免出现低级错误。


开始不知道有什么用，直到有一天，我把接口里的这个方法删除了，结果就编译不通过了。


下面是直接在命令行编译的结果。这回我知道这个标记的作用了，它可以告诉编译器和阅读源码的人这个方法是覆盖或实现超类型的方法。


@Deprecated
这个注解用于表示某个程序元素类，方法等已过时，当其他程序使用已过时的类，方法时编译器会给出警告（删除线，这个见了不少了吧）。


@SuppressWarnings
抑制警告。

package com.secondgod.annotation;

import java.util.ArrayList;
import java.util.List;

public class Test {

    public static void main(String[] args) {
        List<Integer> intList = new ArrayList<>();
        List          objList = intList;
        objList.add("二当家的");
    }
}

在命令行启用建议警告的编译(命令形如 javac -d . -Xlint Test.java ,下文再提到启用建议警告的编译，不再赘述解释)。


代码稍作修改，则可以消除编译警告。

package com.secondgod.annotation;

import java.util.ArrayList;
import java.util.List;

public class Test {

    @SuppressWarnings({"unchecked", "rawtypes"})
    public static void main(String[] args) {
        List<Integer> intList = new ArrayList<>();
        List          objList = intList;
        objList.add("二当家的");
    }
}

@SafeVarargs
在声明具有模糊类型（比如：泛型）的可变参数的构造函数或方法时，Java编译器会报unchecked警告。鉴于这些情况，如果程序员断定声明的构造函数和方法的主体不会对其varargs参数执行潜在的不安全的操作，可使用@SafeVarargs进行标记，这样的话，Java编译器就不会报unchecked警告。

package com.secondgod.annotation;

import java.util.List;

public class Test {
    public final void test(List<String>... stringLists) {

    }
}

在命令行启用建议警告的编译。


代码稍作修改，则可以消除编译警告。

package com.secondgod.annotation;

import java.util.List;

public class Test {
    @SafeVarargs
    public final void test(List<String>... stringLists) {

    }
}

@FunctionalInterface
函数式接口注解，这个是 Java 1.8 版本引入的新特性。函数式编程很火，所以 Java 8 也及时添加了这个特性。
这个注解有什么用？这个注解保证这个接口只有一个抽象方法，注意这个只能修饰接口。

没有抽象方法的接口
package com.secondgod.annotation;

@FunctionalInterface
public interface Test {
    
}
 


有超过一个抽象方法的接口
package com.secondgod.annotation;

@FunctionalInterface
public interface Test {
    String test1();

    String test2();
}

 


只有一个抽象方法的接口
编译通过。

package com.secondgod.annotation;

@FunctionalInterface
public interface Test {
    String test();
}

只有一个抽象方法的抽象类
package com.secondgod.annotation;

@FunctionalInterface
public abstract class Test {
    public abstract String test();
}
 


元注解
我们打开@Override的源码看下，会发现这个注解的定义上本身还有注解，即注解的注解，人们通常叫他们元注解。元注解是负责对其它注解进行说明的注解，自定义注解时可以使用元注解。


JDK内置的元注解都在java.lang.annotation包下面。


@Target
Target 是目标的意思，@Target 指定了注解运用的地方。

取值    注解使用范围
TYPE    可用于类或者接口上
FIELD    可用于域/字段/属性上
METHOD    可用于方法上
PARAMETER    可用于参数上
CONSTRUCTOR    可用于构造方法上
LOCAL_VARIABLE    可用于局部变量上
ANNOTATION_TYPE    可用于注解类型上（被@interface修饰的类型）
PACKAGE    用于记录java文件的package信息
TYPE_PARAMETER    可用于类型变量的声明语句中
TYPE_USE    可用于使用类型的任何语句中
@Documented
用 @Documented 注解修饰的注解类会被 JavaDoc 工具提取成文档。默认情况下，JavaDoc 是不包括注解的，但如果声明注解时指定了 @Documented，就会被 JavaDoc 之类的工具处理，所以注解类型信息就会被包括在生成的帮助文档中。

@Inherited
Inherited 是继承的意思，但是它并不是说注解本身可以继承，而是说如果一个超类被 @Inherited 注解过的注解进行注解的话，那么如果它的子类没有被任何注解应用的话，那么这个子类就继承了超类的注解。

@Repeatable
Repeatable 自然是可重复的意思。Java 8 新增加的，它允许在相同的程序元素中重复注解，在需要对同一种注解多次使用时，往往需要借助 @Repeatable 注解。Java 8 版本以前，同一个程序元素前最多只能有一个相同类型的注解，如果需要在同一个元素前使用多个相同类型的注解，则必须使用注解“容器”。

@Retention
@Retention 用于描述注解的生命周期，也就是该注解被保留的时间长短。@Retention 注解中的成员变量（value）用来设置保留策略，value 是 java.lang.annotation.RetentionPolicy 枚举类型，RetentionPolicy 有 3 个枚举常量，如下所示。

取值    生命周期
SOURCE    在源文件中有效（编译器可以使用）
CLASS    在 class 文件中有效（编译器和虚拟机可以使用）
RUNTIME    在运行时有效（编译器，虚拟机，程序运行时都可以使用）
@Native
使用 @Native 注解修饰成员变量，则表示这个变量可以被本地代码引用，常常被代码生成工具使用。他也在java.lang.annotation包下面，但是我认为他不算是元注解，因为他的使用目标不是注解。


自定义注解
在Spring，Hibernate，Mybatis等框架下都有注解，二当家的也尝试自定义一个注解，先看下@Override的源码吧。

package java.lang;

import java.lang.annotation.*;

/**
 * Indicates that a method declaration is intended to override a
 * method declaration in a supertype. If a method is annotated with
 * this annotation type compilers are required to generate an error
 * message unless at least one of the following conditions hold:
 *
 * <ul><li>
 * The method does override or implement a method declared in a
 * supertype.
 * </li><li>
 * The method has a signature that is override-equivalent to that of
 * any public method declared in {@linkplain Object}.
 * </li></ul>
 *
 * @author  Peter von der Ah&eacute;
 * @author  Joshua Bloch
 * @jls 9.6.1.4 @Override
 * @since 1.5
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

我们照葫芦画瓢也自定义一个。

package com.secondgod.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 测试注解
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
}

我们自定义的注解通常都是定义生命周期为 RUNTIME 的。生命周期为 SOURCE 的，需要编译器的配合。生命周期为 CLASS 的，需要虚拟机的配合。只有程序运行时的行为是我们可以自定义的。

好了，去使用一下这个自定义的注解。

package com.secondgod.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


/**
 * 测试注解
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation {
}

/**
 * 对自定义注解的测试
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
public class Test {
    @MyAnnotation
    private String name;
}

有的注解还带参数，二当家的也加上。

package com.secondgod.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


/**
 * 测试注解
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation {
    String name();
}

/**
 * 对自定义注解的测试
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
public class Test {
    @MyAnnotation(name = "二当家的")
    private String name;
}

使用时候赋值必须写属性名，像@Target等一些注解赋值的时候就不用写属性名，那是因为属性名是“value”，就可以不用写。

package com.secondgod.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


/**
 * 测试注解
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation {
    String value();
}

/**
 * 对自定义注解的测试
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
public class Test {
    @MyAnnotation("二当家的")
    private String name;
}

在注解里定义了属性后，使用的地方必须赋值。 不过可以在注解里定义默认值，使用时就可以不赋值了。

package com.secondgod.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;


/**
 * 测试注解
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation {
    String value() default "二当家的";
}

/**
 * 对自定义注解的测试
 *
 * @author 二当家的白帽子 https://le-yi.blog.youkuaiyun.com/
 */
public class Test {
    @MyAnnotation
    private String name;
}

注解里的内容非常的少，显然他的功能并不在里面实现。所以注解就是个标记，本身并没有任何功能。那他的功能如何实现呢？
————————————————
版权声明：本文为优快云博主「二当家的白帽子」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.youkuaiyun.com/leyi520/article/details/118994416

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值