blade-tool

Introduction: SpringBlade 2.0 架构核心工具包,SpringBlade 是一个由商业级项目升级优化而来的 SpringCloud 分布式微服务架构、SpringBoot 单体式微服务架构并存的综合型项目,采用 Java8 API 重构了业务代码,完全遵循阿里巴巴编码规范。采用 Spring Boot 2 、Spring Cloud Hoxton 、Mybatis 等核心技术,同时提供基于 React 和 Vue 的两个前端框架用于快速搭建企业级的 SaaS 多租户微服务平台。 官网:https://bladex.vip
More: Author   ReportBugs   
Tags:

Downloads Build Status Build Status Coverage Status Downloads
Downloads Downloads

  • 采用前后端分离的模式,前端架构 Saber (基于 Vue3、Element-Plus)
  • 后端采用 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.17
Spring Boot 3.5.13
Spring Cloud 2025.0.2
Spring Cloud Alibaba 2025.0.0.0
Nacos Alibaba 3.1.2
Mybatis Plus 3.5.14

工程结构

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-i18n          -- I18n 国际化封装模块
├── 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 (满)
交流八群 1078507904

官方产品

简介 演示地址
BladeX 企业级开发平台 https://saber3.bladex.cn
BladeX 可视化数据大屏 https://data.bladex.cn
BladeX 物联网开发平台 https://iot.bladex.cn
BladeXAI 大模型平台 https://ai.bladex.cn/

前端项目

简介 地址
前端框架 Saber3(基于 Vue3) https://gitee.com/smallc/Saber3
前端框架 Saber(基于 Vue2) https://gitee.com/smallc/Saber2
前端框架 Sword(基于 React) https://gitee.com/smallc/Sword

后端项目

简介 地址
核心框架项目地址 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 的授权费。
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools