使用 Jackson 解析数组

Question

我想使用 Jackson 解析以下 Json，但我完全不确定应该如何构建实体。

   [
      CHAN_ID, 
      [
        [
          SYMBOL, 
          STATUS, 
          AMOUNT, 
          BASE_PRICE, 
          MARGIN_FUNDING, 
          MARGIN_FUNDING_TYPE,
          PL,
          PL_PERC,
          PRICE_LIQ,
          LEVERAGE,
           ...
        ], 
        ...
      ]
    ]

这是我目前所拥有的：

@Getter
@Setter
@EqualsAndHashCode
@ToString
@NoArgsConstructor
public class Position {

        @JsonProperty("SYMBOL")
        private String symbol;
        @JsonProperty("STATUS")
        private String status;
        @JsonProperty("AMOUNT")
        private Decimal amount;
        @JsonProperty("BASE_PRICE")
        private Decimal basePrice;
        @JsonProperty("MARGIN_FUNDING")
        private Integer marginFunding;
        @JsonProperty("MARGIN_FUNDING_TYPE")
        private Decimal marginFundingType;
        @JsonProperty("PL")
        private Decimal profitLoss;
        @JsonProperty("PL_PERC")
        private Decimal profitLossPercentage;
        @JsonProperty("PRICE_LIQ")
        private Decimal liquidationPrice;
        @JsonProperty("LEVERAGE")
        private Decimal leverage;
    }

我要解析的这个东西，似乎有一个位置数组，但在它有那个 CHAN_ID 之前，我应该为此构造某种包装类吗？

@Getter
@Setter
@EqualsAndHashCode
@ToString
@NoArgsConstructor
public class Positions {

    @JsonProperty("CHAN_ID")
    private String channelId;

    @JsonProperty("positions")
    private List<Position> positions;

}

你怎么看，这是正确的吗？也不要介意类顶部的那些注释，它只是龙目岛。 目前，当我尝试解析时，这个实现给了我以下错误：

com.fasterxml.jackson.databind.exc.MismatchedInputException: 不能 从 START_ARRAY 令牌中反序列化 model.Positions 的实例 [来源：（字符串）“['ps', [ ['aa', 'bb', 123.45, 123.45, 567, 123.45, 123.45、123.45、123.45、123.45]] ]"；行：1，列：1]

为了测试这一点，我只使用了 ObjectMapper：

public static void main(String[] args) throws IOException {
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            Positions positions = objectMapper.readValue("['ps', [ [ 'aa', 'bb', 123.45, 123.45, 567, 123.45, 123.45, 123.45, 123.45, 123.45]] ]", Positions.class);
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

Answer 1

由于输入 JSON 结构为嵌套数组，因此与 @JsonProperty 绑定没有多大意义，因为输入 JSON 中不存在这些属性键。只有当您想在之后将反序列化的数据转换为具有属性值对的 JSON 时，它们才有意义。

要正确读取此 JSON 结构，您必须实现自定义反序列化器，因为在这种情况下，属性无法自动映射到它们的值。解串器可以是 Jackson 的 JsonDeserializer 或 StdDeserializer 的实现。例如，以下实现工作：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;

import java.io.IOException;
import java.util.List;
import java.util.stream.Collectors;

public class PositionsDeserializer extends StdDeserializer<Positions> {

  public PositionsDeserializer() {
    super(Positions.class);
  }

  @Override
  public Positions deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
    Object[] positionsProps = p.readValueAs(Object[].class);
    if (positionsProps != null && positionsProps.length > 0) {
      String chanId = (String) positionsProps[0];
      List<Position> positionsList =
          ((List<List<?>>) positionsProps[1]).stream()
              .map(this::deserializePosition)
              .collect(Collectors.toList());
      Positions positions = new Positions();
      positions.setChannelId(chanId);
      positions.setPositions(positionsList);
      return positions;
    }
    // decide whether you want to return null, throw an exception or other outcome: depends on the constraints of your data
    return null;
  }

  private Position deserializePosition(List<?> props) {
    if (props != null && !props.isEmpty()) {
      final Position position = new Position();
      position.setSymbol((String) props.get(0));
      position.setStatus((String) props.get(1));
      position.setAmount((Double) props.get(2));
      position.setBasePrice((Double) props.get(3));
      position.setMarginFunding((Integer) props.get(4));
      position.setMarginFundingType((Double) props.get(5));
      position.setProfitLoss((Double) props.get(6));
      position.setProfitLossPercentage((Double) props.get(7));
      position.setLiquidationPrice((Double) props.get(8));
      position.setLeverage((Double) props.get(9));
      return position;
    }
    // decide whether you want to return null, throw an exception or other outcome: depends on the constraints of your data
    return null;
  }

}

要使用这个反序列化器，它应该在ObjectMapper中注册：

private ObjectMapper initObjectMapper() {
  ObjectMapper objectMapper = new ObjectMapper();
  SimpleModule module = new SimpleModule();
  module.addDeserializer(Positions.class, new PositionsDeserializer());
  objectMapper.registerModule(module);
  return objectMapper;
}

@Test
public void deserializePositions() throws IOException {
  String json = "[ \"ps\", [ [ \"aa\", \"bb\", 123.45, 123.45, 567, 123.45, 123.45, 123.45, 123.45, 123.45 ] ] ]";

  Positions positions = initObjectMapper().readValue(json, Positions.class);

  System.out.println(positions);
}

建议

如果您有可能选择/更改输入 JSON 的结构，我建议减少嵌套并引入更常规的 KV 映射。比如表示Positions：

{
  "CHAN_ID": "string",
  "positions": [
    // Use the arrays here: [ "aa", "bb", 123.45, 123.45, 567, 123.45, 123.45, 123.45, 123.45, 123.45 ], 
    // OR transform the array into KV mapping: { "SYMBOL": "string", ... }, ...
  ]
}

这种方法将允许：

• 降低与值的数组索引相关的幻数引起的错误风险；

• 简化反序列化：自动读取Positions，并为Position 自定义反序列化器，前提是保留数组结构。

另外，我不知道原代码中Decimal类型是什么意思，所以我把它换成了Double。