简体中文
Fx.json
约 586 字大约 2 分钟
2026-01-09
摘要
本文档的概要说明如下: 本文档介绍 Fx.json 的接口定义、使用方式及相关说明。
1. toJson 对象转json字符串
Fx.json.toJson(<Object data>)
参数说明
入参格式
| 参数名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| data | Object | 转json的对象 | 是 |
Groovy 举例
Fx.json.toJson(["a" : 1, "b" : 2]) //返回:{"a":1,"b":2}2. toJson 对象转json字符串,指定序列化特性
Fx.json.toJson(<Object data>, <SerializerFeature[] features>)
参数说明
入参格式
| 参数名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| data | Object | 转json的对象 | 是 |
| features | SerializerFeature[] | 可变参数,序列化特性列表 | -- |
Groovy 举例
Map m = ["a": 1, "b": null]
log.info(Fx.json.toJson(m))
log.info(Fx.json.toJson(m, SerializerFeature.WriteMapNullValue))3. parse json转Map
Fx.json.parse(<String data>)
参数说明
入参格式
| 参数名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| data | String | json字符串 | 是 |
Groovy 举例
Map map = Fx.json.parse("{\"a\" : 1, \"b\" : 2}")4. parseList json转List
Fx.json.parseList(<String data>)
参数说明
入参格式
| 参数名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| data | String | jsonarray字符串 | 是 |
Groovy 举例
List list = Fx.json.parseList('[{"a": 1, "b": 2},{"a": 10, "b": 20}]')注意事项
- 这里的字符串是jsonArray字符串,以[开头,以]结尾
5. parseObject json转class类
Fx.json.parseObject(<String text>, <Class clazz>)
参数说明
入参格式
| 参数名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| text | String | json字符串 | 是 |
| clazz | Class | 需要转换的类型,例如List.class | 是 |
Groovy 举例
List tmp = Fx.json.parseObject('[{"a": 1, "b": 2},{"a": 10, "b": 20}]', List.class)版本记录
| 版本 | 日期 | 变更内容 | 负责人 |
|---|---|---|---|
| v1.0 | 2026-05-19 | 初始版本 |
背景说明
本文档详细描述 Fx.json 的相关接口功能和使用方法,帮助开发者快速集成相关能力。
适用场景
具体适用场景由实际业务需求决定,开发者可根据需要选择相应的接口进行集成。
前置条件
- 已接入纷享销客开放平台
- 已完成应用授权与配置
- 了解相关业务领域基础知识
操作步骤
具体操作步骤请参考各接口的详细说明。
注意事项
- 调用接口前请确保满足前置条件
- 注意接口调用频率限制
- 异常情况请参考错误码说明进行处理
兼容性说明:当前版本暂无可用的废弃或兼容性说明。
