# mybatis_plus

**Repository Path**: sky365/mybatis_plus

## Basic Information

- **Project Name**: mybatis_plus
- **Description**: mybatis_plus
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-16
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyBatis Plus 示例项目

这是一个基于 Spring Boot 和 MyBatis Plus 的示例项目，展示了如何构建一个具备基本功能的企业级应用，包括用户管理、日志记录、权限控制、跨域配置等功能。

## 功能特性

- **用户管理**：支持用户的增删改查操作。
- **日志记录**：通过 AOP 实现操作日志记录，记录用户操作行为。
- **跨域支持**：支持跨域请求，可通过配置文件或注解方式启用。
- **权限控制**：通过拦截器实现登录验证。
- **Redis 缓存**：集成 Redis 实现数据缓存，提高系统性能。
- **JWT 认证**：使用 JWT 实现无状态的用户认证。
- **MyBatis Plus 集成**：使用 MyBatis Plus 提供的便捷功能简化数据库操作。
- **全局异常处理**：统一处理系统异常，返回标准化错误信息。

## 技术栈

- Spring Boot
- MyBatis Plus
- Redis
- JWT
- AOP
- Nginx（用于跨域配置）
- Logback（日志记录）
- Lombok（简化代码）

## 模块结构

- **Controller**：处理 HTTP 请求，定义 RESTful API。
- **Service**：业务逻辑层，处理核心业务逻辑。
- **Mapper**：数据访问层，使用 MyBatis Plus 提供的 Mapper 接口。
- **Entity**：数据库实体类，映射数据库表。
- **DTO/VO**：数据传输对象和视图对象，用于前后端数据交互。
- **Utils**：工具类，封装常用功能如 Redis 操作、JWT 生成等。
- **Aspect**：切面类，用于日志记录。
- **Interceptor**：拦截器，用于登录验证。
- **Enums**：枚举类，定义系统中使用的常量枚举。
- **Exception**：异常处理类，统一处理系统异常。

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.5+
- Redis 3.0+
- MySQL 5.7+

### 安装步骤

1. **克隆项目**

   ```bash
   git clone https://gitee.com/sky365/mybatis_plus.git
   ```

2. **导入数据库**

   确保数据库中已创建 `user` 和 `sys_oper_log` 表，具体结构可参考 `User.java` 和 `SysOperLog.java` 中的注解。

3. **配置 application.yml**

   修改 `application.yml` 文件中的数据库连接信息、Redis 配置等。

4. **启动项目**

   ```bash
   cd mybatis_plus
   mvn spring-boot:run
   ```

5. **访问接口**

   项目启动后，可以通过以下 URL 访问接口：

   - 用户管理：`http://localhost:8080/user`
   - 测试接口：`http://localhost:8080/test`

## 使用示例

### 用户注册

```http
POST /user/registry
Content-Type: application/json

{
  "username": "testuser",
  "password": "123456",
  "age": 25
}
```

### 用户登录

```http
POST /user/login
Content-Type: application/json

{
  "username": "testuser",
  "password": "123456"
}
```

登录成功后会返回 JWT Token，后续请求需携带该 Token。

### 获取用户列表

```http
GET /user
Authorization: Bearer <your_token>
```

### 新增用户

```http
POST /user
Authorization: Bearer <your_token>
Content-Type: application/json

{
  "username": "newuser",
  "age": 30
}
```

## 贡献指南

欢迎贡献代码和改进文档。请遵循以下步骤：

1. Fork 项目。
2. 创建新分支。
3. 提交代码更改。
4. 创建 Pull Request。

## 许可证

本项目采用 [MIT License](https://opensource.org/licenses/MIT) 开源协议。