Java enum枚举在实际项目中的常用方法

在项目实际开发过程中,经常会遇到对某些固定的值、字典项的定义的需求,很多项目经常使用常量来定义,其实在jdk1.5就已经引入了枚举,使用枚举可以更好的解决这类需求,本文主要记录枚举的优势以及经常在项目中使用的方法。

知识点

  • 枚举类命名
    枚举类的命名通常需要Enum为后缀,枚举成员名称需要全大写,单词间用下划线隔开。
  • 枚举类不允许使用 extends 关键字
    枚举类默认会继承java.lang.Enum,由于java是单继承,所以在定义枚举类时不允许再继承其他类,但可以实现多个接口
  • 枚举的比较可以直接使用 ==
    枚举是不允许被new出来的,枚举类里的构造函数都限定为私有化,是不允许使用public定义构造函数的。枚举的赋值,如果是同一个元素,则会指向同一个地址,所以是可以直接使用==的,当然在Enum类中,重写了equals方法(如下图),所以也是可以用equals来判断。
    在这里插入图片描述
  • 枚举常用方法
方法名 用途
name() 返回枚举常量名
toString() 返回枚举常量名
values() 返回枚举成员数组
valueOf() 通过枚举常量名返回枚举
ordinal() 返回枚举常量在enum声明中的位置,位置是从0开始计数的
  • 枚举在switch中的使用
    枚举在switch中的使用,优势在于能控制case的范围(看以下实例),并且在idea中有相关提示
  • 枚举在单例模式的使用
    首先使用枚举类实现单例模式,写法相当简单,看最后的实例;其次枚举是线程安全、单一实例(由于构造方法都是私有的,不能被new)

实例

1. 最简单的枚举

在项目中经常会遇到一些固定值的定义,以往都是用常量来定义,以下用实例说明,为啥枚举的方式优于常量的方式,以下就以季节的定义为例

1.1 使用常量来实现

/**   * @Description: 季节常量定义   */  public class SeasonConst {      /**       * 春季       */      public static final String SPRING = "SPRING";      /**       * 夏季       */      public static final String SUMMER = "SUMMER";      /**       * 秋季       */      public static final String AUTUMN = "AUTUMN";      /**       * 冬季       */      public static final String WINTER = "WINTER";  }

以上实例虽然实现了功能,但有两点比较明显的缺点:

  1. 常量值容易写错(特别是复制黏贴,但是忘记改对应的值,导致系统出bug),idea不会给任何提示。
    比如,某人粗心,在复制黏贴代码时变成(将春季、夏季都定义成春季了):
/**   * 春季   */  public static final String SPRING = "SPRING";  /**   * 夏季   */  public static final String SUMMER = "SPRING";
  1. 如果我想知道一年总共多少个季节,咋整?用常量定义的类,有点捉襟见肘

1.2 使用枚举来实现,可以实现常量的所有功能,并能轻松解决以上提出的常量的两个缺点

  • 定义枚举类SeasonEnum
public enum SeasonEnum {      /**       * 春季       */      SPRING,      /**       * 夏季       */      SUMMER,      /**       * 秋季       */      AUTUMN,      /**       * 冬季       */      WINTER  }

在SeasonEnum枚举类中,如果定义两个 SPRING,编译器会直接报错,很好解决了常量的第一个缺点

  • 该枚举类的使用(1、获取枚举值的名称;2、枚举判断的使用;3、枚举循环的使用。通过枚举的循环,很好解决了常量的第二个缺点;)
//获取枚举值的名称,与toString得到的结果一样  String spring = SeasonEnum.SPRING.name();  System.out.println(spring);    //枚举判断的使用  SeasonEnum springEnum1 = SeasonEnum.SPRING;  SeasonEnum springEnum2 = SeasonEnum.SPRING;  SeasonEnum summerEnum3 = SeasonEnum.SUMMER;  //由于springEnum1、springEnum2都指向SPRING,所以输出true  System.out.println("springEnum1 == springEnum2:" + (springEnum1 == springEnum2));  //由于springEnum1指向SPRING、summerEnum3指向SUMMER,所以输出false  System.out.println("springEnum1 == summerEnum3:" + (springEnum1 == summerEnum3));    //循环枚举,打印枚举类中的所有枚举成员  SeasonEnum[] seasonEnums = SeasonEnum.values();  for (SeasonEnum seasonEnum : seasonEnums) {      System.out.println(seasonEnum.name());  }
  • 枚举在switch中的使用,如果case后跟不存在SeasonEnum类中的枚举(比如 case OTHER),则编译器会报错
String enumName = "SPRING";  SeasonEnum seasonEnum = SeasonEnum.valueOf(enumName);  switch (seasonEnum){      case SPRING:         System.out.println(seasonEnum.name());         break;      case SUMMER:          System.out.println(seasonEnum.name());          break;      case AUTUMN:          System.out.println(seasonEnum.name());          break;      case WINTER:          System.out.println(seasonEnum.name());          break;      default:          System.out.println("other");  }

2.在枚举中使用自定义属性和方法

项目中经常也会遇到一些字典项的定义,比如性别,包含存入数据库中的值,以及显示在页面上的值。以下通过实例来实现性别字典。

  • 定义SexEnum(注意看代码中的注解)
public enum SexEnum {      MAN("man","男"),      WOMEN("women","女");        private String sexCode;        private String sexName;        /**       * 自定义构造函数,以完成枚举对sexCode、sexName赋值       * @param sexCode       * @param sexName       */      SexEnum(String sexCode,String sexName){          this.sexCode = sexCode;          this.sexName = sexName;      }        /**       * 获取sexCode       * @return       */      public String getSexCode() {          return sexCode;      }        /**       * 获取sexName       * @return       */      public String getSexName() {          return sexName;      }        /**       * 项目中经常会根据code,转换成对应的name       * 所以这里自定义方法,根据sexCode获取sexName       * 通过循环enum来实现       * @param sexCode       * @return       */      public static String getSexNameByCode(String sexCode){          String sexName = "sexCode不存在";          SexEnum[] sexEnums = SexEnum.values();          for (SexEnum sexEnum : sexEnums) {              if(sexEnum.getSexCode().equals(sexCode)){                  sexName =  sexEnum.getSexName();                  break;              }          }          return sexName;      }        /**       * 项目中也有根据name,转换成对应的code       * 所以这里自定义方法,根据sexName获取sexCode       * 通过循环enum来实现       * @param sexName       * @return       */      public static String getSexCodeByName(String sexName){          String sexCode = "sexName不存在";          SexEnum[] sexEnums = SexEnum.values();          for (SexEnum sexEnum : sexEnums) {              if(sexEnum.getSexName().equals(sexName)){                  sexCode =  sexEnum.getSexCode();                  break;              }          }          return sexCode;      }        /**       * 根据sexCode获取SexEnum,在switch中使用       * 通过循环enum来实现       * @param sexCode       * @return       */      public static SexEnum getEnumByCode(String sexCode){          SexEnum[] sexEnums = SexEnum.values();          for (SexEnum sexEnum : sexEnums) {              if(sexEnum.getSexCode().equals(sexCode)){                  return sexEnum;              }          }          return null;      }        /**       * 重写toString方法       * @return       */      @Override      public String toString() {          return this.sexCode + ":" + this.sexName;      }  }
  • SexEnum枚举类的使用
public class EnumMain {        public static void main(String[] args){          //循环带自定义方法的枚举          SexEnum[] sexEnums = SexEnum.values();          for (SexEnum sexEnum : sexEnums) {              System.out.println("sexCode:"+sexEnum.getSexCode());              System.out.println("sexName:"+sexEnum.getSexName());              System.out.println("sexCode:sexName="+sexEnum.toString());          }            //根据sexCode获取sexName          String sexName = SexEnum.getSexNameByCode("women");          System.out.println("根据sexCode获取sexName:" + sexName);            //根据sexName获取sexCode          String sexCode = SexEnum.getSexCodeByName("男");          System.out.println("根据sexName获取sexCode:" + sexCode);            //通过传入的sexCode使用switch          testSexEnumSwitch("women");        }      /**       * 实际项目中,基本上都是传sexCode的,所以这里也根据传入的sexCode,使用switch方法       * @param sexCode       */      private static void testSexEnumSwitch(String sexCode){          //自定义getEnumByCode方法,通过sexCode获取SexEnum          SexEnum sexEnum = SexEnum.getEnumByCode(sexCode);          switch (sexEnum){              case MAN:                  System.out.println(sexEnum.toString());                  break;              case WOMEN:                  System.out.println(sexEnum.toString());                  break;              default:                  System.out.println("other");          }      }  }

3.通过枚举实现单例

  • 单例定义
public enum Singleton {      INSTALL;      /**       * 自定义方法       */      public void yourMethod(){          System.out.println("do your business");      }  }
  • 调用方法
Singleton.INSTALL.yourMethod();

源码获取

以上示例都可以通过我的GitHub获取完整的代码,点击获取