Java基础复习——注解详细介绍-白红宇

Java基础复习——注解详细介绍

阅读量：3958 次

发布时间：2019-05-24

本文共 4119 字，大约阅读时间需要 13 分钟。

Java基础复习——注解详细介绍

文章目录

一.注解的概念

注解（Annotation）,也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

对于注解的概念可简要概括为:

JDK1.5之后的新特性

说明程序的

使用注解：@注解名称

关于注解的作用可以分为三类:

①编写文档：通过代码里标识的注解生成文档【生成doc文档】
②代码分析：通过代码里标识的注解对代码进行分析【使用反射】
③编译检查：通过代码里标识的注解让编译器能够实现基本的编译【Override】

下面我为大家演示一下生成doc文档:

首先新建下面文件:

/** * @author jackTan */public class JavaDocDemo {
       /**     * @author jackTan     * @param a 参数1     * @param b 参数2     * @return 获得a与b的和     */    public int getAdd(int a,int b){
           return a+b;    }}

来到该路径的命令行：

现在我们得到了doc文档。

二.JDK内置注解

@Override ：检测被该注解标注的方法是否是继承自父类(接口)的

@Deprecated：该注解标注的内容，表示已过时

@SuppressWarnings：压制警告, 一般传递参数all @SuppressWarnings(“all”)

演示:

未使用注解前,三条绿杠就是警告:

加入注解后警告消失:

当然把注解放在类前面那么所有的警告都消失.

三.自定义注解

1.注解的格式与本质

注解的格式是:

public @interface 注解名称{

属性列表;
}
还是JavaDemoDoc.java文件，内容如下:

下面我们来探寻他的本质。

public @interface JavaDocDemo {
   }

在这里插入图片描述

从上图我们得到:

Compiled from “JavaDocDemo.java”
public interface JavaDocDemo extends java.lang.annotation.Annotation {

}

这说明注解的本质是一个继承了java.lang.annotation.Annotation的接口。

2.注解属性的定义

注解属性就是指注解的内容，这些内容其实就是抽象方法，只不过这些抽象方法的返回值只能是：

基本数据类型(byte,int,short,long,float,double,boolean,char)

String

枚举

注解

以上类型的数组

还有一个要求就是在使用属性时要对属性赋值。(但是如果是有默认值可以不赋值。)

下面我们来对上面的内容做一个演示:

/** * @author jackTan */public @interface JavaDocDemo {
       myAnno show1();    myAnno[] show1_();    String show2();    String[] show2_();    myEnum show3();    myEnum[] show3_();    int show4();    int[] show4_();}/** * @author jackTan */@interface myAnno{
   }enum myEnum{
   }

下面我们只保留继续演示:

int show4();

由于没有默认值，我们要给show4赋值。

@JavaDocDemo(show4 = 1)class TestAnno{
   }

改为如下：

int show4() default  1;

这个时候有默认值，故而可以不赋值:

@JavaDocDemo()class TestAnno{
   }

然后我们再来演示一下数组赋值:

public @interface JavaDocDemo {
       String[] show2_();    String[] show2();}//赋多个值要包上{},如果只有一个值可以省略{}@JavaDocDemo(show2_ = {
   "a","b","c"},show2="a")class TestAnno{
   }

接下来要说一个特别的情况就是如果方法名叫做value并且只有他需要赋值,那么我们可以直接写值不写名。

把show方法改为:

int value();

那么这个时候:

@JavaDocDemo(1)class TestAnno{
   }

但是当不只有他一个要赋值呢？

public @interface JavaDocDemo {
       int value();    myAnno show1();}

这时必须写上value

@JavaDocDemo(value = 1,show1 = @myAnno)class TestAnno{
   }

3.元注解

元注解是用于描述注解的注解。

1.@Target：描述注解能够作用的位置

他的取值为枚举类型ElementType的成员。

//表示@JavaDocDemo只可以作用在类上@Target(ElementType.TYPE)public @interface JavaDocDemo {
       String[] show2_();    String[] show2();}@JavaDocDemo(show2_ = {
   "a","b","c"},show2="a")class TestAnno{
   }

//表示@JavaDocDemo只可以作用在方法上@Target(ElementType.METHOD)public @interface JavaDocDemo {
       String[] show2_();    String[] show2();}class TestAnno{
       @JavaDocDemo(show2_ = {
   "a","b","c"},show2="a")    void get(){
       }}

//表示@JavaDocDemo只可以作用在成员变量上@Target(ElementType.FIELD)public @interface JavaDocDemo {
       String[] show2_();    String[] show2();}class TestAnno{
       @JavaDocDemo(show2_ = {
   "a","b","c"},show2="a")    int i;}

还有些其他的读者自行尝试。

2.@Retention：描述注解被保留的阶段

@Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到

3.@Documented：描述注解是否被抽取到api文档中

被@Documented修饰的注解，在生成doc文档时会写出来，否则没有。

4.@Inherited：描述注解是否被子类继承

被@Inherited修饰的注解(假设我们叫A),如果@A修饰类，当该类作为父类被继承时，子类也被@A修饰。

四.解析注解

这一部分需要用到反射,这里举个案例就明白了。

import java.lang.annotation.ElementType;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;/** * @author jackTan */@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)public @interface JavaDocDemo {
           String method();        String type();}

/** * @author jackTan */@JavaDocDemo(method = "xxx" ,type = "int")public class MainTest {
       public static void main(String[] args) throws ClassNotFoundException {
           Class
   
     testAnnoClass = MainTest.class;        JavaDocDemo annotation = testAnnoClass.getAnnotation(JavaDocDemo.class);        System.out.println(annotation);        System.out.println(annotation.method()+" "+annotation.type());    }}

那么这里我要着重来强调一下就是一定要指明@Retention(RetentionPolicy.RUNTIME),否则使用getAnnotation()获取到的是null，同时注意包,千万别搞错了，因为在其他包下面也有同名的注解和类

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

转载地址：http://ftlzi.baihongyu.com/

你可能感兴趣的文章