反序列化生成的子類結果在父 object

Question

版本：Swagger-codegen (v3)：3.0.11 | Jackson：2.9.8

我目前從swagger.yaml文件生成我的類（由於雙重復制粘貼，縮進可能不同）：

---
swagger: "2.0"
info:
  description: "servicename"
  version: "1.0"
  title: "servicename"
schemes:
  - "http"
  - "https"
paths:

definitions:
  Notification:
    type: "object"
    discriminator: "typeOfNotification"
    properties:
      typeOfNotification:
        description: "Type of notification"
        enum:
          - "EMAIL"
          - "SMS"
        default: "EMAIL"
  EmailNotification:
    allOf:
    - $ref: "#/definitions/Notification"
    - type: "object"
      properties:
        name:
          type: "string"
          example: "Name of reciever"
          description: "Name of the receiver"
        emailAddress:
          type: "string"
          example: "info@stackoverflow.com"
          description: "Email address of the receiver"

生成兩個類：

通知.java

package nl.test;

import java.util.Objects;
import java.util.Arrays;
import com.google.gson.TypeAdapter;
import com.google.gson.annotations.JsonAdapter;
import com.google.gson.annotations.SerializedName;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import io.swagger.v3.oas.annotations.media.Schema;
import java.io.IOException;
/**
 * Notification
 */

@javax.annotation.Generated(value = "io.swagger.codegen.v3.generators.java.JavaClientCodegen", date = "2019-09-26T16:01:12.401+02:00[Europe/Amsterdam]")
public abstract class Notification {
  /**
   * Type of notification
   */
  @JsonAdapter(TypeOfNotificationEnum.Adapter.class)
  public enum TypeOfNotificationEnum {
    EMAIL("EMAIL"),
    SMS("SMS");

    private String value;

    TypeOfNotificationEnum(String value) {
      this.value = value;
    }
    public String getValue() {
      return value;
    }

    @Override
    public String toString() {
      return String.valueOf(value);
    }
    public static TypeOfNotificationEnum fromValue(String text) {
      for (TypeOfNotificationEnum b : TypeOfNotificationEnum.values()) {
        if (String.valueOf(b.value).equals(text)) {
          return b;
        }
      }
      return null;
    }
    public static class Adapter extends TypeAdapter<TypeOfNotificationEnum> {
      @Override
      public void write(final JsonWriter jsonWriter, final TypeOfNotificationEnum enumeration) throws IOException {
        jsonWriter.value(enumeration.getValue());
      }

      @Override
      public TypeOfNotificationEnum read(final JsonReader jsonReader) throws IOException {
        String value = jsonReader.nextString();
        return TypeOfNotificationEnum.fromValue(String.valueOf(value));
      }
    }
  }  @SerializedName("typeOfNotification")
  private TypeOfNotificationEnum typeOfNotification = null;

  public Notification typeOfNotification(TypeOfNotificationEnum typeOfNotification) {
    this.typeOfNotification = typeOfNotification;
    return this;
  }


  @Schema(description = "Type of notification")
  public TypeOfNotificationEnum getTypeOfNotification() {
    return typeOfNotification;
  }

  public void setTypeOfNotification(TypeOfNotificationEnum typeOfNotification) {
    this.typeOfNotification = typeOfNotification;
  }


  @Override
  public boolean equals(java.lang.Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
    Notification notification = (Notification) o;
    return Objects.equals(this.typeOfNotification, notification.typeOfNotification);
  }

  @Override
  public int hashCode() {
    return Objects.hash(typeOfNotification);
  }
}

和電子郵件通知：

package nl.test;

import java.util.Objects;
import java.util.Arrays;
import com.google.gson.TypeAdapter;
import com.google.gson.annotations.JsonAdapter;
import com.google.gson.annotations.SerializedName;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import io.swagger.v3.oas.annotations.media.Schema;
import java.io.IOException;
import nl.test.Notification;
/**
 * EmailNotification
 */

@javax.annotation.Generated(value = "io.swagger.codegen.v3.generators.java.JavaClientCodegen", date = "2019-09-26T16:01:12.401+02:00[Europe/Amsterdam]")
public class EmailNotification extends Notification {
  @SerializedName("name")
  private String name = null;

  @SerializedName("emailAddress")
  private String emailAddress = null;

  public EmailNotification name(String name) {
    this.name = name;
    return this;
  }

   /**
   * Name of the receiver
   * @return name
  **/
  @Schema(example = "Name of receiver", description = "Name of the receiver")
  public String getName() {
    return name;
  }

  public void setName(String name) {
    this.name = name;
  }

  public EmailNotification emailAddress(String emailAddress) {
    this.emailAddress = emailAddress;
    return this;
  }

   /**
   * Email address of the receiver
   * @return emailAddress
  **/
  @Schema(example = "test@stackoverflow.com", description = "Email address of the receiver")
  public String getEmailAddress() {
    return emailAddress;
  }

  public void setEmailAddress(String emailAddress) {
    this.emailAddress = emailAddress;
  }


  @Override
  public boolean equals(java.lang.Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
     EmailNotification = (EmailNotification) o;
    return Objects.equals(this.name, emailNotification.name) &&
        Objects.equals(this.emailAddress, emailNotification.emailAddress) &&
        super.equals(o);
  }

  @Override
  public int hashCode() {
    return Objects.hash(name, emailAddress, super.hashCode());
  }

}

這很好。 但是現在問題出現在JSON的反序列化過程中。 When an ObjectMapper is passed the JSON corresponding to a User class, which has one property of type Notification , and the JSON is actually of type EmailNotification , then for some reason the deserializer doesn't care and deserializes it into a Notification , thus ignoring the emailAddress屬性。

對應測試class：

package nl.test;

import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.junit.MockitoJUnitRunner;
import org.threeten.bp.LocalDate;

import static com.fasterxml.jackson.databind.MapperFeature.ACCEPT_CASE_INSENSITIVE_ENUMS;
import static org.junit.Assert.*;


@RunWith(MockitoJUnitRunner.class)
public class ObjectMappersConfigurationTest {

    @Test
    public void test() throws Exception {
        String json = "{\n" +
                "  \"user\": {\n" +
                "    \"notification\": {\n" +
                "      \"name\": \"somename\",\n" +
                "      \"emailAddress\": \"test@stackoverflow.com\",\n" +
                "      \"typeOfNotification\": \"EMAIL\"\n" +
                "    },\n" +
                "  }\n" +
                "}\n";

        ObjectMapper mapper = createJsonObjectMapper();
        User order = mapper.readValue(json, User.class);

        assertEquals(1, 1);
    }

    public ObjectMapper createJsonObjectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        setDefaultRelaxObjectMappings(objectMapper);
        return objectMapper;
    }

    public static void setDefaultRelaxObjectMappings(ObjectMapper objectMapper) {
        objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        objectMapper.configure(DeserializationFeature.FAIL_ON_INVALID_SUBTYPE, false);

        objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
        objectMapper.enable(ACCEPT_CASE_INSENSITIVE_ENUMS);
    }
}

output 將是：

User {
  notification {
     notificationType: EMAIL
  }
}

我期望的地方：

User {
  notification {
     notificationType: EMAIL,
     emailAddress: "...",
     name: "..."
  }
}

現在我知道我可以為此目的使用自定義反序列化器，但這似乎有點矯枉過正，我想用 inheritance 反序列化對象應該是一個簡單的設置。 我似乎無法找到它。

啟用默認類型將是另一種選擇，但我寧願避免這樣做，因為我們的 YAML 文件來自外部方，迫使他們默認類型 YAML 不是最好的解決方案 IMO。

Answer 1

原來@JsonSubType注釋丟失了。 由於ObjectMapper不與 swagger 通信，因此它永遠不會知道 class 應該映射到EmailNotification ，因此總是會創建一個Notification object。

添加：

<plugin>
   ....
   <configuration>
     ...
     <library>jersey2</library>
   </configuration>
</plugin>

修復了它， Notification class 的 class 注釋現在生成為：

@JsonSubTypes({
  @JsonSubTypes.Type(value = SMSNotification.class, name = "SMSNotification"),
  @JsonSubTypes.Type(value = EmailNotification.class, name = "EmailNotification"),
})
public class Notification {
    ....

這添加了ObjectMapper在反序列化時理解的映射。

特別感謝這里提供的答案swagger-codegen 客戶端：How to include jackson annotations on models