blade-tool
Introduction: SpringBlade 2.0 架构核心工具包,SpringBlade 是一个由商业级项目升级优化而来的 SpringCloud 分布式微服务架构、SpringBoot 单体式微服务架构并存的综合型项目,采用 Java8 API 重构了业务代码,完全遵循阿里巴巴编码规范。采用 Spring Boot 2 、Spring Cloud Hoxton 、Mybatis 等核心技术,同时提供基于 React 和 Vue 的两个前端框架用于快速搭建企业级的 SaaS 多租户微服务平台。 官网:https://bladex.vip
Tags:
- 采用前后端分离的模式,前端开源两个框架:Sword (基于 React、Ant Design)、Saber (基于 Vue、Element-UI)
- 后端采用 SpringCloud 全家桶,并同时对其基础组件做了高度的封装,单独开源出一个框架:BladeTool
- BladeTool已推送至 Maven 中央库,直接引入即可,减少了工程的臃肿,也可更注重于业务开发
- 集成 Sentinel 从流量控制、熔断降级、系统负载等多个维度保护服务的稳定性。
- 注册中心、配置中心选型 Nacos,为工程瘦身的同时加强各模块之间的联动。
- 极简封装了多租户底层,用更少的代码换来拓展性更强的 SaaS 多租户系统。
- 借鉴 OAuth2,自研多终端认证系统,可控制子系统的 token 权限互相隔离。
- 借鉴 Security,自研 Secure 模块,采用 JWT 做 Token 认证,可拓展集成 Redis 等细颗粒度控制方案。
- 稳定生产了六年,经历了从 Camden -> Hoxton -> 2025 的技术架构,也经历了从 fat jar -> docker -> k8s + jenkins 的部署架构。
- 项目分包明确,规范微服务的开发模式,使包与包之间的分工清晰。
架构图
核心技术栈
技术栈 | 版本 |
---|---|
Java | 17+ |
NodeJS | 18+ |
Spring | 6.2.8 |
Spring Boot | 3.5.3 |
Spring Cloud | 2025.0.0 |
Spring Cloud Alibaba | 2023.0.3.3 |
Nacos Alibaba | 3.0.2 |
Mybatis Plus | 3.5.12 |
工程结构
blade-tool
├── blade-core-bom -- Maven 依赖管理模块
├── blade-core-boot -- 业务包综合模块,集成常用功能的快速启动包
├── blade-core-cloud -- Spring Cloud 微服务封装模块
├── blade-core-launch -- 基础启动模块,提供应用启动的核心功能
├── blade-core-secure -- 安全认证封装模块,JWT Token、权限控制等
├── blade-core-test -- 单元测试封装模块,集成测试工具和配置
├── blade-core-tool -- 核心工具封装模块,通用工具类、常量、配置等
├── blade-starter-api-crypto -- API 接口加密解密模块
├── blade-starter-cache -- 缓存抽象封装模块
├── blade-starter-datascope -- 数据权限封装模块,支持行级权限控制
├── blade-starter-develop -- 代码生成封装模块,支持多种模板生成
├── blade-starter-excel -- Excel 导入导出封装模块
├── blade-starter-loadbalancer -- 负载均衡与灰度发布封装模块
├── blade-starter-log -- 日志封装模块,统一日志处理和存储
├── blade-starter-mybatis -- MyBatis Plus 增强封装模块
├── blade-starter-oss -- 对象存储封装模块,支持多种云存储
├── blade-starter-redis -- Redis 缓存封装模块,提供缓存操作工具
├── blade-starter-report -- 报表封装模块,支持多种报表生成
├── blade-starter-social -- 第三方登录封装模块,OAuth2 社交登录
├── blade-starter-swagger -- Swagger 文档封装模块,API 文档自动生成
├── blade-starter-tenant -- 多租户封装模块,SaaS 多租户支持
└── blade-starter-transaction -- 分布式事务封装模块,Seata 分布式事务
官方信息
简介 | 内容 |
---|---|
官网地址 | https://bladex.cn |
问答社区 | https://sns.bladex.cn |
会员计划 | SpringBlade 会员计划 |
交流一群 | 477853168 (满) |
交流二群 | 751253339 (满) |
交流三群 | 784729540 (满) |
交流四群 | 1034621754 (满) |
交流五群 | 946350912 (满) |
交流六群 | 511624269 (满) |
交流七群 | 298061704 |
官方产品
简介 | 演示地址 |
---|---|
BladeX 企业级开发平台 | https://saber3.bladex.cn |
BladeX 可视化数据大屏 | https://data.bladex.cn |
BladeX 物联网开发平台 | https://iot.bladex.cn |
BladeX 大模型开发平台 | https://ai.bladex.cn |
前端项目
简介 | 地址 |
---|---|
前端框架 Sword(基于 React) | https://gitee.com/smallc/Sword |
前端框架 Saber(基于 Vue2) | https://gitee.com/smallc/Saber |
前端框架 Saber3(基于 Vue3) | https://gitee.com/smallc/Saber3 |
后端项目
简介 | 地址 |
---|---|
核心框架项目地址 | https://gitee.com/smallc/blade-tool |
后端 Gitee 地址 | https://gitee.com/smallc/SpringBlade |
后端 Github 地址 | https://github.com/chillzhuang/SpringBlade |
后端 SpringBoot 版 | https://gitee.com/smallc/SpringBlade/tree/boot/ |
安全手册
简介 | 地址 |
---|---|
Blade 安全手册 | https://www.kancloud.cn/smallchill/blade-safety |
技术文档
简介 | 地址 |
---|---|
SpringBlade 开发手册一览 | https://gitee.com/smallc/SpringBlade/wikis/SpringBlade 开发手册 |
SpringBlade 常见问题集锦 | https://sns.bladex.cn/article-14966.html |
SpringBlade 基于 Kuboard 部署 K8S | https://kuboard.cn/learning/k8s-practice/spring-blade/ |
SpringBlade 基于 Rainbond 部署 | https://www.rainbond.com/docs/micro-service/example/blade |
免费公开课
![]() |
![]() |
开源协议
LGPL(GNU Lesser General Public License)
LGPL 是 GPL 的一个为主要为类库使用设计的开源协议。和 GPL 要求任何使用/修改/衍生之 GPL 类库的的软件必须采用 GPL 协议不同。LGPL 允许商业软件通过类库引用(link)方式使用 LGPL 类库而不需要开源商业软件的代码。这使得采用 LGPL 协议的开源代码可以被商业软件作为类库引用并发布和销售。
但是如果修改 LGPL 协议的代码或者衍生,则所有修改的代码,涉及修改部分的额外代码和衍生的代码都必须采用 LGPL 协议。因此 LGPL 协议的开源代码很适合作为第三方类库被商业软件引用,但不适合希望以 LGPL 协议代码为基础,通过修改和衍生的方式做二次开发的商业软件采用。
用户权益
- 允许以引入不改源码的形式免费用于学习、毕设、公司项目、私活等。
- 特殊情况修改代码,但仍然想闭源需经过作者同意。
- 对未经过授权和不遵循 LGPL 协议二次开源或者商业化我们将追究到底。
- 参考请注明:参考自 mica:https://github.com/lets-mica/mica ,blade-tool:https://github.com/chillzhuang/blade-tool 。另请遵循 LGPL 协议。
注意
:若禁止条款被发现有权追讨 19999 的授权费。