【新技术_04】注解

4.1注解

一个注解就是一个特殊的类

了解注解及java提供的几个基本注解

System.runFinalizersOnExit(true);的编译警告引出@SuppressWarnings("deprecation")

@SuppressWarnings：压缩警告

@Deprecated：过时

 

直接在刚才的类中增加一个方法，并加上@Deprecated标注，在另外一个类中调用这个方法。

@Override

public boolean equals(Reflect other)方法与HashSet结合讲解

注解总结：

         注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记，以后，javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。

看java.lang包，可看到JDK中提供的最基本的annotation。

 

4.2注解的应用结构图：

 

 

4.3自定义注解及其应用

定义一个最简单的注解：public @interface MyAnnotation {}

把它加在某个类上：@MyAnnotation public class AnnotationTest{}

用反射进行测试AnnotationTest的定义上是否有@MyAnnotation

@Retention元注解的，其三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME;分别对应：java源文件-->class文件-->内存中的字节码。

思考：@Override、@SuppressWarnings和@Deprecated这三个注解的属性值分别是什么？

演示和讲解@Target元注解

Target的默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了，改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就可以了。

元注解以及其枚举属性值不用记，只要会看jdk提供那几个基本注解的API帮助文档的定义或其源代码，按图索骥即可查到，或者直接看java.lang.annotation包下面的类。

 

4.4为注解增加高级属性

数组类型的属性

int [] arrayAttr() default {1,2,3};

@MyAnnotation(arrayAttr={2,3,4})

如果数组属性中只有一个元素，这时候属性值部分可以省略大括

 

枚举类型的属性

EnumTest.TrafficLamp lamp() ;

@MyAnnotation(lamp=EnumTest.TrafficLamp.GREEN)

 

注解类型的属性：

MetaAnnotation annotationAttr() default@MetaAnnotation("xxxx");

@MyAnnotation(annotationAttr=@MetaAnnotation(“yyy”))

可以认为上面这个@MyAnnotation是MyAnnotaion类的一个实例对象，同样的道理，可以认为上面这个@MetaAnnotation是MetaAnnotation类的一个实例对象，调用代码如下：

         MetaAnnotationma =  myAnnotation.annotationAttr();

         System.out.println(ma.value());

注解的详细语法可以通过看java语言规范了解，即看java的language specification。

 

练习一：注解的应用

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
importjava.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
 
import cn.itcast.day1.EnumTest;
 
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface ItcastAnnotation {
         Stringcolor() default "blue";
         Stringvalue();
         int[]arrayAttr() default {3,4,4};
         EnumTest.TrafficLamplamp() default EnumTest.TrafficLamp.RED;
         MetaAnnotationannotationAttr() default @MetaAnnotation("lhm");
}
 
import java.lang.reflect.Method;
 
import javax.jws.soap.InitParam;
 
@ItcastAnnotation(annotationAttr=@MetaAnnotation("flx"),color="red",value="abc",arrayAttr=1)
public class AnnotationTest {
 
         /**
          * @param args
          */
         @SuppressWarnings("deprecation")
         @ItcastAnnotation("xyz")
         publicstatic void main(String[] args) throws Exception{
                   //TODO Auto-generated method stub
                   System.runFinalizersOnExit(true);
                   if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
                            ItcastAnnotationannotation = (ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);
                            System.out.println(annotation.color());
                            System.out.println(annotation.value());
                            System.out.println(annotation.arrayAttr().length);
                            System.out.println(annotation.lamp().nextLamp().name());
                            System.out.println(annotation.annotationAttr().value());
                   }
                  
                   MethodmainMethod = AnnotationTest.class.getMethod("main", String[].class);
                   ItcastAnnotationannotation2 = (ItcastAnnotation)mainMethod.getAnnotation(ItcastAnnotation.class);
                   System.out.println(annotation2.value());
         }
 
         @Deprecated
         publicstatic void sayHello(){
                   System.out.println("hi,传智播客");
         }
}