# java-product-test-project

**Repository Path**: linyinneng/java-product-test-project

## Basic Information

- **Project Name**: java-product-test-project
- **Description**: Spring Boot 2.7.7 + MyBatis-Plus 商品增删改查学习项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商品 CRUD 示例项目

这是一个面向前端开发者学习 Java 后端的 Spring Boot 示例项目，技术栈：

- Spring Boot 2.7.7
- Maven
- Java 8
- MyBatis-Plus
- MySQL

## 启动步骤

1. 在 MySQL 中执行建表脚本：

   ```sql
   source src/main/resources/sql/schema.sql;
   ```

2. 修改 `src/main/resources/application.yml` 中的数据库用户名和密码。

3. 启动项目：

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

## 接口列表

基础地址：`http://localhost:8080`

| 方法 | 地址 | 说明 |
| --- | --- | --- |
| GET | `/api/products?pageNum=1&pageSize=10&keyword=mac` | 分页查询商品列表 |
| GET | `/api/products/{id}` | 查询商品详情 |
| POST | `/api/products` | 新增商品 |
| PUT | `/api/products/{id}` | 修改商品 |
| DELETE | `/api/products/{id}` | 删除商品 |

## 新增商品示例

```json
{
  "name": "鼠标",
  "price": 199.00,
  "stock": 100,
  "description": "无线鼠标",
  "status": 1
}
```

## 项目分层

- `controller`：接收 HTTP 请求，类似前端路由入口。
- `service`：业务逻辑层，负责组织具体业务。
- `mapper`：数据库访问层，类似前端调用接口的 request 层，但它面向数据库。
- `entity`：数据库表对应的 Java 对象。
- `dto`：请求参数对象。
- `common`：统一响应和全局异常处理。