# springboot4

**Repository Path**: wuyuan/springboot4

## Basic Information

- **Project Name**: springboot4
- **Description**: springboot4 多时区和 配置中心
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Spring Boot 4 示例项目

一个基于 Spring Boot 的学生管理 REST API 示例项目，支持版本化的 API 路由和数据库持久化。

## 技术栈

- Spring Boot 4.x
- Spring Data JPA
- H2 Database (默认，可配置)
- Lombok

## 项目结构

```
com.podman.springboot4
├── Springboot4Application.java    # 应用入口
├── controller/                   # 控制器
│   ├── IndexController.java     # 基础路由
│   └── StudentController.java   # 学生管理 API
├── dto/                          # 数据传输对象
│   ├── CreateStudentDTO.java
│   └── CreateStudentNoTimeZoneDTO.java
├── entity/                       # 实体类
│   └── Student.java
└── mapper/                       # 数据访问层
    └── StudentRepository.java
```

## 快速开始

### 运行项目

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

应用默认启动于 `http://localhost:8080`

## API 文档

### 基础接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/` | 健康检查 |

### 学生管理接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/student/v1` | 获取学生列表（支持 timezone 参数） |
| POST | `/student/v1` | 创建学生（包含时区信息） |
| POST | `/student/v2` | 创建学生（无时区信息） |

#### 创建学生请求示例 (v1)

```json
{
  "name": "张三",
  "age": 20,
  "timezone": "Asia/Shanghai"
}
```

#### 创建学生请求示例 (v2)

```json
{
  "name": "李四",
  "age": 22
}
```

## 配置

在 `src/main/resources/application.yml` 中修改数据库连接和其他配置。

## 测试

```bash
mvn test
```