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:

Build Status Build Status Coverage Status Downloads Downloads Downloads
Downloads Downloads

  • 采用前后端分离的模式,前端开源两个框架: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 的授权费。
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools