注解和反射（一）注解

注解和反射（一）注解

目录

• 注解和反射（一）注解
  • 注解（Annotation）
    • 注解的作用
    • 注解（Annotation）的格式
    • 注解可以在哪里使用
    • 内置注解
    • 元注解
      • 元注解的作用
        • 4个标准的meta-annotation类型
    • 自定义注解
      • 注意：
  • 实例代码
    • @Target
    • @Retention和@Documented和@Inherited
    • 自定义注解

注解（Annotation）

注解的作用

• 不是程序本身，可以对程序作出解释，（这一点和注释（comment）没什么区别）
• 可以被其他程序（比如：编辑器）读取
• 注解带有检查的约束，可以保障程序的正确性

注解（Annotation）的格式

• 格式：

  @注释名

• 举例：

  @Override//重写的注解
  

• 其中还可以添加一些参数值,例如：

  @SuppressWarnings(value="unchecked")
  

注解可以在哪里使用

• 可以在package、class、method、field等上面使用
• 添加注解相当于添加了额外的辅助信息，
• 可以通过反射机制编程实现对这些元数据的访问

内置注解

• @Override//只适用于修辞方法（只适用于方法），表示一个方法声明打算重写超类中的另一个方法声明
  

• @Deprecated//此注释可以用于修辞方法、属性、类，表示不鼓励程序员使用的意思
  

• @SuppressWarnings//用来抑制(镇压、忽视)编程时的警告信息，需要添加一个正确的参数才能使用
  

  • @SuppressWarnings需要添加一个正确的参数才能使用

  • @SuppressWarnings("all")//镇压（忽视）全部警告，如@Deprecated已经警告的代码会去掉警告
    

  • @SuppressWarnings("unchecked")//镇压（忽视）未检查的警告
    

  • @SuppressWarnings(value={"unchecked","deprecation"})//同时忽略unchecked和deprecation的警告信息
    

  • 等等

元注解

元注解的作用

• 负责注解其他注解，Java定义了4个标准的meta-annotation类型，他们被用来提供对其他annotation（注解）类型作说明

4个标准的meta-annotation类型

• @Targer//用于描述注解的使用范围，也就是描述注解可以用在什么地方
  

• @Retention//表示需要在什么级别保存该注释信息，用于描述注解的生命周期（SOURCE<CLASS<RUNTIME）（一般都用RUNTIME）(RUNTIME:运行时有效)
  

• @Documented//说明该注解将被包含在javadoc中
  

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

自定义注解

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

注意：

• @interface用来声明一个注解

  格式：

  @interface 注解名{定义内容}
  

• 其中每一个方法都是声明了一个配置参数

• 注解的参数：参数类型+参数名()

• 方法的名称就是参数的名称

• 返回值类型就是参数的类型（返回值只能是基本类型、Class、String、enum）

• 可以通过default来声明参数的默认值

      String name() default "";//默认值为空
      int age() default 0;//默认值为0
  

• 如果只有一个参数成员，一般参数名为value

  @SuppressWarnings("all")
  

  或

  @SuppressWarnings(value="all")
  

• 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值

实例代码

@Target

• 实例1

//测试元注解
public class Test01 {
    @MyAnnotation//能用在方法上
    public void test(){

    }
}
//定义一个注解
@Target(value = ElementType.METHOD)//只能在方法上使用
@interface MyAnnotation{

}

• 实例2

//测试元注解
@MyAnnotation//能用在类上
public class Test01 {
    @MyAnnotation//能用在方法上
    public void test(){

    }
}
//定义一个注解
@Target(value = {ElementType.METHOD,ElementType.TYPE})//能方法和类上使用
@interface MyAnnotation{

}

@Retention和@Documented和@Inherited

//测试元注解
@MyAnnotation//能用在类上
public class Test01 {
    @MyAnnotation//能用在方法上
    public void test(){

    }
}
//定义一个注解
@Target(value = {ElementType.METHOD,ElementType.TYPE})//能方法和类上使用
@Retention(value = RetentionPolicy.RUNTIME) //表示我们的注解在什么地方有效（RUNTIME表示运行时有效）
@Documented//说明该注解将被包含在javadoc中
@Inherited//说明子类可以继承父类中的该注解
@interface MyAnnotation{
}

自定义注解

//自定义注解
public class Test02 {
    @MyAnnotation2(age = 18,schools = {"dad","faff"})//因为定义了参数，所以必须给没有默认值的写参数
    public void test(){

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