注解
注解(Annotation)是jdk5引入的新技术。
Anotation的作用:可以对程序作出解释,可以被其它程序(比如编译器等)读取。
Annotation的格式:注解是以"@注释名"在代码中存在的,还可以添加一些参数值。
Annotation可以在package,class,method,filed等上面,相当于给它们添加了额外的辅助信息,可以通过反射机制来实现这些元数据的访问。
内置注解
@Override:定义在java.long.Override中,此注解只适用于修辞方法,表示一个方法声明打算重写超类中的另一个方法声明。
@Deprecated:定义在java.long.Deprecated中,此注解可用于修辞方法,属性,类表示不鼓励使用这样的元素。
@SuppressWarnings:定义在java.long.SuppressWarnings中,用来抑制编译时的警告信息。需添加一个参数才能正常使用。
元注解
元注解的作用就是负责注解其他注解,Java定义了4个标准的meta-annotation类型,它们被用来提供对其他annotation类型作说明。
这些类型和它所支持的类在java.long.annotation包中可恶意找到(@Target,@Retention,@Decumented,@Inherited)。
@Target:用于描述注解使用的范围(即:被描述的注解可以用在什么地方)。
@Retention:表示需要在什么级别保存该注释信息用于描述注解的生命周期(source<class<runtime)。
@Decumented:说明该注解将被包含在javadoc中。
@Inherite:说明子类可以继承父类中的该注解。
package com.annotation;
import java.lang.annotation.*;
//元注解
@MyAnnotation
public class Test02 {
public void test(){
}
}
//定义一个注解
//Target表示注解可以用在哪些地方
@Target(value = {ElementType.METHOD,ElementType.TYPE})
//表示注解在什么地方还有效
@Retention(value = RetentionPolicy.RUNTIME)
//表示是否将注解生成在javadoc中
@Documented
//表示子类可以继承父类的注解
@Inherited
@interface MyAnnotation{
}
自定义注解
使用@interface自定义注解时,自动继承了java.long.annotation.Annotation接口。
- @interface用来声明一个注解,格式:public interface注解名(定义内容)。
- 其中的每一个方法实际上是声明了一个配置参数。
- 方法的名称就是参数的名称。
- 返回值的类型就是参数的类型(返回值只能是基本数据类型,Class,String,enum)。
- 可以通过default来声明参数的默认值。
- 如果只有一个参数成员,一般参数名为value。
- 注解元素必须要有值,我们定义注解元素时,经常使用空字符串,0作为默认值。
package com.annotation;
import java.lang.annotation.*;
//自定义注解
public class Test03 {
//注解可以显示赋值 如果没有默认值 就一定要给注解赋值
@MyAnnotation2(name = "zz",school = {"西北","华中"})
public void test(){
}
//只有一个参数且是value时 value可以不写
@MyAnnotation3("周")
public void test2(){
}
}
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{
//注解的参数 参数类型+参数名 ()
String name() default "";
int age() default 0;
int id() default -1;//如果默认值为-1 代表不存在
String[] school();
}
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3{
String value();
}