一:什么是注解
Annotation(注解)就是java提供了一种元程序中元素关联任何信息和任何元数据的途径和方法。注解是一个接口,程序可以通过反射来获取注解中的元数据。
二:注解有什么用?
1:生成文档,这也是java最早提供的注解。
2:跟踪代码的依赖性,实现替代配置文件功能。
3:在编译时进行格式检查,如@Override放在方法前,如果你这个方法并不是覆盖了超类方法,则编译时就能检查出错误。
三:JDK自带的注解
1:@Override:用来覆盖父类的一个方法
2:@Deprecated:弃用这个注解是程序员不鼓励使用的,通常是因为它是危险的。当使用或覆盖弃用的程序元素时,编辑器会发出警告
3:@SuppressWarnings:如果我们一定要用过时的方法,那么可以在过时的方法上面加上这个注解
public interface Person {
public String name();
public int age();
@Deprecated //表示弃用singsong这个方法
public void singsong();
}
public class Woman implements Person {
@Override //重写父类的方法
public String name() {
return null;
}
@Override
public int age() {
return 0;
}
@Override
public void singsong() {
}
}
public class Test {
@SuppressWarnings("deprecation")// 需要使用singsong时应该加这个注解
public void singsong(){
Person woman=new Woman();
woman.singsong();
}
}
四:注解的分类
1:按照运行机制分类:
源码时注解:注解只要源码中存在,编译成.class文件之后就不存在了
编译时注解:注解在源码和编译文件中都存在。JDK自带的三个注解都属于编译时的注解
运行时注解:在运行阶段还起作用,并且还会影响程序的逻辑。
2:按来源来分:
JDK自带的注解
三方的注解
自定义的注解
3:按照注解的参数个数来分:
标记注解:一个没有成员定义的Annotation类型被称为标记注解。这种Annotation类型仅适用自身的存在与否来为我们提供信息。比如@Override
单值注解
完整注解
五:元注解
元注解的作用就是给注解进行注解,java5.0定义的元注解有:
1):@Target:可以用来修饰哪些程序元素,如TYPE,METHOD,TIELD,PARAMETER,CONSTRUCTOR等,为标注则可以修饰所有
2):@Documented:是否会保存到javadoc文档中
3):@Retention:保留时间,可选值:SOURCE(源码时),CLASS(编译时),也是默认值,RUNTIME(运行时)
4):Inherited:是否可以被继承,默认值为false
六:什么是元数据
就是关于数据的数据的意思。它的作用大致有三类:
1):编写文档:通过代码里标识的元数据生成文档
2):代码分析:通过代码里标识的元数据对代码进行分析
3):编译检查:通过代码里标识的元数据让编译器能实现基本的编译检查
七:自定义的注解
1:语法要求:
public @interface Desription{ //-->①:使用@interface关键字定义注解
string desc(); //-->②:成员无参无异常方式声明
String author();
int age() default 18; //-->可以用default为成员指定一个默认值
}
注意:①:成员类型是受限制的,合法的类型包括原始类型以及String,Class,Annotation,Enummeration
②:如果注解只有一个成员变量,则成员名必须为value(),在使用的时候可以忽略成员名和赋值号。
③:注解类可以没有成员,没有成员的注解为标识注解
2:使用自定义注解的语法:
@<注解名>(<成员名1>=<成员值1>..)
3:解析注解:通过反射获取类,函数或成员上的运行时注解信息,从而实现动态控制程序运行的逻辑
public interface Person {
public String name();
public int age();
public void singsong();
}
@Description("i am a class annotation")
public class Woman implements Person {
@Description("the name method")
@Override
public String name() {
return null;
}
@Override
public int age() {
return 0;
}
@Override
public void singsong() {
}
}
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target({ElementType.METHOD,ElementType.TYPE}) //表明这个注解在什么类型上可以使用
@Retention(RetentionPolicy.RUNTIME) //表示注解的运行机制
@Inherited //注解能否被继承,当注解被用在接口上时,不能被继承,要被用在类上
@Documented //注解生成Javadoc文件
public @interface Description {
String value();
}
public class ParseAnnotation {
public static void main(String[] args) {
try {
//1.使用类加载器加载类
Class c = Class.forName("com.swpu.Woman");
//2.找到类上面的注解
Boolean isExist=c.isAnnotationPresent(Description.class);
if(isExist){
//3.拿到注解实例
Description d=(Description)c.getAnnotation(Description.class);
System.out.println(d.value());
}
//4.找到方法上面的注解
Method[] ms=c.getMethods();
for(Method m:ms){
Boolean isMExist=m.isAnnotationPresent(Description.class);
if(isMExist){
Description d=(Description)m.getAnnotation(Description.class);
System.out.println(d.value());
}
}
//另外一种解析方法
for(Method m:ms){
Annotation[] as=m.getAnnotations();
for(Annotation a:as){
if(a instanceof Description){
System.out.println(((Description) a).value());
}
}
}
} catch (ClassNotFoundException e) {
e.printStackTrace();
}
}
}
运行结果为: