# springboot2.3.7

**Repository Path**: OrzR3/springboot2.3.7

## Basic Information

- **Project Name**: springboot2.3.7
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AFL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# springboot2.3.7

基于 Spring Boot + MyBatis + PageHelper 的订单查询示例项目。提供用户订单关联查询接口，支持分页与全量查询。

## 技术栈

| 组件 | 版本 |
|------|------|
| Spring Boot | 2.3.7.RELEASE |
| Spring Framework | 5.2.12.RELEASE |
| MyBatis Spring Boot Starter | 2.1.4 (MyBatis 3.5.6 / mybatis-spring 2.0.6) |
| PageHelper Spring Boot Starter | 1.4.7 (PageHelper 5.3.3 / jsqlparser 4.5) |
| MySQL Connector/J | 8.0.33 |
| Lombok | 1.18.16 |
| Tomcat (embed) | 9.0.41 |
| JDK | 1.8 |

## 环境要求

- JDK 1.8
- Maven 3.x
- MySQL 5.7+ / 8.0

## 数据库配置

项目默认连接 `jeecg-boot` 库，涉及两张表：

- `ces_order_customer`（订单客户表，字段：name、create_by 等）
- `sys_user`（用户表，字段：username、org_code 等）

连接信息在 `src/main/resources/application.properties`，按需修改：

```properties
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/jeecg-boot?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
```

## 启动方式

- **IDEA**：运行启动类 `com.example.demo.DemoApplication`
- **命令行**：`mvn spring-boot:run`
- **打包运行**：`mvn clean package` 后 `java -jar target/demo-0.0.1-SNAPSHOT.jar`

启动成功后服务监听 `http://localhost:18089`。

## 接口说明

### 查询订单列表

```
GET /userOrder/list
```

**参数**（全部可选）

| 参数 | 类型 | 说明 |
|------|------|------|
| pageNum | Integer | 页码。传了 pageNum 且 pageSize 时启用分页 |
| pageSize | Integer | 每页条数。与 pageNum 同时传才生效 |
| userName | String | 用户名（查询条件，预留） |
| orderNo | String | 订单号（查询条件，预留） |
| startTime | LocalDateTime | 起始时间（查询条件，预留） |
| endTime | LocalDateTime | 结束时间（查询条件，预留） |

**返回**

- 传 `pageNum` + `pageSize`：返回分页结构 `PageInfo`（含 total、list、pageNum、pageSize 等分页信息）
- 不传分页参数：返回全量数据数组 `List`

**示例**

```bash
# 分页查询（第1页，每页10条）
curl "http://localhost:18089/userOrder/list?pageNum=1&pageSize=10"

# 全量查询
curl "http://localhost:18089/userOrder/list"
```

分页返回示例：

```json
{
  "total": 9,
  "list": [{"name": "管理员", "org_code": "A01"}],
  "pageNum": 1,
  "pageSize": 10,
  "pages": 1,
  "isFirstPage": true,
  "isLastPage": true
}
```

> 说明：当前 `userName` / `orderNo` / `startTime` / `endTime` 四个查询条件在 SQL 中尚未生效，接口实际返回全表关联结果。如需按条件过滤，需在 Mapper SQL 中补充 WHERE 条件。

## 项目结构

```
testSpringBoot002
├── pom.xml
├── src/main/java/com/example/demo
│   ├── DemoApplication.java            # 启动类（含 @MapperScan）
│   ├── controller
│   │   └── UserOrderController.java    # 订单查询接口
│   └── mapper
│       └── UserOrderMapper.java        # MyBatis Mapper（@Select 注解）
└── src/main/resources
    ├── application.properties          # 应用配置（数据源、端口、MyBatis）
    └── mapper
        └── UserOrderMapper.xml         # MyBatis XML 映射
```

## 构建说明

```bash
mvn clean compile      # 编译
mvn clean package      # 打包
mvn spring-boot:run    # 运行
```

## 备注

- `mybatis.type-aliases-package` 配置指向 `com.example.demo.entity`，当前项目尚未创建该包，不影响运行。
- SQL 查询关联 `ces_order_customer.create_by = sys_user.username`。