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ù)實際包路徑調(diào)整
import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import com.xxxxx.common.exception.ServiceException; // 根據(jù)實際包路徑調(diào)整

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

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

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

    /**
     * Redisson客戶端（實例變量）
     * 由Spring容器注入，通過@Resource注解按名稱匹配
     */
    @Resource
    private RedissonClient RedissonClient;

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

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

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

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

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

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

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

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

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

            // 8. 返回生成的編號
            return companyNumber;

        } catch (InterruptedException e) {
            // 捕獲線程中斷異常（獲取鎖過程中線程被中斷）
            log.error("獲取編號時線程被中斷，code:{}", code, e);
            throw new ServiceException("獲取編號失敗");
        } catch (ServiceException e) {
            // 拋出獲取鎖失敗的自定義異常（無需額外日志，已在拋出時明確）
            throw e;
        } catch (Exception e) {
            // 捕獲其他異常（Redis操作失敗等）
            log.error("獲取編號失敗，code:{}", code, e);
            throw new ServiceException("獲取編號失敗");
        } finally {
            // 9. 釋放分布式鎖：必須在finally中執(zhí)行，確保鎖一定會釋放
            // 先判斷當(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)繁忙，請稍后重試");
}

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

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

String companyNumber = code + currentTime + seq;

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