我们在项目开发过程,经常会遇到有文章分类分栏,菜单分类,视频分类等多级分类
  
    
  
   那么这种多级分类我们在数据中又是如何设计的呢?在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) 
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 {
    
    private Integer parentId;
    
    private String parentName;
    
    private List<CategoryChildrenVo> childrenCategory;
 * FileName:    CategoryChildrenVo
 * Author:      小袁
 * Date:        2022/4/15 14:18
 * Description: 子分类
@Data
public class CategoryChildrenVo {
    
    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">
	
</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 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>
</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 进行接口测试,网上很多整合的教程,只需要加一个配置类就搞定了,一分钟就行,我这里附上吧
<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完美获取数据
或者直接在浏览器访问请求路径测试
都看到这里啦,点点赞呀😋
感谢阅读😘