我们在项目开发过程,经常会遇到有文章分类分栏,菜单分类,视频分类等多级分类

那么这种多级分类我们在数据中又是如何设计的呢?在mybatis查询过程中又是如何多级查询的呢?

别着急,今年我们来解决这个需求,

当然,解决的方法有很多,这里我只介绍我自己使用的一种,有更好的方法可以评论区评论大家一起探讨

本次用到了 Maven工程 Swagger RESTful接口风格 MyBatis-Plus

整体目录结构如下

二、问题需求

以文章分类为例(这里以二级分类举例,三级、四级甚至多级会了二级的之后可以自行思考)

博客项目中少不了文章分类,如下图所示,那么在数据库如何只使用一张表、一条SQL语句就能完美实现多级目录结构的存储和查询

三、数据库设计

我们需要设计三个字段

字段名 类型 注释
id int 这个不用说了吧,主键
name varchar 分类名称
parent_id int 指向父级分类的ID,如果是父级分类则填0,如果是子分类则填父级分类的ID

接下来我们在mysql中创建出来

四、SQL多级分类查询

不知道大家都有没有用过 join 这个关键字呢,想必大家都挺少用到的吧,忘记的同学记得先去补补 join 的知识哦

采用 left join 左拼接的查询方式,完整的查询语句如下:

SELECT x.id AS parentId, x.name AS parentName, y.id AS childrenId ,y.name AS childrenName
FROM xy_category AS x
LEFT JOIN xy_category AS y ON y.parent_id = x.id
WHERE x.parent_id = 0

查询结果如下(所有分类结构): 当然你也可以指定某个父级分类,查询它所有的子分类,只需要改变一下 where 的条件就行了 是不是就满足了我们的需求了呢,接下来我们在项目MyBatis-Plus中实现多级分类查询

查询SQL语句我们已经写出来了,难的是如何存储这样的结构数据,别着急慢慢来

五、项目结构搭建

先把完整结构创建完成,这个大家应该都很熟悉了吧

我这里使用的MyBatis-Plus,操作都差不多,用MyBatis也可以

(1)创建实体类

* FileName: Category * Author: 小袁 * Date: 2022/4/15 10:42 * Description: 分类实体 @Data @EqualsAndHashCode(callSuper = false) @Accessors(chain = true) // 调用Setting方法后 回传对象 public class Category { * 分类ID @TableId(value = "id", type = IdType.AUTO) private Integer id; * 分类栏目名称 private String name; * 父级栏目 private Integer parent_id;

(2)创建DAO

* FileName: CategoryMapper * Author: 小袁 * Date: 2022/4/15 10:52 * Description: 分类DAO @Repository public interface CategoryMapper extends BaseMapper<Category> { * 查询所有分类的目录结构 * @return List<CategoryParentVo> findCategoryList(); * 通过某个父级分类的ID查询该父级的所有子分类 * @param id * @return CategoryParentVo getCategoryById(Integer id);

(3)创建业务层

我这里把完整的增删改查全部放出来了,这是我之前做的博客项目,可自行删减 R 这个类是统一结果返回类,前后端分析基本都是这样操作,网上也有很多模板

service -- 接口
* FileName: CategoryService * Author: 小袁 * Date: 2022/4/15 10:52 * Description: 分类栏目 Service public interface CategoryService extends IService<Category> { * 新增分类栏目数据 * @param category * @return R insert(Category category); * 根据分类栏目的ID进行修改数据 * @param category * @return R modify(Category category); * 根据分类栏目的ID进行删除 * @param id * @return R remove(Integer id); * 通过某个父级分类的ID查询该父级的所有子分类 * @param id * @return R getCategoryById(Integer id); * 查询所有分类的目录结构 * @return R listCategory();
servieImpl -- 实现类
* FileName: CategoryServiceImpl * Author: 小袁 * Date: 2022/4/15 10:54 * Description: 分类栏目的实现类 @Service @Transactional public class CategoryServiceImpl extends ServiceImpl<CategoryMapper, Category> implements CategoryService { @Autowired private CategoryMapper categoryMapper; @Override public R insert(Category category) { return categoryMapper.insert(category) == 0 ? R.error() : R.ok(); @Override public R modify(Category category) { return categoryMapper.updateById(category) == 0 ? R.error() : R.ok(); @Override public R remove(Integer id) { QueryWrapper<Category> wrapper = new QueryWrapper<>(); wrapper.eq("id", id); wrapper.or(); wrapper.eq("parent_id", id); return categoryMapper.delete(wrapper) == 0 ? R.error() : R.ok(); @Override public R getCategoryById(Integer id) { CategoryParentVo categoryParentVo = categoryMapper.getCategoryById(id); return categoryParentVo == null ? R.error() : R.ok().data("category", categoryParentVo); @Override public R listCategory() { return R.ok().data("categoryList", categoryMapper.findCategoryList());

(4)控制层

这里我也是将所有的代码贴出来,自行需要删除

采用RESTful的接口风格,@Api相关的注解是 Swagger 的相关配置,用于接口测试,你用其他测试方法可以把这个删掉

* FileName: CategoryController * Author: 小袁 * Date: 2022/4/15 10:54 * Description: 分类栏目的控制层 @RestController @RequestMapping("/category") @Api(tags = "分类栏目控制层") public class CategoryController { @Autowired private CategoryService categoryService; * 新增分类栏目数据 * @param category * @return @PostMapping public R insertCategory(@RequestBody Category category) { return categoryService.insert(category); * 根据ID删除分类栏目 * @param id * @return @DeleteMapping("{id}") @ApiOperation(value = "根据ID删除所有子分类栏目(包括父级分类如果有)") public R removeCategoryById(@PathVariable(value = "id") Integer id) { return categoryService.remove(id); @PutMapping public R modifyCategoryById(@RequestBody Category category) { return categoryService.modify(category); * 查询所有分类的目录结构 * @return @GetMapping @ApiOperation(value = "查询所有分类的目录结构") public R getCategoryList() { return categoryService.listCategory(); * 根据ID获取对象 * @param id * @return @GetMapping("{id}") @ApiOperation(value = "根据ID获取对象") public R getCategoryById(@PathVariable(value = "id") Integer id) { return categoryService.getCategoryById(id);

六、Vo对象

一会接收SQL多级查询结果要用到的,也叫视图对象(View Object),返回给前端看的

* FileName: CategoryVo * Author: 小袁 * Date: 2022/4/15 14:16 * Description: @Data public class CategoryParentVo { // 父级分类编号ID private Integer parentId; // 父级分类名称 private String parentName; // 子分类 private List<CategoryChildrenVo> childrenCategory; * FileName: CategoryChildrenVo * Author: 小袁 * Date: 2022/4/15 14:18 * Description: 子分类 @Data public class CategoryChildrenVo { // ID编号 private Integer childrenId; // 分类栏目名称 private String childrenName;

七、MyBatis多级分类查询

(1)在resources目录下创建CategoryMapper.xml静态文件

用来写SQL语句的

别忘了在 application 加上mapper映射路径

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.xiaoyuan.back.db.dao.CategoryMapper">
	<!-- SQL语句 -->
</mapper>

(2)设计模式

回顾一下刚刚的数据格式,有点像什么?细心的同学已经发现了,没错,是不是和 JSON 数据格式有点类似?

将父级分类(Java、实战项目教学等)对应一个CategoryParentVo类

将每个父级分类的所有子分类对应一个List集合

每个CategoryParentVo有一个字分类的集合属性变量

看懂上面三句话就说明你已经掌握了,看不懂的结合创建Vo类看一下

(3)自定义返回类型模板(重点)

MyBatis的知识哦,不知道大伙忘了没?

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.xiaoyuan.back.db.dao.CategoryMapper">
    <!-- 自定义返回数据类型模板 -->
    <resultMap id="categoryMap" type="com.xiaoyuan.back.vo.CategoryParentVo">
        <!-- 父级分类(ID、分类名称) 单个 对象 -->
        <id property="parentId" column="parentId"></id>
        <result property="parentName" column="parentName"></result>
        <!-- 子分类(ID、分类名称) 多个 List集合 -->
        <collection property="childrenCategory" ofType="com.xiaoyuan.back.vo.CategoryChildrenVo" javaType="list">
            <id property="childrenId" column="childrenId"></id>
            <result property="childrenName" column="childrenName"></result>
        </collection>
    </resultMap>
</mapper>

(4)编写SQL

完整的CategoryMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.xiaoyuan.back.db.dao.CategoryMapper">
    <!-- 自定义返回数据类型模板 -->
    <resultMap id="categoryMap" type="com.xiaoyuan.back.vo.CategoryParentVo">
        <id property="parentId" column="parentId"></id>
        <result property="parentName" column="parentName"></result>
        <collection property="childrenCategory" ofType="com.xiaoyuan.back.vo.CategoryChildrenVo" javaType="list">
            <id property="childrenId" column="childrenId"></id>
            <result property="childrenName" column="childrenName"></result>
        </collection>
    </resultMap>
     查询所有分类的目录结构
     父级分类 ==>> 子分类
    <select id="findCategoryList" resultMap="categoryMap">
        select x.id as parentId, x.name as parentName, y.id as childrenId ,y.name as childrenName
        from xy_category x
        left join xy_category as y on y.parent_id = x.id
        where x.parent_id = 0
    </select>
    通过某个父级分类的ID查询该父级的所有子分类
    父级分类 ==>> 子分类
    <select id="getCategoryById" parameterType="int" resultMap="categoryMap">
        select x.id as parentId, x.name as parentName, y.id as childrenId ,y.name as childrenName
        from xy_category x
        left join xy_category as y on y.parent_id = x.id
        where x.id = #{id}
    </select>
</mapper>

八、Swagger接口测试

我这个项目整合了 Swagger 进行接口测试,网上很多整合的教程,只需要加一个配置类就搞定了,一分钟就行,我这里附上吧

<!-- Swagger -->
<dependency>
	<groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.7.0</version>
</dependency>
    <dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.7.0</version>
</dependency>
 * FileName:    SwaggerConfig
 * Author:      小袁
 * Date:        2022/3/11 19:09
 * Description:
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket webApiConfig(){
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("webApi")
                .apiInfo(webApiInfo())
                .select()
                .paths(Predicates.not(PathSelectors.regex("/admin/.*")))
                .paths(Predicates.not(PathSelectors.regex("/error.*")))
                .build();
    private ApiInfo webApiInfo(){
        return new ApiInfoBuilder()
                .title("Swagger接口测试")
                .description("小袁同学")
                .version("1.0")
                .contact(new Contact("Helen", "http://www.baidu.com", "1971788445@qq.com"))
                .build();

打开网页进行测试 执行查询所有分类的接口,测试结果如下,ok完美获取数据 或者直接在浏览器访问请求路径测试

  • 都看到这里啦,点点赞呀😋
  • 感谢阅读😘
  • 分类:
    后端
    标签: