package cn.iocoder.yudao.module.mes.dal.redis; import cn.iocoder.yudao.framework.common.util.number.BizNoUtils; import jakarta.annotation.Resource; import org.springframework.data.redis.core.StringRedisTemplate; import org.springframework.data.redis.core.script.DefaultRedisScript; import org.springframework.data.redis.core.script.RedisScript; import org.springframework.stereotype.Repository; import java.util.ArrayList; import java.util.List; /** * MES 业务编码生成的 Redis DAO(实例码:袋码 / 托盘码 / 临时码等)。 * *
需求:所有业务编码统一为「16 位纯数字」,且全系统唯一。 * 这里复用全系统统一的 Redis 自增 KEY,保证与其它模块的编码也不重复。 */ @Repository public class MesCodeRedisDAO { /** * 袋序号自增 KEY(全局袋序号,保证同一批/跨批生成时不重复) */ private static final String BAG_NO_SEQ_KEY = "mes:bag_no:seq"; /** * 单次批量取码的最大个数 *
* 受 Redis 单条命令参数规模与响应体大小约束,过大反而增加单次阻塞时间。 */ public static final int MAX_BATCH_SIZE = 5000; /** * 批量写入并返回实际生效的编码。 *
* 逐个 SADD 在同一脚本内完成:与调用方逐条 SADD 相比,网络往返从 N 次降为 1 次;
* 同时因为脚本原子执行,并发调用之间也不会产生重复编码。
*/
private static final RedisScript
* 先按库内最大序号校正基准值(Redis 首次使用、或库内数据被直接导入导致基准落后时),
* 再原子自增并返回自增后的值。整个「校正 + 自增」在 Redis 单线程内完成,避免并发下互相覆盖计数。
*
* KEYS[1] = 序号 KEY;ARGV[1] = 本次需要的个数;ARGV[2] = 库内当前最大序号
*/
private static final RedisScript
* 大批量生成时不要循环调用 {@link #generate()}:那会产生 N 次 Redis 往返,
* 几十万条即可把接口拖到分钟级。这里每批最多 {@link #MAX_BATCH_SIZE} 个候选码
* 一次脚本写入,碰撞(概率极低)的缺额再补一批。
*
* @param count 需要的编码个数
* @return 唯一编码列表,顺序无保证但数量等于 count
*/
public List
* 袋序号原先由「查库内最大值再 +1」得到,并发生成时两个请求会读到同一个最大值,
* 从而产出重复的袋序号(袋序号会印在标签上)。此处改为 Redis 原子自增分配,
* 并用库内当前最大值做基准校正,保证序号既不重复也不回退。
*
* @param count 本次需要的连续序号个数(须大于 0)
* @param dbMaxBagNo 数据库当前最大袋序号(含已逻辑删除记录,传 null 视为 0)
* @return 区间起始序号(含),可用区间为 [start, start + count - 1]
*/
public int allocateBagNoStart(int count, Integer dbMaxBagNo) {
if (count <= 0) {
throw new IllegalArgumentException("袋序号分配个数必须大于 0");
}
Long end = stringRedisTemplate.execute(ALLOCATE_BAG_NO_SCRIPT, List.of(BAG_NO_SEQ_KEY),
String.valueOf(count), String.valueOf(dbMaxBagNo == null ? 0 : dbMaxBagNo));
if (end == null) {
throw new IllegalStateException("分配袋序号失败,请重试");
}
return (int) (end - count + 1);
}
}
ADD_UNIQUE_CODES_SCRIPT = new DefaultRedisScript<>(
"local res = {} "
+ "for i = 1, #ARGV do "
+ " if redis.call('SADD', KEYS[1], ARGV[i]) == 1 then "
+ " res[#res + 1] = ARGV[i] "
+ " end "
+ "end "
+ "return res",
List.class);
/**
* 原子分配袋序号区间的 Lua 脚本。
*