定义:说明程序,给计算机看。声明在包,类,字段,方法,局部变量,方法参数之前,用来对这些元素进行说明,注释
功能分类:
1.编写文档,通过代码里的便是注解,生成文档【生成文档doc文件】
2.代码分析:通过代码里的标识的注解对代码进行分析【使用反射】
3.编译检查:通过代码中的标识注解让编译器能够实现基本编译检查【Override】
- JDK中预定义的注解
- @Override:检测被该注解标注的方法是否是继承自父类(接口)的
- @Deprected:该注解标注的内容,表示已过时
- @SuppressWarnings:压制警告
自定义注解
* 格式:
* 元注解
* public @interface 注解名称
*
* 本质:注解本质上就是一个接口,该接口默认继承Annotation接口
* public interface 注解名称 extends java.annotation.Annotation{}
*
* 属性:
* 要求:
* 1.属性的返回值类型有下列取值
* 基本数据类型
* String
* 枚举
* 注解
* 以上类型的数组
* 2.定义了属性,在使用时需要进行对属性赋值
* 1.如果定义了属性,使用default关键字给属性默认初始化值,使用注解时,可以不进行属性的赋值
* 2.如果只有一个属性需要赋值,并且属性名称是value,则value可以省略,直接定义即可
* 3.数组赋值时,值使用{}包裹
- 元注解:用于描述注解的注解
* @Target:描述注解能够作用的位置
* TYPE:可以作用于类上
* METHOD:可以作用于方法上
* FIELD:可以作用于成员变量上
* @Retention:描述注解被保留的阶段
* @Retention(RetentionPolicy.RUNTIME):当前被描述的注解,会保留到class字节码文件中,并被JVM读取到
* @Documented:描述注解能否被抽取到api文档中
* @Inherited:描述注解能否被子类继承
使用注解创建类对象
import java.lang.reflect.Method;
@Properfile(className = "cn.Annoatation.DemoClass",classMethod = "show")
public class ReflectTemplate {
public static void main(String[] args)throws Exception {
/**
* 创建任意类对象,执行任意方法
*/
/*
解析注解
获取该类字节码文件对象
*/
Class<ReflectTemplate> reflectTemplateClass=ReflectTemplate.class;
/*
获取注解对象
其实就是在内存中生成了一个该注解接口的子类实现对象
public class ProImpl implements Properfile{
public String className()
{
return "cn.Annoatation.DemoClass";
}
public String classMethod()
{
return "show"
}
}
*/
Properfile pro=reflectTemplateClass.getAnnotation(Properfile.class);
//调用注解对象中定义的抽象方法,获取返回值
String className=pro.className();
String classMethod=pro.classMethod();
//加载类至内存
Class cla=Class.forName(className);
//创建对象
Object obj=cla.newInstance();
//获取对象方法
Method method=cla.getMethod(classMethod);
method.invoke(obj);
}
}
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 Properfile {
String className();
String classMethod();
}
使用注解测试类方法
import java.io.BufferedWriter;
import java.io.FileWriter;
import java.lang.reflect.Method;
public class DemoTest {
public static void main(String[] args) throws Exception{
//创建计算器对象
Calculator calculate=new Calculator();
//获取字节码文件对象
Class cla=calculate.getClass();
//获取所有方法
Method[] methods=cla.getMethods();
int number=0;//出现异常次数
//使用字符缓冲输出流写日志
BufferedWriter bufferedWriter=new BufferedWriter(new FileWriter("log.txt"));
//判断方法上是否有Check注解
for(Method method:methods)
{
if(method.isAnnotationPresent(Check.class))
{
try{
method.invoke(calculate);
}catch (Exception e)
{
//捕获异常
number++;
bufferedWriter.write(method.getName()+" 方法出错了");
bufferedWriter.newLine();
bufferedWriter.write("异常名称:"+e.getCause().getClass().getSimpleName());
bufferedWriter.newLine();
bufferedWriter.write("************");
bufferedWriter.newLine();
}
}
}
bufferedWriter.write("本次测试一共出现"+number+"次异常");
bufferedWriter.flush();
bufferedWriter.close();
}
}
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Check {
}
public class Calculator {
//加法
@Check
public void Add()
{
String str=null;
str.toString();
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));
}
}