You need to enable JavaScript to run this app. 使用Circe解析二维JSON数组映射为Case Class时旧API失效、解码报错的问题
优惠活动
大模型
产品
解决方案
定价
更多

使用Circe解析二维JSON数组映射为Case Class时旧API失效、解码报错的问题

Circe 解析结构化数组时报错的实现方案

场景说明

手头有如下格式的原始JSON数组:

[
    ["Service ID", "VARCHAR", 1, 12],
    ["Operation", "VARCHAR", 2, 12],
    ["Start Date", "VARCHAR", 3, 12],
    ["End Date", "VARCHAR", 4, 12],
    ["Agent Position", "VARCHAR", 5, 12],
    ["Customer ID", "VARCHAR", 6, 12],
    ["Product", "VARCHAR", 7, 12],
    ["Service Type", "VARCHAR", 8, 12],
    ["Agent", "VARCHAR", 9, 12]
]

需要将其映射为匹配Case Class的目标JSON格式,结构如下:

{
  "schema": [
    {
      "COLUMN_NAME": "Service ID",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 1,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Operation",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 2,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Start Date",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 3,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "End Date",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 4,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Agent Position",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 5,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Customer ID",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 6,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Product",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 7,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Service Type",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 8,
      "JDBC_DATA_TYPE12": 12
    },
    {
      "COLUMN_NAME": "Agent",
      "DATA_TYPE": "VARCHAR",
      "ORDINAL_POSITION": 9,
      "JDBC_DATA_TYPE12": 12
    }
  ]
}

已尝试的实现与问题

之前参考了社区上Circe解码结构化JSON数组的实现思路,发现当前版本Circe中deleteGoRight等旧游标操作方法已被移除无法使用,自己编写的自定义解码器运行始终失败,报错信息无法定位根因:

implicit val decoder: Decoder[Schema] = { (hCursor: HCursor) =>
    for {
      colName <- hCursor.as[String]
      colNameC = hCursor.delete
      dtype <- colNameC.right.as[String]
      dtypeC = colNameC.delete
      pos <- dtypeC.right.as[Double]
      posC = dtypeC.delete
      jtype <- posC.right.as[Double]
    } yield Schema(colName, dtype, pos, jtype) 
}

parser.decode[List[Schema]]("""["Service Type","VARCHAR",8,12]""") match {
  case Right(applicants) => println(applicants)
  case Left(ex) => println(s"Oops something is wrong with decoding value ${ex}")
}

问题根因与正确实现

  • 现有代码的核心问题
    初始传入的hCursor本身指向一个JSON数组节点,直接调用as[String]会尝试把整个数组序列化为字符串,必然触发类型转换错误;同时Circe 0.14+版本的游标为不可变设计,旧版本依赖delete操作改变游标状态、再右移读取下一个元素的写法,已经和当前API的状态流转逻辑不兼容。
  • 适配当前Circe版本的解码实现
    不需要手动操作游标做删除、移动操作,直接通过数组索引读取对应位置的值即可,实现逻辑简洁且兼容最新版本Circe:
    // 定义匹配目标结构的Case Class
    case class Schema(
      COLUMN_NAME: String,
      DATA_TYPE: String,
      ORDINAL_POSITION: Int,
      JDBC_DATA_TYPE12: Int
    )
    // 顶层包装结构,匹配最终输出的schema字段
    case class SchemaWrapper(schema: List[Schema])
    
    // 自定义数组节点到Schema对象的解码器
    implicit val schemaDecoder: Decoder[Schema] = Decoder.instance { cursor =>
      for {
        // downN方法直接返回数组指定索引位置的游标,无副作用
        colName <- cursor.downN(0).as[String]
        dataType <- cursor.downN(1).as[String]
        ordPos <- cursor.downN(2).as[Int]
        jdbcType <- cursor.downN(3).as[Int]
      } yield Schema(colName, dataType, ordPos, jdbcType)
    }
    
    // 解码流程测试
    val rawJsonStr: String = """[["Service ID","VARCHAR",1,12],["Operation","VARCHAR",2,12]]"""
    parser.decode[List[Schema]](rawJsonStr) match {
      case Right(schemaList) => 
        // 将解码得到的列表包装为目标顶层结构,编码后即为要求的JSON格式
        val targetOutput = SchemaWrapper(schemaList)
        println(targetOutput.asJson.spaces2)
      case Left(ex) => println(s"解码失败: ${ex.getMessage}")
    }
    
  • 注意事项
    • 原始数组中的数值为整数类型,不需要用Double接收,使用Int匹配实际数据类型可以避免不必要的类型转换报错
    • Circe的游标为不可变引用,所有导航操作都会返回新的游标对象,不会修改原节点状态,不需要手动执行删除操作
    • 最终目标结构只需要将解码得到的List[Schema]赋值给schema字段即可,无需额外的复杂状态流转操作

内容的提问来源于stack exchange,提问作者Flow

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 16:15:03