注解（张孝祥Java视频笔记）

2017-09-22

Java 张孝祥Java视频

33节视频
34节视频
35节视频

33节视频

注解

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

@Override ————覆盖方法
@Deprecated ———-提示过时
@SuppressWarnings(“deprecation”)—–不提示方法过时
@SafeVarargs———-不显示堆污染警告

堆污染

当把一个不带泛型的对象赋给一个带泛型的变量时，往往会发生堆污染。

List list = new ArrayList<Integer>();
list.add(20);//添加元素引发unchecked警告
List<String> ls = list;//引起“未经检查的转换”的警告编译运行时完全正常
System.out.print(ls.get(0));//引发运行时异常

对于形参个数可变的方法，该形参的类型又是泛型，更容易引发堆污染

public void faultyMethod(List<String>...listStrArray){
     
    List[]  listArray = listStrArray;
    List<Intefer> myList = new ArrayList<Intefer>();
    myList.add(new Random().nextInt(100));
    listArray[0] = myList;
    Sring s = listStrArray[0].get(0);

}

如果想要“抑制”这个警告，可以使用如下的方式:
使用@SafeVarargs修饰引发该警告的方法或者构造器
使用@SuppressWarnings(“unchecked”)修饰

检查视图

List<String> strList = new ArrayList<>;
List list = strList;
list.add(new Date());//并不会报错，但是取值得时候会报错
list.get(0);//报错

List<String> strList = new ArrayList<>;
List<String> safeList = Collections.checkedList(strList，String.class);
List list = strList;
list.add(new Date());//报错

34节视频

注解类—–应用了注解的类——对添加了注解的类进行反射操作的的类

注解1

信息的信息—–元信息

注解的生命周期三个阶段：java源文件——–>class文件——>内存中的字节码

javac在把源代码编译成class文件的时候可能会把注解去掉，类加载器把class文件加载到内存中的时候，也有可能会把注解去掉。

设计注解的时候，加上@Retention(RetentionPolicy.RUNTIME)，提示注解的声明周期在哪一个阶段

RetentionPolicy.RUNTIME–运行阶段(只能通过反射获得生命周期为此的注解)

RetentionPolicy.CLASS–class阶段（默认阶段）

RetentionPolicy.SOURCE–source阶段

@Override:source阶段 @Deprecated: 运行阶段 @SuppressWarnings: source阶段

@Target({ElementType.METHOD,ElementType.TYPE}) 指明该注解只能加在方法跟类上面，如果需要指明该注解既可以作用在方法上也可以作用在类上，则需要指明一个数组，来指明注解作用的对象

ElementType.TYPE//接口、类、枚举、注解

ElementType.FIELD//字段、枚举的常量

ElementType.METHOD//方法

ElementType.PARAMETER//方法参数

ElementType.CONSTRUCTOR//构造函数

ElementType.LOCAL_VARIABLE//局部变量

ElementType.ANNOTATION_TYPE//注解

ElementType.PACKAGE//包

@Documented

@Documented用于指定被该注解修饰的Annotation类将被javadoc工具提取成文档，如果定义Annotation类时使用了@Documented修饰，则所有使用该Annotation修饰的程序元素的API文档中将会包含该Annotation说明。

@Documented作用示例代码

@Documented
public @interface ItcastAnnotation {
    
}

public class First{
     @ItcastAnnotation
     public void get(){
     }
}

使用javac工具为First.java生成文档。如下所示

1 2	@ItcastAnnotation public void get()

如果去掉注解中的@Documented

public @interface ItcastAnnotation {
    
}

public class First{
     @ItcastAnnotation
     public void get(){
     }
}

使用javac工具为First.java生成文档。如下所示

1	public void get()

自己创建注解类，并应用

自己创建的注解类：

@Retention(RetentionPolicy.RUNTIME)//指明该注解存在于运行阶段
@Target({ElementType.METHOD,ElementType.TYPE})//指明该注解既可以加在方法上，也可以加在类上面
public @interface ItcastAnnotation {
    String color() default "blue";
    String value();
    int[] arrayAttr() default {3,4,4};
    EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;
    MetaAnnotation annotationAttr() default @MetaAnnotation("lhm");
}

应用了自定义注解的类：

@ItcastAnnotation("abc")
public class AnnotationTest {

    /**
     * @param args
     */
    @SuppressWarnings("deprecation")
    @ItcastAnnotation("xyz")
    public static void main(String[] args) throws Exception{
        // TODO Auto-generated method stub
        System.runFinalizersOnExit(true);
        if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){//判断这个类是否应用了注解ItcastAnnotation
            ItcastAnnotation annotation = (ItcastAnnotation)AnnotationTest.class.getAnnotation(ItcastAnnotation.class);//如果应用了注解，通过反射获得应用在这个类上面的注解
            System.out.println(annotation);
         }

    }
}

访问注解信息的三个方法

1	getAnnotation(Class<t> class)

返回改程序元素上指定类型的注解，如果该类型的注解不存在，则返回null

1	Annotation[] getAnnotations()

返回改程序元素上的所有注解

1	boolean isAnnotationPresent(Class<? extends Annotation> class)

判断改程序元素上是否存在指定类型的注解，如果存在则返回true否则返回false

35节视频

为注解添加属性

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
 public @interface ItcastAnnotation {
     String color() default "blue";//default 设定属性的默认值，这样如果在应用注解的时候没有给该属性赋值得话，并不会报错，该属性值采用这个默认值
     String value();//特殊的属性，当只需要给这一个属性赋值的时候，可以直接省略掉等号，例： @ItcastAnnotation("xyz")
     int[] arrayAttr() default {3,4,4};//数组属性，当数组属性有多个元素时，arrayAttr={1,2,3}    当数组属性只有一个元素时，arrayAttr=1    或者arrayAttr={1}
     EnumTest.TrafficLamp lamp() default EnumTest.TrafficLamp.RED;//枚举属性，EnumTest.TrafficLamp是一个自定义的枚举类
     MetaAnnotation annotationAttr() default @MetaAnnotation("lhm");// 这个属性的的类型是“注解” MetaAnnotation是一个自定义的注解，其具有value属性，且只需要给这个属性赋值

}

根据注解是否包含成员变量，可以将注解分为一下两类:

标记Annotation : 一个没有定义成员变量的Annotation类型被称为标记。这种注解仅利用自身的存在与否为我们提供信息，如前面介绍的@Override @Test等Annotation

元数据Annotation : 包含成员变量的Annotation因为他们可以接受更多的元数据，所以也被成为元数据Annotation

1	@ItcastAnnotation(annotationAttr=@MetaAnnotation("flx"),color="red",value="abc",arrayAttr=1)

当数组属性有多个元素时，arrayAttr={1,2,3}，当数组属性只有一个元素时，arrayAttr=1 或者arrayAttr={1}

public class AnnotationTest {

 @SuppressWarnings("deprecation") //不提示方法过时警告
 @ItcastAnnotation("xyz")  //当只需要给value属性赋值的时候可以直接省略掉“=”
 public static void main(String[] args) throws Exception{

      System.runFinalizersOnExit(true);
      if(AnnotationTest.class.isAnnotationPresent(ItcastAnnotation.class)){
           ItcastAnnotation annotation = (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());
      }
 
      Method mainMethod = AnnotationTest.class.getMethod("main", String[].class);
      ItcastAnnotation annotation2 = (ItcastAnnotation)mainMethod.getAnnotation(ItcastAnnotation.class);
      System.out.println(annotation2.value());
 }

     
}

上一篇：代理（张孝祥Java视频笔记）

下一篇：反射（张孝祥Java视频笔记）