Сериализация Джексона и DeSerializer

225

Я использую JAVA 1.6 и Jackson 1.9.9 У меня есть enum

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

Что мне здесь не хватает?

pookieman
источник
4
Ты пробовал {"Event":"FORGOT_PASSWORD"}? Обратите внимание на заглавные буквы на Event и FORGOT_PASSWORD.
OldCurmudgeon
Пришедшие сюда также проверяют синтаксис установщика геттера, если вы следуете другому соглашению об именах, т.е. вместо getValueэтого GetValueне работает
Давут Гюрбуз

Ответы:

287

Решение для сериализатора / десериализатора, на которое указывает @xbakesx, является отличным решением, если вы хотите полностью отделить свой класс enum от его представления JSON.

В качестве альтернативы, если вы предпочитаете автономное решение, реализация на основе @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
Прабджот Сингх
25
для некоторых это очевидно, но обратите внимание, что @ JsonValue используется для сериализации, а @ JsonCreator - для десериализации. Если вы не делаете оба, вам понадобится только одно или другое.
Acvcu
6
Мне действительно не нравится это решение из-за того факта, что вы вводите два источника правды. Разработчик всегда должен помнить, чтобы добавить имя в двух местах. Я очень предпочитаю решение, которое просто делает правильные вещи, не украшая внутренности перечисления картой.
mttdbrd
2
@ttdbrd как насчет того, чтобы объединить истины? gist.github.com/Scuilion/036c53fd7fee2de89701a95822c0fb60
KevinO
1
Вместо статической карты вы можете использовать YourEnum.values ​​(), который дает Array of YourEnum и выполняет итерацию по нему
Валерий К.
209

Обратите внимание, что с этого коммита в июне 2015 года (Jackson 2.6.2 и выше) вы теперь можете просто написать:

public enum Event {
    @JsonProperty("forgot password")
    FORGOT_PASSWORD;
}
TIF
источник
1
Хорошее решение. Обидно, что я застрял с 2.6.0 в комплекте с Dropwizard :-(
Клинт Иствуд
1
К сожалению, это не возвращает свойство при преобразовании вашего перечисления в строку.
Николай
4
Эта функция устарела с версии 2.8.
Pqian
2
Это решение работает как для сериализации, так и для десериализации в Enum. Проверено в 2.8.
Даунхилски,
1
Похоже, не рекомендуется вообще: github.com/FasterXML/jackson-annotations/blob/master/src/main/…
pablo
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) { ... }десериализовать intв Eventсчетчик.
Eido95
1
@ClintEastwood, следует ли избегать других решений, зависит от того, хотите ли вы отделить проблемы сериализации / десериализации от перечисления или нет.
Аса
44

Фактический ответ:

Десериализатор по умолчанию для перечислений использует .name()для десериализации, поэтому он не использует @JsonValue. Таким образом, как указал @OldCurmudgeon, вам нужно пройти, {"event": "FORGOT_PASSWORD"}чтобы соответствовать.name() значению.

Другой вариант (если вы хотите, чтобы значения json для записи и чтения были одинаковыми) ...

Больше информации:

Существует (еще) другой способ управления процессом сериализации и десериализации с Джексоном. Вы можете указать эти аннотации, чтобы использовать свой собственный сериализатор и десериализатор:

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

Затем вы должны написать, MySerializerи MyDeserializerкоторые выглядят так:

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;
}
xbakesx
источник
3
Использование пользовательского (де) сериализатора убивает простоту (которая, кстати, стоит использовать Джексона), так что это необходимо в действительно тяжелых ситуациях. Используйте @JsonCreator, как описано ниже, и проверьте этот комментарий
Дмитрий Грязин
1
Это решение лучше всего подходит для несколько сумасшедшей проблемы, представленной в вопросе ОП. Настоящая проблема здесь заключается в том, что ОП хочет вернуть структурированные данные в визуализированном виде. То есть они возвращают данные, которые уже содержат дружественную строку. Но чтобы превратить визуализированную форму обратно в идентификатор, нам нужен код, который может обратить преобразование. Хакерский принятый ответ хочет использовать карту для обработки преобразования, но требует большего обслуживания. С помощью этого решения вы можете добавлять новые перечисляемые типы, и тогда ваши разработчики смогут продолжить свою работу.
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);
    }
}

Доступны дополнительные функции, связанные с enum, см. Здесь:

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

lagivan
источник
10
не уверен, почему вам нужно расширить класс. Вы можете включить эту функцию в экземпляре ObjectMapper.
mttdbrd
+1, потому что он указал мне на [READ | WRITE] _ENUMS_USING_TO_STRING, который я могу использовать в приложении
Spring.yml
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

Вы можете настроить десериализацию для любого атрибута.

Объявите свой класс десериализации, используя annotationJsonDeserialize ( import com.fasterxml.jackson.databind.annotation.JsonDeserialize) для атрибута, который будет обработан. Если это Enum:

@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;
    }
}
Фернандо Гомес
источник
Натаниэль Форд, поправился?
Фернандо Гомес
1
Да, это гораздо лучший ответ; это обеспечивает некоторый контекст. Однако я бы пошел еще дальше и обсудил, почему добавление десериализации таким образом устраняет конкретные препятствия ФП.
Натаниэль Форд
5

Существуют различные подходы, которые можно использовать для выполнения десериализации объекта JSON в enum. Мой любимый стиль - сделать внутренний класс:

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;
    }
}
Gremash
источник
4

В контексте перечисления использование @JsonValuenow (начиная с 2.0) работает для сериализации и десериализации.

Согласно Джексон-аннотации Javadoc для@JsonValue :

ПРИМЕЧАНИЕ: при использовании для перечислений Java одной дополнительной особенностью является то, что значение, возвращаемое аннотированным методом, также считается значением для десериализации, а не просто строкой JSON для сериализации. Это возможно, так как набор значений Enum является постоянным и возможно определить отображение, но не может быть сделано вообще для типов POJO; как таковой, он не используется для десериализации POJO.

Таким образом, Eventаннотированное перечисление, как указано выше, работает (как для сериализации, так и для десериализации) с Jackson 2.0+.

Брайс Ронкас
источник
3

Помимо использования @JsonSerialize @JsonDeserialize, вы также можете использовать SerializationFeature и DeserializationFeature (привязка Джексона) в сопоставителе объектов.

Например, DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE, которые дают тип перечисления по умолчанию, если предоставленный тип не определен в классе перечисления.

Yuantao
источник
0

Самый простой способ, который я нашел, - это использование аннотации @ JsonFormat.Shape.OBJECT для перечисления.

@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public enum MyEnum{
    ....
}
yrazlik
источник
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"
}

Я надеюсь, что это помогает!

Флавио Соуза
источник