2024-01-27发表2024-08-11更新 Xiamu SpringBoot3 / MyBatisPlus7 分钟读完 (大约1002个字)

在我们的教程中，我们设计了一个课程内容的数据结构，包含章节和相关资源。这种结构非常适合在线教育平台或电子学习系统，其中课程内容需要被组织成不同的章节和子章节，每个子章节可能关联特定的学习资源。

这将是一个很好的示例来展示 MyBatis 中如何使用一对多（<collection>）和一对一（<association>）映射。

一、业务背景

1. 数据库表结构

章节表 (chapter)
这张表包含所有章节的信息，其中包括大章节和小章节。大章节作为容器，可以包含多个小章节。
- id (章节ID)
- parent_id (父章节ID，用于区分大章节和小章节)
- name (章节名称)
- courseId (课程ID)

language-java

public class Chapter {
   
    private Long id;
    private Long parentId;
    private String name;
    private Long courseId;
}

资源表 (resource)
这张表包含与小章节相关联的资源信息。
- id (资源ID)
- section_id (章节ID，关联到章节表)
- name (资源名称)

language-java

public class Resource {
   
    private Long id;
    private Long sectionId;
    private String name;
}

2. 需求

要求根据courseId查询出指定课程的信息，包括大章节、小章节、资源，并以一定结构返回，比如

language-json

[
    {
   
        "id": 1,
        "parentId": null,
        "name": "Chapter 1",
        "courseId": 100,
        "subChapters": [
            {
   
                "id": 11,
                "parentId": 1,
                "name": "Section 1.1",
                "courseId": 100,
                "resource": {
   
                    "id": 101,
                    "sectionId": 11,
                    "name": "Introduction Video"
                }
            },
            {
   
                "id": 12,
                "parentId": 1,
                "name": "Section 1.2",
                "courseId": 100,
                "resource": null
            }
        ],
        "resource": null
    }
    // other...
]

所以我们定义一个Dto如下

language-java

public class ChapterDto extends Chapter {
   
    private List<ChapterDto> subChapters;
    private Resource resource;

    // 构造器、getter和setter
}

二、使用映射直接得到指定结构

在 ChapterMapper.xml 文件中，我们定义 SQL 查询以及结果映射。

language-xml

<mapper namespace="com.example.mapper.ChapterMapper">

    <resultMap id="ChapterDtoMap" type="com.example.dto.ChapterDto">
        <id column="chapter_id" property="id" />
        <result column="parent_id" property="parentId" />
        <result column="name" property="name" />
        <result column="courseId" property="courseId" />
        <collection property="subChapters" ofType="com.example.dto.ChapterDto">
            <id column="sub_chapter_id" property="id" />
            <result column="sub_parent_id" property="parentId" />
            <result column="sub_name" property="name" />
            <result column="sub_courseId" property="courseId" />
            <association property="resource" javaType="com.example.model.Resource">
                <id column="resource_id" property="id" />
                <result column="section_id" property="sectionId" />
                <result column="resource_name" property="name" />
            </association>
        </collection>
    </resultMap>

    <select id="selectChaptersWithResources" resultMap="ChapterDtoMap">
        SELECT
            c.id AS chapter_id, c.parent_id, c.name, c.courseId,
            sc.id AS sub_chapter_id, sc.parent_id AS sub_parent_id, sc.name AS sub_name, sc.courseId AS sub_courseId,
            r.id AS resource_id, r.section_id, r.name AS resource_name
        FROM
            chapter c
        LEFT JOIN
            chapter sc ON c.id = sc.parent_id
        LEFT JOIN
            resource r ON sc.id = r.section_id
        WHERE
            c.courseId = #{courseId} AND c.parent_id IS NULL
    </select>

</mapper>

三、其他文件

1. Mapper

language-java

public interface ChapterMapper {
   
    List<ChapterDto> selectChaptersWithResources(Long courseId);
}

2. Service

language-java

@Service
public class ChapterService {
   
    @Autowired
    private ChapterMapper chapterMapper;

    public List<ChapterDto> getChaptersWithResources(Long courseId) {
   
        return chapterMapper.selectChaptersWithResources(courseId);
    }
}

3. Controller

language-java

@RestController
@RequestMapping("/chapters")
public class ChapterController {
   
    @Autowired
    private ChapterService chapterService;

    @GetMapping("/{courseId}")
    public ResponseEntity<List<ChapterDto>> getChapters(@PathVariable Long courseId) {
   
        List<ChapterDto> chapters = chapterService.getChaptersWithResources(courseId);
        return ResponseEntity.ok(chapters);
    }
}

四、概念理解

一级映射

在提供的 resultMap 中，一级映射是针对 ChapterDto类的直接属性的映射。这意味着数据库中的列（如 chapter_id, parent_id等）直接映射到 ChapterDto类的相应属性（如 id, parent_id等），这部分映射是非常直接的。

二级映射

二级映射用于处理复杂的对象关系，比如当一个对象包含其他对象或对象的集合时。这通常在处理一对多关系时出现，例如，一个章节结构（ChapterDto）可能包含多个子章节。

聚合

这种聚合是根据您在 <collection> 标签中定义的规则进行的。MyBatis 会识别哪些行应该被映射为独立的实例，哪些行应该作为子元素聚合到其他实例中。

五、标签使用

1. 标签

用途：用于映射一对多关系。在这个例子中，ChapterDto类包含一个 Chapter 类型的列表，这代表了大章节和小章节之间的一对多关系。

常用属性：

property：指定要映射到的目标属性名称。
ofType：指定集合中元素的类型。

2. 标签

用途：用于映射一对一关系。在您的例子中，ChapterDto包含一个 Resource 类型的属性，这代表了小章节和资源之间的一对一关系。
常用属性：

property：指定要映射到的目标属性名称。
javaType：指定关联对象的类型。

2024-01-23发表2024-08-11更新 Xiamu SpringBoot3 / MyBatisPlus1 分钟读完 (大约187个字)

SpringBoot3整合MyBatisPlus

一、起因

随着SpringBoot3的发布，mybatisplus也在不断更新以适配spirngboot3 。目前仍然处于维护升级阶段，最初2023.08时，官方宣布对SpringBoot3的原生支持，详情看这里。

但是对于较新版本的SpringBoot3，仍然有很多bug，甚至无法启动，摸爬滚打又游历社区后，实践后得到一套成功的版本搭配，具体如下

	Version
Java	17
Spring Boot	3.2.1
Spring Cloud	2023.0.0
Mybatis Plus	`3.5.5`

二、引入依赖

language-xml

<dependency>
             <groupId>com.baomidou</groupId>
             <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
             <version>3.5.5</version>
         </dependency>

同时官方也提供了Demo项目，详情看这里，里面使用的版本搭配如下

	Version
Java	17
Spring Boot	3.2.0
Mybatis Plus	3.5.5-SNAPSHOT

一、业务背景

1. 数据库表结构

2. 需求

二、使用映射直接得到指定结构

三、其他文件

1. Mapper

2. Service

3. Controller

四、概念理解

一级映射

二级映射

聚合

五、标签使用

1. 标签

2. 标签

一、起因

二、引入依赖

分类

标签

最新文章

归档