如何用Jackson将Apache Any23生成的JSON-LD映射为Java POJO

针对你遇到的三个JSON-LD反序列化问题，直接给你具体的Jackson配置和POJO注解方案：

1. 处理@type被包裹在数组中的情况 #

JSON-LD里@type经常以数组格式存在（比如"@type": ["JobPosting"]），但POJO里一般用String类型接收。直接在POJO的type字段上添加@JsonProperty("@type")，再配合@JsonFormat开启单值转数组的兼容：

public class JobPosting {
    @JsonProperty("@type")
    @JsonFormat(with = JsonFormat.Feature.ACCEPT_SINGLE_VALUE_AS_ARRAY)
    private String type;
    // 其他字段...
}

这样不管@type是单个字符串还是数组，都能正常反序列化为String类型。

2. 消除额外的@value层级 #

很多JSON-LD属性会嵌套在@value节点下，比如"title": {"@value": "Java开发工程师"}。有两种简单处理方式：

• 方式一：用内部类封装

  public class JobPosting {
      @JsonProperty("title")
      private TitleWrapper title;
      // 内部类专门解析@value
      static class TitleWrapper {
          @JsonProperty("@value")
          private String value;
          // getter/setter
      }
      // 其他字段...
  }
  

• 方式二：自定义反序列化器
  如果多个字段都有这个情况，写个通用反序列化器更高效：

  public class JobPosting {
      @JsonProperty("title")
      @JsonDeserialize(using = ValueExtractorDeserializer.class)
      private String title;
      // 其他字段...
  }
  
  // 通用@value提取反序列化器
  public class ValueExtractorDeserializer extends JsonDeserializer<String> {
      @Override
      public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
          JsonNode node = p.getCodec().readTree(p);
          return node.get("@value").asText();
      }
  }
  

3. 处理@id引用的对象 #

JSON-LD的@id引用属于图结构，Jackson默认不会自动解析关联。需要开启引用处理特性，并给POJO添加身份标识注解：

// 先给被引用的类（比如招聘方Company）添加身份标识
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "@id")
public class Company {
    @JsonProperty("@id")
    private String id;
    private String name;
    // getter/setter
}

// 在JobPosting的引用字段上配置关联规则
public class JobPosting {
    @JsonProperty("hiringOrganization")
    @JsonIdentityReference(alwaysAsId = false)
    private Company hiringOrganization;
    // 其他字段...
}

最后给ObjectMapper开启引用处理开关：

ObjectMapper mapper = new ObjectMapper();
mapper.enable(DeserializationFeature.ENABLE_REFERENCE_PROCESSING);

这样Jackson会自动识别@id引用，把关联的对象实例化并绑定到对应字段上。

如果觉得配置麻烦，也可以先用JSON-LD专用工具（比如JSON-LD Java）把JSON-LD展开为扁平结构，再用Jackson反序列化，能避开大部分嵌套和引用问题。

内容的提问来源于stack exchange，提问作者wero026