目录
什么是注解
内置注解:
@Override:定义在java.lang.Override中,此注释只适用于修辞方法,表示一个方法声明打算重写超类中的另一个方法声明。
@Deprecated:定义在java.lang.Deprecated中,此注释可以用于修辞方法,属性,类,表示不鼓励程序员使用这样的元素,通常是因为它很危险或者存在更好的选择。
@SuppressWarnings:定义在java.lang.SuppressWarnings中,用来抑制编译时的警告信息,与前两个注释有所不同,你需要添加一个参数才能正确使用,这些参数都是已经定义好的:@SuppressWarnings("all")、@SuppressWarnings("unchecked")、@SuppressWarnings(value={"unchecked","deprecation"})等等。
//内置注解
public class Test01 {
@Override//方法重写的注解
public String toString() {
return super.toString();
}
@Deprecated//该注解注释的方法不推荐程序员使用,但是可以用,或者存在其他更好的方式
public static void test01(){
System.out.println("这是测试");
}
@SuppressWarnings("all")//该注解注释的方法、类中不会出现警告
public void test02(){
String a = "测试a";
}
public static void main(String[] args) {
test01();//被@Deprecated注解的方法调用时会有删除线,但是依然可以用。
}
}
元注解:
@Target:注解的作用目标
@Target(ElementType.TYPE) //接口、类、枚举
@Target(ElementType.FIELD) //字段、枚举的常量
@Target(ElementType.METHOD) //方法
@Target(ElementType.PARAMETER) //方法参数
@Target(ElementType.CONSTRUCTOR) //构造函数
@Target(ElementType.LOCAL_VARIABLE)//局部变量
@Target(ElementType.ANNOTATION_TYPE)//注解
@Target(ElementType.PACKAGE) ///包
@Retention:表示需要在什么级别保存该注释信息,用于描述注解的生命周期(SOURCE<CLASS<RUNTIME)
@Retention:注解的保留位置
@Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中,在class字节码文件中不包含
@Retention(RetentionPolicy.CLASS) // 默认的保留策略,注解会在class字节码文件中存在,但运行时无法获得,
@Retention(RetentionPolicy.RUNTIME) // 注解会在class字节码文件中存在,在运行时可以通过反射获取到
@Document:说明该注解将被包含在javadoc中。
@Inherited:说明子类可以继承父类中的该注解。
import java.lang.annotation.*;
//测试元注解
public class Test02 {
@MyAnnotation
public void test01(){
}
}
//定义一个注解
//@Target表示注解可以用在什么地方,ElementType.METHOD表示可用在方法上,可以传递一个数组
@Target(value = {ElementType.METHOD, ElementType.TYPE})
//@Retention表示注解在什么地方才有效,一般都写RetentionPolicy.RUNTIME,运行时都有效;RUNTIME>CLASS>SOURCE
@Retention(value = RetentionPolicy.RUNTIME)
//@Documented 表示是否将我们的注解生成在javaDOC中。
@Documented
//@Inherited子类可以继承父类的注解
@Inherited
@interface MyAnnotation{
}
自定义注解:
使用@interface自定义注解时,自动继承了java.lang.annotation.Annotation接口。
分析:
@interface用来声明一个注解,格式:public @interface 注解明{定义内容}
其中的每一个方法实际上是声明了一个配置参数。
方法的名称就是参数的名称。
返回值类型就是参数的类型(返回值只能是基本类型,Class,String。enum)。
可以通过default来声明参数的默认值。
如果只有一个参数成员,一般参数名为value。
注解元素必须要有值,我们定义注解元素时,经常使用空字符串、0作为默认值。
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//自定义注解
public class Test03 {
//@MyAnno2(name = "奇怪的大冒险o") 注解可以显式赋值,如果没有默认值,必须给注解赋值
@MyAnno2(name = "奇怪的大冒险o", schools = {"清华", "北大"})
public void test1(){
}
@MyAnno3("测试")//如果参数为value的时候,可以省略value
public void test2(){
}
}
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno2{
//注解的参数,参数类型 参数名();
String name() default "";
int age() default 0;
int id() default -1;//如果默认值为-1,代表不存在,就像indexof如果找不到就返回-1。
String[] schools();
}
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno3{
//只有一个参数,建议用value命名
String value() default "";
}