摘要

本文档的概要说明如下： 本文档介绍 Fx.lock 的接口定义、使用方式及相关说明。

1. lock 使用redisson 的分布式锁，解锁为FxLock.unLock();

Fx.lock.lockData(<String apiName>, <String dataId>, <Integer expireTime>)

参数说明

入参格式

参数名称	类型	描述	是否必填
apiName	String	对象的apiname	是
dataId	String	数据ID	是
expireTime	Integer	失效时间	是

Groovy 举例

//加锁一定要细粒度，防止锁竞争等待
FxLock lock = Fx.lock.lockData("Account","dataId", 2)

// 需要加锁的函数代码
// do something

lock.unlock()

注意事项

• 错误示例：如lock("prepareData")这样，这种锁粒度过粗，反而会影响业务；
• 要使用细粒度的锁，如数据id，针对某个数据加锁，防止并发产生问题

版本记录

版本	日期	变更内容	负责人
v1.0	2026-05-19	初始版本

背景说明

本文档详细描述 Fx.lock 的相关接口功能和使用方法，帮助开发者快速集成相关能力。

适用场景

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

前置条件

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

操作步骤

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

注意事项

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

以上代码示例执行后将返回对应接口的调用结果。

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