KOCA5.3.0升级说明

升级说明
#1

升级文档说明汇总

1、后端

开发框架

依赖版本升级说明：
●spring-boot升级至2.5.15
●spring-boot-autoconfigure升级至2.5.15
●spring-web升级至5.3.36
●spring-security-core升级至5.8.11
●spring-security-web升级至5.7.10
●spring-boot-actuator升级至2.7.18
●spring-kafka升级至2.9.13
●kafka-clients升级至3.4.1
●json升级至20231013
●druid升级至1.2.23
●snakeyaml升级至2.0
●logback-core升级至1.2.13
●mybaits-plus支持版本升级至3.5.3.1

缓存框架（koca-cache）：
●添加租户缓存功能
影响范围：无

远程调用（koca-client）
●BexClient 兼容5.0.0之前的逻辑，优先使用Http协议做远程调用
●调整默认超时时间为60s, 默认重试次数1，不重试
影响范围：远程调用默认超时时间和重试次数

认证框架（koca-auth）：
●添加租户Session功能
影响范围：强依赖于租户缓存功能，如需使用，需要和缓存框架一起升级
●添加安全防御模块 koca-auth-security-defense
●完善了垂直越权校验api流程与能力
影响范围：无

消息队列（koca-mq）：
●提供消费者统一生命周期管理能力
●添加自启动开关，支持配置自启动顺序
影响范围：无

消息中心（koca-amc）：
●适配spring-kafka升级，使用新版发送API与回调注册，以备springboot3.0版本API变更
●支持关闭框架自带投递错误主题功能，关闭后异常处理会使用打印日志进行兜底
影响范围：spring-kafka需要是2.9以上版本

文件（koca-file）
●业务参数规范bizParam改为Map<String, Object>
●s3存储文件命名修改，以及上传时AWS4签名问题修复
●新增加通过版本下载接口（wps）
●md5算法抽出，业务可以自由选择，koca提供基础实现
影响范围：旧版升级需要修改BizParam返回类型，以及新接口实现

koca-bex Idea跳转插件（koca-bex-plugin）
●提供koca-bex xml文件到java代码的相互跳转，支持基于类名和方法名进行跳转
影响范围：无

主键生成器-数据库序列生成（koca-admin-id-generator-seq）：
●优化生成序列过程中字符串替换性能
●新增支持通过业务日期批量重置按日复位的所有主键
影响范围：无

业务组件

技术组件

lcp低码组件

  1. 数据模型管理 lcp-runtime-model：
    ●支持模型驱动设计
    ●支持模型代码导出

  2. 页面管理 lcp-runtime-page:
    ●支持模型驱动页面快速生成/解绑

  3. 通用流程适配层 general-workflow-adapter
    ●新增通用流程适配层模块，默认支持组件化/流程中心流程接口回调对接，支持自定义扩展能力

  4. bug修复与优化
    ●groovy引擎优化，保证脚本安全使用
    ●修复数据模型管理-基础信息默认排序项选择后清空保存不生效问题
    ●修复数据模型管理-关联关系，新增关联关系时目标模型的模型字段无法正常显示问题

  5. 前端设计器
    ●为模型驱动页面提供丰富的自定义功能
    ●优化设计器使用体验，修复已知bug

基础组件

消息队列管理端（koca-admin-mq）：
●新增错误消息处理拓展接口，并提供基于数据库持久化的默认实现。可以自定义实现错误处理
影响范围：无

脱敏组件（koca-admin-mask）：
●优化脱敏过程速度过慢导致接口返回时间过长的问题
影响范围：无

定时任务（koca-admin-jobschedule）：
●实现分布式任务锁，保证仅有一个节点执行定时任务
影响范围：无

操作流水(koca-admin-biz-log)：
●支持登录/登出日志记录
影响范围：无

通用导出组件（koca-admin-export）：
●支持多sheet导出和自定义样式配置
影响范围：无

文件中心（koca-admin-file-center）
●KOCA文件中心， 支持个人空间， 团队空间，团队空间下划分项目空间， 文件存储以及文件夹创建删除等
●对接S3存储以及WPS预览编辑
●支持文件回收站以及回收站中的文件文件夹回收
影响范围：与koca-admin-file-manage不可以同时存在

流程管理（koca-admin-workflow）：

● 节点属性：支持设置可修改完成人节点
●节点属性：向前加签优化：加签完留痕并屏蔽待办
●节点属性：撤回支持配置在当前节点
●节点属性：驳回支持设置自定义节点范围
●节点属性：支持设置审批意见是否必填及默认审批意见
●节点属性：人员选择器支持分页、支持最近搜索
●流程方案：流程方案支持版本管理
●节点属性：回调函数配置组件支持前端自定义配置
●流程图：新增人工分支节点
●流程属性：支持设置可发起人权限，可发起列表根据发起人权限自动过滤
●流程属性：支持设置流水号，并在流程实例名称中使用流水号
●抄送：支持待阅已阅功能
●审批记录优化：审批记录和流程状态合并，流程图增加轨迹信息
●节点回调支持扩展
●支持人大金仓数据库
●补全camunda 抄送、导入、特权人功能
●数据迁移批量导入导出优化
●流程表单：新增富文本，文件上传，头像上传，Tabs等控件
●流程审批：PDF 和 图片 类型的附件支持预览
●流程审批：操作逻辑重构，支持前端配置
●前端集成：iframe集成支持认证信息传递
●前端集成：iframe集成时，支持向表单内传递数据
影响范围：无

资管场景
通用复核（koca-assets-common-confirm）
●添加动态列查询功能
●完善了使用文档和案例说明，具体查看官网文档
影响范围：无

通用查询（koca-assets-common-query）
●添加高级查询功能，支持针对自定义列以及方式进行查询
●通用查询列和参数配置取用户和*并集，优先使用用户配置
●完善了使用文档和案例说明，具体查看官网文档
影响范围：无

通用导出（koca-assets-common-export-poi）
●添加支持PDF导出功能
影响范围：无

交易业务框架
缓存（koca-assets-cache）
●支持堆外缓存
●修复不同事务下先del再put相同主键及索引的数据时，偶发性通过主键查询不到数据的问题
●当在事务内含有refreshAll操作，数据同步时将该张表的全部操作合并为一个刷新指令
影响范围：无

行情客户端（koca-market）
●新增上海确定报价逐笔、上海非公开报价逐笔、基金通(仅V1版本)行情
●行情批量分发支持去重
●支持切换故障行情源
●修复逐笔行情相关问题
●修复行情备注字段内含有空格时数据被截断的问题
影响范围：无

高速消息通信框架（koca-hare）
●新增高可用配置
●实现断点保存和断点重连
●支持动态创建hare连接
●支持从hare上下文中获取请求头信息
●支持通过开关控制hare jni是否加载
●hare序列化支持通过配置指定context级别字符集，默认UTF8
●HareSender支持传入mid和nid参数，用于消息去重
●支持生成traceId和spanId
●修复hare连接断开时Token没有删除成功的问题
影响范围：无

JSTP协议核心包（koca-jstp-core）
●字符串解码异常直接抛出而非内部处理
●使用@JstpPackField注解修饰的Map类型的字段打包解包支持更多Value类型(JavaBean,Map,List)
●修复集合类型打包时，第二个元素为NULL造成的崩溃问题
●修复高并发下嵌套包结果集类型解析出现的字段描述器线程安全问题
●迁移kgbp协议定义到jstp-core中
影响范围：无

JSTP服务端（koca-jstp-server）
●新增支持kgbp协议
●增加空闲连接检测功能，当超过空闲超时时长时服务器将断开连接，默认永不断开
●支持传递协议中的链路追踪信息和token到业务公参中
●修复多处捕获异常时未打印异常堆栈信息问题
影响范围：需要配套升级koca-jstp-core至5.3.0版本，手动取包时需注意引入koca-tcp-transfer-jstp和koca-tcp-transfer-kgbp

JSTP客户端（koca-jstp-client）
●新增支持kgbp协议
●实现心跳保活机制
●开放配置netty线程池线程数量
●添加traceId和spanId生成逻辑
●当超时时间<=0时设置为默认60s
●支持获取koca认证token并放入请求头中
影响范围：需要配套升级koca-jstp-core至5.3.0版本，手动取包时需注意引入koca-tcp-transfer-jstp和koca-tcp-transfer-kgbp

KGBP客户端（koca-kgbp-client）-用于请求KGMS网关
●添加心跳检测开关
●添加spanId生成逻辑
●当超时时间<=0时设置为默认60s
●升级jni版本为1.0.2
影响范围：无

远程调用框架（koca-biz-prc）
●修复日志打印异常堆栈缺失的问题
●当超时时间<=0时设置为默认60s
●koca-rpc-hare-client 移除通过注册中心配置hare服务（因注册中心提供的hare配置结构与最新版hare不一致)
●koca-rpc-hare-client 添加调用端负载均衡支持
●koca-rpc-hare-client 去除重试调用逻辑
●koca-rpc-hare-client 优化RPC调用性能
●koca-rpc-jstp-client 新增支持kgbp协议
●koca-rpc-kgms-plugin http调用通过kgms转发时携带X-Request-TimeOut头信息
影响范围：无

KGBP服务端（koca-kgbp-server）-使用Hare通信的多通道架构
●支持多通道下的断点保存和断点重演功能
●提供多活版本的主键生成器实现，仅在高可用部署下使用
●支持配置全局默认队列深度
●支持配置主库通道执行线程数量与队列深度，用于执行一些通道无关的任务
影响范围：需要配套升级koca-jstp-core，koca-hare至5.3.0及以上版本

KMDB内存数据库（koca-mdb-core）：
●更新内存数据库底层动态链接库
●支持通过程序API刷内存库数据到磁盘数据库(仅限于高斯数据库)
●分区句柄池化，每个分区独立句柄池，句柄池数量，默认为cpu核心数量的四分之三，最大不超过32，最小不低于4，可配置
●范围查询支持单边查询(>=或者<=某个值)
●修复分页查询死循环问题
●复MYSQL端口收到未知二进制包时连接卡住的问题(不包含linux x86依赖)
●修复堆外内存块未初始化造成的脏数据问题
●修复其他已知问题
影响范围：无

结构体解析工具包（koca-structure-util）
●结构体解析性能优化(针对UTF-8且JDK8的情况)
●提供C++结构体转换为Java对象或Map的能力
影响范围：针对UTF-8且JDK8的情况，若字符串解析失败，先前版本会返回乱码的字符串，当前版本将会抛出异常

通信连接工具包（koca-biz-meter-util）
●提供请求hare服务端的API（支持jstp和kgbp协议）
●提供请求koca-jstp-server的API（支持jstp和kgbp协议）
●提供请求kgms网关的API（支持kgbp协议）
影响范围：无

2、前端

升级指南 V5.2.0 升级 V5.3.0

KOCA依赖升级


pnpm add @szkingdom.koca/ui@5.3.0 -s
pnpm add @szkingdom.koca/icons-vue@5.3.0 -s
pnpm add @szkingdom.koca/template@5.3.0 -s
pnpm add @szkingdom.koca/eslint-config@5.0.0 -s
pnpm add @szkingdom.koca/bundler-vite@5.3.0 -d

本地文件升级

升级index.html, 添加以下代码，支持默认设置index.html 不缓存

  <meta http-equiv="Expires" content="0">
  <meta http-equiv="Pragma" content="no-cache">
  <meta http-equiv="Cache-control" content="no-cache">
  <meta http-equiv="Cache" content="no-cache">

更新日志
查看详细提交日志（仅支持内网查看）

KOCA-TEMPLATE 更新日志

2024-09-30（V5.3.0）

新特性

框架

  • 单点登录支持 OAuth2 方式
  • 添加页签打开过多提示，详见【projectSetting】多页签相关配置
  • rootFontConfig配置支持添加maxFontSize
  • 增加showEnvMark配置，是否显示环境标记

打包工具 bundler-vite

  • 去除prettier 依赖，减少包体积
  • 添加vite-plugin-compression插件，支持gzip压缩打包
  • 依赖更新

工作流

  • 节点属性：支持设置可修改完成人节点
  • 节点属性：向前加签优化：加签完留痕并屏蔽待办
  • 节点属性：撤回支持配置在当前节点
  • 节点属性：驳回支持设置自定义节点范围
  • 节点属性：支持设置审批意见是否必填及默认审批意见
  • 节点属性：人员选择器支持分页、支持最近搜索
  • 节点属性：回调函数配置组件支持前端自定义配置
  • 流程方案：流程方案支持版本管理
  • 流程图：新增人工分支节点
  • 流程属性：支持设置可发起人权限
  • 流程属性：支持设置流水号，并在流程实例名称中使用流水号
  • 抄送：支持待阅已阅功能
  • 审批记录优化：审批记录和流程状态合并，流程图增加轨迹信息
  • 节点回调支持扩展
  • 支持人大金仓数据库
  • 补全camunda 抄送、导入、特权人功能
  • 流程表单：新增富文本，文件上传，头像上传，Tabs等控件
  • 流程审批：PDF 和 图片 类型的附件支持预览
  • 流程审批：操作逻辑重构，支持前端配置
  • 集成：iframe集成支持认证信息传递
  • 集成：iframe集成时，支持向表单内传递数据

优化

框架

  • 删除普通登录中调用的 getUserInfo 接口
  • page-wrapper 组件 expose redoHeight 方法，用于重新计算组件高度
  • 组件权限功能的性能优化
  • APP_INFO.json文件请求方式由相对路径改为绝对路径
  • 硬件插件检测页面区分windows/mac/linux操作系统的下载
  • 硬件插件安装后，刷新浏览器，自动从下载提示页跳转到登录页
  • 删除部分vite2 已弃用的api import.meta.globEager
  • 默认设置index.html不缓存
  • 调整多页签右键菜单为单例

Bug 修复

框架

  • wujie 微前端子应用中的 document.documentElement.fontSize 没有根据分辨率响应式处理
  • wujie 微前端子应用中无法获取 document.querySelector(:root) 的问题

通用复核

  • 修复查询条件中的发起人/复核人无数据问题
  • 修复快速点击复核左侧列表count不正确问题
  • 支持通过接口获取动态表单选项
  • 复活页面去除激活刷新

KOCA-UI更新日志
查看详细提交日志（仅支持内网查看）

2024-09-30（V5.3.0）

:::warning

  • element-plus 版本号需升级至 2.8.0+

可能出现的页面问题

  1. kui-tabs 组件的头部和内容颠倒，一般是页面中的样式影响导致

  2. kui-select 组件的样式失效，底层实现方式变更，class 与之前没有对应上，需要重写样式

:::

新特性

kui-select

  • 添加suffix插槽
  • 添加adaptive-tags属性，多选设置collapseTags且未设置maxCollapseTags时tag标签显示个数自适应select宽度
  • 添加checkAllThreshold属性，设置当超过多少个选项时显示全选反选按钮
  • 添加showPanelExpand支持双列面板选择模式，设置defaultPanelExpand为true时默认展开两列，仅在多选下拉选择非大数据模式支持

kui-table

  • 单元格内容的tooltip支持展示自定义的html内容
  • 表格操作列，多选列，序号列添加分辨率自适应功能
  • 大数据表格的多选列支持配置 selectable
  • 大数据表格支持分页
  • 大数据表格支持 setSelectedByKey 方法
  • 大数据表格切换全选时，触发单挑数据的 select 事件
  • selection列支持配置renderCell自定义内容渲染

kui-cron

  • 支持汉化翻译
  • 月份添加【不指定】选项

KuiMessage

  • 新增 KuiMessage 函数组件

kui-cascader

  • 新增支持 readonly 属性

kui-rich-text

  • 富文本内容支持 v-model 绑定

kui-select

  • 新增 filter-with-value 属性
  • 添加suffix插槽
  • 添加adaptive-tags属性，多选设置collapseTags且未设置maxCollapseTags时tag标签显示个数自适应select宽度

v-tooltip

  • 新增 v-tooltip 指令

kui-common-empty

  • 新增 kui-common-empty 组件

缺陷修复

kui-table-page

  • 修复自定义表格配置中，序列化保存导致的 items 配置中的函数丢失

kui-cron

  • 初始化赋值的cron表达式在组件上的回显问题

kui-input

  • 修复输入框 tooltip 的xss问题

kui-number-format

  • 修复整数时，设置精度补0会出现死循环
  • 修复 type 属性 设置 thousandth 时，表单校验触发没有提示

kui-checkbox

  • 修复 checkbox-group 的 label 设置是 name 时，显示错误的问题

kui-radio

  • 修复使用 el-tooltip 包裹时，不显示tooltip

kui-switch

  • 修复使用 el-tooltip 包裹时，不显示tooltip

kui-button

  • 修复点击事件功能在某些场景下失效问题

kui-input

  • 修复配置限制字节数后，达到限制后仍然可以输入的问题

kui-sform

  • 修复 colspan 属性失效问题

kui-split

  • 修复组件内包含 kui-form 时，form 的 scrollToError 事件会导致布局错乱

优化

  • 所有录入组件的 clear 图标使用 element-plus 默认图标

kui-cascader

  • 点击清空时，设置值为 [] 不再设置为 null

kui-select

  • 代码重构，底层实现变更
  • remote-method 方法默认参数为空字符串
  • 插槽方式的option也支持readonly
  • tooltip 样式问题
  • 下拉框使用checkbox多选
  • 配置远程查询后，没有下拉选项那么 focus 时会自动触发查询
  • 样式优化

kui-bond

  • 支持高亮多个匹配文本

kui-table

  • 大数据表格宽度根据页面宽度变化重新渲染
  • 优化大数据表格样式，字体颜色，大小跟随全局设置
  • 重构单元格的 tooltip 显示
  • 大数据表格的部分事件触发两次问题

kui-table-page

  • 修复自定义列设置中的内存泄露问题

kui-v-table

  • 大数据表格与普通表格样式调制

kui-textarea

  • 优化滚动条样式

kui-transfer

  • 优化滚动条样式

kui-bond

  • 样式优化

ASSETS-UI更新日志

查看详细提交日志（仅支持内网查看）

2024-09-30（V5.3.0）

新特性

kace-container

  • 添加 variant 属性

kace-search-form

  • 表单的 button 支持独立插槽

kace-table

  • 添加 auto-virtual 属性，配置数据量超过多少时，自动开启大数据
  • 添加 form 属性，设置可编辑表格时表单项的样式

kace-search-form

  • 添加 btn-placement 属性，设置操作按钮的位置

kui-form

  • 添加控制表单内边距的CSS变量

kace-meta-form

  • form-items 配置支持 class 属性
  • 添加 show-review-comp 属性，设置复核表单项是否展示旧的表单项

缺陷修复

kace-page

  • 修复 search-form-position 设置为 bottom 时，表单项类型一直为 input

kace-table-page

  • 表格数据请求支持配置请求头

kace-table

  • 修复列配置中 format 属性对数字四舍五入的处理，支持安全显示超过JS最大精度的值
  • 操作列配置 tip 属性和 pop-confirm 属性无法同时生效

kace-general

  • 导出功能在 wujie 微前端下报错

kace-client

  • 修复组件单独使用时报错

kace-piecewise-set

  • 修复宽松紧凑模式切换时的样式问题
  • 修复识别输入的是字符串还是数字的问题

优化

kace-meta-form

  • 优化复核时 kui-cascader 的样式
  • 表单项的 renderSlot 属性支持传入虚拟节点

kace-form-comp-render

  • kui-select 多选时， 绑定值如果是 "" 重新赋值为 []

kace-table

  • 表格内容根据分辨率响应式调整的功能重构
  • 操作列是 tag 类型时，disabled 状态下的按钮不再是 type: info 样式

kace-find-select

  • 数据量很大时的性能优化