若依项目阅读记录

前言

项目源码地址

2020/11/20

商品管理demo

目标：实现导入电子表格文件自动解析导入商品（导入功能），并且显示是可以显示图片 实际完成情况：大部分完成，原本想电子表格存图片，读取的时候上传到图床返回url，后来没实现，直接在表格用url了。

1. 创建商品表

create table gok_goods
(
    id                int auto_increment comment 'id'
    primary key,
    good_id           varchar(20)  null comment '商品编号',
    good_name         varchar(50)  null comment '商品名称',
    good_price        decimal      null comment '商品价格',
    good_image        varchar(100) null comment '商品图片',
    good_created_time datetime     null comment '商品生产日期',
    good_status       int          null comment '商品状态'
)
    comment '商品表';

2. 代码生成

• 创建商品菜单

• 导入表，编辑信息

• 生成代码，导入项目

3. 项目模块配置

• 依赖配置

<!--  在ruoyi-admin的pom.xml配置新模块依赖  -->
<dependency>
    <groupId>com.ruoyi</groupId>
    <artifactId>rouyi-goods</artifactId>
    <version>4.5.0</version>
</dependency>

<!--  在ruoyi-goods的pom.xml配置通用依赖  -->
<!-- 通用工具-->
<dependency>
    <groupId>com.ruoyi</groupId>
    <artifactId>ruoyi-common</artifactId>
</dependency>

4.界面优化

• 配置导入功能

//bootstrap-table中添加两个参数
importUrl: prefix + "/importData",
importTemplateUrl: prefix + "/importTemplate",

• 配置文件导入模板脚本

<script id="importTpl" type="text/template">
         <form enctype="multipart/form-data" class="mt20 mb10">
             <div class="col-xs-offset-1">
                 <input type="file" id="file" name="file"/>
                 <div class="mt10 pt5">
                     <input type="checkbox" id="updateSupport" name="updateSupport" title="如果数据已经存在，更新这条数据。"> 是否更新已经存在的数据
                     &nbsp;    <a onclick="$.table.importTemplate()" class="btn btn-default btn-xs"><i class="fa fa-file-excel-o"></i> 下载模板</a>
                 </div>
                 <font color="red" class="pull-left mt10">
                     提示：仅允许导入“xls”或“xlsx”格式文件！
                 </font>
             </div>
         </form>
     </script>

• 配置导入按钮显示

{
    field: 'goodImage',
    title: '商品图片',
    formatter: function (value,row,index) {
        var s = [];
        if(row.goodImage!=null){
            var url = row.goodImage;
            s.push('<a class = "view"  href="javascript:void(0)"><img style="width:100px;height:100px;"  src="'+url+'" /></a>');
        }
        return s.join('');
    },

• 后台controller(去除了shiro)

@Log(title = "商品", businessType = BusinessType.IMPORT)
@PostMapping("/importData")
@ResponseBody
public AjaxResult importData(MultipartFile file, boolean updateSupport) throws Exception
{
    ExcelUtil<GokGoods> util = new ExcelUtil<GokGoods>(GokGoods.class);
    List<GokGoods> goodList = util.importExcel(file.getInputStream());
    String message = gokGoodsService.importGoods(goodList, updateSupport);
    return AjaxResult.success(message);
}

5. 效果

2020/11/17

1. 前端精读

bootstrap-table

今天主要对bootstrap-table进行了解，大致了解了一些基本功能

• 数据表格
• 自动分页
• 其他参数（获取数据、获取元素....）

大多是一些钩子

2. 完善订单CRUD

自动代码生成

看了一下生成的流程，大致摸清了一个思路，用的是velocity

感觉底层原理就是反射，之前做个一个小例子就是自定义注解生成sql语句，感觉大致思路都是一样的，目的就是把java代码看成一个对象，然后获取里面的内容，实现拼接，难点就在于定制化的拼接（需要考虑缜密，需要具有普适性）

3. 提交git

成功提交

2020/11/16

创建订单模块CRUD

1. 创建数据库表gok_order

create table gok_order
(
    id                int auto_increment comment 'id'
        primary key,
    order_id          varchar(64)  not null comment '订单号',
    order_content     varchar(255) not null comment '订单内容',
    order_amount      varchar(20)  not null comment '订单金额',
    order_create_time date         not null comment '订单创建时间',
    order_paid_time   date         not null comment '订单支付时间',
    user_id           int          not null comment '订单消费人',
    order_status      int          not null comment '订单状态',
    constraint gok_order_order_id_uindex
        unique (order_id)
)
    comment '订单表';

2. 利用若依提供的代码生成工具生成对应代码

• 导入表及结构

• 编辑配置相关信息，生成代码
• 解压并添加文件到对应项目结构
  • 将生成的controller放到ruoyi-admin的controller文件夹下
  • 将生成的domain、service、mapper放到ruoyi-system的对应文件夹下
  • 将生成的resources放到ruoyi-admin的resources文件夹下
• 重启项目，查看是否嵌入进去
  • 失败，发现没有显示
  • 失败原因：只生成了业务代码，前端没有展示
  • 解决方案：菜单管理--系统管理--添加新的菜单管理项（“gok订单管理”）

• 检测功能是否完成

  • 失败，发现页面报错

  org.thymeleaf.exceptions.TemplateInputException: Error resolving template [system/order/order], template might not exist or might not be accessible by any of the configured Template Resolvers

  • 失败原因：渲染路径错误，多了一个order
  • 解决方案：检查路径（无错误）；检查target发现没有对应文件，rebulid重新构建项目

• 功能测试

  

前端页面阅读笔记（user.html）

• 引入thymeleaf
• 引入shiro

<html lang="zh" xmlns:th="http://www.thymeleaf.org" xmlns:shiro="http://www.pollix.at/thymeleaf/shiro">

• th:include：只插入片段的内容

<th:block th:include="include :: header('用户列表')" />
<!--往当前页面插入include.html中的一个叫做header的片段th:fragment -->

半程自我总结

1. 项目整体认知

• 还处于比较模糊的理解阶段

• 模块有点多，理解起来比较吃力

  • mybaits中的mapper
  • template中的渲染
  • 导入、导出、字典等功能整合起来不知如何下手

  2020/11/15

  略读“前端手册”模块

  • 前端比较看不懂

  找到用户管理的CRUD实现

  定位

  • 全局搜索user，定位到ruoyi-admin模块web.controller.system下的SysUserController

  简单分析

  • 与之关联的service：用户、角色、岗位、密码
  • @RequiresPermissions("system:user:view")：shiro注解
  • @Log(title = "用户管理", businessType = BusinessType.EXPORT)：自定义的日志
  • .stream().filter(r -> !r.isAdmin())：java8新特性

  理清CRUD实现逻辑

  • 添加用户
    • 弹出新增用户页面，填充信息，跳转新增页面
    • 参数校验，shiro加盐，存入数据库
  • 删除用户
    • 按照id删除（假删）
  • 修改用户
    • 类似添加用户
  • 查找用户

2020/11/14

略读若依"后台手册"

• 分页：pagehelper
• 导入导出：自定义注解@Excel
• 权限注解
• 事务处理
• 异常处理@ControllerAdvice

理清项目结构模块

后台服务主要在ruoyi-admin模块下

对照昨天的项目模块分析即可

寻找项目入口，debug调试

1. 页面入口

2. 登陆成功后，会根据权限初始化主页内容

2020/11/13

目标分解

搭建项目本地运行环境

• maven环境
• jdk环境
• 大多都是maven依赖，配置难度较小

部署运行本地项目

• 从码云下载项目压缩包，本地解压导入
• 根据sql文件创建本地数据库ry
• 修改项目数据库配置信息

master:
    url: jdbc:mysql://localhost:3306/ry?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: ****

• 运行项目（本地成功部署）

阅读若依系统官方手册"项目模块介绍"

• 文件结构（模块化）

com.ruoyi     
├── common            // 工具类
│       └── annotation                    // 自定义注解
│       └── config                        // 全局配置
│       └── constant                      // 通用常量
│       └── core                          // 核心控制
│       └── enums                         // 通用枚举
│       └── exception                     // 通用异常
│       └── json                          // JSON数据处理
│       └── utils                         // 通用类处理
│       └── xss                           // XSS过滤处理
├── framework         // 框架核心
│       └── aspectj                       // 注解实现
│       └── config                        // 系统配置
│       └── datasource                    // 数据权限
│       └── interceptor                   // 拦截器
│       └── manager                       // 异步处理
│       └── shiro                         // 权限控制
│       └── util                          // 通用工具
│       └── web                           // 前端控制
├── ruoyi-generator   // 代码生成（可移除）
├── ruoyi-quartz      // 定时任务（可移除）
├── ruoyi-system      // 系统代码
├── ruoyi-admin       // 后台服务
├── ruoyi-xxxxxx      // 其他模块

• 核心技术
  • springboot框架
  • shiro安全控制
  • thymeleaf模板

总结反馈

• 部署较顺利

• 项目属于父子多模块工程，之前没有接触过，理解起来有点吃力

• 虽然能看见一些controller-service-dao的痕迹，不过模块化的设计还不理解为什么要这么设计，得研究一下。

• 项目内容庞大，一时半会还消化不了。模块有点多，很多都没接触过。

• 前端也有点看不懂，好像是动态读取的。。。

• 计划：

  • 先找点shiro的资料看一下
  • 接下来以登陆账户为引，找到项目入口，debug看一下执行流程