zoukankan      html  css  js  c++  java
  • 注解介绍

    注解@Retention可以用来修饰注解,是注解的注解,称为元注解

    Retention注解有一个属性value,是RetentionPolicy类型的,Enum RetentionPolicy是一个枚举类型

    /** * 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 {

    /**

    * Annotations are to be discarded by the compiler.

    */ SOURCE,

    /**

    * Annotations are to be recorded in the class file by the compiler

    * but need not be retained by the VM at run time. This is the default

    * behavior.

    */ CLASS,

    /**

    * Annotations are to be recorded in the class file by the compiler and

    * retained by the VM at run time, so they may be read reflectively.

    * * @see java.lang.reflect.AnnotatedElement

    */ RUNTIME }

    /**

    *注释保留策略。此枚举类型的常数

    *描述保留注释的各种策略。使用它们

    *与{@link Retention}元注释类型一起指定 *注释要保留多长时间。

    *

    * @作者约书亚·布洛赫

    * @since 1.5

    * / public enum RetentionPolicy{

    /** *保留源文件,编译成Class注释将被编译器丢弃。

    * / SOURCE,

    /** 注解被保留到class文件,但jvm加载class文件时候被遗弃,这是默认的生命周期;

    * / Class,

    /** 注解不仅被保存到class文件中,jvm加载class文件之后,仍然存在;

    * * @see java.lang.reflect.AnnotatedElement

    * / RUNTIME }

    .java<.class<内存中的字节码

    首先要明确生命周期长度 SOURCE < CLASS < RUNTIME ,所以前者能作用的地方后者一定也能作用

    @Inherited:说明子类可以继承父类中的该注解

    @Target:注解的作用目标

    public @interface Target {

    /**

    * Returns an array of the kinds of elements an annotation type

    * can be applied to.

    * @return an array of the kinds of elements an annotation type

    * can be applied to

    */ ElementType[] value();

    }

      /** *返回可应用于注释类型的元素类型的数组。

    * @返回注释类型中元素类型的数组可以应用到

    * /

     ElementType

    /* *版权所有(c)2003,2013,Oracle和/或其附属公司。保留所有权利。 *ORACLE专有/机密。使用须遵守许可条款。

    */ 包java.lang.annotation;

    /** *这种枚举类型的常量提供了一个简单的语法位置分类,在那里注释可能出现在Java程序中。这些常数用于

    {@link Target java.lang.annotation.Target}元注释,指定在何处编写给定类型的注释是合法的。

    * *

    注释可能出现的语法位置分为声明上下文,其中注释适用于声明,而类型上下文,其中注释适用于声明和表达式中使用的类型。

    * *

    常数 {@link#ANNOTATION_TYPE}, {@link#构造函数}, {@link#字段}, {@link#局部变量}, {@link#方法}, {@link#包}, {Link Ly*参数}, {@link#类型}, {Link LyTyType参数}对应于JLS.94.4.1中的声明上下文。

    * *

    例如,类型是用{@code@Target(ElementType.FIELD)}进行元注释的注释只能作为字段声明的修饰符写入。

    * *

    常量{@link#TYPE USE}对应于JLS 4.11中的15个类型上下文,以及两个声明上下文:类型声明(包括注释类型声明)和类型参数声明。

    * *

    例如,类型是用{@code@Target(ElementType.type_USE)}进行元注释的注释可以写在字段的类型上(如果是嵌套的、参数化的或数组类型,则可以写在字段的类型内),也可以显示为类声明的修饰符。

    * *

    常量{@code TYPE_USE}包括类型声明和类型参数声明,以方便为注释类型提供语义的类型检查程序的设计者。

    例如,如果注释类型{@code non null}是用{@code@Target(ElementType.Type_ USE)}进行元注释的,

    则类型检查器可以将{@code@NonNull}{@code class C{…}}视为类{@code C}的所有变量都是非空的,

    同时仍然允许其他类的变量为非空或非空,

    这取决于{@code@non null}是否出现在变量的声明中。

    * *@作者乔舒亚·布洛赫 *@从1.5开始 *@jls 9.6.4.1@目标 *@jls 4.1类型和值的种类

    */ public enum ElementType{

    /**类、接口(包括注释类型)或枚举声明

    */

    TYPE,

    /**字段声明(包括枚举常量)

    */

    FIELD,

    /**方法声明

    */

    METHOD,

    /**形式参数声明

    */

    PARAMETER,,

    /**构造函数声明

    */

    CONSTRUCTOR,

    /**局部变量声明

    */

    LOCAL_VARIABLE,

    /**注释类型声明

    */

    ANNOTATION_TYPE,

    /**包声明

    */

    PACKAGE,

    /** *类型参数声明 **@从1.8开始 */

    TYPE_PARAMETER

    /**

    TYPE_PARAMETER

    * *@从1.8开始

    *

    / TYPE_USE }

    @Target(ElementType.TYPE)——接口、类、枚举、注解

    @Target(ElementType.FIELD)——字段、枚举的常量

    @Target(ElementType.METHOD)——方法

    @Target(ElementType.PARAMETER)——方法参数

    @Target(ElementType.CONSTRUCTOR) ——构造函数

    @Target(ElementType.LOCAL_VARIABLE)——局部变量

    @Target(ElementType.ANNOTATION_TYPE)——注解

    @Target(ElementType.PACKAGE)——包

     @Document

    *表示带有类型的注释将由javadoc记录

    *和默认的类似工具。应使用此类型来注释

    *声明类型的注释会影响到annotated的使用

    *客户提供的元素。如果一个类型声明被注释了

    *记录,它的注释成为公共API的一部分

    *注释的元素。 *

    一点点学习,一丝丝进步。不懈怠,才不会被时代淘汰
  • 相关阅读:
    XSS跨站脚本攻击实例讲解,新浪微博XSS漏洞过程分析
    PHP常量PHP_SAPI与函数php_sapi_name()简介,PHP运行环境检测
    PHP导出数据到CSV文件函数/方法
    iOS8 Core Image In Swift:视频实时滤镜
    实战:mysql版本号升级
    Apache Shiro 使用手冊 链接文件夹整理
    Windows 驱动开发
    Python标准库:内置函数bytearray([source[, encoding[, errors]]])
    cocos2d-x 2.2.3 之菜单分析(1)
    JSP具体篇——out
  • 原文地址:https://www.cnblogs.com/wangbiaohistory/p/12522153.html
Copyright © 2011-2022 走看看