spring boot3.4.3+MybatisPlus3.5.5+swagger-ui2.7.0

利用 MyBatis-Plus 操作 books 表。我们将实现以下功能：

• 创建实体类 Book。
  
• 创建 Mapper 接口 BookMapper。
  
• 创建 Service 层 BookService 和 BookServiceImpl。
  
• 创建 Controller 层 BookController。
  
• 设置 MyBatis-Plus 和数据库毗连。
  

1. 项目结构

1. src
2. ├── main
3. │   ├── java
4. │   │   └── com
5. │   │       └── example
6. │   │           ├── DemoApplication.java
7. │   │           ├── entity
8. │   │           │   └── Book.java
9. │   │           ├── mapper
10. │   │           │   └── BookMapper.java
11. │   │           ├── service
12. │   │           │   ├── BookService.java
13. │   │           │   └── impl
14. │   │           │       └── BookServiceImpl.java
15. │   │           └── controller
16. │   │               └── BookController.java
17. │   └── resources
18. │       └── application.properties
19. └── test
20.     └── java
21.         └── com
22.             └── example
23.                 └── DemoApplicationTests.java

复制代码

2. 添加依赖

在 pom.xml 中添加 MyBatis-Plus 和 MySQL 依赖：
POP.XML
 

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
4.     <modelVersion>4.0.0</modelVersion>
5.     <parent>
6.         <groupId>org.springframework.boot</groupId>
7.         <artifactId>spring-boot-starter-parent</artifactId>
8.         <version>3.4.3</version>
9.         <relativePath/> <!-- lookup parent from repository -->
10.     </parent>
11.     <groupId>com.example</groupId>
12.     <artifactId>demo3</artifactId>
13.     <version>0.0.1-SNAPSHOT</version>
14.     <name>demo3</name>
15.     <description>demo3</description>
16.     <url/>
17.     <licenses>
18.         <license/>
19.     </licenses>
20.     <developers>
21.         <developer/>
22.     </developers>
23.     <scm>
24.         <connection/>
25.         <developerConnection/>
26.         <tag/>
27.         <url/>
28.     </scm>
29.     <properties>
30.         <java.version>23</java.version>
31.     </properties>
32.     <dependencies>
33.         <dependency>
34.             <groupId>org.springframework.boot</groupId>
35.             <artifactId>spring-boot-starter-web</artifactId>
36.         </dependency>
39.       <!-- jakarta相关依赖 -->
40.         <dependency>
41.             <groupId>org.hibernate.validator</groupId>
42.             <artifactId>hibernate-validator</artifactId>
43.             <version>8.0.0.Final</version> <!-- 或者选择一个适合Spring Boot 3.x的最新版本 -->
44.         </dependency>
46.         <dependency>
47.             <groupId>jakarta.validation</groupId>
48.             <artifactId>jakarta.validation-api</artifactId>
49.             <version>3.0.2</version> <!-- 或者更高版本，确保与Spring Boot 3.x兼容 -->
50.         </dependency>
52.         <dependency>
53.             <groupId>org.glassfish</groupId>
54.             <artifactId>jakarta.el</artifactId>
55.             <version>4.0.2</version> <!-- 提供EL表达式语言支持 -->
56.         </dependency>
57.       <!-- jakarta相关依赖 -->
58.         
60.         <!-- swagger-ui依赖 -->
61.         <dependency>
62.             <groupId>org.springdoc</groupId>
63.             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
64.             <version>2.7.0</version>
65.         </dependency>
67.         <dependency>
68.             <groupId>org.projectlombok</groupId>
69.             <artifactId>lombok</artifactId>
70.             <version>1.18.30</version> <!-- 或者选择一个适合Spring Boot 3.x的最新版本 -->
71.         </dependency>
74.         <!-- MybatisPlus依赖 -->
75.         <dependency>
76.             <groupId>com.baomidou</groupId>
77.             <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
78.             <version>3.5.5</version>
79.         </dependency>
81.         <!-- MYSQL依赖 -->
82.         <dependency>
83.             <groupId>com.mysql</groupId>
84.             <artifactId>mysql-connector-j</artifactId>
85.         </dependency>
88.         <dependency>
89.             <groupId>org.springframework.boot</groupId>
90.             <artifactId>spring-boot-starter-test</artifactId>
91.             <scope>test</scope>
92.         </dependency>
93.     </dependencies>
95.     <build>
96.         <plugins>
97.             <plugin>
98.                 <groupId>org.springframework.boot</groupId>
99.                 <artifactId>spring-boot-maven-plugin</artifactId>
100.             </plugin>
101.         </plugins>
102.     </build>
104. </project>

复制代码

3. 设置数据库和 MyBatis-Plus

在 application.properties 中设置数据库毗连和 MyBatis-Plus：
application.properties

1. spring.application.name=demo3
3. spring.datasource.url=jdbc:mysql://192.168.1.10:3306/databasename**?useSSL=false&serverTimezone=UTC
4. spring.datasource.username=user***
5. spring.datasource.password=psd***
6. spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
9. # MyBatis-Plus 配置
10. mybatis-plus.mapper-locations=classpath:mapper/*.xml
11. mybatis-plus.type-aliases-package=com.example.com.mapper
13. # OpenAPI 配置
14. #springdoc.swagger-ui.path=/swagger-ui.html

复制代码

启动 MyBatis-Plus 的分页功能 

1. MybatisPlusConfig.java

复制代码

1. package com.example.demo.config;
3. import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
4. import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
5. import org.springframework.context.annotation.Bean;
6. import org.springframework.context.annotation.Configuration;
8. @Configuration
9. public class MybatisPlusConfig {
11.     @Bean
12.     public MybatisPlusInterceptor mybatisPlusInterceptor() {
13.         MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
14.         interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
15.         return interceptor;
16.     }
17. }

复制代码

4. 创建实体类

利用 MyBatis-Plus 的注解定义实体类。
Book.java

1. package com.example.demo.entity;
3. import com.baomidou.mybatisplus.annotation.IdType;
4. import com.baomidou.mybatisplus.annotation.TableId;
5. import com.baomidou.mybatisplus.annotation.TableName;
6. import lombok.Data;
8. @Data // 使用 Lombok 自动生成 getter 和 setter 方法
9. @TableName("books") // 指定数据库表名
10. public class Book {
11.     @TableId(type = IdType.AUTO) // 主键自增
12.     private Long id;
13.     private String name;
14.     private String author;
15. }

复制代码

5. 创建 Mapper 接口

继承 MyBatis-Plus 的 BaseMapper 接口，自动得到 CRUD 方法。
BookMapper.java

1. package com.example.mapper;
3. import com.baomidou.mybatisplus.core.mapper.BaseMapper;
4. import com.example.entity.Book;
5. import org.apache.ibatis.annotations.Mapper;
7. @Mapper
8. public interface BookMapper extends BaseMapper<Book> {
9.     // 无需手动编写 CRUD 方法，BaseMapper 已提供
10. }

复制代码

6. 创建 Service 层

利用 MyBatis-Plus 的 IService 和 ServiceImpl 简化 Service 层代码。
BookService.java

1. package com.example.service;
3. import com.baomidou.mybatisplus.extension.service.IService;
4. import com.example.entity.Book;
6. public interface BookService extends IService<Book> {
7.     // 可以在此定义自定义方法
8. }

复制代码

BookServiceImpl.java

1. package com.example.service.impl;
3. import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
4. import com.example.entity.Book;
5. import com.example.mapper.BookMapper;
6. import com.example.service.BookService;
7. import org.springframework.stereotype.Service;
9. @Service
10. public class BookServiceImpl extends ServiceImpl<BookMapper, Book> implements BookService {
11.     // 无需手动实现 CRUD 方法，ServiceImpl 已提供
12. }

复制代码

7. 创建 Controller 层

在控制器中调用 Service 层的方法。
BookController.java

1. package com.example.controller;
3. import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
4. import com.baomidou.mybatisplus.core.metadata.IPage;
5. import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
6. import com.example.entity.Book;
7. import com.example.service.BookService;
8. import org.springframework.beans.factory.annotation.Autowired;
9. import org.springframework.web.bind.annotation.*;
11. import java.util.List;
13. @RestController
14. @RequestMapping("/books")
15. public class BookController {
17.     @Autowired
18.     private BookService bookService;
20.     // 获取所有书籍
21.     @GetMapping
22.     public List<Book> findAll() {
23.         return bookService.list();
24.     }
26.     // 根据 ID 获取书籍
27.     @GetMapping("/{id}")
28.     public Book findById(@PathVariable Long id) {
29.         return bookService.getById(id);
30.     }
32.     // 创建书籍
33.     @PostMapping
34.     public void insert(@RequestBody Book book) {
35.         bookService.save(book);
36.     }
38.     // 更新书籍
39.     @PutMapping("/{id}")
40.     public void update(@PathVariable Long id, @RequestBody Book book) {
41.         book.setId(id);
42.         bookService.updateById(book);
43.     }
45.     // 删除书籍
46.     @DeleteMapping("/{id}")
47.     public void delete(@PathVariable Long id) {
48.         bookService.removeById(id);
49.     }
51.     // 分页查询书籍
52.     @GetMapping("/page")
53.     public IPage<Book> getBooksByPage(
54.             @RequestParam(defaultValue = "1") int pageNum, // 默认第 1 页
55.             @RequestParam(defaultValue = "10") int pageSize // 默认每页 10 条
56.     ) {
57.         Page<Book> page = new Page<>(pageNum, pageSize);
58.         return bookService.page(page);
59.     }
61.     // 根据名称搜索书籍
62.     @GetMapping("/search")
63.     public List<Book> search(@RequestParam String keyword) {
64.         QueryWrapper<Book> queryWrapper = new QueryWrapper<>();
65.         queryWrapper.like("name", keyword).or().like("author", keyword);
66.         return bookService.list(queryWrapper);
67.     }
68. }

复制代码

8. 创建数据库表

在 MySQL 中创建 books 表：

1. CREATE TABLE books (
2.     id BIGINT AUTO_INCREMENT PRIMARY KEY,
3.     name VARCHAR(100) NOT NULL,
4.     author VARCHAR(100) NOT NULL
5. );

复制代码

9. 运行项目

启动项目后，可以利用以下 API 进行测试：

• 获取所有书籍：
  bash
  复制
  
  1. curl http://localhost:8080/books

  复制代码
• 根据 ID 获取书籍：
  bash
  复制
  
  1. curl http://localhost:8080/books/1

  复制代码
• 创建书籍：
  bash
  复制
  
  1. curl -X POST -H "Content-Type: application/json" -d '{"name": "Spring Boot in Action", "author": "Craig Walls"}' http://localhost:8080/books

  复制代码
• 更新书籍：
  bash
  复制
  
  1. curl -X PUT -H "Content-Type: application/json" -d '{"name": "Spring Boot in Action (2nd Edition)", "author": "Craig Walls"}' http://localhost:8080/books/1

  复制代码
• 删除书籍：
  bash
  复制
  
  1. curl -X DELETE http://localhost:8080/books/1

  复制代码
• 分页查询书籍：
  bash
  复制
  
  1. curl http://localhost:8080/books/page?pageNum=1&pageSize=5

  复制代码
• 搜索书籍：
  bash
  复制
  
  1. curl http://localhost:8080/books/search?keyword=Spring

  复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。