Spring Boot + MyBatis-Plus 的现代开发模式

之前的Maven项目和本次需要的环境配置并不一样

之前使用的是：

传统的 MyBatis 框架（非 Spring Boot 环境）
手动管理 SqlSession
使用了 .xml 的 Mapper 映射文件
没有 Spring 容器管理（没有 @Service / @RestController 等）
没有看到分页插件配置，也没有 REST 接口入口

项目结构对比	你现在的项目	实验要求的项目
框架风格	手动搭建的原生 MyBatis	Spring Boot 自动化集成
Mapper 类型	接口 + XML	接口继承 `BaseMapper`（少量或无 XML）
SqlSession	手动获取和关闭	Spring 管理，自动注入 Mapper
事务控制	手动 commit	使用 Spring 的 `@Transactional` 管理
分页插件	没有集成插件	要集成 MyBatis-Plus 分页插件
接口风格	控制台输出	使用 `@RestController` 提供 REST API
调试方式	控制台 + main 方法测试	使用 Postman 测试 API 接口

添加依赖项

依赖名称	作用
Spring Web	用来写 REST API 接口，也就是你要用 Postman 调的接口
MyBatis Plus	是 MyBatis 的增强版，提供了分页插件、条件构造器、简化 DAO 写法
MySQL Driver	数据库驱动，让 Java 项目能连接你本地的 MySQL 数据库
Lombok	简化实体类写法，比如 `@Data` 自动生成 getter/setter，不用手写

MyBatis Plus会发现并没有找到

可能用的是 国内 Spring Initializr 镜像站（start.spring.io 国内版），它没集成 MyBatis-Plus 官方模块。这时我们用手动方式加上去就行：

✅ 添加 MyBatis-Plus 的方式

完成创建项目后，在 pom.xml 中手动添加以下依赖：

<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3.1</version>
</dependency>
添加后点击 IDEA 右上角的 Maven 小象图标 → Reimport，让它下载依赖。

先MySQL中建立数据库

CREATE DATABASE product_db DEFAULT CHARACTER SET utf8mb4;USE product_db;CREATE TABLE product (id BIGINT PRIMARY KEY AUTO_INCREMENT,name VARCHAR(100) NOT NULL,category_level1 VARCHAR(50),category_level2 VARCHAR(50),category_level3 VARCHAR(50),brand VARCHAR(50),price DECIMAL(10, 2)
);

配置 `application.properties`

spring.application.name=product-service
#这个是 Spring Boot 给你的服务起个名字，比如后续你如果集成了日志系统、监控平台、微服务等，它就能显示“是谁”在运行。
#❗ 这个对本地调试没影响，可以留着，也可以删，不影响实验内容。

设置端口号

server.port=8080
表示你的服务启动后监听 http://localhost:8080，是 Postman 访问接口的基础。

数据库连接配置

spring.datasource.url=jdbc:mysql://localhost:3306/product_db?useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

MyBatis-Plus 设置

mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl
让你在控制台中看到执行的 SQL，非常适合调试查询条件对不对。

spring.application.name=product-serviceserver.port=8080spring.datasource.url=jdbc:mysql://localhost:3306/product_db?useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Drivermybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

最后点击运行ProductServiceApplication.java----自动结束，运行失败

这个问题需要先处理一下------

-----------------------------------------------------------------------------------------全局搜索是Ctrl+Shift+N--

原因是mybatis的版本问题，换到3.5.5就不会出现这个bean的问题了

Started ProductServiceApplication in 1.199 seconds (process running for 1.539)Application availability state ReadinessState changed to ACCEPTING_TRAFFIC

🧩 接下来要做的事（建议顺序）

🔧 第 1 步：实体类

Product.java → 映射数据库表字段

（便于 MyBatis-Plus 自动匹配）

保持 Java 字段名和数据库字段名一致
如果不一致就用 @TableField 和 @TableId 明确指定

package org.example.productservice.entity;import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.TableField;
import lombok.Data;import java.math.BigDecimal;@Data
@TableName("product")
public class Product {@TableId("id")private Long id;@TableField("name")private String name;@TableField("category_level1")private String categoryLevel1;@TableField("category_level2")private String categoryLevel2;@TableField("category_level3")private String categoryLevel3;@TableField("brand")private String brand;@TableField("price")private BigDecimal price;
}

配套说明：

@TableName("product")：绑定对应的表名
@TableField("xxx")：将 Java 命名风格（驼峰）映射到数据库的下划线字段
@TableId("id")：指定主键列
BigDecimal：更适合处理 DECIMAL(10, 2) 类型，避免精度丢失

🔧 第 2 步：Mapper 接口

ProductMapper.java → 使用 BaseMapper<Product>

package org.example.productservice.mapper;import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.example.productservice.entity.Product;@Mapper
public interface ProductMapper extends BaseMapper<Product> {
}

extends BaseMapper<Product>
→ 让你继承了 MyBatis-Plus 提供的所有基础增删改查方法（包括分页、条件构造器）
@Mapper
→ 是 MyBatis 要求的注解，告诉 Spring 它是一个 Mapper 接口
不需要自己写 XML 映射文件了，MyBatis-Plus 自动帮你做了映射！

🔧 第 3 步：Service 层

IProductService.java（接口）

package org.example.productservice.service;import com.baomidou.mybatisplus.extension.service.IService;
import org.example.productservice.entity.Product;public interface IProductService extends IService<Product> {
}

ProductServiceImpl.java（实现）

package org.example.productservice.service.impl;import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.example.productservice.entity.Product;
import org.example.productservice.mapper.ProductMapper;
import org.example.productservice.service.IProductService;
import org.springframework.stereotype.Service;@Service
public class ProductServiceImpl extends ServiceImpl<ProductMapper, Product> implements IProductService {
}

原理说明：

IService<Product> 接口：

提供了更高层级的封装，比如 getById、save、removeById 等，默认自带 CRUD
ServiceImpl<Mapper, Entity> 实现类：

自动帮你实现这些方法，不用自己写 SQL

-----------------

后端结构已经扎实完整，马上就能提供接口服务了。

🔧 第 4 步：Controller 层

📁 路径：org.example.productservice.controller

package org.example.productservice.controller;import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.example.productservice.entity.Product;
import org.example.productservice.service.IProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;@RestController
@RequestMapping("/api/products")
public class ProductController {@Autowiredprivate IProductService productService;@GetMapping("/page")public Page<Product> getProductPage(@RequestParam(defaultValue = "1") int page,@RequestParam(defaultValue = "10") int size,@RequestParam(required = false) String name) {QueryWrapper<Product> queryWrapper = new QueryWrapper<>();if (name != null && !name.isEmpty()) {queryWrapper.like("name", name);}return productService.page(new Page<>(page, size), queryWrapper);}
}

🔧 第 5 步：分页插件配置

📁 创建一个配置类：MyBatisPlusConfig.java
路径：org.example.productservice.config

package org.example.productservice.config;import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class MyBatisPlusConfig {@Beanpublic MybatisPlusInterceptor paginationInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();interceptor.addInnerInterceptor(new PaginationInnerInterceptor());return interceptor;}
}

----

此时先暂时尝试运行项目在idea中

现在虽然逻辑没写很多，但只靠你目前写的代码：

你已经拥有了分页、条件查询、自动封装结果、返回 JSON 的完整功能

运行后报错

Spring Boot 升级 3.2 报错 Invalid value type for attribute ‘factoryBeanObjectType‘: java.lang.String_invalid value type for attribute 'factorybeanobjec-CSDN博客

需要注意下 Maven 的坐标标识是mybatis-plus-spring-boot3-starter，这点和SpringBoot 2 的依赖坐标mybatis-plus-boot-starter有所区别。

对于

创建商品处理的业务接口实现类 ProductServiceImpl，完成按商品名称、多级类别、品牌查询商品

MyBatis-Plus 自带的是“基础查询”，但你要做复杂查询逻辑（多条件），就得：

自己在 Controller 里组合 QueryWrapper
或者把逻辑抽出来写在 ServiceImpl 中（推荐，逻辑更清晰）

总结你现在做的是：

✅ REST 风格接口设计
✅ SpringBoot + MyBatisPlus 的现代开发方式
✅ 使用分层架构（Controller + ServiceImpl + Mapper + Entity）

所以你这叫遵循 REST 风格的分层 Web API 实现，并且是目前企业开发里非常标准的一种写法。

先暂时用游览器的url直接访问

postman暂时还是不方便

records 数组中是空对象 {}，说明实体类字段没被序列化。

接口逻辑是对的，返回结构也有 total 等字段，说明查询成功。但 records 是空对象 {}

✅ 最可能原因：

你的 Product 实体类字段没有加上 getter/setter 或 Lombok 注解 @Data，导致无法被 Jackson 序列化为 JSON。

期望结果
{"records": [{"id": 1,"name": "小米电视 4C","categoryLevel1": "家电","categoryLevel2": "电视","categoryLevel3": "智能电视","brand": "小米","price": 2299.00},{"id": 2,"name": "海信电视 H55","categoryLevel1": "家电","categoryLevel2": "电视","categoryLevel3": "液晶电视","brand": "海信","price": 2699.00}],"total": 2,"size": 10,"current": 1,"pages": 1
}

total, size, current, pages 是分页系统生成的，是 Page<Product> 本身的结构。

🔄 IService 提供的是分页机制

Page<Product> page = productService.page(new Page<>(page, size), queryWrapper);

的确是lombok的问题，全部手动设置构造函数就解决了

“按商品名称、多级类别、品牌查询商品”的业务逻辑。

需要修改的类是：ProductServiceImpl 和 ProductController

QueryWrapper<Product> 是 MyBatis-Plus 提供的条件构造器，用来拼接 SQL 查询语句。

wrapper.like("name", name) 是模糊查询（SQL 中的 LIKE '%关键词%'）。

wrapper.eq(...) 是精确匹配（SQL 中的 = 值）。

this.page(...) 调用 MyBatis-Plus 提供的分页查询方法（自动生成 limit offset 分页语句）。

👉 为什么写在 ProductServiceImpl？

因为 Service 是 业务逻辑层，用于组织和处理“多个条件组合”的查询。控制器不直接处理数据拼接，而是委托给 Service 层。

✅ 二、`IProductService`：定义接口的契约

目的：明确 ProductService 应该提供哪些方法。

在 Java 中，通过接口来隔离调用者（Controller）与实现者（Impl）。
当 Controller 调用 searchProducts(...)，它并不关心方法的具体实现是谁，只要接口定义存在即可。

👉 为什么要定义这个接口？

是为了松耦合：如果将来想换一个查询逻辑，只需更换 Impl 实现，不必改调用方（Controller）。

✅ 三、`ProductController`：暴露查询接口（给前端或 Postman 测试）

目的：将你定义的查询功能开放为一个 HTTP 请求入口。

@GetMapping("/search") 表示它是一个 GET 请求，路径为 /api/products/search
@RequestParam 是接收 URL 参数的注解，比如 ?name=电视
调用的是 productService.searchProducts(...)，把参数传入，调用你刚实现的业务逻辑。

👉 为什么写在 Controller？

控制器是Web 层的入口，处理请求参数、调用服务、返回数据。它不直接写业务细节，而是只负责“调度”。

按 Alt + Enter 自动导入

使用你在 ProductServiceImpl 里自定义的 searchProducts 方法对商品进行 条件查询，不用默认的分页方法名 getProductPage

-----------

完成

postman查询（游览器也可以，只不过也是这个更专业一点吧，，目前其实游览器直接输入都可以了）

类名	作用
`Product`	实体类，对应数据库字段
`ProductMapper`	Mapper接口，继承自 BaseMapper
`IProductService`	服务接口，继承 IService，并声明 `searchProducts` 方法
`ProductServiceImpl`	服务实现，继承 ServiceImpl，实现自定义搜索逻辑
`ProductController`	控制器，定义 `/page` 与 `/search` 两个查询接口