KOCA6.4.0升级说明

升级说明
#1

1、后端

依赖版本升级：

● 框架整体升级spring-boot3

springframework 6.2.14 springboot 3.5.8 springcloud 2025.0.0

spring-cloud-alibaba 2023.0.1

● 框架代码全面移除对commons-lang包的使用，已替换成commons-lang3

后端框架

koca-client:

● 新增 KGMS 启用时可返回默认实例，兼容调用未注册服务实例。

● 异常处理统一为 RpcInvokeException，保留业务错误码/消息，替代 BexCallException。

koca-rpc-commons

● 响应解析增强，字符串响应可自动落地 ListResult/ExtResult/MapResult/PageListResult。

koca-kcxp:

● 支持流式处理和动态字节缓冲区，新增StreamHandler接口以优化大包和多结果集处理。

● 消息生命周期改为可配置，ListenerProperties新增lifetime属性配置

koca-jdbc:

● 兼容高版本oceanbase-client返回clob字段为字节数组问题

koca-multi-datasource:

● 多数据源时并行创建mybatis sqlSessionFactory

● 支持主从多数据源配置koca.jdbc.clusters[0].cluster:xx,xx，当主挂时自动切换从

koca-bex:

● 解决注解方式入参为map时，参数映射问题

● 增加配置koca.bex.strict-bex-request-param:false，当配置开启时，bex未配置入参时不接受请求参数

koca-auth:

● 解决设置MDC中的sessionId未清除的问题

koca-file:

● 解决上传0k文件报空指针的问题

koca-mybatis:

● 支持配置查询最大查询行数，koca.mybatis.maxQueryRows默认0不开启，当非分页查询返回条数大于配置数会发出警告，配置koca.mybatis.maxQueryThrowableFunc可对匹配dao方法抛出异常

koca-web:

● 支持特定header请求头才进行解密

● 新增fsenc算法加解密

消息队列（koca-mq）：

● koca-mq-kafka && koca-mq-rabbit 获取本地IP优先使用非回环地址 && 多网卡场景下支持preferredNetworks

影响范围：koca-mq-kafka和koca-mq-rabbit引入了spring-cloud-common组件

消息中心（koca-amc）：

● koca-amc-kafka支持获取本地IP优先使用非回环地址 && 多网卡场景下支持preferredNetworks

影响范围：koca-amc-kafka组件引入了spring-cloud-common组件

jni加载(koca-jni):

● 支持搬运带版本号的so文件，类似于libobci.so.2

koca-cloud-config-refresh:

● 提供配置刷新接口，返回刷新成功或失败信息

技术组件

业务组件

智能助手（koca-admin-assist）：

● 新增智能助手模块，提供通用智能问答集成方案

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

● 修复老数据rejectTo无值问题

● 兼容流程id不包含processDefinitionKey情况

● 修复待办查询报错问题

● 修复回调没有实例名称问题

脱敏模块（koca-admin-mask）

● 支持自定义脱敏权限判断，接口com.szkingdom.koca.admin.mask.permission.MaskFiledDecider

前端配置(koca-admin-front-profiles)

● 新增前端配置编辑接口，支持更新前端配置信息；数据库表新增字段，接收前端传输的logo编码信息

交易业务框架

行情客户端（koca-market）

● 【港股买卖盘上下限价】同步服务端结构改动

● 补充【股票/个股期权】行情缺失的市场状态[status]

● 去掉所有行情缓存类型的serviceId主键，除了逐笔行情

● 修复v2【上海待定报价、上海确定报价】[买入到期收益率]字段重复赋值问题

● 新增沪港通行情及产品信息订阅

● 新增新版【上海待定报价、确定报价】行情信息

● 新增【互联网固收平台迁移后结构体】确定/待定报价

● 行情缓存增加一个可扩展的过滤接口

数据同步V2（koca-data-sync-v2）

● 通道分配时进行判断开启通道的实例参与分配

● 在阻塞通道，发现bizKey有阻塞数据的时候，直接把阻塞数据按顺序重发一遍（遇到失败停止发送）

● 校验rpc、kafka必要配置，如果没有则跳过此配置。通道id计算逻辑优化

● 添加不同发送方式的阻塞key获取方法

● 日志记录存储由原来的开始记录结束更新状态修改为结束记录日志

● 日志跳过时，同步更新记录状态

● 添加通道拉取开关

● 发送执行器的线程池前置到通道传递

● 添加发送器公共参数获取及处理功能

● 修改sendProp、transformProp、handlerProp字段类型

由Map<String,String>变更为Map<String,Object>

● 修改ParamTransformer接口方法类型

由 String transform(String originalData, Map<String, Object> transformPrp);变更为 Object transform(Object originalData, Map<String, Object> transformPrp);

高速消息通信框架（koca-hare）

● 性能日志增加hare send API调用耗时

● 增加可捕获约定异常，以提取错误码返回给业务

● 升级C++ Hare监控代理包(koca-hma-jni-loader-default)JNI依赖至1.0.8，适配hare 2.5.4指标变动

● 移除JDK已废弃的SecurityManager相关逻辑

● 移除废弃的配置类代码

影响范围：

  1. 使用7.0.0版本的koca-hare时，如果需要采集hare原生指标，则必须使用hare监控代理 C++ 1.0.8及以上版本,若自行修改hare监控代理版本号需要注意该事项。

JSTP协议核心包（koca-jstp-core）

● 优化字符串压缩字节数组比对性能

● 优化根对象为Collection，元素类型为JavaBean场景打包性能

● 优化新版JDK字符串UTF8编码实现

影响范围： 无

JSTP服务端（koca-jstp-server）

● 支持配置TCP连接发送/接收缓冲区大小调优参数

● 消息写入完成回调中打印IO耗时信息

● 增加可捕获约定异常，以提取错误码返回给业务

● 移除冗余的通过切面在Bex公参中加入链路信息的代码,trace包已提供无感链路传递功能

● 移除废弃的Handler

影响范围：无

KGBP服务端（koca-kgbp-server）-使用Hare通信的多通道架构

● 支持配置旁路查询通道线程数，增大查询并发数量

● 通道输出链路耗时日志信息，方便性能问题排查

影响范围：无

链路追踪(koca-trace)

● 链路追踪开关默认开启

影响范围：无

KMDB内存数据库（koca-mdb-core）

● 建表语句执行API判断忽略大小写

● 修复SQL建表语句判断改动造成的句柄级别预分配参数设置不生效问题

● 修复全量查询复用Condition对象造成访问了被释放内存的问题

● maxSizePerPacket默认值变为1000，适配C++侧变动，避免线程数参数设置不生效

● 升级内存数据库依赖到4.2.6, 对接内存数据库带条件插入磁盘API

影响范围：

  1. 内存库底层依赖升级到4.2.6版本，6.4.0之前的版本升级到此版本之后必须铲库

  2. 内存表同步持久化到磁盘库功能依赖的底层三方驱动由静态链接库变为了动态链接库，如果使用此功能，需要部署时添加当前程序目录到环境变量中，同时koca-jni的版本必须升级到6.4.0及以上版本

KOCA-TEMPLATE 更新日志

:::warning

在本次发布中，@szkingdom.koca/template发布了6.4.0(非模块化)和7.0.0(模块化)两个版本，项目若没有框架模块化需要，建议升级到6.4.0版本。

:::

新特性

框架

  • 新增 CardEmbed 组件，用于使用 iframe 中嵌入其他系统页面

流程管理

  • 新增消息中间事件和定时器中间事件

  • 流程设计操作优化

人员管理

  • 新增系统信息页面，用于自定义设置系统 Logo 和名称

缺陷修复

框架

  • 修复关闭页签后，刷新页签数据恢复问题

  • 修复打开多个iframe, 每个iframe 中使用 useRoute 响应式 query 参数，会把所有的iframe src 的query改成同一个

  • 修复multipleTab 中 decodeUrI 可能出现的转义错误

  • 设置session 中的activeTopMenu 为立即执行，避免数据缓存，造成的不恰当表现

  • 修复页签重新加载iframe页面时不重新加载的问题

租户模块

  • 修复pinia-plugin-persistedstate插件升级导致的配置失效问题

优化

框架

  • 单点登录时【关闭系统】和【退出登录】按钮不是互斥关系，支持单独设置其显示与隐藏

  • 去除重制滚动条的样式

  • 修改 v-html 全局指令中使用 xss 插件的逻辑

  • 菜单显示逻辑，修改menuItemContent 无icon 时不显示，否则水平菜单的选中线会超过长度

人员管理

  • 菜单管理页面 菜单过滤添加容错处理

KOCA-UI更新日志

新特性

  • 重构组件的宽松紧凑方案

  • 内置基本颜色变量调整

  • 支持修改el-select组件默认值

kui-table-tool

  • 显示详情支持字典翻译

kui-form

  • prop 属性支持设置类似 a.b.c 的嵌套属性

kui-textarea

  • 支持文本内容放大功能

  • 新增 textarea-suffix-outside 属性，文本后缀外置

kui-page

  • 支持设置加载状态文本

kui-table

  • 表格组件大数据模式支持行拖拽

缺陷修复

kui-edit-list

  • 修复 edit-list 中number-format组件配置precision后无法输入小数点的问题

kui-table-tool

  • 修复表格工具栏查看详情会出现选择列信息的问题

kui-table

  • 修复表格工具栏展示列设置拖拽修改列顺序失效问题

  • 大数据表格功能失效修复

kui-tree-select

  • 修复大数据模式下默认值不回显的问题

kui-table-edit

  • 表格列show-overflow-tooltip属性设置为 false，避免重复显示文本超出提示

kui-cascader

  • 多选时 clear 图标无法点击的问题

kui-tabs

  • 修复标签页组件内存泄漏问题

kui-form

  • 修复不传递items属性报错问题

kui-date

  • 修复date组件设置size=small样式失效问题

优化

kui-table

  • 单元格文本超出提示添加是否有值判断，无值时不展示提示

  • 表格列的 show-overflow-tooltip 默认开启

  • 样式优化

  • 弹出框内容区域设计一个表格，表格上方设置一个浮动按钮，表格会盖住按钮

  • 表格继承 attrs

  • 展开列等设置了 type 类型的列不显示 tooltip

  • border 设置为 false 时表头分割线颜色调整

  • 表格组件表格列嵌套逻辑完善

kui-transfer

  • 完善国际化

kui-u-dialog

  • 样式优化

kui-table-page

  • 样式优化

kui-select

  • 样式优化

  • 禁用时背景色调整，禁用时 placeholder 文本颜色调整

  • 优化 clear 图标的渲染时机

kui-page

  • is-block 属性默认值从 true 改为 false

  • block-margin 属性默认值从 false 改为 true

  • title属性支持响应式

kui-input

  • el-input 的 append 中使用 el-select 样式问题

  • 禁用时背景色调整，禁用时 placeholder 文本颜色调整

kui-drawer

  • 样式优化

  • teleport 逻辑调整，默认只会渲染到祖先元素中的 KFRAME_CONTENT_CONTAINER

kui-u-title

  • 修复设置为 circle 时，按钮不圆

kui-page

  • trans 类型方法支持返回 Boolean 类型和 Object 类型

kui-radio

  • 选择项间距调整

kui-switch

  • 开关组件的高度调整

kui-form

  • 设置 fieldArr 的 title 插槽的逻辑调整

  • kui-form-item组件插槽支持动态切换表单项组件

kui-dialog

  • fullContent 属性支持动态修改

  • teleport 逻辑调整，默认只会渲染到祖先元素中的 KFRAME_CONTENT_CONTAINER

kui-badge

  • is-dot 时样式问题处理

kui-cascader

  • 样式优化

KACE-UI更新日志

新特性

缺陷修复

优化

kace-review-flow

  • 样式优化