# v2.2.x 升级至 v2.3.x

# 组件更改说明

该升级指南以v2.2.x版本为基准,更早的版本请先参考之前版本的升级文档。

diboot v2.3.x是基于spring boot 2.5的长期维护版本。

将diboot所有的组件版本号替换至2.3.0的最新版本,然后按照下述内容进行相关更改即可。

# diboot-core 内核

  • 配置参数统一前缀更名

如自定义了以下参数,对应修改为新的参数名。未自定义的无需更改。

# 原配置
system.pagination.page-size=20
system.batch.size=1000
# 更名为
diboot.core.pageSize=20
diboot.core.batchSize=1000
  • 如还需新建表生成代码(无需新生成代码可忽略)
    • BaseCustomCrudRestController 继承的 BaseCrudRestController<E> 需加泛型<E>
    • Controller的 增、删、改 的before方法和after方法,参数类型需改为对应实体类型

# diboot-IAM 组件相关变更

  • IamUserService 移除了 getViewObjectListSortByOrg 接口,改用getViewObjectList查询
iamUserService.getViewObjectListSortByOrg() => iamUserService.getViewObjectList()
  • ApiPermissionCache废弃,其下接口移至 IamCacheManager 中。
ApiPermissionCache.getApiPermissionVoList() => IamCacheManager.getApiPermissionVoList()

# diboot-file 组件

  • 配置参数统一前缀更名
# 文件上传路径 原配置
files.storage.directory=/myfile
# 更名为
diboot.component.file.storageDirectory=/myfile

# 前端升级说明

  • diboot-antd-admin前端调整

升级前请下载diboot-antd-admin 2.3.0 (opens new window)源码包,以下升级流程将依赖此包。

  • diboot-element-admin前端调整

升级前请下载diboot-element-admin 2.3.0 (opens new window)源码包,以下升级流程将依赖此包。

  • 对比新旧版本的相关页面及代码,替换或合并至本地。