java----枚举与注解

枚举

简介：

     JDK1.5引入了新的类型——枚举。
     在JDK1.5 之前，我们定义常量都是： public static fianl… 。很难管理。
     枚举，可以把相关的常量分组到一个枚举类型里，而且枚举提供了比常量更多的方法。
     用于定义有限数量的一组同类常量，
     例如： 错误级别：
          低、中、高、急
     一年的四季：
          春、夏、秋、冬
     在枚举类型中定义的常量是该枚举类型的实例。
     定义格式：
     1.5之前写法：

public class Level{
    public static final level LOW =  new Level (1);
    public static final level MEDIUM =  new Level (50);
    public static final level HIGH =  new Level (100);
    private int levelValue;
    private Level (int levelValue){
        this.levelValue = levelValue;
    }
     get方法
}

     1.5之后写法：

          权限修饰符 enum 枚举名称 {
               实例1,实例2，实例3，实例4;
          }

public enum Level { 
    LOW(30), MEDIUM(15), HIGH(7), URGENT(1); 
    private int levelValue; 
    private Level(int levelValue) { 
        this.levelValue = levelValue; 
    } 
    public int getLevelValue() { 
        return levelValue; 
    }
 }

          常见方法:

     实现接口的枚举类：
          枚举都继承java.lang.Enum类。由于Java 不支持多继承，所以枚举对象不能再继承其他类。
每个枚举对象，都可以实现自己的抽象方法

public interface LShow{
    void show();
}
public enum Level implements LShow{ 
    LOW(30){ 
        @Override 
        public void show(){
             //... 
        } 
    }, MEDIUM(15){ 
        @Override 
        public void show(){ 
            //... 
        } 
    },HIGH(7){ 
        @Override 
        public void show(){ 
            //... 
        } 
   }；

     枚举注意事项：
          一旦定义了枚举，最好不要妄图修改里面的值，除非修改是必要的。
          枚举类默认继承的是java.lang.Enum类而不是Object类
          枚举类不能有子类，因为其枚举类默认被final修饰
          只能有private构造方法
          switch中使用枚举时，直接使用常量名，不用携带类名
          不能定义name属性，因为自带name属性
          不要为枚举类中的属性提供set方法，不符合枚举最初设计初衷。

注解：

     Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。
     Java 语言中的类、方法、变量、参数和包等都可以被标注。和注释不同，Java 标注可以通过反
     射获取标 注内容。在编译器生成类文件时，标注可以被嵌入到字节码中。Java 虚拟机可以保留
     标注内容，在运行 时可以获取到标注内容 。 当然它也支持自定义 Java 标注。
     主要用于：
          编译格式检查
          反射中解析
          生成帮助文档
          跟踪代码依赖
     学习重点:
          理解 Annotation 的关键，是理解 Annotation 的语法和用法
          1. 概念
          2. 怎么使用内置注解
          3. 怎么自定义注解
          4. 反射中怎么获取注解内容
     内置注解:
          @Override ： 重写 * 定义在java.lang.Override
          @Deprecated：废弃 * 定义在java.lang.Deprecated
          @SafeVarargs Java 7 开始支持，忽略任何使用参数为泛型变量的方法
或构造函数调用产生的警告。
          @FunctionalInterface： 函数式接口 * Java 8 开始支持，标识一个匿名函数或函数式接口。
          @Repeatable： Java 8 开始支持，标识某注解可以在同一个声明上使用多次。
          SuppressWarnings：抑制编译时的警告信息。 *
               定义在java.lang.SuppressWarnings
               三种使用方式
                    1. @SuppressWarnings(“unchecked”) [^ 抑制单类型的警告]
                    2. @SuppressWarnings(“unchecked”,“rawtypes”) [^ 抑制多类型的警告]
                    3. @SuppressWarnings(“all”) [^ 抑制所有类型的警告]
                    参数列表：

     元注解：
          作用在其他注解的注解
          @Retention - 标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运
行时可 以通过反射访问。(RententionPolicy.类型…)
          @Documented - 标记这些注解是否包含在用户文档中 javadoc。
          @Target - 标记这个注解应该是哪种 Java 成员，用途类型。（ElenmentType.类型…）
          @Inherited - 标记这个注解是自动继承的
               1. 子类会继承父类使用的注解中被@Inherited修饰的注解
               2. 接口继承关系中，子接口不会继承父接口中的任何注解，不管父接口中使用的注解有
没有 被@Inherited修饰
               3. 类实现接口时不会继承任何接口中定义的注解
     自定义注解：
          架构：

     Annotation与RetentionPolicy 与ElementType ：
          每 1 个 Annotation 对象，都会有唯一的 RetentionPolicy 属性；至于 ElementType 属
性，则有 1~n 个。
     ElementType(注解的用途类型：
          当 Annotation 与某个 ElementType 关联 时，就意味着：Annotation有了某种用途。例
如，若一个 Annotation 对象是 METHOD 类型，则该 Annotation 只能用来修饰方法。

     RetentionPolicy（注解作用域策略）：
          “每 1 个 Annotation” 都与 “1 个 RetentionPolicy” 关联
          a) 若 Annotation 的类型为 SOURCE，则意味着：Annotation 仅存在于编译器处理期
间，编译器 处理完之后，该 Annotation 就没用了。 例如，" @Override" 标志就是一个
Annotation。当它修 饰一个方法的时候，就意味着该方法覆盖父类的方法；并且在编译
期间会进行语法检查！编译器处 理完后，"@Override" 就没有任何作用了。
           b) 若 Annotation 的类型为 CLASS，则意味着：编译器将 Annotation 存储于类对应的
.class 文件 中，它是 Annotation 的默认行为。
           c) 若 Annotation 的类型为 RUNTIME，则意味着：编译器将 Annotation 存储于 class
文件中，并 且可由JVM读入。

          定义格式：
               @interface 自定义注解名{}
               注意事项：
                    1. 定义的注解，自动继承了java.lang,annotation.Annotation接口
                    2. 注解中的每一个方法，实际是声明的注解配置参数
                         方法的名称就是 配置参数的名称
                         方法的返回值类型，就是配置参数的类型。只能是：基本类型/Class/String/enum
                    3. 可以通过default来声明参数的默认值
                    4. 如果只有一个参数成员，一般参数名为value
                    5. 注解元素必须要有值，我们定义注解元素时，经常使用空字符串、0作为默认值。
       例如：

@Documented 
@Target(ElementType.TYPE) 
@Retention(RetentionPolicy.RUNTIME) 
public @interface MyAnnotation1 { 
参数类型 参数名() default 默认值; 
}

上面的作用是定义一个 Annotation，我们可以在代码中通过 “@MyAnnotation1” 来使用它。
@Documented, @Target, @Retention, @interface 都是来修饰 MyAnnotation1 的。