Java注解之 @Target、@Retention、@Documented简介

先来看一个Spring中的一个常用注解

package org.springframework.stereotype;import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Controller {/*** The value may indicate a suggestion for a logical component name,* to be turned into a Spring bean in case of an autodetected component.* @return the suggested component name, if any*/String value() default "";}

@Target({ElementType.TYPE}) 注解

ElementType 这个枚举类型的常量提供了一个简单的分类：注解可能出现在Java程序中的语法位置（这些常量与元注解类型(@Target)一起指定在何处写入注解的合法位置）

package java.lang.annotation;/*** The constants of this enumerated type provide a simple classification of the* syntactic locations where annotations may appear in a Java program. These* constants are used in {@link Target java.lang.annotation.Target}* meta-annotations to specify where it is legal to write annotations of a* given type.* @author  Joshua Bloch* @since 1.5* @jls 9.6.4.1 @Target* @jls 4.1 The Kinds of Types and Values*/
public enum ElementType {/** 类, 接口 (包括注解类型), 或 枚举 声明 */TYPE,/** 字段声明（包括枚举常量） */FIELD,/** 方法声明(Method declaration) */METHOD,/** 正式的参数声明 */PARAMETER,/** 构造函数声明 */CONSTRUCTOR,/** 局部变量声明 */LOCAL_VARIABLE,/** 注解类型声明 */ANNOTATION_TYPE,/** 包声明 */PACKAGE,/*** 类型参数声明** @since 1.8*/TYPE_PARAMETER,/*** 使用的类型** @since 1.8*/TYPE_USE
}字段声明（包括枚举常量） */FIELD,/** 方法声明(Method declaration) */METHOD,/** 正式的参数声明 */PARAMETER,/** 构造函数声明 */CONSTRUCTOR,/** 局部变量声明 */LOCAL_VARIABLE,/** 注解类型声明 */ANNOTATION_TYPE,/** 包声明 */PACKAGE,/*** 类型参数声明** @since 1.8*/TYPE_PARAMETER,/*** 使用的类型** @since 1.8*/TYPE_USE
}

@Retention({RetentionPolicy.Runtime}) 注解

RetentionPolicy这个枚举类型的常量描述保留注解的各种策略，它们与元注解(@Retention)一起指定注释要保留多长时间

package java.lang.annotation;
/*** Annotation retention policy.  The constants of this enumerated type* describe the various policies for retaining annotations.  They are used* in conjunction with the {@link Retention} meta-annotation type to specify* how long annotations are to be retained.** @author  Joshua Bloch* @since 1.5*/
public enum RetentionPolicy {/*** 注解只在源代码级别保留，编译时被忽略*/SOURCE,/*** 注解将被编译器在类文件中记录* 但在运行时不需要JVM保留。这是默认的* 行为.*/CLASS,/***注解将被编译器记录在类文件中
     *在运行时保留VM，因此可以反读。* @see java.lang.reflect.AnnotatedElement*/RUNTIME
}注解将被编译器在类文件中记录* 但在运行时不需要JVM保留。这是默认的* 行为.*/CLASS,/***注解将被编译器记录在类文件中
     *在运行时保留VM，因此可以反读。* @see java.lang.reflect.AnnotatedElement*/RUNTIME
}

@Documented注解

Documented注解表明这个注解是由 javadoc记录的，在默认情况下也有类似的记录工具。如果一个类型声明被注解了文档化，它的注解成为公共API的一部分。

Java注解之 @Target、@Retention、@Documented简介相关推荐

java @Target@Retention @Documented 注解的含义
spring 注解@Target@Retention @Documented 当我们看想看一个spring 注解点击进去看的时候就会发现,注解类中大多都会有标题中的这三个注解,这三个注解什么意思呢?, ...
@Target,@Retention,@Documented注解简介
学习目标: 了解@Target,@Retention,@Documented各自的作用学习内容: @Target:说明了Annotation所修饰的对象范围作用:用于描述注解的使用范围(即:被描述 ...
Java注解篇（一）四大元注解@Target@Retention@Documented注解
1.@Target目标注解,意思带注解的适用于哪些范围,有以下参数可供使用 @Target(ElementType.METHOD) 1.CONSTRUCTOR:用于描述构造器 2.FIELD:用于描述 ...
Java注解定义使用@Retention、@Documented、@Target、@Inherited、@Repeatable
元标签有 @Retention.@Documented.@Target.@Inherited.@Repeatable 5 种. @Retention Retention 的英文意为保留期的意思.当 @ ...
spring 注解@Target @Retention @Documented
@Target({ ElementType.PARAMETER, ElementType.METHOD }) @Retention(RetentionPolicy.RUNTIME) @Document ...
JAVA注解笔记之@Retention
@Retention @Retention是java的元注解,用来注解注解的,是注解的注解 @Documented @Retention(RetentionPolicy.RUNTIME) @Targe ...
@Target,@Retention,@Documented 注释的作用
@Target target英文有目标.目的的意思. @Target在java中是注释类.@Target作用于修饰的注释可以修饰的类型范围 @Target包含一个ElementType[]元素类型的数 ...
java注释和注解_深入理解JAVA注解(Annotation)以及自定义注解
Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释机制.Java 语言中的类.方法.变量.参数和包等都可以被标注.注解可以看作是一种特殊的标记,在程序在编译或 ...
Java 注解知识总结
引言本博客总结自<Java 编程思想>第 20 章. 一.什么是注解注解是 Java 5 引入的一种通过反射机制实现的语法特性,开发者可以通过在类.域.方法等元素前面标记一个" ...

Java注解之 @Target、@Retention、@Documented简介

Java注解之 @Target、@Retention、@Documented简介相关推荐

最新文章

热门文章