使用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
相关产品推荐
相关产品推荐

