# springbootssm

**Repository Path**: thin-rain/springbootssm

## Basic Information

- **Project Name**: springbootssm
- **Description**: 基于 Spring Boot + SSM (Spring + Spring MVC + MyBatis) 的企业级管理系统脚手架，集成了 MyBatis Plus、Redis、Druid 连接池、FreeMarker 模板引擎等常用技术栈。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-11-24
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 测试项目

## README



# SpringBoot SSM 项目

基于 Spring Boot + SSM (Spring + Spring MVC + MyBatis) 的企业级管理系统脚手架，集成了 MyBatis Plus、Redis、Druid 连接池、FreeMarker 模板引擎等常用技术栈。

## 技术栈

- **核心框架**: Spring Boot 2.x
- **持久层**: MyBatis Plus
- **数据库连接池**: Druid
- **缓存**: Redis
- **模板引擎**: FreeMarker
- **前端框架**: Bootstrap + DataTables + Vue.js + ECharts
- **任务调度**: Quartz
- **其他**: Log4j、AOP、异步任务

## 项目结构

```
com.akl.ssmspringboot
├── config/                  # 配置类
│   ├── MybatisPlusConfig   # MyBatis Plus 配置
│   ├── RedisConfig         # Redis 配置
│   ├── ViewExceptionHandler # 全局异常处理
│   ├── WebConfigurer       # Web 配置
│   ├── intercept/          # 拦截器
│   └── properties/         # 配置属性类
├── controller/             # 控制器
│   ├── UserController      # 用户管理
│   ├── LoginController     # 登录
│   ├── LoginLogController  # 登录日志
│   ├── TableController     # 表格示例
│   ├── AsyncController     # 异步任务
│   ├── QuartzController    # 定时任务
│   ├── RedisController     # Redis 测试
│   ├── poi/                # Excel 导入导出
│   └── freemarkerutils/    # FreeMarker 工具
├── service/                # 业务层接口
│   ├── impl/               # 业务层实现
├── dao/                    # 数据访问层 (MyBatis Mapper)
├── entity/                 # 实体类
├── utils/                  # 工具类
└── SsmspringbootApplication # 启动类
```

## 功能模块

| 模块 | 说明 |
|------|------|
| 用户管理 | 用户的增删改查、用户名唯一性校验 |
| 登录认证 | 登录验证、登录日志记录 |
| 数据表格 | DataTables 表格展示、分页、排序 |
| Excel 导入导出 | 使用 POI 进行 Excel 操作 |
| 异步任务 | Spring @Async 异步执行 |
| 定时任务 | Spring Scheduled 定时任务 |
| Redis 缓存 | Redis 缓存操作封装 |
| 登录拦截器 | 登录状态拦截验证 |
| 异常处理 | 全局异常捕获与处理 |
| AOP 日志 | 登录日志 AOP 切面记录 |
| ECharts 图表 | 数据可视化示例 |

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.x
- MySQL 5.7+
- Redis 3.x+

### 配置说明

在 `src/main/resources/application.properties` 中配置数据库和 Redis 连接信息：

```properties
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/db_ssm?useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

# Redis配置
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=
```

### 初始化数据库

执行 `db/test.sql` 或 `dbreport.sql` 创建数据库表。

### 运行项目

```bash
# 使用 Maven 运行
./mvnw spring-boot:run

# 或打包后运行
./mvnw clean package
java -jar target/ssmspringboot-0.0.1-SNAPSHOT.jar
```

访问 `http://localhost:8080` 进入系统登录页面。

## 核心功能示例

### 用户管理接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/user/list` | GET | 用户列表页面 |
| `/user/toAdd` | GET | 添加用户页面 |
| `/user/addUser` | POST | 添加用户 |
| `/user/toUpdate/{userId}` | GET | 编辑用户页面 |
| `/user/updateUser` | POST | 更新用户 |
| `/user/delUser/{userId}` | GET | 删除用户 |
| `/user/checkUsername` | POST | 用户名唯一性校验 |

### 登录接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/login` | POST | 用户登录 |
| `/loginOut` | GET | 退出登录 |

### 数据表格接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/dataTables/table` | GET | 表格页面 |
| `/dataTables/ajax/arrays.json` | GET | 表格数据接口 |

## 项目特色

1. **MyBatis Plus 集成**: 简化 CRUD 操作，支持分页插件
2. **Druid 监控**: 提供 SQL 监控和连接池管理
3. **完整的后台管理功能**: 用户管理、登录认证、权限控制
4. **前后端分离实践**: RESTful API 设计
5. **丰富的工具类**: 分页、日期处理、Excel 操作等
6. **AOP 应用**: 登录日志切面记录
7. **异步任务**: 支持 @Async 异步执行
8. **定时任务**: 内置定时任务示例

## 许可证

MIT License