# sat4

**Repository Path**: wuyuan/sat4

## Basic Information

- **Project Name**: sat4
- **Description**: springboot4整合satoken4
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# SAT4 项目

基于 Spring Boot + MyBatis + Sa-Token 的轻量级权限管理系统。

## 项目简介

SAT4 是一个简单易用的 Java Web 脚手架项目，集成了 Spring Boot 框架、MyBatis 数据库持久层框架以及 Sa-Token 权限认证框架。项目提供了完整的用户认证、权限控制、异常处理等功能，可以快速用于搭建各类后台管理系统。

## 技术栈

- **后端框架**：Spring Boot 2.x
- **数据库持久层**：MyBatis
- **身份认证**：Sa-Token
- **工具库**：Lombok
- **构建工具**：Maven

## 项目结构

```
src/
├── main/
│   ├── java/com/podman/sat4/
│   │   ├── config/           # 配置类
│   │   │   ├── GlobalExceptionHandler.java    # 全局异常处理器
│   │   │   ├── NotFoundHandle.java            # 404错误处理
│   │   │   ├── SaTokenConfigure.java          # Sa-Token配置
│   │   │   └── StpInterfaceImpl.java          # 权限验证扩展实现
│   │   ├── controller/       # 控制器
│   │   │   ├── LoginController.java           # 登录控制器
│   │   │   └── UserController.java            # 用户控制器
│   │   ├── dto/               # 数据传输对象
│   │   │   └── UserDTO.java
│   │   ├── entity/            # 实体类
│   │   │   └── User.java
│   │   ├── mapper/            # MyBatis mapper接口
│   │   │   └── UserMapper.java
│   │   ├── util/              # 工具类
│   │   │   └── AjaxJson.java
│   │   └── Sat4Application.java               # 启动类
│   └── resources/
│       ├── application.yml    # 配置文件
│       └── static/            # 静态资源
└── test/                      # 测试类
```

## 功能特性

### 用户认证
- 用户登录 (`/acc/doLogin`)
- 登录状态检查 (`/acc/isLogin`)
- 获取Token信息 (`/acc/tokenInfo`)
- 退出登录 (`/acc/logout`)

### 权限控制
- 基于注解的权限验证 (`@SaCheckPermission`)
- 自定义权限和角色扩展
- 接口级别的权限拦截

### 异常处理
- 全局异常捕获和处理
- 统一的JSON返回格式
- 404错误专门处理

### 响应封装
- 统一的响应结构 (`AjaxJson`)
- 成功/失败/警告/未登录等多种响应类型
- 支持分页数据返回

## 快速开始

### 环境要求

- JDK 1.8 或更高版本
- Maven 3.x
- MySQL 5.7 或更高版本（可选）

### 配置说明

在 `src/main/resources/application.yml` 中配置数据库连接等基本信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database
    username: your_username
    password: your_password
```

### 运行项目

```bash
# 编译项目
mvn clean package

# 运行项目
mvn spring-boot:run
```

项目启动后，访问 `http://localhost:8080` 即可。

## API 接口

### 登录接口

```
POST /acc/doLogin?name=用户名&pwd=密码
```

### 登出接口

```
POST /acc/logout
```

### 获取用户信息

```
GET /users
Header: Authorization: Bearer your_token
```

## 扩展开发

### 添加新的Controller

继承 RESTful 风格，使用 `@RestController` 和 `@RequestMapping` 注解。

### 添加新的Mapper

1. 在 `mapper` 包下创建 Interface
2. 在对应的 Mapper XML 中编写 SQL
3. 在启动类同级的 mapper 包路径下确保被扫描到

### 添加新的实体

在 `entity` 包下创建对应的实体类，使用 Lombok 注解简化代码。

## 许可证

本项目基于 LICENSE 文件中指定的许可证开源。