基于若依的微服务快速开发框架(积木报表 + 工作流)
Posted 辰鬼丫
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了基于若依的微服务快速开发框架(积木报表 + 工作流)相关的知识，希望对你有一定的参考价值。
项目简介
基于若依Cloud的Jove-Fast微服务项目，主要集成了 积木报表,工作流 flowable.
项目地址::https://gitee.com/wxjstudy/jove-fast
- 账号密码admin/Psitadmin
- 采用前后端分离的模式
- 后端采用Spring Boot、Spring Cloud & Alibaba。
- 注册中心、配置中心选型Nacos，权限认证使用Redis。
- 流量控制框架选型Sentinel.
- 分布式锁选型redisson.
表调整
- 部门表调整，增加了一列 describes，主要作用于积木设置当前登录用户部门描述
@Override
public Map<String, Object> getUserInfo(String token)
// 将所有信息存放至map 解析sql会根据map的键值解析,可自定义其他值
Map<String, Object> map = new HashMap<>(20);
LoginUser loginUser = tokenService.getLoginUser(token);
map.put("sysUserCode",loginUser.getUsername());
//设置当前日期（年月日）
map.put("sysData",DateUtils.getDate());
//设置昨天日期（年月日）
map.put("sysYesterDay",DateUtils.getyesterday());
//设置当前登录用户昵称
map.put("sysUserName",loginUser.getSysUser().getNickName());
//设置当前登录用户部门ID
map.put("deptId",loginUser.getSysUser().getDeptId());
//设置当前登录用户部门描述
map.put("describe",loginUser.getSysUser().getDept().getDescribes());
return map;
- 实现同一报表，不同角色的人看到的列数据不一样的结果，两个注解解决
/**
* 使用示例：在实现类方法上增加@ColAssign，用于标识需要返回修改的注入点
*
* @param params
*/
@Override
@ColAssign
public List<PcbstatementVO> getPcbstatement(PcbstatementVO params)
return engineeringMapper.selectPcbstatement(params);
/**
* 使用示例：在bean的属性上增加@Assign，其中roleCallout的值为角色代码，用逗号分割标识多个角色
*
* @param params
*/
@Excel(name = "工程及其它费用",cellType = Excel.ColumnType.NUMERIC)
@Assign(roleCallout = "admin,confidential")
private Double amount;
- excel导出增强支持冻结首行以及开启筛选列<均为可选项>
@Log(title = "客户组别管理", businessType = BusinessType.EXPORT)
@RequiresPermissions("auxiliary:customergroup:export")
@PostMapping("/customergroup/export")
public void export(HttpServletResponse response, Data9977 data9977)
List<Data9977> list = iErpSalesmoduleservice.getCustomerGroupList(data9977);
ExcelUtil<Data9977> util = new ExcelUtil<Data9977>(Data9977.class);
/**
第四个参数是否冻结首行
第五个参数是否筛选列
*/
util.exportExcel(response, list, "客户组别信息",true,true);
积木报表
工作流引擎
分布式锁
Redisson是Redis官方推荐的Java版的Redis客户端,此处我们只用它的分布式锁功能。
package com.jovefast.common.redis.redisson;
import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.util.concurrent.TimeUnit;
/**
* redis锁工具类
*
* @author Acechengui
*/
@Component
public class RedisLock
@Autowired
private RedissonClient redissonClient;
/**
* 获取锁
*
* @param lockKey 锁实例key
* @return 锁信息
*/
public RLock getRLock(String lockKey)
return redissonClient.getLock(lockKey);
/**
* 加锁
*
* @param lockKey 锁实例key
* @return 锁信息
*/
public RLock lock(String lockKey)
RLock lock = getRLock(lockKey);
lock.lock();
return lock;
/**
* 加锁
*
* @param lockKey 锁实例key
* @param leaseTime 上锁后自动释放锁时间
* @return true=成功；false=失败
*/
public Boolean tryLock(String lockKey, long leaseTime)
return tryLock(lockKey, 0, leaseTime, TimeUnit.SECONDS);
/**
* 加锁
*
* @param lockKey 锁实例key
* @param leaseTime 上锁后自动释放锁时间
* @param unit 时间颗粒度
* @return true=加锁成功；false=加锁失败
*/
public Boolean tryLock(String lockKey, long leaseTime, TimeUnit unit)
return tryLock(lockKey, 0, leaseTime, unit);
/**
* 加锁
*
* @param lockKey 锁实例key
* @param waitTime 最多等待时间
* @param leaseTime 上锁后自动释放锁时间
* @param unit 时间颗粒度
* @return true=加锁成功；false=加锁失败
*/
public Boolean tryLock(String lockKey, long waitTime, long leaseTime, TimeUnit unit)
RLock rLock = getRLock(lockKey);
boolean tryLock = false;
try
tryLock = rLock.tryLock(waitTime, leaseTime, unit);
catch (InterruptedException e)
return false;
return tryLock;
/**
* 释放锁
*
* @param lockKey 锁实例key
*/
public void unlock(String lockKey)
RLock lock = getRLock(lockKey);
lock.unlock();
/**
* 释放锁
*
* @param lock 锁信息
*/
public void unlock(RLock lock)
lock.unlock();
用法:
@Autowired
private RedisLock redisLock;
// lockKey 锁实例key waitTime 最多等待时间 leaseTime 上锁后自动释放锁时间 unit 时间颗粒度
redisLock.lock(lockKey);
redisLock.tryLock(lockKey, leaseTime);
redisLock.tryLock(lockKey, leaseTime, unit);
redisLock.tryLock(lockKey, waitTime, leaseTime, unit);
redisLock.unlock(lockKey);
redisLock.unlock(lock);
目录结构
com.jovefast
├── jovefast-gateway // 网关模块
├── jovefast-auth // 认证中心
├── jovefast-flowable // 工作流中心
├── jovefast-api // 接口模块
│ └── jovefast-api-system // 系统接口
├── jovefast-common // 通用模块
│ └── jovefast-common-core // 核心模块
│ └── jovefast-common-datascope // 权限范围
│ └── jovefast-common-datasource // 多数据源
│ └── jovefast-common-log // 日志记录
│ └── jovefast-common-redis // 缓存服务
│ └── jovefast-common-seata // 分布式事务
│ └── jovefast-common-security // 安全模块
│ └── jovefast-common-swagger // 系统接口
├── jovefast-modules // 业务模块
│ └── jovefast-system // 系统模块
│ └── jovefast-gen // 代码生成
│ └── jovefast-job // 定时任务
│ └── jovefast-file // 文件服务
│ └── jovefast-report // 报表服务
├── jovefast-visual // 图形化管理模块
│ └── jovefast-visual-monitor // 监控中心
├──pom.xml // 公共依赖
架构图
组件式开发框架-积木
积木是什么
积木是一套高效快速开发Web应用的开发框架。框架通过组件化可配置的开发模式，将系统的开发抽象成搭建积木的过程。积木提供了多种通用的开发组件，开发者可根据需要进行选择。同时也可以基于现有框架进行拓展，开发所需的组件，有效地降低了项目的开发周期。
获取
【源码地址】
https://gitee.com/geohey/app-jimu
【示例地址】
【详细文档】
特点
- 可配置组件化的开发模式
- 基于框架轻松拓展自定义组件
有什么区别
近年来有很多优秀的开发框架被广泛使用如Vue、React等，那么积木框架与Vue、React等开发框架有什么不同呢？
相较之下，积木与其说是一个框架不如说是一种代码的设计模式。积木采用组件式开发模式，整个系统由一系列高内聚、低耦合的组件组成。每一个组件（Widget）内部封装了针对性很强的业务逻辑功能模块，而组件之间的组织工作全部交由框架去维护。这种设计模式可以是开发者更好的集中精力去处理组件内部的实现逻辑。这样，不仅提高了开发效率，也使后期维护的工作变得更加轻松。
框架设计
在积木中，所有的模块都是通过组件的的形式进行搭建，即所见之处皆为组件。组件的搭建由一个系统的配置文件进行统一的控制。组件分为两种：
- 普通组件
- 容器组件
普通组件只负责实现自身的业务逻辑，容器组件除了负责自身的业务逻之外还负责根据配置去构造其内部的子组件，并进行管理。可想而知，最外层的App.vue就是一个容器组件，由它开始自动的生成子组件，如果子组件仍然是容器组件的话，还会不断的向下构造。直到所有的组件搭建完毕
积木UML图
能带来什么
- 功能相对完善的项目开发基础框架
- 组件式的开发体验，开发者只需要去关注每个组件自身的业务逻辑
以上是关于基于若依的微服务快速开发框架(积木报表 + 工作流)的主要内容，如果未能解决你的问题，请参考以下文章
若依框架以及Mybatis-plus分页插件失效，数据库有多条却只查前十条