Javaweb的学习03_注解

注解：

      概念：说明程序的。给计算机看的

  （注释：用文字描述程序的。给程序员看的）

定义：注解(Annotation),也叫元数据。 一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。

概念描述：

       JDK1.5之后的新特性

       说明程序的

       使用注解：@注解名称

作用分类：

       1.编写文档：通过代码里标识的注解(/元数据)生成文档【doc文档】

       2.代码分析：通过代码里标识的注解对代码进行分析【使用反射】

       3.编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查eg.【override】

JDK中预定义的一些注解（JDK内置注解）:

       @Override   ：检测被注解标注的方法是否是继承自父类（接口）的

       @Deprecated   ：该注解标注的内容，表示 已过时

       @SuppressWarnings   ：压制警告

              一般传递参数all  @SuppressWarnings（"all") 

表示 show1()已经过时了，不建议使用，但想用 还是可以用的

我们可以看到，旁边有时候会有很多警告，eg.如下

那么，例如在demo()方法前添加注解@SuppressWarnings（"all")  //表示压制所有的警告

           那么，关于demo()方法的所有警告就没有了

一般，把注解@SuppressWarnings("all") 放在类的前面

使用@SuppressWarnings，一般要传参，一般传一个参数all 压制所有的警告

自定义注解

        格式：

        元注解

        public @interface 注释名称{

              属性列表；

}

直接把class改成@interface （也可以在创建的时候直接选择annotation，不选class）

就可以使用这个自定义的注解了

        本质：注解本质上就是一个接口，该接口默认继承Annotation接口

              public interface MyAnno extends java.lang.annotation.Annotation{ }

        属性：（接口中可以定义的成员方法）接口中的抽象方法

             要求：

                 一.属性的返回值类型 只有下列取值

                        1.基本数据类型

                        2.String（字符串类型）

                        3.枚举

                        4.注解

                        5.以上类型的数组

示例：

              二 . 定义了属性，在使用时需要给属性赋值

     （1）如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。   eg.String name() default "小涵"；

     （2）如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。              eg.@MyAnno(12)

     （3）数组赋值时，值使用{ }包裹。如果数组只有一个值，则{ }可以省略。

                     eg.strs="bbb"

示例：

枚举：

元注解：用于描述注解的注解

      1. @Target  ：描述注解能够作用的位置

                ElementType取值：

                      TYPE ：可以作用于类上

                      METHOD ：可以作用于方法上

                      FIELD ：可以作用于成员变量上

             @Target(value={ElementType.TYPE, ElementType.METHOD, ElementType.FIELD})                //表示既可以作用于类上，又可以作用于方法上，还可以作用于成员变量上

              （value可以省略）

      2. @Retention  ：描述注解被保留的阶段

                  @Retention(RetentionPolicy.RUNTIME) ：当前被描述的注解，会保留到class字节码文件中，并被JVM（java虚拟机）读取到

      3. @Documented  ：描述注解是否被抽取到api文档中

      4. @Inherited  ：描述注解是否被子类继承  （如果加了这个，那么子类会自动地继承父类里边的这个注解）

在程序中使用（解析）注解：获取注解中定义的属性值

         1.获取注解定义的位置的对象（Class,Method,Field)

         2.获取指定的注解

                  getAnnotation(Class)        

/*
 * 其实就是在内存中生成了一个该注解接口的子类实现对象
 * public class ProImp1 implements pro {  
 *      public String className(){
 *          return "annotation.Demo1";
 *      }
 *      public String methodName(){
 *          return "show";
 *      }
 * }
 */

         3.调用注解中的抽象方法，获取配置的属性值

使用注解来实现  与之前配置文件的实现效果一样：

注解_案例：

      （1.定义注解：）

      （2.解析注解：）

1. close()方法：关闭输出流并释放与其相关的任何系统资源。
2. flush()方法：刷新输出流，强制将所有缓冲的输出字节写入其目标。
3. write(int c)方法：将指定的字节写入输出流中。

出现了异常，抓异常：

（抓大的异常即可，即Exception e）

补充：

1.  BufferedWriter类是Writer的子类，它为了提高效率，加入了缓冲技术，将字符读取对象作为参数

2.  write()   将单个字符写入写入器的内部缓冲区

3.   A.isAnnotationPresent(B.class)；

     意思就是：注释B是否在此A上。如果在则返回true；不在则返回false

4. number++;表示运算完毕，number加上1

    ++number;表示先进行number加上1后，再进行其它运算

5.  .newLine(); 换行

6.  .getCause() 返回此异常的原因

7. .getClass()返回运行时的类

8. .getSimpleName()方法用于返回源代码中给定的基础类的简单名称

9. .getMessage() 获取异常简单的描述信息     

10.  flush方法和close方法的区别:

      close () 是 闭流对象 ，但是会先刷新一次缓冲区，关闭之后，流对象不可以继续再使用了，否则报空指针异常。

       flush () 仅仅是刷新缓冲区，准确的说是 "强制写出缓冲区的数据" ，流对象还可以继续使用。 

小结：大多数情况下，我们会使用注解，而不是定义注解。 注解一般给编译器和解析程序用。                注解不是程序的一部分，可以理解为它是一个标签。