Java注解

Posted YEN_csdn

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Java注解相关的知识,希望对你有一定的参考价值。

Java注解是插入代码中的一种注释或者说一种元数据(mete data)。这些注解信息可以在编译期使用编译期使用预编译工具进行处理,也可以运用Java的反射机制在运行时处理。注解为我们在代码中添加信息提供了一种形式化的方法。

Java中的注解主要是:

  • 元注解
  • 自定义注解

元注解
Java提供了四个基本的元注解类型:
这里写图片描述
这些类型在:java.lang.annotation包中


@Documented
@Documented是指示某一类型的注解将通过java doc和默认的工具进行文档化。如果类型声明是用 Documented 来注释的,则其注释将成为注释元素的公共 API 的一部分。


@Inherited
指示注释类型被自动继承,如果在注释类型中存在@Inherited元注释,并且用户在某一类声明中查询该注释类型,同时该类声明中没有此类型的注释,则将在该类的超类中自动查询该注释类型。此过程会重复进行,直到找到此类型的注释或到达了该类层次结构的顶层 (Object) 为止。如果没有超类具有该类型的注释,则查询将指示当前类没有这样的注释。


@Retention
指示注释类型的注释要保留多久,如果注释类型声明中不存在 Retention 注释,则保留策略默认为 RetentionPolicy.CLASS。
这里写图片描述

  • CLASS: 在class文件中有效,即class保留。
  • RUNTIME: 在运行时有效,即运行时保留。(这样注解处理器可以通过反射,获取到该注解的属性值)
  • SOURCE: 在源文件中有效,即源文件中保留。

@Target
指示注释类型所适用的程序元素的种类。如果注释类型声明中不存在 Target 元注释,则声明的类型可以用在任一程序元素上。如果存在这样的元注释,则编译器强制实施指定的使用限制。
@Target可被用于
这里写图片描述



自定义注解
@interface用来声明一个注解,其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称,返回值类型就是参数的类型(返回值类型只能是基本类型、Class、String、enum)。可以通过default来声明参数的默认值。

定义注解格式:
  public @interface 注解名称 {
  ……
  }
  
创建自定义注解,类似创建接口。

import java.lang.annotation.*;

@Documented
@Inherited
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface AuthorAnno{
    String name();
    char sex() default 'F';
}

自定义注解的规则:

  • 注解方法不带参数。
  • 注解方法的返回值类型:基本类型、String、Enums、Annotation以及前面这些类型的数组类型
  • 注解方法可有默认值:char sex() default ‘F’;

注解解析
通过反射技术来解析自定义注解,使用java.lang.reflect 的接口:AnnotatedElement。该接口允许反射性地读取注释。
这里写图片描述


在代码中使用自定义注解@AuthorAnno。

@Documented
@Inherited
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface AuthorAnno{
    String name();
    char sex() default 'M';
}


public class AuthorAnnoDemo {
    @AuthorAnno(name="YEN",sex = 'M')
    public static void main(String[] args) {
        System.out.println("...........main.............");

    }

    @AuthorAnno(name="yen",sex = 'M')
    public void demo(){
        System.out.println("..... .....demo.............");
    }
}

那么可以利用上面的反射方法,来实现解析@AuthorAnno的功能

public class AnnotationParser {
    public static void main(String[] args) throws ClassNotFoundException {
        String myclass="AuthorAnnoDemo";
        Method[] methods=AnnotationParser.class.getClassLoader().loadClass(myclass).getMethods();
        for(Method method:methods){
            if(method.isAnnotationPresent(AuthorAnno.class)){
                AuthorAnno authorAnno=method.getAnnotation(AuthorAnno.class);
                System.out.println("method................."+method);
                System.out.println("name.........."+authorAnno.name()+"..........sex........."+authorAnno.sex());
            }
        }
    }
}

这里写图片描述


Java的注解要结合反射机制来使用。

以上是关于Java注解的主要内容,如果未能解决你的问题,请参考以下文章

JavaLearn#(20)注解元注解模拟MyBatis注解JDK新特性数据库建模UML建模

Java注解

Springboot注解,元注解,常规操作

Springboot注解,元注解,常规操作

JAVA进阶-注解

java注解简单使用