Jackson enum Serializing and DeSerializer

225

Używam JAVA 1.6 i Jackson 1.9.9 Mam wyliczenie

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;
    }
}

Dodałem @JsonValue, wydaje się, że wykonuje to zadanie, w którym serializuje obiekt do:

{"event":"forgot password"}

ale kiedy próbuję deserializować, dostaję

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

Czego tu brakuje?

pookieman
źródło
4
Próbowałeś {"Event":"FORGOT_PASSWORD"}? Zwróć uwagę na ograniczenia zarówno dla zdarzenia, jak i FORGOT_PASSWORD.
OldCurmudgeon
Kto tu przyszedł, sprawdź także składnię narzędzia ustawiającego getter, jeśli przestrzegasz innej konwencji nazewnictwa, tzn. Zamiast getValuetego GetValuenie działa
Davut Gürbüz

Odpowiedzi:

286

Rozwiązanie szeregujące / deserializujące wskazane przez @xbakesx jest doskonałe, jeśli chcesz całkowicie oddzielić swoją klasę enum od jej reprezentacji JSON.

Alternatywnie, jeśli wolisz samodzielne rozwiązanie, wygodniejsze byłoby wdrożenie oparte na adnotacjach @JsonCreatori @JsonValueadnotacjach.

Tak więc korzystając z przykładu @Stanley, poniższe jest kompletnym samodzielnym rozwiązaniem (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
    }
}
Agustí Sánchez
źródło
@ Agusti, proszę spojrzeć na moje pytanie, co tam brakuje, stackoverflow.com/questions/30525986/enum-is-not-binding
Prabjot Singh
25
dla niektórych może to oczywiste, ale należy pamiętać, że @ JsonValue służy do serializacji, a @ JsonCreator do deserializacji. Jeśli nie robisz obu, potrzebujesz tylko jednego lub drugiego.
acvcu
6
Naprawdę nie lubię tego rozwiązania z powodu prostego faktu, że wprowadzacie dwa źródła prawdy. Deweloper zawsze będzie musiał pamiętać o dodaniu nazwy w dwóch miejscach. Zdecydowanie wolę rozwiązanie, które po prostu robi właściwą rzecz bez ozdabiania wnętrza wyliczenia mapą.
mttdbrd 10.10.16
2
@ttdbrd, a co powiesz na to, by zjednoczyć prawdy? gist.github.com/Scuilion/036c53fd7fee2de89701a95822c0fb60
KevinO
1
Zamiast mapy statycznej możesz użyć YourEnum.values ​​(), które dają Array of YourEnum i iterują na niej
Valeriy K.
209

Zauważ, że od tego zatwierdzenia w czerwcu 2015 r. (Jackson 2.6.2 i wyżej) możesz teraz po prostu napisać:

public enum Event {
    @JsonProperty("forgot password")
    FORGOT_PASSWORD;
}
tif
źródło
1
fajne rozwiązanie. Szkoda, że ​​utknąłem z pakietem 2.6.0 w Dropwizard :-(
Clint Eastwood
1
Niestety nie zwraca to właściwości przy konwersji enumu na ciąg.
Mikołaj
4
Ta funkcja jest przestarzała od wersji 2.8.
pqian 10.10.17
2
To rozwiązanie działa zarówno w przypadku serializacji, jak i deserializacji w Enum. Testowany w 2.8.
Downhillski
1
W ogóle nie wydaje się być przestarzałe: github.com/FasterXML/jackson-annotations/blob/master/src/main/…
pablo
88

Powinieneś stworzyć statyczną metodę fabryczną, która pobiera pojedynczy argument i adnotuje go @JsonCreator(dostępna od Jackson 1.2)

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

Przeczytaj więcej o adnotacjach JsonCreator tutaj .

Stanley
źródło
10
To najczystsze i najbardziej zwięzłe rozwiązanie, reszta to tylko tony płyty kotłowej, których można (i należy!) Uniknąć za wszelką cenę!
Clint Eastwood
4
@JSONValueserializować i @JSONCreatordeserializować.
Chiranjib
@JsonCreator public static Event valueOf(int intValue) { ... }deserializacji intdo Eventwyliczający.
Eido95
1
@ClintEastwood, czy należy unikać innych rozwiązań, zależy od tego, czy chcesz oddzielić kwestie szeregowości / deserializacji od wyliczenia.
Asa
44

Rzeczywista odpowiedź:

Domyślny deserializator dla wyliczeń używa .name()do deserializacji, więc nie używa @JsonValue. Tak jak wskazał @OldCurmudgeon, musisz przekazać, {"event": "FORGOT_PASSWORD"}aby dopasować .name()wartość.

Inna opcja (zakładając, że chcesz, aby zapis i odczyt wartości Json były takie same) ...

Więcej informacji:

Istnieje (jeszcze) inny sposób zarządzania procesem serializacji i deserializacji z Jacksonem. Możesz określić te adnotacje, aby użyć własnego niestandardowego serializatora i deserializatora:

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

Następnie musisz napisać MySerializeri MyDeserializerktóre wyglądają tak:

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;
    }

}

Na JsonEnumkoniec , szczególnie w przypadku wyliczenia szeregowego za pomocą metody getYourValue(), Twój serializator i deserializator mogą wyglądać następująco:

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
źródło
3
Użycie niestandardowego (de) serializatora zabija prostotę (która jest warta użycia Jacksona, btw), więc jest to potrzebne w naprawdę ciężkich sytuacjach. Użyj @JsonCreator, jak opisano poniżej, i sprawdź ten komentarz
Dmitry Gryazin
1
To rozwiązanie najlepiej nadaje się do nieco zwariowanego problemu wprowadzonego w pytaniu dotyczącym PO. Prawdziwy problem polega na tym, że OP chce zwrócić uporządkowane dane w renderowanej formie. Oznacza to, że zwracają dane, które zawierają już przyjazny dla użytkownika ciąg. Ale aby przekształcić renderowaną formę z powrotem w identyfikator, potrzebujemy kodu, który może odwrócić transformację. Zaakceptowana odpowiedź chce użyć mapy do obsługi transformacji, ale wymaga więcej konserwacji. Dzięki temu rozwiązaniu możesz dodawać nowe wyliczone typy, a następnie programiści mogą wykonywać swoje zadania.
mttdbrd
34

Znalazłem bardzo miłe i zwięzłe rozwiązanie, szczególnie przydatne, gdy nie możesz modyfikować klas enum, jak to było w moim przypadku. Następnie powinieneś dostarczyć niestandardowy ObjectMapper z włączoną określoną funkcją. Te funkcje są dostępne od wersji Jackson 1.6. Musisz tylko napisać toString()metodę w swoim wyliczeniu.

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);
    }
}

Dostępnych jest więcej funkcji związanych z wyliczaniem, patrz tutaj:

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

lagivan
źródło
10
nie jestem pewien, dlaczego musisz przedłużyć klasę. możesz włączyć tę funkcję w instancji ObjectMapper.
mttdbrd 10.10.16
+1, ponieważ wskazał mi [CZYTAJ | NAPISZ] _ENUMS_USING_TO_STRING, którego mogę użyć w aplikacji
Spring.yml
8

Spróbuj tego.

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;
    }
}
Durga
źródło
6

Możesz dostosować deserializację dla dowolnego atrybutu.

Zadeklaruj swoją deserializowaną klasę za pomocą adnotacjiJsonDeserialize ( import com.fasterxml.jackson.databind.annotation.JsonDeserialize) dla atrybutu, który zostanie przetworzony. Jeśli jest to Enum:

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

W ten sposób twoja klasa zostanie wykorzystana do deserializacji atrybutu. To jest pełny przykład:

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
źródło
Nathaniel Ford, wyzdrowiałeś?
Fernando Gomes
1
Tak, to jest o wiele lepsza odpowiedź; zapewnia pewien kontekst. Chciałbym jednak pójść jeszcze dalej i przedyskutować, dlaczego dodanie deserializacji w ten sposób rozwiązuje konkretną przeszkodę PO.
Nathaniel Ford
5

Istnieją różne podejścia do deserializacji obiektu JSON do wyliczenia. Moim ulubionym stylem jest stworzenie klasy wewnętrznej:

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;
    }
  }
}
Sam Berry
źródło
4

Oto kolejny przykład, który używa wartości ciągu zamiast mapy.

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
źródło
4

W kontekście wyliczenia użycie @JsonValueteraz (od 2.0) działa na serializacji i deserializacji.

Według javadoc jackson-adnotations dla@JsonValue :

UWAGA: podczas korzystania z wyliczeń Java, jedną dodatkową cechą jest to, że wartość zwracana przez metodę z adnotacjami jest również uważana za wartość do deserializacji, a nie tylko ciąg JSON do serializacji. Jest to możliwe, ponieważ zestaw wartości Enum jest stały i możliwe jest zdefiniowanie odwzorowania, ale ogólnie nie można tego zrobić dla typów POJO; jako taki nie jest wykorzystywany do deserializacji POJO.

Tak więc Eventwyliczanie adumacji tak jak powyżej działa (zarówno w przypadku serializacji, jak i deserializacji) z jacksonem 2.0+.

Brice Roncace
źródło
3

Oprócz używania @JsonSerialize @JsonDeserialize, możesz również użyć SerializationFeature i DeserializationFeature (powiązanie Jacksona) w maperze obiektów.

Takie jak DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_USING_DEFAULT_VALUE, które dają domyślny typ wyliczenia, jeśli podany nie jest zdefiniowany w klasie wyliczania.

Yuantao
źródło
0

Najprostszym sposobem, jaki znalazłem, jest użycie adumacji @ JsonFormat.Shape.OBJECT dla wyliczenia.

@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public enum MyEnum{
    ....
}
yrazlik
źródło
0

W moim przypadku to rozwiązało:

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);
    }
}

Serializuje i deserializuje następujący plik Json:

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

Mam nadzieję, że to pomoże!

Flavio Sousa
źródło