# springboot-start

**Repository Path**: mryve/springboot-start

## Basic Information

- **Project Name**: springboot-start
- **Description**: SpringBoot 项目初始模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-11-18
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpringBoot 项目初始模板

基于 Java SpringBoot 的项目初始模板，整合了常用框架和主流业务的示例代码。

只需 1 分钟即可完成内容网站的后端！！！大家还可以在此基础上快速开发自己的项目。

[toc]

## 模板特点

### 主流框架 & 特性

- Spring Boot 2.7.6
- Spring MVC
- MyBatis + MyBatis Plus 数据访问（开启分页）
- Spring Boot 调试工具和项目处理器
- Spring AOP 切面编程
- Spring Scheduler 定时任务
- Spring 事务注解
- [Sa-Token](https://gitee.com/dromara/sa-token) + JWT 轻量级权限认证框架
- [WxJava](https://gitee.com/binary/weixin-java-tools) 微信Java开发工具包，简化开发流程
- [X-File-Storage](https://gitee.com/dromara/x-file-storage) 对象存储，简化SDK开放

### 数据存储

- MySQL 数据库
- Redis 内存数据库
- 阿里云OSS、腾讯云 COS 对象存储

### 工具类

- Easy Excel 表格处理
- Hutool 工具库
- Lombok 注解

### 业务特性

- JWT + Redis Session 分布式登录
- 全局请求响应拦截器（记录日志）
- 全局异常处理器
- 自定义错误码
- 封装通用响应类
- Swagger + Knife4j 接口文档
- Sa-Token 权限注解 + 全局校验
- 全局跨域处理
- 长整数丢失精度解决
- 多环境配置
- Redis 序列化配置
- JSR303 校验
- 抽象BaseEntity，MP自动填充创建者、创建时间、更新者、更新时间

## 业务功能

- 提供示例 SQL（用户表、文件记录表）
- 用户登录、注册、注销、封禁、更新、检索、权限管理
- 支持微信开放平台登录
- 支持微信公众号扫码登录、订阅、收发消息、设置菜单
- 支持分业务的文件上传、保存文件信息、文件删除

### 单元测试

- JUnit5 单元测试
- 示例单元测试类

### 架构设计

- 合理分层

### 自用
- 安全
  - 拦截器
  - 过滤器
    - 全局过滤器
    - 网关过滤器(包含响应式编程)
  - spring security
- excel相关功能
    - 使用easyExcel导出(包含策略)
- pdf相关功能
    - 按照freemarker模板生成带水印pdf
- zip相关
    - 将多个文件放到zip并导出
- 远程调用
  - 使用feign进行微服务调用
  - 使用hutool工具进行接口调用
- 多线程相关
  - 使用completableFuture进行异步处理 
  - B操作再A操作事务提交后再处理
- 设计模式
  - 建造者模式
  - 单例模式
  - 工厂模式
  - 原型模式
  - 适配器模式
  - 桥接模式
  - 代理模式
  - 装饰器模式
  - 组合模式
  - 观察者模式
  - 策略模式
  - 模板方法模式
  - 命令模式
  - 责任链模式
- 进度条功能
- 工作流编排

## 快速上手

> 所有需要修改的地方都标记了 `todo`，便于大家找到修改的位置~