java 注解

注解

什么是注解

• 不是程序本身，可以对程序作出解释
• 可以被其他程序读取
• 格式：@注释名，还可以添加一些参数值，例如@SuppressWarnings(value=“unchecked”)
• 可以附加在package, class, method, field等上面

内置注解

• @Override
• @Deprecated
• @SuppressWarnings

元注解

负责注解其他注解

• @Target：用于描述注解的使用范围
• @Retention：用于描述注解的生命周期，表示需要在什么级别保存该注释信息
  • (SOURCE < CLASS < RUNTIME)
• @Documented：说明该注解将被包含在javadoc中
• @Inherited：说明子类可以继承父类中的该注解

自定义注解

package com.nocilantro.Annotation;

import java.lang.annotation.*;

/**
 * 测试元注解
 */
@MyAnnotation
public class Test02 {

    @MyAnnotation
    public void test() {
    }

}

// 表示注解可以用在哪里
@Target(value = {ElementType.METHOD, ElementType.TYPE})
// 表示注解在什么地方还有效
// SOURCE只在源码中有效
// CLASS在CLASS文件中还有效
// RUNTIME在什么地方都有效
@Retention(value = RetentionPolicy.RUNTIME)
// 表示注解将被包含在javadoc中
@Documented
// 子类可以继承父类的注解
@Inherited
@interface MyAnnotation {

}

package com.nocilantro.Annotation;

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

/**
 * 自定义注解
 */
public class Demo03 {
    @MyAnnotation2(name = "Leo", schools = "MIT") // 如果没有默认值，必须给注解赋值
    public void test() {}

    @MyAnnotation3("xixi") // 可以省略value =
    public void test02(){}
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{
    // 注解的参数：参数类型，参数名
    String name() default "Qiuqiu";
    int age() default 0;
    int id() default -1;

    String[] schools() default "UW";
}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3 {
    String value(); // 只有一个参数成员是，使用value作为参数名，使用该注解时可以直接定义value
}