注解
概念:说明程序的。给计算机看的
注释:用文字描述程序的。给程序员看的
概念描述︰
JDK1.5之后的新特性
说明程序的
使用注解︰@注解名称
作用分类︰
编写文档：通过代码里标识的注解生成文档【生成文档doc文档】
代码分析：通过代码里标识的注解对代码进行分析【使用反射】
编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【override】
JDK中预定义的一些注解
@Override:检测被该注解标注的方法是否是继承自父类(接口)的
@Deprecated:该注解标注的内容，表示已过时
@suppresswarnings:压制警告
@SuppressWarnings("all")//使得编辑器右边的所有黄色警告消失
public class AnnoDemo2 {
@Override
public String toString(){
return super.toString();
}
@Deprecated //demo 方法使用show1方法时提示加个横杠
public void show1(){
//有缺陷
}
public void show2(){
//替代show1
}
public void demo(){
show1();
Date date = new Date();
}
}
自定义注解
自定义的注解格式
元注解：描述注解的注解
@Target：描述注解能够作用的位置【类，成员变量，方法】
@Target(value={ElementType.ANNOTATION_TYPE[作用域类],ElementType.METHOD【作用于方法】,ElementType.FIELD【作用于成员变量】})
@Retention：描述注解被保留的阶段【代码期[RetentionPolicy.SOURCE]，解析期[RetentionPolicy.CLASS]，运行期[RetentionPolicy.RUNTIME]】
所使用的注解都是运行期：@Retention(RetentionPolicy.RUNTIME)
@Documented:描述注解是否被抽调出api文档中
@Inherited：描述注解是否被子类继承【使用MyAnno注解的类的子类上也继承了MyAnno注解】
public @interface 注解名称{}
注解的本质
public interface myAnno1 extends java.lang.annotation.Annotation{}
属性：接口中的抽象方法
String show()[省略写法];//public abstract String show();
返回类型的要求
基本数据类型
String
枚举类型[enum]
注释类型
以上类型的数组
@Target(value={ElementType.TYPE,ElementType.METHOD,ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface MyAnno {
//String show();//public abstract String show();
int age();
String name() default "张三";
Person per();
MyAnno2 myAnno2();
String[] strs();
}
自定义注使用
给属性要赋值
@MyAnno(age=12,name="张三",per=Person.p1,myAnno2 = @MyAnno2,strs={"a","aa","abc"})
自定义注解中有default关键字,就可以不用赋值
注解中：String name() default "张三";
使用时:@MyAnno(age=12)
如果只有一个属性需要赋值，并且属性名称时value，直接写值即可
注解中：int value();
使用时：@MyAnno(12)
数组赋值，如果数组中只有一个值，可省略大括号{}
使用时：@MyAnno(strs="a")
@MyAnno(age = 12, name = "zhangsan", per = Person.p1, myAnno2 = @MyAnno2, strs = {"a", "aa", "abc"})
public class AnnoWorkers {
}
注解配合反射
1，获取注解定义位置的对象【class，field，method】。
2，获取指定的注解对象。解定义位置的对象.getAnnotation(注解类.class);
3，调用注解中的抽象方法获取配置的属性值。
@ReflectAnno(className="com.xjbt.ReflectClass1",MethodName="show")
public class ReflectTest {
public static void main(String[] args) throws Exception {
//获取字节码文件【reflectTestClass】的class对象
Class<ReflectTest> reflectTestClass = ReflectTest.class;
//获取reflectTest对象的注解实现类对象
ReflectAnno ra = reflectTestClass.getAnnotation(ReflectAnno.class);
///获取到com.xjbt.ReflectClass1的class对象,ra.className(),注解中的方法，返回com.xjbt.ReflectClass1
Class raClass = Class.forName(ra.className());
//创建ReflectClass1的对象
Object obj = raClass.newInstance();
//获取ReflectClass1类对象的方法对象
Method method=raClass.getMethod(ra.MethodName());
//执行方法
method.invoke(obj);
}
}
1．以后大多数时候，我们会使用注解，而不是自定义注解
2．注解给谁用?
1.编译器
2．给解析程序用
3．注解不是程序的一部分，可以理解为注解就是一个标签
一个列子
注解：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Check {
}
测试程序：
public class Suanshu {
@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));
}
public void show(){
System.out.println("永无bug");
}
}
主程序
public class Test {
public static void main(String[] args) throws IOException {
Suanshu checkss = new Suanshu();
//获取字节码文件对象
Class cClass = checkss.getClass();
//找到这个对象的所有方法
Method[] methods = cClass.getMethods();
int num=0;//出现异常的次数
BufferedWriter bw=new BufferedWriter(new FileWriter("bug.txt"));
for (Method method:methods) {
if(method.isAnnotationPresent(Check.class)){//判断是否有Check注解
try {
method.invoke(checkss);
} catch (Exception e) {
//捕获异常
//记录到文件中
num++;
bw.write(method.getName()+"方法出异常了");
bw.newLine();
bw.write("异常名称是："+e.getCause().getClass().getSimpleName());
bw.newLine();
bw.write("异常原因是："+e.getCause().getMessage());
bw.newLine();
bw.write("----------------------------");
}
}
}
bw.newLine();
bw.write("本次一共出现"+num+"次异常");
bw.flush();
bw.close();
}
}
结果：
