Jackson自定义序列化：处理外部库嵌套对象并扁平化为列表

public class Article extends AbstractEntityBase {
    // ... 其他字段
    @NonNull
    LocalizedTexts designation; // 需要转换
    LocalizedTexts touchCaption; // 需要转换
    LocalizedTexts printText; // 需要转换
    LocalizedTexts productInformation; // 需要转换
    // ... 其他字段
}

// 来自第三方库，无法修改
public class LocalizedTexts extends HashMap<Language, String> implements EntityBase {
    // ...
}

// 来自第三方库，无法修改
public enum Language {
    AA("aa"), AB("ab"), AE("ae"), AF("af"), AK("ak"),
    // ...
    DE("german"), EN("english"), ES("spanish"); // 假设有对应的语言名

    private final String langName;
    Language(String langName) { this.langName = langName; }
    public String getLangName() { return langName; } // 假设有此方法
}

{
    "id": "...",
    "iNo": 3,
    "isValid": true,
    "articleGroup": { /* ... */ },
    "numberOfDecimalsSalesPrice": 2,
    "codes": [ /* ... */ ],
    "translation": [ // 扁平化后的列表
        { "productInformation": "...", "language": "spanish" },
        { "touchCaption": "...", "language": "english" },
        { "designation": "...", "language": "german" }
        // ... 所有 LocalizedTexts 字段的内容
    ]
}

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Builder;
import lombok.Getter;
import lombok.Setter;
import lombok.NonNull;
import lombok.Singular;

import java.util.List;
import java.util.UUID;

@Builder
@Getter
@Setter
public class ArticleWrapper {
    @NonNull
    private UUID id;
    @JsonProperty("iNo")
    private Integer iNo;
    private boolean isValid;
    @NonNull
    private ReferenceArticleGroup articleGroup; // 假设 ArticleGroup 正常序列化
    private Integer numberOfDecimalsSalesPrice;
    @Singular
    private List<String> codes;

    // 所有 LocalizedTexts 的内容将扁平化存储在这里
    private List<LanguageAttribute> translation; 
}

import com.fasterxml.jackson.annotation.JsonAnyGetter;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;

import java.util.Map;

// Java 16+ 可以使用 record，如果使用旧版本Java，请将其实现为普通类
public record LanguageAttribute(
    // @JsonAnyGetter 将 Map 的内容直接作为顶层属性序列化，而不是作为嵌套的 "map" 属性
    @JsonAnyGetter
    Map<String, String> map, 

    // 使用 LanguageConverter 将 Language 枚举序列化为字符串
    @JsonProperty
    @JsonSerialize(converter = LanguageConverter.class) 
    Language language) {}

import com.fasterxml.jackson.databind.util.StdConverter;

public class LanguageConverter extends StdConverter<Language, String> {

    @Override
    public String convert(Language language) {
        // 假设 Language 枚举有一个 getLangName() 方法来获取小写语言名称
        return language.getLangName(); 
    }
}

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.util.StdConverter;

import java.util.List;
import java.util.Map;
import java.util.function.Function;
import java.util.stream.Stream;

public class ArticleConverter extends StdConverter<Article, ArticleWrapper> {

    // 构造函数可以为空，如果不需要特殊初始化
    public ArticleConverter() {}

    @Override
    public ArticleWrapper convert(Article article) {
        // 1. 提取所有 LocalizedTexts 字段并转换为 LanguageAttribute 列表
        List<LanguageAttribute> translations = getTranslations(article);

        // 2. 构建 ArticleWrapper 对象，填充非 LocalizedTexts 字段和 translations 列表
        return ArticleWrapper.builder()
            .id(article.getId())
            .iNo(article.getINo())
            .isValid(article.isValid())
            .articleGroup(article.getArticleGroup())
            .numberOfDecimalsSalesPrice(article.getNumberOfDecimalsSalesPrice())
            .codes(article.getCodes()) // 假设 codes 字段也需要复制
            .translation(translations) // 填充转换后的列表
            .build();
    }

    /**
     * 收集 Article 中所有 LocalizedTexts 字段的翻译内容。
     */
    private List<LanguageAttribute> getTranslations(Article article) {
        // 使用 Stream.of 收集所有 LocalizedTexts 字段，并指定它们对应的 JSON 属性名
        return Stream.of(
                toLanguageAttribute(article.getDesignation(), "designation"),
                toLanguageAttribute(article.getTouchCaption(), "touchCaption"),
                toLanguageAttribute(article.getPrintText(), "printText"),
                toLanguageAttribute(article.getProductInformation(), "productInformation")
            )
            // 将 Stream<Stream<LanguageAttribute>> 扁平化为 Stream<LanguageAttribute>
            .flatMap(Function.identity())
            .toList();
    }

    /**
     * 将单个 LocalizedTexts 对象转换为 LanguageAttribute 对象的 Stream。
     * 每个 LocalizedTexts 内部的 Map.Entry 对应一个 LanguageAttribute。
     */
    private Stream<LanguageAttribute> toLanguageAttribute(LocalizedTexts texts, String attribute) {
        // 检查 LocalizedTexts 是否为空，避免空指针
        if (texts == null || texts.isEmpty()) {
            return Stream.empty();
        }
        return texts.entrySet().stream()
            .map(entry -> new LanguageAttribute(
                // 使用 Map.of 创建一个单例 Map，键为属性名，值为翻译文本
                Map.of(attribute, entry.getValue()), 
                entry.getKey()) // 语言枚举
            );
    }
}

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
// ... 其他导入

@Value
@NoArgsConstructor(force = true, access = AccessLevel.PRIVATE)
@AllArgsConstructor(access = AccessLevel.PRIVATE)
@SuperBuilder(toBuilder = true)
@JsonDeserialize(builder = Article.ArticleBuilderImpl.class) // 假设存在反序列化构建器
@ToString(callSuper = true)
@EqualsAndHashCode(callSuper = true)
// 核心：通过 @JsonSerialize 注解应用 ArticleConverter
@JsonSerialize(converter = ArticleConverter.class) 
public class Article extends AbstractEntityBase {

    @NonNull
    UUID id;

    @JsonProperty("iNo")
    Integer iNo;

    boolean isValid;

    @NonNull
    LocalizedTexts designation; // 将通过 Converter 处理

    @NonNull
    ReferenceArticleGroup articleGroup;

    Integer numberOfDecimalsSalesPrice;

    LocalizedTexts touchCaption; // 将通过 Converter 处理

    LocalizedTexts printText; // 将通过 Converter 处理

    LocalizedTexts productInformation; // 将通过 Converter 处理

    @Singular
    List<String> codes;
    // ... 其他字段
}