Jackson枚举序列化和反序列化器


225

我正在使用JAVA 1.6和Jackson 1.9.9我有一个枚举

public enum Event {
    FORGOT_PASSWORD("forgot password");

    private final String value;

    private Event(final String description) {
        this.value = description;
    }

    @JsonValue
    final String value() {
        return this.value;
    }
}

我添加了一个@JsonValue,这似乎可以将对象序列化为:

{"event":"forgot password"}

但是当我尝试反序列化时,我得到了

Caused by: org.codehaus.jackson.map.JsonMappingException: Can not construct instance of com.globalrelay.gas.appsjson.authportal.Event from String value 'forgot password': value not one of declared Enum instance names

我在这里想念什么?


4
你试过了{"Event":"FORGOT_PASSWORD"}吗?注意Event和FORGOT_PASSWORD的大小写。
OldCurmudgeon 2012年


谁来到这里,还要检查的getter setter方法的语法,如果你遵循不同的命名约定,即代替getValue这个GetValue行不通
DavutGürbüz

Answers:


286

如果您希望将枚举类与其JSON表示完全脱钩,则@xbakesx指出的序列化器/反序列化器解决方案是一个很好的解决方案。

另外,如果您希望使用独立的解决方案,则基于@JsonCreator@JsonValue注释的实现会更方便。

因此,利用@Stanley的示例,以下是一个完整的自包含解决方案(Java 6,Jackson 1.9):

public enum DeviceScheduleFormat {

    Weekday,
    EvenOdd,
    Interval;

    private static Map<String, DeviceScheduleFormat> namesMap = new HashMap<String, DeviceScheduleFormat>(3);

    static {
        namesMap.put("weekday", Weekday);
        namesMap.put("even-odd", EvenOdd);
        namesMap.put("interval", Interval);
    }

    @JsonCreator
    public static DeviceScheduleFormat forValue(String value) {
        return namesMap.get(StringUtils.lowerCase(value));
    }

    @JsonValue
    public String toValue() {
        for (Entry<String, DeviceScheduleFormat> entry : namesMap.entrySet()) {
            if (entry.getValue() == this)
                return entry.getKey();
        }

        return null; // or fail
    }
}

@Agusti,请看一下我的问题,我在那里错过了什么stackoverflow.com/questions/30525986/enum-is-not-binding
Prabjot Singh

25
也许对某些人来说很明显,但是请注意,@ JsonValue用于序列化,@ JsonCreator用于反序列化。如果两者都不做,则只需一个或另一个。
acvcu 2015年

6
我很不喜欢这种解决方案,因为您会介绍两个事实来源。开发人员将始终必须记住在两个位置添加名称。我更喜欢这样一种解决方案,该解决方案只做正确的事情,而不用地图装饰枚举的内部。
mttdbrd


1
除了静态映射,您还可以使用YourEnum.values(),它给出YourEnum数组并对其进行迭代
Valeriy

209

请注意,自2015年6月提交此内容(杰克逊2.6.2及更高版本)起,您现在可以简单地编写:

public enum Event {
    @JsonProperty("forgot password")
    FORGOT_PASSWORD;
}

1
不错的解决方案。遗憾的是我被捆绑在Dropwizard中的2.6.0捆绑了:-(
Clint Eastwood

1
不幸的是,在将枚举转换为字符串时,这不会返回该属性。
尼古拉斯

4
从2.8开始不推荐使用此功能。
pqian

2
此解决方案适用于Enum上的序列化和反序列化。在2.8中测试。
Downhillski '18


88

您应该创建一个静态工厂方法,该方法采用单个参数并用对其进行注释@JsonCreator(自Jackson 1.2起可用)。

@JsonCreator
public static Event forValue(String value) { ... }

在此处阅读有关JsonCreator注释的更多信息。


10
这是最干净,最简洁的解决方案,剩下的只是数不清的样板,可以(并且应该!)不惜一切代价避免!
克林特·伊斯特伍德

4
@JSONValue进行序列化和@JSONCreator反序列化。
Chiranjib

@JsonCreator public static Event valueOf(int intValue) { ... }反序列化intEvent枚举。
Eido95 '18 -10-3

1
@ClintEastwood是否应避免使用其他解决方案取决于您是否要将序列化/反序列化问题与枚举分开。
Asa

44

实际答案:

枚举的默认反序列化器用于.name()反序列化,因此不使用@JsonValue。因此,正如@OldCurmudgeon指出的那样,您需要传递{"event": "FORGOT_PASSWORD"}以匹配该.name()值。

另一个选项(假设您希望写入和读取json值相同)...

更多信息:

还有(另一种)使用Jackson来管理序列化和反序列化过程的方法。您可以指定以下批注以使用自己的自定义序列化器和反序列化器:

@JsonSerialize(using = MySerializer.class)
@JsonDeserialize(using = MyDeserializer.class)
public final class MyClass {
    ...
}

那你得写 MySerializerMyDeserializer它看起来像这样:

MySerializer

public final class MySerializer extends JsonSerializer<MyClass>
{
    @Override
    public void serialize(final MyClass yourClassHere, final JsonGenerator gen, final SerializerProvider serializer) throws IOException, JsonProcessingException
    {
        // here you'd write data to the stream with gen.write...() methods
    }

}

MyDeserializer

public final class MyDeserializer extends org.codehaus.jackson.map.JsonDeserializer<MyClass>
{
    @Override
    public MyClass deserialize(final JsonParser parser, final DeserializationContext context) throws IOException, JsonProcessingException
    {
        // then you'd do something like parser.getInt() or whatever to pull data off the parser
        return null;
    }

}

最后一点,特别是对于对JsonEnum使用该方法进行序列化的枚举执行此操作时getYourValue(),您的序列化器和反序列化器可能如下所示:

public void serialize(final JsonEnum enumValue, final JsonGenerator gen, final SerializerProvider serializer) throws IOException, JsonProcessingException
{
    gen.writeString(enumValue.getYourValue());
}

public JsonEnum deserialize(final JsonParser parser, final DeserializationContext context) throws IOException, JsonProcessingException
{
    final String jsonValue = parser.getText();
    for (final JsonEnum enumValue : JsonEnum.values())
    {
        if (enumValue.getYourValue().equals(jsonValue))
        {
            return enumValue;
        }
    }
    return null;
}

3
自定义(反)序列化器的使用扼杀了简单性(顺便说一句,使用Jackson是值得的),因此在非常繁重的情况下需要这样做。如下所述,使用@JsonCreator,并检查此评论
Dmitry Gryazin

1
此解决方案最适合于OPs问题中引入的有些疯狂的问题。真正的问题在于,OP希望以渲染形式返回结构化数据。也就是说,他们正在返回已经包含用户友好字符串的数据。但是为了将呈现的表单转换回标识符,我们需要一些可以反转转换的代码。骇人接受的答案想使用地图来处理转换,但需要更多维护。使用此解决方案,您可以添加新的枚举类型,然后您的开发人员可以继续他们的工作。
mttdbrd

34

我找到了一个非常简洁的解决方案,当您无法修改枚举类时尤其有用。然后,您应该提供一个启用了某些功能的自定义ObjectMapper。这些功能自Jackson 1.6开始可用。因此,您只需要toString()在枚举中编写方法。

public class CustomObjectMapper extends ObjectMapper {
    @PostConstruct
    public void customConfiguration() {
        // Uses Enum.toString() for serialization of an Enum
        this.enable(WRITE_ENUMS_USING_TO_STRING);
        // Uses Enum.toString() for deserialization of an Enum
        this.enable(READ_ENUMS_USING_TO_STRING);
    }
}

还有更多与枚举相关的功能,请参见此处:

https://github.com/FasterXML/jackson-databind/wiki/Serialization-Features https://github.com/FasterXML/jackson-databind/wiki/Deserialization-Features


10
不知道为什么需要扩展该类。您可以在ObjectMapper的实例上启用此功能。
mttdbrd

+1是因为他指出了我要在Spring application.yml中使用的[READ | WRITE] _ENUMS_USING_TO_STRING。yml
HelLViS69

8

试试这个。

public enum Event {

    FORGOT_PASSWORD("forgot password");

    private final String value;

    private Event(final String description) {
        this.value = description;
    }

    private Event() {
        this.value = this.name();
    }

    @JsonValue
    final String value() {
        return this.value;
    }
}

6

您可以为任何属性定制反序列化。

使用注解JsonDeserialize(import com.fasterxml.jackson.databind.annotation.JsonDeserialize)声明将要反序列化的类的属性。如果这是一个枚举:

@JsonDeserialize(using = MyEnumDeserialize.class)
private MyEnum myEnum;

这样,您的类将用于反序列化属性。这是一个完整的示例:

public class MyEnumDeserialize extends JsonDeserializer<MyEnum> {

    @Override
    public MyEnum deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
        JsonNode node = jsonParser.getCodec().readTree(jsonParser);
        MyEnum type = null;
        try{
            if(node.get("attr") != null){
                type = MyEnum.get(Long.parseLong(node.get("attr").asText()));
                if (type != null) {
                    return type;
                }
            }
        }catch(Exception e){
            type = null;
        }
        return type;
    }
}

纳撒尼尔·福特,好起来了吗?
Fernando Gomes

1
是的,这是一个更好的答案。它提供了一些上下文。不过,我将走得更远,讨论为什么以这种方式添加反序列化可以解决OP的特定障碍。
纳撒尼尔·福特

5

您可以采用多种方法来将JSON对象反序列化为枚举。我最喜欢的样式是制作内部类:

import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.JsonProperty;
import org.hibernate.validator.constraints.NotEmpty;

import java.util.Arrays;
import java.util.Map;
import java.util.function.Function;
import java.util.stream.Collectors;

import static com.fasterxml.jackson.annotation.JsonFormat.Shape.OBJECT;

@JsonFormat(shape = OBJECT)
public enum FinancialAccountSubAccountType {
  MAIN("Main"),
  MAIN_DISCOUNT("Main Discount");

  private final static Map<String, FinancialAccountSubAccountType> ENUM_NAME_MAP;
  static {
    ENUM_NAME_MAP = Arrays.stream(FinancialAccountSubAccountType.values())
      .collect(Collectors.toMap(
        Enum::name,
        Function.identity()));
  }

  private final String displayName;

  FinancialAccountSubAccountType(String displayName) {
    this.displayName = displayName;
  }

  @JsonCreator
  public static FinancialAccountSubAccountType fromJson(Request request) {
    return ENUM_NAME_MAP.get(request.getCode());
  }

  @JsonProperty("name")
  public String getDisplayName() {
    return displayName;
  }

  private static class Request {
    @NotEmpty(message = "Financial account sub-account type code is required")
    private final String code;
    private final String displayName;

    @JsonCreator
    private Request(@JsonProperty("code") String code,
                    @JsonProperty("name") String displayName) {
      this.code = code;
      this.displayName = displayName;
    }

    public String getCode() {
      return code;
    }

    @JsonProperty("name")
    public String getDisplayName() {
      return displayName;
    }
  }
}

4

这是另一个使用字符串值而不是映射的示例。

public enum Operator {
    EQUAL(new String[]{"=","==","==="}),
    NOT_EQUAL(new String[]{"!=","<>"}),
    LESS_THAN(new String[]{"<"}),
    LESS_THAN_EQUAL(new String[]{"<="}),
    GREATER_THAN(new String[]{">"}),
    GREATER_THAN_EQUAL(new String[]{">="}),
    EXISTS(new String[]{"not null", "exists"}),
    NOT_EXISTS(new String[]{"is null", "not exists"}),
    MATCH(new String[]{"match"});

    private String[] value;

    Operator(String[] value) {
        this.value = value;
    }

    @JsonValue
    public String toStringOperator(){
        return value[0];
    }

    @JsonCreator
    public static Operator fromStringOperator(String stringOperator) {
        if(stringOperator != null) {
            for(Operator operator : Operator.values()) {
                for(String operatorString : operator.value) {
                    if (stringOperator.equalsIgnoreCase(operatorString)) {
                        return operator;
                    }
                }
            }
        }
        return null;
    }
}

4

在枚举的上下文中,使用@JsonValuenow(从2.0开始)可进行序列化反序列化。

根据javason的jackson-annotations@JsonValue

注意:当用于Java枚举时,一个附加功能是带注释的方法返回的值也被视为要反序列化的值,而不仅仅是序列化为JSON字符串的值。这是可能的,因为Enum值的集合是恒定的,并且可以定义映射,但是通常不能对POJO类型执行此操作。因此,这不适用于POJO反序列化。

因此,对Event杰克逊2.0+ 的枚举进行上述注释(适用于序列化和反序列化)。


3

除了使用@JsonSerialize @JsonDeserialize,您还可以在对象映射器中使用SerializationFeature和DeserializationFeature(杰克逊绑定)。

如DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE,如果未在枚举类中定义提供的枚举类型,则将提供默认枚举类型。


0

我发现的最简单的方法是对枚举使用@ JsonFormat.Shape.OBJECT批注。

@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public enum MyEnum{
    ....
}

0

就我而言,这是解决的方法:

import com.fasterxml.jackson.annotation.JsonCreator;
import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.JsonProperty;

@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public enum PeriodEnum {

    DAILY(1),
    WEEKLY(2),
    ;

    private final int id;

    PeriodEnum(int id) {
        this.id = id;
    }

    public int getId() {
        return id;
    }

    public String getName() {
        return this.name();
    }

    @JsonCreator
    public static PeriodEnum fromJson(@JsonProperty("name") String name) {
        return valueOf(name);
    }
}

序列化和反序列化以下json:

{
  "id": 2,
  "name": "WEEKLY"
}

希望对您有所帮助!

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.