• 基于若依框架进行二次开发优化指南

     背景

    若依（RuoYi）开源框架是一个功能强大的Java开发框架，专注于快速构建企业级后台管理系统。它提供了一套丰富的功能和模块，可以帮助开发人员快速搭建稳定、高效的管理系统。本篇博客将大家了解若依框架的基本概念和使用方法，帮助您快速上手。

    系统需求

    • JDK >= 1.8
      MySQL >= 5.7
      Maven >= 3.0
      Node >= 12
      Redis >= 3

    这里是若依官网，还有在线演示 

    具体的若依介绍，大家可以看官网或者这篇文章：

    https://blog.csdn.net/weixin_49185262/article/details/131448994

    我主要说一下基于若依快速二次开发的方法，给自己做个记录，若有不对的地方欢迎指出批评，过程中的相关的代码都是示例代码，大家仅供参考！

    想基于若依快速开发，但是若依有一些能力规范还不够全面，所以需要稍微处理一下，接下来把需要修改的几点罗列一下

    一、修改配置

    1、mybatis-plus 适配

    关于Mybatis-plus的使用，大家可以参考我的这篇文章：

    使用Mybatis-plus清空表数据_mybatisplus删除表所有内容_Alex_81D的博客-CSDN博客

    1.1 添加pom

    1. <dependency>
    2. 	<groupId>com.baomidou</groupId>
    3. 	<artifactId>mybatis-plus-boot-starter</artifactId>
    4. 	<version>3.4.2</version>
    5. </dependency>

    1.2 修改配置类

    增加 MybatisPlusConfig.java，并注释掉 MyBatisConfig

    内容如下：

    1. package com.ruoyi.framework.config;
    2.  
    3. import com.baomidou.mybatisplus.annotation.DbType;
    4. import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
    5. import com.baomidou.mybatisplus.extension.plugins.inner.BlockAttackInnerInterceptor;
    6. import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
    7. import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
    8. import org.springframework.context.annotation.Bean;
    9. import org.springframework.context.annotation.Configuration;
    10. import org.springframework.transaction.annotation.EnableTransactionManagement;
    11.  
    12. /**
    13.  * Mybatis Plus 配置
    14.  */
    15. @EnableTransactionManagement(proxyTargetClass = true)
    16. @Configuration
    17. public class MybatisPlusConfig
    18. {
    19.     @Bean
    20.     public MybatisPlusInterceptor mybatisPlusInterceptor()
    21.     {
    22.         MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    23.         // 分页插件
    24.         interceptor.addInnerInterceptor(paginationInnerInterceptor());
    25.         // 乐观锁插件
    26.         interceptor.addInnerInterceptor(optimisticLockerInnerInterceptor());
    27.         // 阻断插件
    28.         interceptor.addInnerInterceptor(blockAttackInnerInterceptor());
    29.         return interceptor;
    30.     }
    31.  
    32.     /**
    33.      * 分页插件，自动识别数据库类型 https://baomidou.com/guide/interceptor-pagination.html
    34.      */
    35.     public PaginationInnerInterceptor paginationInnerInterceptor()
    36.     {
    37.         PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor();
    38.         // 设置数据库类型为mysql
    39.         paginationInnerInterceptor.setDbType(DbType.MYSQL);
    40.         // 设置最大单页限制数量，默认 500 条，-1 不受限制
    41.         paginationInnerInterceptor.setMaxLimit(-1L);
    42.         return paginationInnerInterceptor;
    43.     }
    44.  
    45.     /**
    46.      * 乐观锁插件 https://baomidou.com/guide/interceptor-optimistic-locker.html
    47.      */
    48.     public OptimisticLockerInnerInterceptor optimisticLockerInnerInterceptor()
    49.     {
    50.         return new OptimisticLockerInnerInterceptor();
    51.     }
    52.  
    53.     /**
    54.      * 如果是对全表的删除或更新操作，就会终止该操作 https://baomidou.com/guide/interceptor-block-attack.html
    55.      */
    56.     public BlockAttackInnerInterceptor blockAttackInnerInterceptor()
    57.     {
    58.         return new BlockAttackInnerInterceptor();
    59.     }
    60. }

     1.3 修改配置文件

    增加如下配置，并注释掉原来的mybatis的配置信息

    1. # MyBatis Plus配置
    2. mybatis-plus:
    3.   configuration:
    4.     map-underscore-to-camel-case: true
    5.     log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
    6.   # 搜索指定包别名
    7.   typeAliasesPackage: com.ruoyi.**.domain
    8.   # 配置mapper的扫描，找到所有的mapper.xml映射文件
    9.   mapperLocations: classpath*:mapper/**/*Mapper.xml

     至此，mybatis-plus改造完成

    2.增加 lombok

    pom文件内容如下：

    2. 	org.projectlombok
    3. 	lombok
    4. 	1.18.24

    3.mysql版本调整

    这步有需要调整，没需要可以不调整：在ruoyi-admin/pom.xml
     

    3.     mysql
    4.     mysql-connector-java
    5.     5.1.16
    6.     runtime

    4.增加Knife4j

    Knife4j的前身是swagger-bootstrap-ui，可以让swagger显示更加优美

    4.1 修改pom

    3. 	com.github.xiaoymin
    4. 	knife4j-spring-boot-starter
    5. 	3.0.3

    4.2 修改配置 

    在SwaggerConfig中修改内容

    1. /**
    2.  * 创建API
    3.  */
    4. @Bean
    5. public Docket createRestApi()
    6. {
    7. 	return new Docket(DocumentationType.OAS_30)
    8. 			// 是否启用Swagger
    9. 			.enable(enabled)
    10. 			// 用来创建该API的基本信息，展示在文档的页面中（自定义展示的信息）
    11. 			.apiInfo(apiInfo())
    12. 			// 设置哪些接口暴露给Swagger展示
    13. 			.select()
    14. 			// 扫描所有有注解的api，用这种方式更灵活
    15. 			//.apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
    16. 			// 扫描指定包中的swagger注解
    17. 			// .apis(RequestHandlerSelectors.basePackage("com.ruoyi.project.tool.swagger"))
    18. 			// 扫描所有
    19. 			.apis(RequestHandlerSelectors.any())
    20. 			.paths(PathSelectors.any())
    21. 			.build()
    22. 			/* 设置安全模式，swagger可以设置访问token */
    23. 			.securitySchemes(securitySchemes())
    24. 			.securityContexts(securityContexts())
    25. 			.pathMapping(pathMapping);
    26. }

     4.3 前端改法

     来看效果：

     是不是比一开始的时候好一点

    对比一下：

    修改的先写这么多，基本上够用了

    二、开发说明

    1.XxxController

    1. /**
    2.  * @Author
    3.  * @Description 
    4.  * @Version 1.0
    5.  */
    6. @RestController
    7. @RequestMapping("/freight/freight")
    8. public class FreightBillController extends BaseController {
    9.  
    10.     @Autowired
    11.     private FreightBillService freightBillService;
    12.  
    13.     @PostMapping("/selectFreightBillList")
    14.     public TableDataInfo selectFreightBillList(@RequestBody FreightBillDTO freightBill)
    15.     {
    16.         startPage();
    17.         List areaList = freightBillService.selectFreightBillList(freightBill);
    18.         return getDataTable(areaList);
    19.     }
    20.  
    21.     @GetMapping("/selectFreightBillById/{id}")
    22.     public AjaxResult selectFreightBillById(@PathVariable("id") Long id)
    23.     {
    24.         FreightBill freightBill = freightBillService.selectFreightBillById(id);
    25.         return AjaxResult.success(freightBill);
    26.     }
    27.  
    28.     /**
    29.      * 导出【请填写功能名称】列表
    30.      */
    31.     @Log(title = "导出", businessType = BusinessType.EXPORT)
    32.     @PostMapping("/export")
    33.     @ResponseBody
    34.     public AjaxResult export(@RequestBody FreightBillDTO freightBill)
    35.     {
    36.         List list = freightBillService.selectFreightBillList(freightBill);
    37.         ExcelUtil util = new ExcelUtil(FreightBill.class);
    38.         return util.exportExcel(list, "XX数据");
    39.     }
    40.  
    41.     /**
    42.      * 新增保存
    43.      */
    44.     @Log(title = "XX新增", businessType = BusinessType.INSERT)
    45.     @PostMapping("/add")
    46.     @ResponseBody
    47.     public AjaxResult addSave(@RequestBody FreightBillDTO freightBill)
    48.     {
    49.         freightBillService.insertFreightBill(freightBill);
    50.         return success();
    51.     }
    52.  
    53.     /**
    54.      * 修改保存
    55.      */
    56.     @Log(title = "修改XX", businessType = BusinessType.UPDATE)
    57.     @PostMapping("/updateFreightBill")
    58.     @ResponseBody
    59.     public AjaxResult updateFreightBill(@RequestBody FreightBillDTO freightBill)
    60.     {
    61.         freightBillService.updateFreightBill(freightBill);
    62.         return success();
    63.     }
    64.  
    65.     /**
    66.      * 删除
    67.      */
    68.     @Log(title = "删除XX", businessType = BusinessType.DELETE)
    69.     @PostMapping( "/deleteFreightBillByIds")
    70.     @ResponseBody
    71.     public AjaxResult deleteFreightBillByIds(String ids)
    72.     {
    73.         freightBillService.deleteFreightBillByIds(ids);
    74.         return success();
    75.     }
    76.  
    77.     /**
    78.      * 删除
    79.      */
    80.     @Log(title = "删除XX", businessType = BusinessType.DELETE)
    81.     @PostMapping( "/deleteFreightBillById")
    82.     @ResponseBody
    83.     public AjaxResult deleteFreightBillById(Long id)
    84.     {
    85.         freightBillService.deleteFreightBillById(id);
    86.         return success();
    87.     }
    88.  
    89. }

    2.XxService

    1. /**
    2.  * @Author 
    3.  * @Description TODO
    4.  * @Version 1.0
    5.  */
    6. public interface FreightBillService extends IService {
    7.  
    8.     /**
    9.      * 根据id查询数据
    10.      *
    11.      * @param id
    12.      * @return
    13.      */
    14.     public FreightBill selectFreightBillById(Long id);
    15.  
    16.  
    17.     /**
    18.      * 查询接口
    19.      * @param freightBill
    20.      * @return
    21.      */
    22.     List selectFreightBillList(FreightBillDTO freightBill);
    23.  
    24.  
    25.     /**
    26.      * 新增【请填写功能名称】
    27.      *
    28.      * @param freightBill 【请填写功能名称】
    29.      * @return 结果
    30.      */
    31.     void insertFreightBill(FreightBillDTO freightBill);
    32.  
    33.     /**
    34.      * 修改【请填写功能名称】
    35.      *
    36.      * @param freightBill 【请填写功能名称】
    37.      * @return 结果
    38.      */
    39.     void updateFreightBill(FreightBillDTO freightBill);
    40.  
    41.     /**
    42.      * 批量删除【请填写功能名称】
    43.      *
    44.      * @param ids 需要删除的【请填写功能名称】主键集合
    45.      * @return 结果
    46.      */
    47.     void deleteFreightBillByIds(String ids);
    48.  
    49.     /**
    50.      * 删除【请填写功能名称】信息
    51.      *
    52.      * @param id 【请填写功能名称】主键
    53.      * @return 结果
    54.      */
    55.     boolean deleteFreightBillById(Long id);
    56. }

    3.XxServiceImpl

    1. @Service
    2. public class FreightBillServiceImpl extends ServiceImpl implements FreightBillService {
    3.  
    4.     /**
    5.      * 查询接口
    6.      *
    7.      * @param freightBill
    8.      * @return
    9.      */
    10.     @Override
    11.     public List selectFreightBillList(FreightBillDTO freightBill) {
    12.         //根据条件查询数据信息
    13.         LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>();
    14.         queryWrapper.eq(FreightBill::getEnableFlag, "0");
    15.         List freightBillList = this.list(queryWrapper);
    16.         return freightBillList;
    17.     }
    18.  
    19.     /**
    20.      * 查询
    21.      */
    22.     @Override
    23.     public FreightBill selectFreightBillById(Long id) {
    24.         LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>();
    25.         queryWrapper.eq(FreightBill::getEnableFlag, "0");
    26.         queryWrapper.eq(FreightBill::getId, id);
    27.         FreightBill freightBill = this.getOne(queryWrapper);
    28.         return freightBill;
    29.     }
    30.  
    31.     /**
    32.      * 新增
    33.      *
    34.      * @return 结果
    35.      */
    36.     @Override
    37.     @Transactional(rollbackFor = Exception.class)
    38.     public void insertFreightBill(FreightBillDTO freightBillDTO) {
    39.         FreightBill freightBill = new FreightBill();
    40.         BeanUtils.copyProperties(freightBillDTO, freightBill);
    41.         freightBill.setEnableFlag("0");
    42.         //将当前用户插入表中
    43.         SysUser useId = ShiroUtils.getSysUser();
    44.         freightBill.setUserId(useId.getUserId());
    45.         freightBill.setUserName(useId.getUserName());
    46.         this.save(freightBill);
    47.     }
    48.  
    49.     /**
    50.      * 修改
    51.      *
    52.      * @return 结果
    53.      */
    54.     @Override
    55.     @Transactional(rollbackFor = Exception.class)
    56.     public void updateFreightBill(FreightBillDTO freightBillDTO) {
    57.         Long id = freightBillDTO.getId();
    58.         FreightBill freightBill = this.selectFreightBillById(id);
    59.  
    60.         if (!ObjectUtils.isEmpty(freightBill)) {
    61.             BeanUtils.copyProperties(freightBillDTO, freightBill);
    62.             updateById(freightBill);
    63.         } else {
    64.             throw new ServiceException("数据不存在！");
    65.         }
    66.     }
    67.  
    68.     /**
    69.      * 批量删除
    70.      *
    71.      * @return 结果
    72.      */
    73.     @Override
    74.     @Transactional(rollbackFor = Exception.class)
    75.     public void deleteFreightBillByIds(String ids) {
    76.         Long[] freightBillids = Convert.toLongArray(ids);
    77.         for (Long freightBillid : freightBillids) {
    78.             this.deleteFreightBillById(freightBillid);
    79.         }
    80.     }
    81.  
    82.     /**
    83.      * 删除
    84.      *
    85.      * @return 结果
    86.      */
    87.     @Override
    88.     @Transactional(rollbackFor = Exception.class)
    89.     public boolean deleteFreightBillById(Long id) {
    90.         boolean deleteFlag = false;
    91.         FreightBill freightBill = this.selectFreightBillById(id);
    92.         if (!ObjectUtils.isEmpty(freightBill)) {
    93.             freightBill.setEnableFlag("2");
    94.             deleteFlag = updateById(freightBill);
    95.         } else {
    96.             throw new ServiceException("数据不存在！");
    97.         }
    98.         return deleteFlag;
    99.     }
    100. }

    4. XxMapper

    1. /**
    2.  * @Author 
    3.  * @Description TODO
    4.  * @Version 1.0
    5.  */
    6. public interface FreightBillMapper extends BaseMapper {
    7. }

    这里有需要复杂sql操作了，可以在这里写，然后service中引用，我这里给的是极简的示例，仅供参考！

    5.XxVO

    1. /**
    2.  * @Author 
    3.  * @Description TODO
    4.  * @Version 1.0
    5.  */
    6. @Data
    7. @TableName("freight_bill")
    8. public class FreightBill {
    9.  
    10.     private static final long serialVersionUID = 1L;
    11.  
    12.     /** 主键 */
    13.     @TableField("id")
    14.     @TableId(type= IdType.AUTO)
    15.     private Long id;
    16.  
    17.     /** XX */
    18.     @Excel(name = "车辆类型")
    19.     @TableField("cartype")
    20.     private String cartype;
    21. 	
    22. }

    基本上就是这么用的，仅供参考啊

    三、PostMan调用示例

    备注：我用的单机版做的示例，按照自己的版本进行调整

    把页面上的cookie拿过来放到headers中通过权限校验

     

     调用完成！

  • 相关阅读:
    SAP Business One二次开发：解锁潜力，实现定制化需求
    【LangChain学习之旅】—（11） 记忆：通过Memory记住用户上次的对话细节
    springboot基于微信小程序的宿舍管理系统毕业设计源码
    ffmpeg转YUV打死都不行
    淘宝/天猫API接口，item_sku - 淘宝商品SKU详细信息查询，淘宝/天猫获取sku详细信息 API 返回值说明
    qt 使用qt_material库打包报错 ImportError: cannot import name ‘uic‘ from ‘PyQt5‘
    kuangbin专题一 简单搜索
    UT_hash实现增删改查
    10 个鲜为人知的 Python 可视化概念和技巧
    问道管理：历史市净率在哪看？
  • 原文地址：https://blog.csdn.net/Alex_81D/article/details/132090289