java基础(5)——注解和反射(1)注解(内置注解、元注解、自定义注解)

注解和反射

注解

• Annotation是从jdk5.0开始引入的新技术
• Annotation的作用：
  • 不是程序本身，可以对程序做出解释
  • 可以被其他程序读取
• Annotation的格式：
  • @注释名，还可以添加一些参数
  • @SuppressWarnings（value=“unchecked”）
• Annotation在哪里使用？
• 可以附加在package，class，method，field等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制编程实现对这些元数据的访问

内置注解

• @Override：定义在java.lang.Override中，此注解值只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法声明。
• Deprecated：定义在java.lang.Deprecated中，此注解值只适用于修辞方法，属性，类表示不鼓励程序员使用这样的元注释，通常是因为他很危险或者存在更好的选择
• @SuppressWarnings：定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息
  • 与前两个注解有所不同，需要添加一个参数才能正确使用，这些参数都是已经定义好了的，选择性使用即可
  • @SuppressWarnings(“all”)
  • @SuppressWarnings(“unchecked”)
  • @SuppressWarnings(value={“unchecked”,“deprecation”})
  • …

public class TestAnno {
    //@Override重写超类的方法
    @Override
    public String toString() {
        return super.toString();
    }

    //不推荐使用，但可以用
    @Deprecated
    public static void test1(){
        System.out.println("deprecated");
    }
    
	//抑制编译时警告  需要参数
    @SuppressWarnings("all")
    public void test2(){}
    public static void main(String[] args) {
        test1();
    }
}


// @SuppressWarnings源码
@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.CONSTRUCTOR, ElementType.LOCAL_VARIABLE})//可以放置的地方
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    String[] value();//表示参数
}

元注解

• 元注解的作用就是负责解释其他注解，Java定义了4个标准的meta-annotation类型，他们被用来提供对其他annotation类型的说明
• 这些类型和他们所支持的类在java.lang.annotation包中
  • @Target：用于描述注解的使用范围
  • @Retention：表示需要在什么级别保存该注解信息，用于描述注解的生命周期
    • runtime>class>source
  • @Document：说明该注解被包含在javadoc中
  • @Inherited：说明子类可以继承父类的该注解

//注解可以在什么地方使用
@Target(value = {ElementType.FIELD, ElementType.METHOD})
//注解在什么时候有效 runtime>class>source
@Retention(RetentionPolicy.RUNTIME)
//是否生成javadoc
@Documented
//是否继承注解
@Inherited
public @interface MyAnnotation { }

自定义注解

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

分析

• @interface用来声明一个注解，格式：public @interface 注解名{定义内容}
• 其中每一个方法实际上是声明了一个配置参数
• 方法的名称就是参数的名称
• 返回值类型就是参数类型（返回值只能是基本类型Class，String，enum）
• 可以通过default来声明参数的默认值
• 如果只有一个参数成员，一般参数名为value，因为可以省去
• 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值

public class TestMyAnno {
//    @MyAnnotation1(hobbies = {"code, read"})
    @MyAnnotation2("here")//@MyAnnotation2(value = "here")
    public static void main(String[] args) {
    }
}
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation1{
    //定义：  参数类型 参数名();
    int id() default 0;//默认值为0，当有默认值时，在写注解时，可以写也可以不写
    int age() default -1;//默认值为-1，代表不存在
    String name() default "";
    String[] hobbies();
}
@interface MyAnnotation2{
    String value();//当只有一个参数时，可以用value，因为在写时，参数名可以省去
}

如有不对的地方欢迎指出，共同进步！