Spring Boot中如何实现基于继承的条件化ID生成策略

来源：网站主作者：小宵头衔：网络博主
导读：本期聚焦于小伙伴创作的《Spring Boot中如何实现基于继承的条件化ID生成策略》，敬请观看详情，探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《Spring Boot中如何实现基于继承的条件化ID生成策略》有用，将其分享出去将是对创作者最好的鼓励。

在Spring Boot项目里，不同业务模块对ID生成的需求往往存在差异，比如核心业务表需要有序且高性能的雪花ID，辅助表可以使用简单的UUID，历史归档表可能需要兼容旧系统的自增规则。基于继承的条件化ID生成策略可以通过抽象父类和具体实现类拆分逻辑，再结合Spring的条件装配能力，实现不同场景下自动匹配对应的ID生成器。

Spring Boot中如何实现基于继承的条件化ID生成策略

核心抽象父类定义

首先定义所有ID生成器需要遵循的抽象父类，统一生成方法的签名，后续不同的生成策略都继承这个父类实现具体逻辑。

// 抽象ID生成器父类
public abstract class AbstractIdGenerator {

    /**
     * 生成ID的抽象方法，由子类实现具体逻辑
     * @return 生成的ID字符串
     */
    public abstract String generateId();

    /**
     * 判断当前生成器是否支持指定的实体类型
     * @param entityClass 实体类Class对象
     * @return 是否支持
     */
    public abstract boolean supports(Class<?> entityClass);
}

具体ID生成策略实现

接下来实现三种常见的ID生成策略，分别适配不同的业务场景，每个实现类都继承AbstractIdGenerator抽象类。

雪花算法ID生成器

适用于需要有序、高性能、分布式唯一ID的核心业务表，比如用户、订单等实体。

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.stereotype.Component;

// 当配置文件中id.generator.type=snowflake时加载该生成器
@Component
@ConditionalOnProperty(name = "id.generator.type", havingValue = "snowflake")
public class SnowflakeIdGenerator extends AbstractIdGenerator {

    // 雪花算法核心参数，实际项目中可配置化
    private final long workerId = 1L;
    private final long datacenterId = 1L;
    private long sequence = 0L;
    private final long twepoch = 1288834974657L;
    private final long workerIdBits = 5L;
    private final long datacenterIdBits = 5L;
    private final long maxWorkerId = -1L ^ (-1L << workerIdBits);
    private final long maxDatacenterId = -1L ^ (-1L << datacenterIdBits);
    private final long sequenceBits = 12L;
    private final long workerIdShift = sequenceBits;
    private final long datacenterIdShift = sequenceBits + workerIdBits;
    private final long timestampLeftShift = sequenceBits + workerIdBits + datacenterIdBits;
    private final long sequenceMask = -1L ^ (-1L << sequenceBits);
    private long lastTimestamp = -1L;

    @Override
    public String generateId() {
        long timestamp = timeGen();
        if (timestamp < lastTimestamp) {
            throw new RuntimeException("时钟回拨，无法生成ID");
        }
        if (timestamp == lastTimestamp) {
            sequence = (sequence + 1) & sequenceMask;
            if (sequence == 0) {
                timestamp = tilNextMillis(lastTimestamp);
            }
        } else {
            sequence = 0;
        }
        lastTimestamp = timestamp;
        long id = ((timestamp - twepoch) << timestampLeftShift)
                | (datacenterId << datacenterIdShift)
                | (workerId << workerIdShift)
                | sequence;
        return String.valueOf(id);
    }

    @Override
    public boolean supports(Class<?> entityClass) {
        // 支持标记了SnowflakeId注解的实体
        return entityClass.getAnnotation(SnowflakeId.class) != null;
    }

    private long tilNextMillis(long lastTimestamp) {
        long timestamp = timeGen();
        while (timestamp <= lastTimestamp) {
            timestamp = timeGen();
        }
        return timestamp;
    }

    private long timeGen() {
        return System.currentTimeMillis();
    }
}

UUID生成器

适用于对ID有序性无要求、不需要依赖外部组件的辅助表，比如操作日志、临时数据等实体。

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.stereotype.Component;
import java.util.UUID;

// 当配置文件中id.generator.type=uuid时加载该生成器
@Component
@ConditionalOnProperty(name = "id.generator.type", havingValue = "uuid")
public class UuidIdGenerator extends AbstractIdGenerator {

    @Override
    public String generateId() {
        return UUID.randomUUID().toString().replace("-", "");
    }

    @Override
    public boolean supports(Class<?> entityClass) {
        // 支持标记了UuidId注解的实体
        return entityClass.getAnnotation(UuidId.class) != null;
    }
}

数据库自增ID生成器

适用于兼容旧系统、依赖数据库自增能力的实体，比如历史归档表等。

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.stereotype.Component;
import org.springframework.beans.factory.annotation.Autowired;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;

// 当配置文件中id.generator.type=auto_increment时加载该生成器
@Component
@ConditionalOnProperty(name = "id.generator.type", havingValue = "auto_increment")
public class AutoIncrementIdGenerator extends AbstractIdGenerator {

    @Autowired
    private DataSource dataSource;

    @Override
    public String generateId() {
        try (Connection conn = dataSource.getConnection();
             PreparedStatement ps = conn.prepareStatement("SELECT LAST_INSERT_ID()");
             ResultSet rs = ps.executeQuery()) {
            if (rs.next()) {
                return String.valueOf(rs.getLong(1));
            }
            throw new RuntimeException("获取自增ID失败");
        } catch (Exception e) {
            throw new RuntimeException("获取自增ID异常", e);
        }
    }

    @Override
    public boolean supports(Class<?> entityClass) {
        // 支持标记了AutoIncrementId注解的实体
        return entityClass.getAnnotation(AutoIncrementId.class) != null;
    }
}

条件注解与实体标记

为了区分不同实体对应的ID生成策略，我们定义对应的注解，实体类上标记对应注解即可关联生成器。

import java.lang.annotation.*;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SnowflakeId {
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface UuidId {
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AutoIncrementId {
}

ID生成器管理类

定义一个管理类，自动注入所有AbstractIdGenerator的实现类，根据实体类型匹配对应的生成器。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.util.List;

@Component
public class IdGeneratorManager {

    @Autowired
    private List<AbstractIdGenerator> idGenerators;

    /**
     * 根据实体类获取对应的ID生成器并生成ID
     * @param entityClass 实体类Class对象
     * @return 生成的ID
     */
    public String generateId(Class<?> entityClass) {
        for (AbstractIdGenerator generator : idGenerators) {
            if (generator.supports(entityClass)) {
                return generator.generateId();
            }
        }
        throw new RuntimeException("未找到对应实体" + entityClass.getName() + "的ID生成器");
    }
}

实际使用示例

首先在配置文件中指定当前启用的ID生成器类型，比如启用雪花算法：

id.generator.type=snowflake

然后定义对应的实体类，标记对应的注解：

// 用户实体使用雪花算法生成ID
@SnowflakeId
public class User {
    private String id;
    private String username;
    private String password;
    // 省略getter、setter
}

// 操作日志实体使用UUID生成ID
@UuidId
public class OperationLog {
    private String id;
    private String userId;
    private String content;
    // 省略getter、setter
}

在业务代码中注入IdGeneratorManager即可生成对应实体的ID：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private IdGeneratorManager idGeneratorManager;

    @PostMapping("/user")
    public String createUser() {
        User user = new User();
        // 生成用户ID
        String userId = idGeneratorManager.generateId(User.class);
        user.setId(userId);
        user.setUsername("testUser");
        // 后续保存逻辑
        return userId;
    }
}

方案优势总结

  • 复用性强：公共的判断逻辑可以放在抽象父类中，避免重复代码
  • 扩展性好：新增ID生成策略只需要新增继承抽象父类的实现类，无需修改原有代码
  • 适配灵活：通过条件注解和实体注解可以灵活匹配不同场景的ID生成需求，切换成本低
  • 符合开闭原则：对扩展开放，对修改关闭，后续迭代维护更方便

Spring_Boot条件化ID生成继承策略ID生成器策略模式修改时间：2026-07-11 02:09:41

免责声明：​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰，观点力求客观中立。本站旨在免费分享，内容仅供个人学习、研究或参考使用。若引用了第三方作品，版权归原作者所有。如内容涉及您的权益，请联系我们处理。

上一篇如何通过应用服务器安全挂载文件系统并提供静态文件

下一篇怎么利用 while(true) 配合 Selector 在 NIO 网络编程中构建高性能的事件轮询死循环

猜你喜欢

内容垂直聚焦
专注技术核心技术栏目，确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计，为用户提供无干扰的纯技术知识沉淀，精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进，构建清晰学习路径，帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈，深入技术细节与实践难点。无论是数据库优化还是服务器配置，均结合真实场景与代码示例进行剖析，致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程，从数据库操作到服务器运维，形成完整闭环，一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性，步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目，显著缩短从学习到实践的距离，快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代，紧跟主流技术发展趋势，为用户提供经久不衰的学习价值。

负责任网站 - 免责声明 - 隐私政策 - 网站地图

举报邮箱：chomcom@qq.com

Copyright (C) www.ipipp.com All Rights Reserved.