spring boot 枚舉使用的坑

java 枚舉的功能挺多，但是坑更多，使用的時候要注意。如下面這個枚舉。

@Getter
@AllArgsConstructor
public enum  EnumExpenseType implements BaseEnum {
    小歡喜(1),
    大歡喜(2);

    private final int value;
}

咋一看，沒什么問題，但是具體使用過程中，總是會出問題。原因就是這個枚舉沒有按照從0開始索引，除此之外即使從0開始，中間有斷的索引也會有問題。主要出現在以下方面：

1. 在controller的方法中，比如以這個枚舉為參數，如下代碼：

    @RequestMapping("/**")
    public String getRejectReasons(EnumExpenseType type) {
        return "";
    }

前台傳入的參數如果是type:1, 那它值應該是：小歡喜，實際上呢？

Caused by: java.lang.IllegalArgumentException: No enum constant com.**.EnumReasonType.1
at java.lang.Enum.valueOf(Enum.java:238) ~[?:1.8.0_111]
at org.springframework.core.convert.support.StringToEnumConverterFactory$StringToEnum.convert(StringToEnumConverterFactory.java:52) ~[spring-core-5.1.8.RELEASE.jar:5.1.8.RELEASE]
at org.springframework.core.convert.support.StringToEnumConverterFactory$StringToEnum.convert(StringToEnumConverterFactory.java:38) ~[spring-core-5.1.8.RELEASE.jar:5.1.8.RELEASE]
at org.springframework.core.convert.support.GenericConversionService$ConverterFactoryAdapter.convert(GenericConversionService.java:436) ~[spring-core-5.1.8.RELEASE.jar:5.1.8.RELEASE]
at org.springframework.core.convert.support.ConversionUtils.invokeConverter(ConversionUtils.java:41) ~[spring-core-5.1.8.RELEASE.jar:5.1.8.RELEASE]
at org.springframework.core.convert.support.GenericConversionService.convert(GenericConversionService.java:191) ~[spring-core-5.1.8.RELEASE.jar:5.1.8.RELEASE]
at org.springframework.beans.TypeConverterDelegate.convertIfNecessary(TypeConverterDelegate.java:129) ~[spring-beans-5.1.7.RELEASE.jar:5.1.7.RELEASE]
at org.springframework.beans.TypeConverterSupport.convertIfNecessary(TypeConverterSupport.java:73) ~[spring-beans-5.1.7.RELEASE.jar:5.1.7.RELEASE]
at org.springframework.beans.TypeConverterSupport.convertIfNecessary(TypeConverterSupport.java:53) ~[spring-beans-5.1.7.RELEASE.jar:5.1.7.RELEASE]
at org.springframework.validation.DataBinder.convertIfNecessary(DataBinder.java:693) ~[spring-context-5.1.7.RELEASE.jar:5.1.7.RELEASE]
at org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver.resolveArgument(AbstractNamedValueMethodArgumentResolver.java:124) ~[spring-web-5.1.7.RELEASE.jar:5.1.7.RELEASE]
... 81 more

Failed to convert value of type 'java.lang.String' to required type 'com.**.EnumExpenseType'; 
nested exception is org.springframework.core.convert.ConversionFailedException: 
Failed to convert from type [java.lang.String] to type [com.**.EnumExpenseType] for value '1'; 
nested exception is java.lang.IllegalArgumentException: No enum constant com.***.EnumExpenseType.1
實際上它卻報了個錯。轉換失敗了。
查看報錯信息，可以定位到是spring框架中StringToEnumConverterFactory中轉換失敗，具體代碼如下：

private static class StringToEnum<T extends Enum> implements Converter<String, T> {

        private final Class<T> enumType;

        public StringToEnum(Class<T> enumType) {
            this.enumType = enumType;
        }

        @Override
        public T convert(String source) {
            if (source.isEmpty()) {
                // It's an empty enum identifier: reset the enum value to null.
                return null;
            }
            return (T) Enum.valueOf(this.enumType, source.trim()); 
        }
    }

是Enum.valueOf這里報錯，Enum.valueOf的后面的值並不是我們的value,而是name(這里的小歡喜)。

所以，我們不能使用這個spring提供converter，需要自定義一個：StringToEnumConverterFactory 

public class StringToEnumConverterFactory implements ConverterFactory<String, BaseEnum> {

    private static final Map<Class, Converter> converterMap =  new HashMap<>();

    @Override
    public <T extends BaseEnum> Converter<String, T> getConverter(Class<T> targetType) {
        Converter<String, T> converter = converterMap.get(targetType);
        if(converter == null) {
            converter = new StringToEnumConverter<>(targetType);
            converterMap.put(targetType, converter);
        }
        return converter;
    }

    class StringToEnumConverter<T extends BaseEnum> implements Converter<String, T> {
        private Map<String, T> enumMap = new HashMap<>();

        StringToEnumConverter(Class<T> enumType) {
            T[] enums = enumType.getEnumConstants();
            for(T e : enums) {
                enumMap.put(String.valueOf(e.getValue()), e);
            }
        }

        @Override
        public T convert(String source) {

            T t = enumMap.get(source);
            if (t == null) {
                // 異常可以稍后去捕獲
                throw new IllegalArgumentException("No element matches " + source);
            }
            return t;
        }
    }

}

然后再將這個工廠配置到項目中WebMvcConfigurationSupport：

@Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverterFactory(new StringToEnumConverterFactory());

    }

意思就是string 轉 BaesEnum都走這個converter。

至此這個坑就算解決了。

下一篇繼續...