import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import javax.annotation.PostConstruct;
import javax.annotation.Resource;
import java.util.Date;
import java.util.concurrent.TimeUnit;
import com.baomidou.mybatisplus.core.toolkit.DateUtils;
import com.xxxxx.blade.redis.BladeRedis; // 根據(jù)實(shí)際包路徑調(diào)整
import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import com.xxxxx.common.exception.ServiceException; // 根據(jù)實(shí)際包路徑調(diào)整

/**
 * 通用編號(hào)生成工具類(lèi)
 * 功能：生成格式為【業(yè)務(wù)編碼+日期+3位自增序號(hào)】的唯一編號(hào)（例如：JJ20250826001）
 * 特性：基于Redis實(shí)現(xiàn)分布式自增，通過(guò)Redisson分布式鎖保證并發(fā)安全，序號(hào)按日期重置
 */
@Slf4j // Lombok注解，自動(dòng)注入日志對(duì)象log
@Component // Spring組件注解，將該類(lèi)注冊(cè)為Bean，交由Spring容器管理
public class CommonNumber {

    /**
     * Redis操作客戶(hù)端（靜態(tài)變量）
     * 用于執(zhí)行自增、過(guò)期時(shí)間設(shè)置等Redis命令
     */
    private static BladeRedis BLADE_REDIS;

    /**
     * Redisson客戶(hù)端（靜態(tài)變量）
     * 用于獲取分布式鎖，保證多實(shí)例環(huán)境下的并發(fā)安全
     */
    private static RedissonClient REDISSSON_CLIENT;

    /**
     * Redisson客戶(hù)端（實(shí)例變量）
     * 由Spring容器注入，通過(guò)@Resource注解按名稱(chēng)匹配
     */
    @Resource
    private RedissonClient RedissonClient;

    /**
     * Redis操作客戶(hù)端（實(shí)例變量）
     * 由Spring容器注入，Blade框架封裝的Redis客戶(hù)端
     */
    @Resource
    private BladeRedis bladeRedis;

    /**
     * 初始化方法（PostConstruct注解）
     * 作用：在Spring Bean初始化完成后，將實(shí)例變量賦值給靜態(tài)變量
     * 原因：工具方法為static，無(wú)法直接注入Spring Bean，通過(guò)該方式間接獲取容器中的Bean實(shí)例
     */
    @PostConstruct
    public void init() {
        BLADE_REDIS = bladeRedis;
        REDISSSON_CLIENT = RedissonClient;
    }

    /**
     * 生成通用唯一編號(hào)
     * 格式：業(yè)務(wù)編碼（code） + 年月日（yyyyMMdd） + 3位自增序號(hào)（不足補(bǔ)0）
     * 示例：code=JJ → JJ20250826001、JJ20250826002...
     *
     * @param code 業(yè)務(wù)編碼（區(qū)分不同業(yè)務(wù)場(chǎng)景的編號(hào)前綴）
     * @return 格式化后的唯一編號(hào)
     * @throws ServiceException 當(dāng)獲取分布式鎖失敗或Redis操作異常時(shí)拋出
     */
    public static String getCommonNumber(String code) {
        // 1. 定義分布式鎖key：按業(yè)務(wù)編碼區(qū)分，避免不同業(yè)務(wù)鎖競(jìng)爭(zhēng)
        RLock lock = REDISSSON_CLIENT.getLock("common-number-lock:" + code);

        try {
            // 2. 嘗試獲取分布式鎖：最多等待3秒，持有鎖5秒（防止死鎖）
            // tryLock返回false表示獲取鎖失?。úl(fā)過(guò)高）
            if (!lock.tryLock(3, 5, TimeUnit.SECONDS)) {
                throw new ServiceException("系統(tǒng)繁忙，請(qǐng)稍后重試");
            }

            // 3. 格式化當(dāng)前日期為yyyyMMdd格式（用于序號(hào)按日期重置）
            String currentTime = DateUtils.format(new Date(), "yyyyMMdd");

            // 4. 定義Redis自增key：業(yè)務(wù)編碼+日期，確保每天的序號(hào)從1開(kāi)始
            String companyNumberKey = "common_number_key:" + code + currentTime;

            // 5. Redis自增操作：原子性遞增，保證序號(hào)唯一（初始值為1，每次+1）
            Long incr = BLADE_REDIS.incr(companyNumberKey);

            // 6. 拼接最終編號(hào)：業(yè)務(wù)編碼 + 日期 + 3位補(bǔ)0序號(hào)（例如：1→001，10→010，100→100）
            String companyNumber = code + currentTime + String.format("%03d", incr);

            // 7. 設(shè)置Rediskey過(guò)期時(shí)間：48小時(shí)（確保過(guò)期數(shù)據(jù)自動(dòng)清理，節(jié)省Redis空間）
            BLADE_REDIS.expire(companyNumberKey, 60 * 60 * 48L);

            // 8. 返回生成的編號(hào)
            return companyNumber;

        } catch (InterruptedException e) {
            // 捕獲線程中斷異常（獲取鎖過(guò)程中線程被中斷）
            log.error("獲取編號(hào)時(shí)線程被中斷，code:{}", code, e);
            throw new ServiceException("獲取編號(hào)失敗");
        } catch (ServiceException e) {
            // 拋出獲取鎖失敗的自定義異常（無(wú)需額外日志，已在拋出時(shí)明確）
            throw e;
        } catch (Exception e) {
            // 捕獲其他異常（Redis操作失敗等）
            log.error("獲取編號(hào)失敗，code:{}", code, e);
            throw new ServiceException("獲取編號(hào)失敗");
        } finally {
            // 9. 釋放分布式鎖：必須在finally中執(zhí)行，確保鎖一定會(huì)釋放
            // 先判斷當(dāng)前線程是否持有鎖，避免釋放其他線程的鎖
            if (lock.isHeldByCurrentThread()) {
                lock.unlock();
            }
        }
    }
}

```java

public static String getCommonNumber(String code)

RLock lock = REDISSSON_CLIENT.getLock("common-number-lock:"+code);
if (!lock.tryLock(3, 5, TimeUnit.SECONDS)) {
    throw new ServiceException("系統(tǒng)繁忙，請(qǐng)稍后重試");
}

// 1. 生成當(dāng)天日期（格式：yyyyMMdd）
String currentTime = DateUtil.format(DateUtil.date(), "yyyyMMdd");
// 2. 構(gòu)建Redis自增key（業(yè)務(wù)編碼+日期，確保每天的序號(hào)獨(dú)立重置）
String companyNumberKey = "common_number_key:" + code + currentTime;
// 3. Redis自增（原子操作，確保序號(hào)唯一）
Long incr = BLADE_REDIS.incr(companyNumberKey);
// 4. 序號(hào)補(bǔ)零（3位，不足3位前面補(bǔ)0，如1→001，10→010）
String seq = String.format("%03d", incr);

BLADE_REDIS.expire(companyNumberKey, 60 * 60 * 48L); // 48小時(shí)過(guò)期

String companyNumber = code + currentTime + seq;

try {
    // 編號(hào)生成邏輯...
} catch (Exception e) {
    log.error("獲取編號(hào)失敗", e); // 打印異常堆棧，便于排查
    throw new ServiceException("獲取編號(hào)失敗"); // 拋出自定義業(yè)務(wù)異常，上層處理
} finally {
    // 確保鎖一定釋放（避免死鎖）
    if (lock.isHeldByCurrentThread()) {
        lock.unlock();
    }
}