package cn.iocoder.yudao.framework.common.util.number;
|
|
/**
|
* 业务编码（单据号 / 主数据编码）生成的公共约定。
|
*
|
* <p>需求：系统中所有自动生成的业务编码统一为「16 位纯数字」，且全系统唯一（任意两条编码都不重复）。
|
*
|
* <p>实现约定：全系统共用同一个 Redis 自增 KEY（{@link #GLOBAL_SEQ_KEY}），
|
* 每次生成时对其执行 INCR 得到单调递增的序列号，再左补 '0' 到 {@link #CODE_LENGTH} 位。
|
* 由于所有编码都来自同一条递增序列，故天然保证「全系统唯一」。
|
*
|
* <p>注意：
|
* <ul>
|
* <li>该 KEY 不设置过期时间，避免过期归零导致重号；</li>
|
* <li>Redis 若发生数据丢失 / 清空，需要从数据库现有编码的最大值恢复计数器，否则可能重号。</li>
|
* </ul>
|
*/
|
public class BizNoUtils {
|
|
/**
|
* 全系统业务编码统一使用的 Redis 自增 KEY。
|
*
|
* <p>所有模块（erp / crm / trade / aftersales / hrm / bpm / mes）共用此 KEY，
|
* 以保证「全系统唯一」。
|
*/
|
public static final String GLOBAL_SEQ_KEY = "biz:seq_no:global";
|
|
/**
|
* 业务编码的总长度：16 位
|
*/
|
public static final int CODE_LENGTH = 16;
|
|
/**
|
* 将自增序列号格式化为 16 位纯数字编码（左侧补 '0'）
|
*
|
* @param seq 自增序列号
|
* @return 16 位纯数字编码
|
*/
|
public static String format(Long seq) {
|
return String.format("%0" + CODE_LENGTH + "d", seq);
|
}
|
|
}
|
