Spring 引导向 XML 元素添加属性但不在 JSON 响应中

Question

我正在开发一个 API，它会同时产生 XML 和 JSON 响应。我在响应中有一个元素仅在 XML 响应中需要一个属性。此外，当值为 null 时，该元素不应出现在两种格式的响应中。

期望：
XML:

<name>john</name>
<status type="text">married</status>

JSON:

"name":"john"
"status":"married"

这是我的代码：

    /**
     * POJO with bunch of LOMBOK annotations to avoid boiler-plate code.
     */
    @AllArgsConstructor
    @NoArgsConstructor
    @Builder(toBuilder = true)
    @Data
    public class User implements Customer, Serializable {

        private static final long serialVersionUID = 1L;

        private Status status;
        private String name;

        /**
         * Matrital status of the user.
         */
        @Builder
        @Value
        public static class Status {

            @JacksonXmlText
            private String maritalStatus;

            @JacksonXmlProperty(isAttribute = true)
            private String type = "text";
        }

    }

通过上述更改，我得到了正确的 XML 响应，但 JSON 响应也 returns type=text

 "status" : {
    "maritalStatus" : "married",
    "type" : "text"
  }

我尝试将 @JsonValue 添加到 private String maritalStatus，这解决了 JSON 响应，但由于未将属性添加到元素而破坏了 XML 响应。

有人可以帮忙吗？

Answer 1

可能最简单的方法是为 User.Status 实现自定义序列化器并为不同类型的表示生成不同的输出。

class UserStatusJsonSerializer extends JsonSerializer<User.Status> {

    @Override
    public void serialize(User.Status value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        if (gen instanceof ToXmlGenerator) {
            ToXmlGenerator toXmlGenerator = (ToXmlGenerator) gen;
            serializeXml(value, toXmlGenerator);
        } else {
            gen.writeString(value.getMaritalStatus());
        }
    }

    private void serializeXml(User.Status value, ToXmlGenerator toXmlGenerator) throws IOException {
        toXmlGenerator.writeStartObject();

        toXmlGenerator.setNextIsAttribute(true);
        toXmlGenerator.writeFieldName("type");
        toXmlGenerator.writeString(value.getType());
        toXmlGenerator.setNextIsAttribute(false);
        toXmlGenerator.writeRaw(value.getMaritalStatus());

        toXmlGenerator.writeEndObject();
    }

    @Override
    public boolean isEmpty(SerializerProvider provider, User.Status value) {
        return value == null || value.getMaritalStatus() == null;
    }
}

从现在开始，您可以删除额外的 XML 注释并注册自定义序列化程序：

@AllArgsConstructor
@NoArgsConstructor
@Builder(toBuilder = true)
@Data
class User implements Serializable {

    private static final long serialVersionUID = 1L;

    private Status status;
    private String name;

    @Builder
    @Value
    @JsonSerialize(using = UserStatusJsonSerializer.class)
    public static class Status {
        private String maritalStatus;
        private String type = "text";
    }
}

简单的控制台应用程序用法如下所示：

import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.json.JsonMapper;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import com.fasterxml.jackson.dataformat.xml.ser.ToXmlGenerator;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.Value;

import java.io.IOException;
import java.io.Serializable;
import java.util.Arrays;
import java.util.List;

public class JsonPathApp {

    public static void main(String[] args) throws Exception {
        List<User> users = Arrays.asList(
                createUser("John", "married"),
                createUser("Tom", null));

        ObjectMapper jsonMapper = JsonMapper.builder()
                .enable(SerializationFeature.INDENT_OUTPUT)
                .serializationInclusion(JsonInclude.Include.NON_EMPTY)
                .build();
        for (User user : users) {
            System.out.println(jsonMapper.writeValueAsString(user));
            System.out.println();
        }

        XmlMapper xmlMapper = XmlMapper.builder()
                .enable(SerializationFeature.INDENT_OUTPUT)
                .serializationInclusion(JsonInclude.Include.NON_EMPTY)
                .build();
        for (User user : users) {
            System.out.println(xmlMapper.writeValueAsString(user));
            System.out.println();
        }
    }

    private static User createUser(String name, String maritalStatus) {
        return User.builder()
                .name(name)
                .status(User.Status.builder()
                        .maritalStatus(maritalStatus)
                        .build())
                .build();
    }
}

以上代码打印

JSON 约翰：

{
  "status" : "married",
  "name" : "John"
}

JSON 汤姆：

{
  "name" : "Tom"
}

XML 约翰：

<User>
  <status type="text">married</status>
  <name>John</name>
</User>

XML 汤姆

<User>
  <name>Tom</name>
</User>

注意，我们实现了 UserStatusJsonSerializer#isEmpty 方法，它定义了 empty 对于 Status class 的含义。现在，我们需要在您的 Spring Boot 应用程序中启用 JsonInclude.Include.NON_EMPTY 功能。将以下密钥添加到您的应用程序配置文件中：

spring.jackson.default-property-inclusion=non_empty

如果您不想全局启用包含，您可以使用 @JsonInclude 注释仅为一个属性启用它。

@JsonInclude(JsonInclude.Include.NON_EMPTY)
private Status status;

另请参阅：

How to tell Jackson to ignore a field during serialization if its value is null?
Spring Boot: Customize the Jackson ObjectMapper

Answer 2

在 XML 中以一种方式编组对象的解决方案，但在 JSON 中的另一种方式（不同的字段等）是使用 "mixins"。一个技巧是您必须手动注册 mixin，这没有魔法。见下文。

混合接口：

public interface UserStatusXmlMixin {

    @JsonValue(false)
    @JacksonXmlText
    String getStatus();

    @JacksonXmlProperty(isAttribute = true)
    String getType();
}

实施：

@Value
public class UserStatus implements UserStatusXmlMixin {

    private String status;

    @JsonValue
    @Override
    public String getStatus() {
        return status;
    }

    @Override
    public String getType() {
        return "text";
    }

    /**
     * Returns an unmodifiable UserStatus when status is available, 
     * otherwise return null. This will help to remove this object from the responses.
     */
    public static UserStatus of(final String status) {
        return Optional.ofNullable(status)
                       .map(UserStatus::new)
                       .orElse(null);
    }

}

我还必须手动注册 "mixin"。

@Configuration
public class AppJacksonModule extends SimpleModule {

    private static final long serialVersionUID = -1;

    private final Map<Class, Class> mixinByTarget;

    /**
     * Construct an AppJacksonModule.
     */
    public AppJacksonModule() {
        super("AppJacksonModule");
        this.mixinByTarget = Map.of(
                UserStatus.class, UserStatusXmlMixin.class
        );
    }

    @Override
    public void setupModule(final SetupContext context) {
        super.setupModule(context);
        final ObjectCodec contextOwner = context.getOwner();
        if (contextOwner instanceof XmlMapper) {
            mixinByTarget.forEach(context::setMixInAnnotations);
        }
    }

现在，如果输入参数为空，无论我需要使用 UserStatus.of(..) 创建 UserStatus，<status/> 都不会出现在响应中。

Spring 引导向 XML 元素添加属性但不在 JSON 响应中

Spring Boot adding attribute to XML element but NOT in JSON response

xml

json

jackson

lombok

spring-boot

以上代码打印