摘要

本文档的概要说明如下： 本文档介绍 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 的相关接口功能和使用方法，帮助开发者快速集成相关能力。

适用场景

具体适用场景由实际业务需求决定，开发者可根据需要选择相应的接口进行集成。

前置条件

• 已接入纷享销客开放平台
• 已完成应用授权与配置
• 了解相关业务领域基础知识

操作步骤

具体操作步骤请参考各接口的详细说明。

注意事项

• 调用接口前请确保满足前置条件
• 注意接口调用频率限制
• 异常情况请参考错误码说明进行处理

兼容性说明：当前版本暂无可用的废弃或兼容性说明。