内置注解与自定义注解

基础知识

• 注解是JDK5.0引入的新技术

• 可以附加在package，class，method，field等上面，相当于给他们添加了额外的辅助功能，我们可以通过反射机制编程实现对这些元数据的访问。

内置注解

• @Override：此注释只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法声明。

• @Deprecated：此注释可以用于修辞方法，属性，类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择。

• @SuppressWarnings：用来抑制编译时的警告信息。

  与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参 数都是已经定义好了的，我们选择性的使用就好了。

  @SuppressWarnings（"all"）：抑制所有警告 @SuppressWarnings（"unchecked"）：抑制未经检查的操作（比 如强转）的警告。 @SuppressWarnings（value=["unchecked"，"deprecation"]）

  抑制未经检查的操作，并且如果使用了使用@Deprecated注释的 方法，编译器将出现警告信息。使用这个注释将警告信息去掉。

元注解

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

@Target，@Retention，@Documented，@Inherited

@Target：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）

@Retention：表示需要在什么级别保存该注释信息，用于描述注解的生命周期

（SOURCE < CLASS < RUNTIME）

@Document：说明该注解将被包含在javadoc中

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

//测试元注解
@MyAnnotation
public class Demo02_MetaAnnotation {
    @MyAnnotation
    public void test() {
    }
}
//定义一个注解
//@Target可以用在什么地方
//ElementType.METHOD方法上有效  ElementType.TYPE类上有效
@Target(value = {ElementType.METHOD, ElementType.TYPE})
//@Retention在什么地方有效
//RUNTIME>CLASS>SOURCES
@Retention(value = RetentionPolicy.RUNTIME)
//@Documented 表示是否将我们的注解生成在Javadoc中
@Documented
//@Inherited 子类可以继承父类的注解
@Inherited
@interface MyAnnotation { }

自定义注解

@interface用来声明一个注解，格式：public@interface 注解名（定义内容）

• 其中的每一个方法实际上是声明了一个配置参数。

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

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

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

• 如果只有一个参数成员，一般参数名为value注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值。

//自定义注解
public class Demo03_CustomAnnotation {
    //注解可以显示赋值,如果没有默认值,就必须给注解赋值
    @MyAnnotation2(name = "张三")
    public void test() {
    }
}
@Target(value = {ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2 {
    //注解的参数:参数类型+参数名()
    //String name();
    String name() default "";
    int age() default 0;
    int id() default -1;//-1代表不存在
    String[] schools() default {"西部开源","清华大学"};