# sbf

**Repository Path**: ct_dayan/sbf

## Basic Information

- **Project Name**: sbf
- **Description**: 用Spring Boot Framework写接口
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-18
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 用户管理服务 - Spring Boot实战项目

这是一个基于Spring Boot + MyBatis + MySQL的用户管理服务，实现了完整的CRUD操作。

## 项目结构

```
user-service/
├── src/main/java/com/example/userservice/
│   ├── UserServiceApplication.java          # 启动类
│   ├── controller/                          # 控制层
│   │   └── UserController.java             # 用户控制器
│   ├── service/                            # 业务层
│   │   ├── UserService.java                # 用户服务接口
│   │   └── impl/
│   │       └── UserServiceImpl.java        # 用户服务实现
│   ├── dao/                                # 数据访问层
│   │   └── UserDAO.java                    # 用户DAO接口
│   ├── entity/                             # 实体类
│   │   └── User.java                       # 用户实体
│   └── common/                             # 公共组件
│       ├── ApiResponse.java                # 统一响应格式
│       └── GlobalExceptionHandler.java     # 全局异常处理
├── src/main/resources/
│   ├── mapper/
│   │   └── UserMapper.xml                  # MyBatis映射文件
│   ├── sql/
│   │   └── init.sql                        # 数据库初始化脚本
│   └── application.properties              # 应用配置文件
└── pom.xml                                 # Maven依赖配置
```

## 环境要求

- JDK 1.8+
- Maven 3.6+
- MySQL 5.7+
- IntelliJ IDEA（推荐）

## 快速开始

### 1. 数据库准备

1. 启动MySQL服务
2. 执行 `src/main/resources/sql/init.sql` 脚本创建数据库和表

### 2. 修改数据库配置

编辑 `src/main/resources/application.properties`，修改数据库连接信息：

```properties
spring.datasource.username=你的MySQL用户名
spring.datasource.password=你的MySQL密码
```

### 3. 启动项目

1. 在IDEA中打开项目
2. 运行 `UserServiceApplication.java` 的main方法
3. 看到控制台输出"用户管理服务启动成功！"表示启动完成

### 4. 测试接口

使用Postman或其他API测试工具测试以下接口：

#### 查询所有用户
```
GET http://localhost:8080/api/users
```

#### 根据ID查询用户
```
GET http://localhost:8080/api/users/1
```

#### 根据用户名模糊查询
```
GET http://localhost:8080/api/users/name/张
```

#### 新增用户
```
POST http://localhost:8080/api/users
Content-Type: application/json

{
  "name": "新用户",
  "age": 25,
  "gender": "男"
}
```

#### 修改用户
```
PUT http://localhost:8080/api/users/1
Content-Type: application/json

{
  "name": "修改后的用户名",
  "age": 26,
  "gender": "男"
}
```

#### 删除用户
```
DELETE http://localhost:8080/api/users/1
```

## 响应格式

所有接口都返回统一的JSON格式：

```json
{
  "code": 0,
  "message": "成功",
  "data": {
    // 具体数据
  }
}
```

- `code`: 0表示成功，1表示失败
- `message`: 提示信息
- `data`: 响应数据

## 技术栈

- **Spring Boot 2.7.18**: 主框架
- **MyBatis**: ORM框架
- **MySQL**: 数据库
- **Lombok**: 简化代码
- **Spring Boot DevTools**: 热部署

## 分层架构

- **Controller层**: 接收HTTP请求，返回响应
- **Service层**: 处理业务逻辑
- **DAO层**: 数据访问，与数据库交互
- **Entity层**: 实体类，对应数据库表

## 开发建议

1. 修改代码后会自动重启（热部署）
2. 查看控制台SQL日志，了解数据库操作
3. 使用Postman测试接口，确保功能正常
4. 遵循RESTful API设计规范

## 常见问题

1. **数据库连接失败**: 检查MySQL服务是否启动，用户名密码是否正确
2. **端口被占用**: 修改 `application.properties` 中的 `server.port`
3. **Lombok不生效**: 在IDEA中安装Lombok插件

## 扩展功能

可以基于此项目扩展：
- 用户认证和授权
- 文件上传下载
- 缓存（Redis）
- 消息队列
- 微服务架构