关于java:Java-注解

9次阅读

共计 5102 个字符,预计需要花费 13 分钟才能阅读完成。

Java 注解

  • 本文参照学习:

    感激大佬~

  • 集体源码地址:https://gitee.com/WSM540

注解

前言:

框架等于:注解 + 反射 + 设计模式~

JDK 5.0 开始, Java 减少了对元数据的反对, 也就是 Annotation(注解) 安闹太湿~

Annotation 其实就是代码里的 非凡标记, 这些标记能够在编译, 类加 载, 运行时被读取, 并执行相应的解决

  • 通过:注解 + 反射

    反射扫描对应类的注解,以及注解下面的参数,给类的增加一些通用的操作~

  • 开发者,能够:

    不扭转原有逻辑的状况下, 在源文件中嵌入一些补充信息

    代码剖析工具、开发工具和部署工具:能够通过这些补充信息进行验证或者进行部署。

Annotation 能够像修饰符一样被应用:

  • 用于润饰包, 类, 结构器, 方 法, 成员变量, 参数, 局部变量的申明

为什么要援用注解:

应用【注解】之前:

  • xml 是被宽泛的利用于形容 元数据 它以 松耦合 的形式实现了框架中简直所有的配置

    然而随着我的项目越来越宏大: XML 的内容也越来越简单,一些利用开发人员和架构师发现保护老本变高。

  • 人门跟心愿呈现一些和代码 紧耦合的形式~

    能够更加清晰的理解类的申明~

  • 于是就有人提出来一种标记式高耦合的配置形式 注解:

    办法上能够进行注解,类上也能够注解,字段属性上也能够注解,反正简直须要配置的中央都能够进行注解. 对象代码进行申明治理;

注解须要配合反射一起应用~

Java 常见的 Annotation 实例:

@Override

  • 限定重写父类办法, 该注解只能用于办法 属于一种 标记注解
  • //1. 定义一个接口
    interface Info{void show();
    }
    //2. 创立一个类, 实现接口 info 实现办法~
    class Student implements Info{
        // 个别工具都会主动加一个注解, 
        //    示意:改办法是实现接口的重写办法(); 当然不加也没啥事件, 只是一个程序提醒~
        @Override
        public void show() {}
    }

    @Deprecated

  • 用于示意所润饰的元素 (类, 办法等) 已过期,通常是因为 所润饰的构造危险或存在更好的抉择
  • Date date = new Date(2000,9,9); 
    // 这段代码并不会报错:创立一个日期对象 2000-09-09 日期对象;
    //    但 new Date(); 办法上会有一个 删除线,提醒改办法以及淘汰~
    
    //ctrl+ 右击  查看源码发现, 改办法被注解为已淘汰~
    @Deprecated
    public Date(int year, int month, int date) {this(year, month, date, 0, 0, 0);
    }
  • 这样申明并不是示意,办法不能应用而是 不倡议 曾经有更好的办法了

    JDK 是向下兼容的,不然每次更新一些老我的项目如果不合乎就会出错,就不好了~

  • 场景:

    如果你的我的项目中有一个,你写的办法,忽然一个大佬也写了一个更好的,你又不想删除 已经的办法

    都是手敲的多少有点舍不得 能够应用该 注解 ,标记一下办法~ 已淘汰😥

@SuppressWarnings

  • 克制编译器正告
  • 当我门定义对象,没有被应用的时候, 编辑器会呈现 正告 能够应用该 注解 屏蔽正告⚠

应用注解后面要加 @符号 当作一个修饰符应用,申明在类 办法 属性上!

自定义注解:

目前除了, JDK 自带的注解,很多的框架也提供了很多的注解:

  • Spring JPA Hibernate 很多框架都提供很多注解,实现基于注解开发~
  • 自定义注解,并不常见但能够理解 …

    自定义注解必须配上注解的信息处理流程才有意义 如果没有解析它的代码,它可能连正文都不如

实现:

  • 定义新的 Annotation 类型应用 @interface 关键字
  • 自定义注解主动继承了:Java.lang.annotation.Annotation 接口
  • Annotation 的成员变量

    以无参数办法的模式来申明

    其:办法名和返回值 对应 该成员的 == 名字 == 和 == 类型 ==

  • 类型只能是:

    八种根本数据,String,Class,enum,Annotation

MyAnnotation

Idea 工具创立 Annotation 注解类:

MyAnnotation

/** 自定义注解 1.0 */
@Retention(RetentionPolicy.RUNTIME)                    // 一种元注解: 标识注解的执行生命周期 (什么时候被执行!)
public @interface MyAnnotation {

    // 这是自定义注解中, 属性的申明形式: 数据类型 参数名;
//    String value();

    // 指定成员变量的初始值可应用 default 关键字
    String value() default "wsm";                   /** 如果只有一个参数成员,倡议应用参数名为 value */}

TestAnnotation.Java

package com.wsm.anotation;
import java.lang.annotation.Annotation;
/** 步骤 2 */
public class TestAnnotation {public static void main(String[] args) {
        // 应用反射, 来实现注解是实习, 这里只是简略的输入.
        //  很多时候反射, 扫描所有的类, 并判断注解的参数 欠缺类添新的性能~
        Class clazz = Wsm.class;
        Annotation[] annotations = clazz.getAnnotations();      // 获取以后类的注解汇合~
        for(int i = 0;i < annotations.length;i++){              // 输入注解汇合的值!System.out.println(annotations[i]);
        }
    }
}

/** 步骤 1 */
//@MyAnnotation                     // 啥也不写默认值~
//@MyAnnotation(value = "abc")      // 手动填写
@MyAnnotation("efg")              // 如果注解的只有一个属性且属性名是 value: 能够省略不写
class Wsm{
    // 一个空的类, 应用 自定义注解~
    @MyAnnotation
    public void show(){System.out.println("show 办法()");
    }
}
  • ok,这就是一个最根本是 自定义注解的应用~
  • 别忘了自定义注解要加上 @Retention(RetentionPolicy.RUNTIME) 不然类加载时候,扫描不到;

    @Retention 是什么?

    @Retention 是一种 元注解

元注解Meta-Annotation

什么是元注解:

Java5.0 定义了 4 个规范的 Meta-Annotation类型 继承了:Java.lang.annotation.Annotation 接口

元注解的作用就是负责注解其余注解: 它们被用来提供对其它 注解类型作阐明; 润饰注解的注解

JDK 中的元注解 4:

@Retention

  • 用于润饰一个 Annotation 定义,用于指定该 Annotation 的生命 周期

    @Rentention 蕴含一个 RetentionPolicy 类型的成员变量enum 类型 @Rentention 蕴含一个 RetentionPolicy 类型的成员变量

  • RetentionPolicy 枚举

    **RetentionPolicy.SOURCE**
    - ** 注解只在源码阶段保留,在编译器进行编译时它将被抛弃漠视 **
    
    **RetentionPolicy.CLASS**
    - ** 当运行 Java 程序时, JVM 不会保留注解,这是 ` 默认值 `**
    - ** 实例:** `@Override、@Deprecated、@SuppressWarnning`
    
    **RetentionPolicy.RUNTIME**
    - ** 当运行 Java 程序时, JVM 会保留正文,` 程序能够通过反射获取该正文 `**
    - ** 实例:** `@Controller、@Autowired、@RequestMapping`
    - ` 自定义注解, 想要被扫描到, 须要增加改注解 @Retention(RetentionPolicy.RUNTIME)`

@Target

  • 用于润饰 Annotation 定义, 指定被润饰的 Annotation 能用于 润饰哪些程序元素 默认值:为任何元素

    即:注解能够润饰的元素:类 属性 泛型 enum 枚举 办法()...

  • JDK5.0

    顾名思义,这个元注解必定是和文档无关。它的作用是可能将注解中的元素蕴含到 Javadoc 中去 ElementType.ANNOTATION_TYPE 能够给一个注解进行注解
    ElementType.CONSTRUCTOR     能够给构造方法进行注解
    ElementType.FIELD             能够给属性进行注解
    ElementType.LOCAL_VARIABLE     能够给局部变量进行注解
    ElementType.METHOD             能够给办法进行注解
    ElementType.PACKAGE         能够给一个包进行注解
    ElementType.PARAMETER         能够给一个办法内的参数进行注解
    ElementType.TYPE             能够给一个类型进行注解,比方类、接口、枚举
  • JDK8.0 顾名思义,这个元注解必定是和文档无关。它的作用是可能将注解中的元素蕴含到 Javadoc 中去

    ElementType.TYPE_PARAMETER    能够给一个泛型进行注解
    ElementType.TYPE_USE         示意该注解能写在应用类型的任何语句中 ` 申明了改类型就不必在申明其它形式了.`

@Documented

  • 顾名思义,这个元注解必定是和文档无关。它的作用是可能将注解中的元素蕴含到 Javadoc 中去
  • 定义为 Documented 的注解必须设置 Retention 值为 RUNTIME

@Inherited

  • @Inherited 元注解是一个标记注解 被标注的类型是被继承的
  • A 类 应用了带有 @Inherited的注解,B 类 继承 A 类,B 也会领有 A 的注解~

JDK8.0 新增元注解

@Repeatable

  • 可反复注解 有时候, 须要注解在类上屡次申明应用能够应用改注解.

JDK8.0 可反复注解应用:

定义可反复的注解容器注解

MyAnnotations

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

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations {MyAnnotation[] value();             // 注解属性, 是可反复注解的数组~}

MyAnnotation

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

@Retention(RetentionPolicy.RUNTIME)
@Repeatable(MyAnnotations.class)           //1.8 新增可反复注解, 晓得注解容器~
public @interface MyAnnotation {String value();                         // 参数~
}

TestAnnotation.java

import java.lang.annotation.Annotation;

/** 步骤 2 */
public class TestAnnotation {public static void main(String[] args) {
        // 应用反射, 来实现注解是实习, 这里只是简略的输入.
        //  很多时候反射, 扫描所有的类, 并判断注解的参数 欠缺类添新的性能~
        Class clazz = Wsm.class;
        Annotation[] annotations = clazz.getAnnotations();      // 获取以后类的注解汇合~
        for(int i = 0;i < annotations.length;i++){              // 输入注解汇合的值!System.out.println(annotations[i]);
        }
    }
}

/** 步骤 1 */
@MyAnnotation("abc")        // 可反复注解, 能够一次增加多个属性!@MyAnnotation("efg")
class Wsm{
    // 一个空的类, 应用 自定义注解~
    public void show(){System.out.println("show 办法()");
    }
}

运行后果:

@com.wsm.annotation2.MyAnnotations(value[@com.wsm.annotation2.MyAnnotation(value=abc),@com.wsm.annotation2.MyAnnotation(value=efg)])

输入了多个注解的 value

正文完
 0