Java张孝祥视频 学习笔记 注解

/***************************************************************************************/

此博客主要是在观看张孝祥老师的教学视频的过程中，自己所做的学习笔记，在此以博客的形式分享出来，方便大家学习 ，建议大家观看视频，然后以此笔记作为资料回顾复习。

参考资料

张孝祥2010年贺岁视频：Java高新技术   视频下载

疯狂Java讲义

 /*********************************** 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节视频 *******************************************/

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

信息的信息-----元信息

                                                             

注解的生命周期三个阶段：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说明,下面会有示例代码。

自己创建注解类，并应用

自己创建的注解类

@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);

          }

    }

}

访问注解信息的三个方法

getAnnotation(Class<t> class)  返回改程序元素上指定类型的注解，如果该类型的注解不存在，则返回null

Annotation[] getAnnotations()  返回改程序元素上的所有注解

boolean  isAnnotationPresent(Class<? extends Annotation> class)  判断改程序元素上是否存在指定类型的注解，如果存在则返回true否则返回false

@Documented作用示例代码

@Documented

public @interface ItcastAnnotation {

    

}

public class First{
     @ItcastAnnotation

     public void get(){

     }

}

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

@ItcastAnnotation

public void get()

如果去掉注解中的@Documented

public @interface ItcastAnnotation {

    

}

public class First{
     @ItcastAnnotation

     public void get(){

     }

}

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

public void get()

 /*********************************** 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

@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());

 }

     

} 

怎么看文档视频里有

/*********************************************************************************/

编译时处理Annotation 见疯狂Java讲义P650