注解(Annotation):
- 概念:说明程序的。给计算机看的。
- 注释:用文字描述程序的。给程序员看的。
- 定义:注解(Annotation),也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数的前面,用来对这些元素进行说明,注释。
- 概念描述:
- JDK1.5之后的新特性
- 说明程序的
- 使用注解:@注解名称
- 作用分类:
- 编写文档:通过代码里标识的注解生成文档[生成文档doc文档]。
- 代码分析:通过代码里标识的注解进行分析[使用反射]。
- 编译检查:通过代码里标识的注解让编译器能够实现基本的编译检查[override]。
- JDK中预定义的一些注解
- @Override:检测被该注解标注的方法是否是继承自该父类(接口)的
- @Deprecated:该注解标注的内容,标识已过时
- @SuppressWarnings:压制警告。一般传递参数all:@SuppressWarnings(“all”)
- 自定义注解
- 格式:
- 元注解
- public @interface 注解名称{ 属性列表 }
- 本质:注解本质上就是一个接口,该接口默认继承Annotation接口
- public interface MyAnno extends java.lang.annotation.Annotation{}
- 属性:接口中的抽象方法
- 要求:
- 属性的返回值类型有下列取值,其他的都不行
- 定义了属性在使用时需要给属性赋值
- 如果定义属性时,使用default关键字给属性默认初始化值,则使用注解时可以不进行属性的赋值。
- 如果只有一个属性需要进行赋值,并且属性的名称是value,直接定义值即可。
- 数组赋值时,值使用{}包裹。如果数组中还有一个值,则{}可以省略。
- 元注解:用于注解的注解
- @Target:描述注解能够作用的位置
- ElementType取值:
- TYPE:可以作用于类上
- METHOD:可以作用于方法上
- FIELD:可以作用于成员变量上
- @Retention:描述注解被保留的阶段
- @Retention(RetentionPolicy.RUNTIME):当前被描述的注解,会保留到class字节码文件中,并被JVM读取到
- @Documented:描述注解是否被抽取到API文档中
- @Inherited:描述注解是否被子类继承
- 在程序使用(解析)注解:获取注解中定义的属性值。
- 获取定义的位置的对象
- 获取指定的注解
- 调用注解中的抽象方法,获取配置的属性值
- 例:
package cn.itcast.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface pro {
String className();
String methodName();
}
package cn.itcast.annotation;
public class DemoClass {
public void show(){
System.out.println("DemoClass...show....");
}
}
package cn.itcast.annotation;
import java.io.IOException;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.Properties;
@pro(className = "cn.itcast.annotation.DemoClass",methodName = "show")
public class ReflectTest {
public static void main(String[] args) throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
Class<ReflectTest> reflectTestClass = ReflectTest.class;
pro an = reflectTestClass.getAnnotation(pro.class);
String className = an.className();
String methodName = an.methodName();
System.out.println(className);
System.out.println(methodName);
Class cls = Class.forName(className);
Constructor constructor = cls.getDeclaredConstructor();
Object obj = constructor.newInstance();
Method method = cls.getMethod(methodName);
method.invoke(obj);
}
}
- 练习:一次测试编写的所有方法
package cn.itcast.annotation.demo;
public class Calculator {
@Check
public void add(){
System.out.println("1 + 0 ="+ (1 + 0));
}
@Check
public void sub(){
System.out.println("1 - 0 ="+ (1 - 0));
}
@Check
public void mul(){
System.out.println("1 * 0 ="+ (1 * 0));
}
@Check
public void div(){
System.out.println("1 / 0 ="+ (1 / 0));
}
public void show(){
System.out.println("never to see bug...");
}
}
package cn.itcast.annotation.demo;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Check {
}
package cn.itcast.annotation.demo;
import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
public class TestCheck {
public static void main(String[] args) throws IOException {
Calculator c = new Calculator();
Class cls = c.getClass();
Method[] methods = cls.getMethods();
int number = 0;
BufferedWriter bw = new BufferedWriter(new FileWriter("bug.txt"));
for (Method method : methods) {
if (method.isAnnotationPresent(Check.class)){
try {
method.invoke(c);
} catch (Exception e) {
number++;
bw.write(method.getName()+"方法出现异常le");
bw.newLine();
bw.write("异常的名称"+e.getCause().getClass().getSimpleName());
bw.newLine();
bw.write("异常的原因"+e.getCause().getMessage());
bw.newLine();
bw.write("--------------------------");
bw.newLine();
}
}
}
bw.write("本次测试一共出现"+number+"次异常。");
bw.flush();
bw.close();
}
}
div方法出现异常le
异常的名称ArithmeticException
异常的原因/ by zero
--------------------------
本次测试一共出现1次异常。