Java enum枚举在实际项目中的常用方法
- 2020 年 3 月 6 日
- 筆記
在项目实际开发过程中,经常会遇到对某些固定的值、字典项的定义的需求,很多项目经常使用常量来定义,其实在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"; }
以上实例虽然实现了功能,但有两点比较明显的缺点:
- 常量值容易写错(特别是复制黏贴,但是忘记改对应的值,导致系统出bug),idea不会给任何提示。
比如,某人粗心,在复制黏贴代码时变成(将春季、夏季都定义成春季了):
/** * 春季 */ public static final String SPRING = "SPRING"; /** * 夏季 */ public static final String SUMMER = "SPRING";
- 如果我想知道一年总共多少个季节,咋整?用常量定义的类,有点捉襟见肘
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();