• 三级分类的数据表设计和构造API数据

    诸如下图这种：

    一级菜单下有二级菜单和三级菜单。与此类似的应用场景还有很多很多，如省市县的三级联动、后台管理菜单、部门展示等等。

    一、数据表设计

    先看看表结构吧

    具体的 sql 文件，在贴的源码仓库中有。

    其中最重要的就是理清父子层级的关系就好了，知道是个什么样子设计的，如何去管理他们，那这些就都不是事啦。

    二级评论的表的设计方法其实也大致如此。

    数据表中对应的数据关系大致如下：

    二、项目代码

    技术就是常用的 SpringBoot、Mybatis-Plus

    另外还用了下Mybatis-Plus逆向生成器，还有Java的函数式编程

    3.1、导入依赖

    完整依赖如下：

    1.    <parent>
    2.         <groupId>org.springframework.bootgroupId>
    3.         <artifactId>spring-boot-dependenciesartifactId>
    4.         <version>2.5.2version>
    5.     parent>
    6.     <properties>
    7.         <maven.compiler.source>8maven.compiler.source>
    8.         <maven.compiler.target>8maven.compiler.target>
    9.     properties>
    10.     <dependencies>
    11.         <dependency>
    12.             <groupId>org.springframework.bootgroupId>
    13.             <artifactId>spring-boot-starterartifactId>
    14.         dependency>
    15.         <dependency>
    16.             <groupId>org.springframework.bootgroupId>
    17.             <artifactId>spring-boot-starter-webartifactId>
    18.         dependency>
    19.         <dependency>
    20.             <groupId>org.springframework.bootgroupId>
    21.             <artifactId>spring-boot-starter-testartifactId>
    22.         dependency>
    23.         <dependency>
    24.             <groupId>com.baomidougroupId>
    25.             <artifactId>mybatis-plus-boot-starterartifactId>
    26.             <version>3.4.1version>
    27.         dependency>
    28.         <dependency>
    29.             <groupId>com.alibabagroupId>
    30.             <artifactId>druid-spring-boot-starterartifactId>
    31.             <version>1.2.6version>
    32.         dependency>
    33.         <dependency>
    34.             <groupId>mysqlgroupId>
    35.             <artifactId>mysql-connector-javaartifactId>
    36.         dependency>
    37.  
    38.         
    39.         <dependency>
    40.             <groupId>org.springframework.bootgroupId>
    41.             <artifactId>spring-boot-configuration-processorartifactId>
    42.             <optional>trueoptional>
    43.         dependency>
    44.  
    45.         
    46.         <dependency>
    47.             <groupId>com.baomidougroupId>
    48.             <artifactId>mybatis-plus-generatorartifactId>
    49.             <version>3.4.1version>
    50.         dependency>
    51.         <dependency>
    52.             <groupId>org.apache.velocitygroupId>
    53.             <artifactId>velocity-engine-coreartifactId>
    54.             <version>2.2version>
    55.         dependency>
    56.         <dependency>
    57.             <groupId>org.projectlombokgroupId>
    58.             <artifactId>lombokartifactId>
    59.         dependency>
    60.         <dependency>
    61.             <groupId>junitgroupId>
    62.             <artifactId>junitartifactId>
    63.             <version>4.12version>
    64.         dependency>
    65.     dependencies>

    关于 Mybatis-plus 的版本，最新的那个逆向生成器不太熟，就用了旧版本的。感兴趣的可以去试一试新版本的。

    3.2、逆向生成代码

    1. import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
    2. import com.baomidou.mybatisplus.core.toolkit.StringPool;
    3. import com.baomidou.mybatisplus.generator.AutoGenerator;
    4. import com.baomidou.mybatisplus.generator.InjectionConfig;
    5. import com.baomidou.mybatisplus.generator.config.*;
    6. import com.baomidou.mybatisplus.generator.config.po.TableInfo;
    7. import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
    8. import com.baomidou.mybatisplus.generator.engine.VelocityTemplateEngine;
    9. import org.junit.platform.commons.util.StringUtils;
    10.  
    11. import java.util.ArrayList;
    12. import java.util.List;
    13. import java.util.Scanner;
    14.  
    15. // 演示例子，执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
    16. public class CodeGenerator {
    17.  
    18.     /**
    19.      * 
    20.      * 读取控制台内容
    21.      * 
    22.      */
    23.     public static String scanner(String tip) {
    24.         Scanner scanner = new Scanner(System.in);
    25.         StringBuilder help = new StringBuilder();
    26.         help.append("请输入" + tip + "：");
    27.         System.out.println(help.toString());
    28.         if (scanner.hasNext()) {
    29.             String ipt = scanner.next();
    30.             if (StringUtils.isNotBlank(ipt)) {
    31.                 return ipt;
    32.             }
    33.         }
    34.         throw new MybatisPlusException("请输入正确的" + tip + "！");
    35.     }
    36.  
    37.     public static void main(String[] args) {
    38.         // 代码生成器
    39.         AutoGenerator mpg = new AutoGenerator();
    40.  
    41.         // 全局配置
    42.         GlobalConfig gc = new GlobalConfig();
    43.         final String projectPath = System.getProperty("user.dir");
    44.         gc.setOutputDir(projectPath + "/src/main/java");
    45.         gc.setAuthor("nzc");
    46.         gc.setOpen(false);
    47.         // gc.setSwagger2(true); 实体属性 Swagger2 注解
    48.         mpg.setGlobalConfig(gc);
    49.  
    50.         // 数据源配置
    51.         DataSourceConfig dsc = new DataSourceConfig();
    52.         dsc.setUrl("jdbc:mysql://localhost:3306/task1?useUnicode=true&useSSL=false&characterEncoding=utf8");
    53.         // dsc.setSchemaName("public");
    54.         dsc.setDriverName("com.mysql.cj.jdbc.Driver");
    55.         dsc.setUsername("root");
    56.         dsc.setPassword("123456");
    57.         mpg.setDataSource(dsc);
    58.  
    59.         // 包配置
    60.         final PackageConfig pc = new PackageConfig();
    61.         pc.setModuleName(scanner("模块名"));
    62.         pc.setParent("com.nzc");
    63.         mpg.setPackageInfo(pc);
    64.  
    65.         // 自定义配置
    66.         InjectionConfig cfg = new InjectionConfig() {
    67.             @Override
    68.             public void initMap() {
    69.                 // to do nothing
    70.             }
    71.         };
    72.  
    73.         // 如果模板引擎是 freemarker
    74.         //String templatePath = "/templates/mapper.xml.ftl";
    75.         // 如果模板引擎是 velocity
    76.         String templatePath = "/templates/mapper.xml.vm";
    77.  
    78.         // 自定义输出配置
    79.         List focList = new ArrayList<>();
    80.         // 自定义配置会被优先输出
    81.         focList.add(new FileOutConfig(templatePath) {
    82.             @Override
    83.             public String outputFile(TableInfo tableInfo) {
    84.                 // 自定义输出文件名 ， 如果你 Entity 设置了前后缀、此处注意 xml 的名称会跟着发生变化！！
    85.                 return projectPath + "/src/main/resources/mapper/" + pc.getModuleName()
    86.                         + "/" + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
    87.             }
    88.         });
    89.         cfg.setFileOutConfigList(focList);
    90.         mpg.setCfg(cfg);
    91.  
    92.         // 配置模板
    93.         TemplateConfig templateConfig = new TemplateConfig();
    94.  
    95.         templateConfig.setXml(null);
    96.         mpg.setTemplate(templateConfig);
    97.  
    98.         // 策略配置
    99.         StrategyConfig strategy = new StrategyConfig();
    100.         strategy.setNaming(NamingStrategy.underline_to_camel);
    101.  
    102.         strategy.setColumnNaming(NamingStrategy.underline_to_camel);
    103.         strategy.setEntityLombokModel(true);
    104.         strategy.setRestControllerStyle(true);
    105.         // 公共父类
    106.         // 写于父类中的公共字段
    107.         strategy.setSuperEntityColumns("id");
    108.         strategy.setInclude(scanner("表名，多个英文逗号分割").split(","));
    109.         strategy.setControllerMappingHyphenStyle(true);
    110.         strategy.setTablePrefix("pms_");
    111.         mpg.setStrategy(strategy);
    112.         mpg.setTemplateEngine(new VelocityTemplateEngine());
    113.         mpg.execute();
    114.     }
    115.  
    116. }

    运行代码：

    执行结果

    默认里面是没有方法的话，不过用来写个基本的小demo是非常方便的。

    3.3、业务代码

    controller、mapper、entity都不是重点，一笔带过了哈。

    1. @RestController
    2. @RequestMapping("/category")
    3. public class CategoryController {
    4.  
    5.     @Autowired
    6.     ICategoryService categoryService;
    7.     /**
    8.      * 查询出所有的数据，以树形结构组装起来
    9.      * @return
    10.      */
    11.     @GetMapping("/tree")
    12.     public Result listTree() {
    13.         List entities= categoryService.listWithTree();
    14.         return ResultUtil.success(entities);
    15.     }
    16. }
    1. public interface CategoryMapper extends BaseMapper<Category> {
    2.  
    3. }
    1. @Data
    2. @EqualsAndHashCode(callSuper = false)
    3. @TableName("pms_category")
    4. public class Category implements Serializable {
    5.  
    6.     private static final long serialVersionUID = 1L;
    7.  
    8.     @TableId(value = "cat_id", type = IdType.AUTO)
    9.     private Long catId;
    10.  
    11.     private String name;
    12.  
    13.     private Long parentCid;
    14.  
    15.     private Integer catLevel;
    16.  
    17.     private Integer showStatus;
    18.  
    19.     private Integer sort;
    20.  
    21.     private String icon;
    22.  
    23.     private String productUnit;
    24.  
    25.     private Integer productCount;
    26.  
    27.     @TableField(exist = false)
    28.     private List<Category> categoryChild;
    29.  
    30. }
    1. public interface ICategoryService extends IService<Category> {
    2.  
    3.     /**
    4.      * 封装成三级菜单形式
    5.      * @return
    6.      */
    7.     List listWithTree();
    8. }

    真正的业务是在 serviceImpl 中

    1. @Service
    2. public class CategoryServiceImpl extends ServiceImpl, Category> implements ICategoryService {
    3.  
    4. //    @Autowired 
    5. //    CategoryMapper categoryMapper;
    6.  
    7.     @Override
    8.     public List<Category> listWithTree() {
    9.         //1、查询出所有的分类
    10.         List<Category> allCategory = baseMapper.selectList(null);
    11.         //2、组装成父子的树形结构
    12.         //2.1、找到所有的一级分类
    13.         List<Category> categoriesLevel1 = allCategory.stream()
    14.               // filter 方法就如名称一样，就是用来过滤的 
    15.               // 满足条件的会留下，到最后会返回一个流式对象
    16.                 .filter(category ->
    17.                         category.getParentCid() == 0
    18.                 )
    19.               // map 的理解百话点说就是可以对传入的对象做出修改 
    20.               // 这里的意思就是找出当前一级分类中的二级分类，然后再set进去
    21.                 // 最后再返回一个流式对象
    22.                 .map((menu) -> {
    23.                     menu.setCategoryChild(getChildrens(menu, allCategory));
    24.                     return menu;
    25.                 })
    26.               // 见名知意，这就是排序 ，其实也算是重定义Java比较器
    27.                .sorted((menu1, menu2) -> {
    28.                     return (menu1.getSort() == null ? 0 : menu1.getSort()) - (menu2.getSort() == null ? 0 : menu2.getSort());
    29.                 })
    30.               // 就是将流转换为带泛型的List对象
    31.                 .collect(Collectors.toList());
    32.         return categoriesLevel1;
    33.     }
    34.  
    35.     private List<Category> getChildrens(Category root, List<Category> all) {
    36.         // 这里的逻辑和上面一段是一样的，这里是构造三级、四级等等多层也是一样构造的
    37.         List<Category> collect = all.stream()
    38.                 .filter(category -> {
    39.                     return category.getParentCid().equals(root.getCatId());
    40.                 }).map((menu) -> {
    41.                     menu.setCategoryChild(getChildrens(menu, all));
    42.                     return menu;
    43.                 })
    44.                 .sorted((menu1, menu2) -> {
    45.                     return (menu1.getSort() == null ? 0 : menu1.getSort()) - (menu2.getSort() == null ? 0 : menu2.getSort());
    46.                 })
    47.                 .collect(Collectors.toList());
    48.         return collect;
    49.     }
    50. }

    还有一些公共代码和配置文件什么的，在仓库中都是有的，这里不再重复贴出来啦。

    3.4、测试结果

    我就是使用 Postman 测试的，没有专门画前端，前端太弱鸡啦，求大佬们放过...

    源码：github，gitee

    三、总结

    真正到了工作的时候，你会发现你写代码和平常还是会有很大差别的，最主要就是体现在业务场景这个方面。

    写 Demo 的时候，主要就想着能写出个 Demo 就不错了，但实际上真到了该上业务的时候，综合起来还是有很多值得思考的问题。

    在学习的时候针对一些必要的技术还是可以往深里挖掘挖掘的，并且自己也要学会根据现学的东西想到应用场景，思考如何整合项目，那些地方还有不足的，项目的扩展性如何等等，这些可以不用实现，但是在学习的时候能够多一些思考，这对于学习一个新技术是很有必要的

  • 相关阅读:
    系列七、栈 & 堆
    接口测试vs功能测试
    文字悬停效果
    4.力扣c++刷题--＞删除有序数组中的重复项 II
    GEE——利用map函数获取指定时间范围内年份月份日期内的所有影像并求降水平均值
    曼孚科技入选IDC中国数据智能市场代表厂商
    DS线性表—多项式相加 C++
    SpringCloud 客户端负载均衡：Ribbon
    快速入门C++正则表达式
    RocketMQ生产者原理及最佳实践
  • 原文地址：https://blog.csdn.net/weixin_62421895/article/details/126118026