JSON ItemReader 和 ItemWriter

Spring Batch 支持以下格式的 JSON 资源读写

[
  {
    "isin": "123",
    "quantity": 1,
    "price": 1.2,
    "customer": "foo"
  },
  {
    "isin": "456",
    "quantity": 2,
    "price": 1.4,
    "customer": "bar"
  }
]

假定 JSON 资源是对应于单个 Item 的 JSON 对象数组。Spring Batch 不依赖于任何特定的 JSON 库。

JsonItemReader

JsonItemReader 将 JSON 解析和绑定委托给 org.springframework.batch.item.json.JsonObjectReader 接口的实现。该接口旨在通过流式 API 来分块读取 JSON 对象。目前提供了两种实现:

  • Jackson 通过 org.springframework.batch.item.json.JacksonJsonObjectReader

  • Gson 通过 org.springframework.batch.item.json.GsonJsonObjectReader

要处理 JSON 记录,需要以下内容:

  • Resource:表示要读取的 JSON 文件的 Spring Resource。

  • JsonObjectReader:用于解析 JSON 对象并将其绑定到 Item 的 JSON 对象读取器

以下示例展示了如何定义一个使用前面的 JSON 资源 org/springframework/batch/item/json/trades.json 和基于 Jackson 的 JsonObjectReaderJsonItemReader

@Bean
public JsonItemReader<Trade> jsonItemReader() {
   return new JsonItemReaderBuilder<Trade>()
                 .jsonObjectReader(new JacksonJsonObjectReader<>(Trade.class))
                 .resource(new ClassPathResource("trades.json"))
                 .name("tradeJsonItemReader")
                 .build();
}

JsonFileItemWriter

JsonFileItemWriter 将 Item 的编组委托给 org.springframework.batch.item.json.JsonObjectMarshaller 接口的实现。此接口的约定是接收一个对象并将其编组为 JSON String。目前提供了两种实现:

  • Jackson 通过 org.springframework.batch.item.json.JacksonJsonObjectMarshaller

  • Gson 通过 org.springframework.batch.item.json.GsonJsonObjectMarshaller

要写入 JSON 记录,需要以下内容:

  • Resource:表示要写入的 JSON 文件的 Spring Resource

  • JsonObjectMarshaller:用于将对象编组为 JSON 格式的 JSON 对象编组器

以下示例展示了如何定义一个 JsonFileItemWriter

@Bean
public JsonFileItemWriter<Trade> jsonFileItemWriter() {
   return new JsonFileItemWriterBuilder<Trade>()
                 .jsonObjectMarshaller(new JacksonJsonObjectMarshaller<>())
                 .resource(new ClassPathResource("trades.json"))
                 .name("tradeJsonFileItemWriter")
                 .build();
}