[Java知识库]Java高级编程八：枚举类及注解类

第八章 枚举类&注解

1. 枚举类的使用

• 当一个类的对象只有有限个，是确定的，我们称此类为枚举类

• 当需要定义一组常量时，建议使用枚举类

• 如果枚举类只有一个对象，则可以作为单例模式的实现方式

1.1 如何定义枚举类

1. JDK5.0以前，自定义枚举类

   class Season{
       //声明Season对象的属性：private final修饰
       private final String name;
       private final String desc;
       //2.私有化构造方法,并给对象赋值
       private Season(String name,String desc){
           this.name = name;
           this.desc = desc;
       }
       //3.提供当前枚举类的多个对象，声明为public static final
       public static final Season SPRING = new Season("春天","春暖花开");
       public static final Season SUMMER = new Season("夏天","夏日炎炎");
       public static final Season AUTUMN = new Season("秋天","秋高气爽");
       public static final Season WINTER = new Season("冬天","冰天雪地");
       
       public String getName(){
           return name;
       }
       public String getDesc(){
           return desc;
       }
   }
   class Test{
       @Test
       public void test(){
           Season spring = Season.SPRING;
           System.out.println(spring);
       }
   }
   

2. JDK5.0.可以使用enum关键字定义枚举类

   • 默认父类是 java.lang.Enum ,不用重写toString() 方法

   public class Test{
       @Test
       public void test(){
           System.out.println(Season1.SUMMER);
       }
   }
   enum Season1{
       //1.提供枚举类的多个对象，对象之间用 , 隔开 最后一个用 ;
       SPRING("春天","春暖花开"),
       SUMMER("夏天","夏日炎炎"),
       AUTUMN("秋天","秋高气爽"),
       WINTER("冬天","冰天雪地");
       
       private final String name;
       private final String desc;
      
       public String getName(){
           return name;
       }
       public String getDesc(){
           return desc;
       }
   }
   

1.2 Enum的常用方法

1. values()

Season1[] v = Season1.values();
for(Season1 s: v){
    System.out.println(s);
}

2. valueOf()

   //valueOf(String objName) 返回美剧类中对象名是objName的对象
   //如果没有对应的objName的枚举类对象，则抛出异常
   System.out.println(Season1.valueOf("WINTER"));
   

1.3 使用 enum 关键字的枚举类实现接口

1. 跟普通类一样的实现方法

   interface info{
       void show();
   }
   enum t implements info{
       w,A;
       @Override
       public void show(){}
   }
   

2. 每个对象都重写方法

   interface info{
       void show();
   }
   enum t implements info{
       W{
           @Override
            public void show(){}
       },
       A{
            @Override
            public void show(){}
       };
   }
   
   

2. 注解的使用

• 从JDK5.0开始，java增加了队元数据的支持，也就是注解(Annotation)
• 注解就是代码中的**特殊标记**，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理，通过使用注解，可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。
• 注解可以像修饰符一样被使用，可以用来**修饰包，类，构造方法，方法，成员变量，参数，局部参数的声明**，这些信息被保存在注解的“name = value” 对中。
• 可以说 框架 = 注解 + 反射 + 设计模式。

1. 生成文档相关的注解

   注解	作用
   @author	标明开发该类的作者，多个作者用，分开
   @version	标明该类模块的版本
   @see	参考
   @since	从哪个版本开始
   @param	对方法中某个参数的说明，没有参数不能写
   @return	对返回值的说明，void 不能写
   @exception	对可能抛出的异常说明，没有显式的用throws抛出异常的不能写

   其中@return @param @exception 只能用于方法

   @param 格式要求 @param 形参名 形参类型 形参说明

   @return 格式要求 @return 返回值类型 返回值说明

   @execption 格式要求 @execption 异常类型 异常说明

   @param @execption 可以并列多个

2. 在编译时进行格式检查(JDK内置的三个基本注解)

   注解	含义
   @Override	限定重写父类方法，只能用于方法
   @Deprecated	表示修饰的元素已经过时了
   @SuppressWarnings	抑制编译器警告

3. 如何自定义注解

   //声明为@interface
   public @interface AnnotationTest{
       String[] value();
   }
   //自定义注解通常会指明两个元注解，一折Retention指明生命周期，一个Target指明能够声明哪些结构
   

4. JDK中的四种元注解

   Retention、Target、Documentd、Inherited

   是对现有注解进行解释说明的注解

   1. @Retention：指明注解的生命周期，SOURCE \ CLASS (默认行为) \ RUNTIME ，只有声明为RUNTIME生命周期的注解，才能通过反射获取
   2. @Target： 指明注解可以声明可以哪些结构
   3. @Documented：表示所修饰的注解在javadoc解析时保留下来
   4. @Inherited 被修饰的注解有继承性