Java 枚举类与注解

枚举类&注解

枚举类的使用

• 类的对象只有有限个,确定的。我们称此类为枚举类

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

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

如何自定义枚举类

方式一jdk5.0之前，自定义枚举类

public class SeasonTest {
     public static void main(String[] args) {
         Season spring = Season.SPRING;
         System.out.println(spring);
     }
 ​
 }
 //自定义枚举类
 class Season{
     //1.声明Season对象的属性
     private final String seasonName;
     private final String seasonDesc;
     //2.私有化类的构造器,并给对象属性赋值
     private Season(String seasonName,String seasonDesc){
         this.seasonName = seasonName;
         this.seasonDesc = seasonDesc;
     }
     //3.提供当前枚举类的多个对象: public static final的
     public static final Season SPRING = new Season("春天","春暖花开");
     public static final Season SUMMER = new Season("夏天","夏日炎炎");
     public static final Season AUTUME = new Season("秋天","秋高气爽");
     public static final Season WINTER = new Season("冬天","寒风刺骨");
 ​
     //其他诉求1: 提供get方法
 ​
     public String getSeasonName() {
         return seasonName;
     }
 ​
     public String getSeasonDesc() {
         return seasonDesc;
     }
     //其他诉求2:提供toString
 ​
     @Override
     public String toString() {
         return "Season{" +
                 "seasonName='" + seasonName + '\'' +
                 ", seasonDesc='" + seasonDesc + '\'' +
                 '}';
     }

方式二：jdk5.0之后，使用enum定义枚举类

 
 ​

 public class SeasonTest1 {
     public static void main(String[] args) {
         Season1 summer = Season1.SUMMER;
         System.out.println(summer);
         System.out.println(Season1.class.getSuperclass()); //class java.lang.Enum 父类不是Object，故toString方法不是打印地址值
     }
 }
 //使用enum定义枚举类
 enum Season1 {
 ​
     //1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象";"结束
     SPRING ("春天", "春暖花开"),
     SUMMER ("夏天", "夏日炎炎"),
     AUTUME ("秋天", "秋高气爽"),
     WINTER ("冬天", "寒风刺骨");
 ​
     //2.声明Season对象的属性
     private final String seasonName;
     private final String seasonDesc;
 ​
     //3.私有化类的构造器,并给对象属性赋值
     private Season1(String seasonName, String seasonDesc) {
         this.seasonName = seasonName;
         this.seasonDesc = seasonDesc;
     }
 ​
 ​
     //其他诉求1: 提供get方法
 ​
     public String getSeasonName() {
         return seasonName;
     }
 ​
     public String getSeasonDesc() {
         return seasonDesc;
     }
     //其他诉求2:提供toString
 ​
 //    @Override
 //    public String toString() {
 //        return "Season{" +
 //                "seasonName='" + seasonName + '\'' +
 //                ", seasonDesc='" + seasonDesc + '\'' +
 //                '}';
 //    }
 }

Enum类的主要方法

然而Enum类并没有values方法

• values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的枚举值

• valueOf(String str) : 可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常:lllegalArgumentException。 非法数据异常 返回枚举类中对象名是str的对象。

• toString():返回当前枚举类对象常量的名称

  Season1[] values = Season1.values();
         for(int i = 0;i<values.length;i++){
             System.out.println(values[i]);
 //            System.out.println(values);  [Lcom.bo.java.Season1;@4eec7777
         }
         System.out.println("****************");
         //线程状态
         Thread.State[] values1 = Thread.State.values();
         for(int i = 0;i<values1.length;i++) {
             System.out.println(values1[i]);
         }
         System.out.println("*****************");
         //valueOf(String objName):返回枚举类中对象名是objName的对象。
         Season1 winter = Season1.valueOf("WINTER");
         //Season1 winter = Season1.valueOf("WINTER1");  java.lang.IllegalArgumentException
         System.out.println(winter);
     }

实现接口的枚举类(使用enum)

情况一：实现接口，在enum类中实现抽象方法

情况二：让枚举类的对象分别实现接口中的抽象方法

 interface Info{
     void show();
 }
 ​
 //使用enum定义枚举类
 enum Season1 implements Info {
 ​
     //1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象";"结束
     SPRING ("春天", "春暖花开"){
     @Override
     public void show() {
         System.out.println("春天在哪里?");
     }},
     SUMMER ("夏天", "夏日炎炎"){
     @Override
     public void show() {
         System.out.println("夏天在哪里?");
     }},
     AUTUME ("秋天", "秋高气爽"){
     @Override
     public void show() {
         System.out.println("秋天在哪里?");
     }},
     WINTER ("冬天", "寒风刺骨"){
     @Override
     public void show() {
         System.out.println("冬天在哪里?");
     }};
     
     
 values[i].show();

注解的使用Annotion

注解概述

对元数据(MetaData)的支持，也就是Annotion

Annotation其实就是代码里的特殊标记,这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。

框架=注解＋反射＋设计模式。

常见的Annotion示例

没有成员定义的Annotation称为标记;包含成员变量的 Annotation称为元数据Annotation

元数据的理解： String name = "bo";(String)

示例一 生成文档相关的注解

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

• @Override:限定重写父类方法,该注解只能用于方法

• @Deprecated:用于表示所修饰的元素(类,方法等)已过时。通常是因达所修饰的结构危险或存在更好的选择

• @SuppressWarnings:抑制编译器警告

 private int age;
     @SuppressWarnings("unused")
     public final static int  num = 10;
     @SuppressWarnings({"unused","rawtypes"})
     ArrayList list = new ArrayList();

示例三 跟踪代码依赖性,实现替代配置文件功能

• Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署

• spring框架中关于“事务”的管理

自定义Annotion

如何定义

参照 @SuppressWarnings 来定义

• 注解声明为@interface

• 内部定义成员，通常使用value表示

• 可以指定成员的默认值，使用default定义

• 如果自定义注解没有成员，表明是一个标识作用。 eg:@Override

• 如果注解有成员，在使用注解时，需要指明成员的值。

自定义注解必须配上注解的信息处理流程(使用反射)才有意义。

public @interface MyAnnotation {
     String value() default "hello";
 }
 @MyAnnotation(value = "hi")

自定义注解通过都会指明两个元注解:Retention、Target

JDK中的元注解

定义：修饰其他注解的注解 meta-annotation

Retention

指定所修饰的Annotation 的生命周期

SOURCE CLASS(默认行为)

RUNTIME只有声明为RUNTIME生命周期的注解，才能通过反射获取。

Target

用于指定被修饰的Annotation能用于修饰哪些程序元素

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, MODULE})

Documented 出现频率较低

表示所修饰的注解在被javadoc解析时，保留下来。

javadoc是不包括注解的

Inherited 出现频率较低

被它修饰的Annotation将具有继承性。

利用反射获取注解信息

JDK8中注解新特性

可重复注解

• 在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class

• MyAnnotation的Target和Retention等元注解与MyAnnotations相同。

类型注解

TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如:泛型声明)

TYPE_USE 表示该注解能写在使用类型的任何语句中

 class Generic<@MyAnnotation T>      TYPE_PARAMETER
 public void show() throws @MyAnnotation RuntimeException{     TYPE_USE   
         ArrayList<@MyAnnotation String> list = new ArrayList<>();
         int num = (@MyAnnotation int) 10L;
 }
 }