Spring Boot 服务层泛型抽象与代码复用实战

详解如何设计基于泛型的 BaseService + BaseServiceImpl 模板,极大减少业务层重复 CRUD 代码,提高代码可维护性和扩展性。


🎯 设计目标

  • 统一定义 CRUD 接口
  • 抽象公共实现,业务专注差异化
  • 避免重复代码膨胀
  • 提升开发效率与代码质量

🧱 代码设计

1. BaseService 接口

java 复制代码
public interface BaseService<T, ID extends Serializable> {
    T getById(ID id);
    List<T> listAll();
    void save(T entity);
    void update(T entity);
    void deleteById(ID id);
}

2. BaseServiceImpl 抽象实现

java 复制代码
public abstract class BaseServiceImpl<T, ID extends Serializable, M extends BaseMapper<T>> implements BaseService<T, ID> {

    protected final M mapper;

    public BaseServiceImpl(M mapper) {
        this.mapper = mapper;
    }

    @Override
    public T getById(ID id) {
        return mapper.selectById(id);
    }

    @Override
    public List<T> listAll() {
        return mapper.selectAll();
    }

    @Override
    public void save(T entity) {
        mapper.insert(entity);
    }

    @Override
    public void update(T entity) {
        mapper.update(entity);
    }

    @Override
    public void deleteById(ID id) {
        mapper.deleteById(id);
    }
}

⚙️ 业务接入示例

java 复制代码
@Service
public class UserServiceImpl extends BaseServiceImpl<User, Long, UserMapper> implements UserService {

    public UserServiceImpl(UserMapper userMapper) {
        super(userMapper);
    }

    // 可写特有业务逻辑
}

📌 实践建议

  • 新增业务模块从此基类继承,避免重复实现
  • 结合分页、事务钩子方法,增强基类能力
  • 定期重构老业务代码,引入泛型抽象层

🔚 总结

服务层泛型抽象设计,减少了样板代码,提高了代码复用率和可维护性,是大型项目必备的架构实践。业务开发专注核心逻辑,极大提升团队开发效率。


🔗 项目源码地址


🙋‍♂️ 如果你觉得这篇文章有帮助:

  • 点赞 👍
  • 收藏 ⭐
  • 评论 💬
  • 关注我 👇 获取后续实战内容
相关推荐
Pr Young4 小时前
服务优雅停止和服务优雅启动
后端
嘟嘟MD5 小时前
程序员副业 | 2025年9月复盘
后端·aigc
尘觉6 小时前
中秋节与 Spring Boot 的思考:一场开箱即用的团圆盛宴
java·spring boot·后端
间彧6 小时前
Seata分布式事务框架详解与项目实战
后端
zhuyasen6 小时前
单机已达上限?PerfTest 分布式压测登场,轻松模拟百万用户洪峰
后端·性能优化·测试
勇哥java实战分享6 小时前
sensitive-word:一个简单易用的敏感词过滤框架
后端
popoxf6 小时前
spring容器启动流程(反射视角)
java·后端·spring
Funcy7 小时前
XxlJob 源码08:任务执行流程(三)之执行器揭秘
后端
AAA修煤气灶刘哥7 小时前
监控摄像头?不,我们管这个叫优雅的埋点艺术!
java·后端·spring cloud
2301_772093567 小时前
tuchuang_后端_前端_注册登录
数据库·后端·网络协议·mysql·wireshark