Java注解

注解

什么是注解？

• 不是程序本身，可以对程序作出解释
• 可以被其他程序读取，例如编译器
• 注解是以“@注解名”在代码中存在，还可以添加参数值，例如@SuppressWarning(value=”unchecked” )
• 可以在package、class、method、field等使用，添加额外信息
• 反射机制编程实现对这些元数据的访问

内置注解

• @Override 重写: 定义在java.lang.Override中，该注解用于修辞方法，表示一个方法声明重写超类中的另一个方法声明

• @Deprecated 废弃: 定义在java.lang.Deprecated中，可以用于修饰类、方法、属性、表示不支持程序员使用这种元素，因为有更好的选择。

• @SupressWarning(“all”)

  定义在java.lang.SuppreWarning中，用来抑制编译时所产生的警告信息。该注解需要添加参数

  • SupressWarning(“unchekced”)
  • SupressWarning({“unchecked”, “deprecation”})

package com.yang.lesson01;

import java.util.ArrayList;
import java.util.List;

public class Test01 extends Object{

    //@Override 重写的注解
    @Override
    public String toString() {
        return super.toString();
    }

    //@Deprecated 不推荐程序员使用，但是可以使用，或者存在更好的方式
    @Deprecated
    public static void test(){
        System.out.println("test");
    }

    //@SuppressWarnings("all")  用来抑制编译时所产生的警告信息,该注解需要添加参数
    @SuppressWarnings("all")
    public void test2(){
        List list = new ArrayList();
    }

    public static void main(String[] args) {
        test();
    }
}

元注解

负责注解其它注解

1. @Target() 参数： {ElementType.TYPE, ElementType.METHOD} , 用于描述注解的使用范围，例如：类、方法
2. @Retention() 参数： RetentionPolicy: SOURCE|CLASS|RUNTIME, 表示需要在什么级别保存该注释信息，用于描述注解的生命周期，一般在Runtime中
3. @Document() 说明该注解将被包含在javadoc中
4. @Inherited() 说明子类可以继承父类中的该注解

package com.yang.lesson01;

import java.lang.annotation.*;

@MyAnnotation
public class Test02{

    @MyAnnotation
    public void test(){

    }

}

@Target(value = {ElementType.METHOD,ElementType.TYPE})  //Target 描述注解的使用范围，例如：类、方法
@Retention(value = RetentionPolicy.RUNTIME) //Retention 表示需要在什么级别保存该注释信息，用于描述注解的生命周期，一般在Runtime中
@Documented   //说明该注解将被包含在javadoc中
@Inherited  //说明子类可以继承父类中的该注解
@interface MyAnnotation{    //定义一个注解

}

自定义注解

使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口

分析:

• 当@interface 自定义注解时，自动继承了java.lang.annotation.Annotation接口
• @interface用来声明一个注解，格式：public @interface 注解名{ 自定义内容}
• 每一个方法实际上就是声明了一个配置参数
• 方法的名称就是参数的名称
• 返回值值类型就是参数的类型（返回值只能是基本类型Class、String、enum等）
• 可以通过default来声明参数的默认值
• 当只有一个参数成员的时候，一般参数名为value
• 注解元素必须要有值，我们自定义注解元素时，经常使用空字符串，0作为默认值

package com.yang.lesson01;

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

public class Test03 {
    //注解可以显示赋值，如果没有默认值，我们就必须给注解赋值
    @MyAnnotation2(name = "yy",id = 10,schools = "北京大学")
    public void test(){

    }

    public void test2(){

    }
}

@Target(value = {ElementType.METHOD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{
    //注解参数：参数类型 + 参数名 + ();
    String name();
    int id() default -1;    //如果默认值为-1，代表不存在
    int age() default 22;   //default 默认值
    String[] schools();
}