山东省建设人才网站,微信红包制作官网,德阳市建设局官方网站安全月,益阳网站建设方案JeecgBoot 框架升级 Spring Boot 3.1.5 步骤
JEECG官方推出SpringBoot3分支#xff1a;https://github.com/jeecgboot/jeecg-boot/tree/springboot3 本次更新由于属于破坏式更新#xff0c;有几个生态内的组件#xff0c;无法进行找到平替或无法升级#xff0c;目前尚不完…JeecgBoot 框架升级 Spring Boot 3.1.5 步骤
JEECG官方推出SpringBoot3分支https://github.com/jeecgboot/jeecg-boot/tree/springboot3 本次更新由于属于破坏式更新有几个生态内的组件无法进行找到平替或无法升级目前尚不完善部分功能选择直接注释的方式以下为功能列表 Online功能积木报表功能仪表盘功能spring cloud gateway 的 SentinelFilterContextConfig 过滤器 Spring Boot
从 2.7.10升级到3.1.5有以下几个点需要注意。
JDK版本支持从JDK 17-19版本javax.servlet切换到jakarta.servletspring.redis配置切换为spring.data.redisSpring Cloud 2022.0.4Spring Cloud Alibaba 2022.0.0.0
除以上三点外其它都是平滑升级不过这也只是相对于我们应用Spring Boot的用户来说。不过对于第二点属于是破坏性升级了需要将项目中引用的javax.servlet替换成jakarta.servlet。
spring boot升级参考文档https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide
spring cloud升级参考文档https://docs.spring.io/spring-cloud/docs/current/reference/html/
spring cloud alibaba升级参考文档https://sca.aliyun.com/zh-cn/docs/2022.0.0.0/overview/version-explain
Shiro
前面讲到由于Spring Boot内部的servlet包换掉了jeecg框架使用shiro以及spring boot集成所以shiro需要升级不过还好shiro官方给这个点提供了支持以下是shiro的升级替换。 需要注意的是spring boot 3.1.5对jedis的版本做了提升提升后shiro无法兼容所以只能在项目进行降版本处理。 shiro升级参考文档https://blog.csdn.net/weixin_43492211/article/details/131217344 !--shiro--dependencygroupIdorg.apache.shiro/groupIdartifactIdshiro-spring-boot-starter/artifactIdversion${shiro.version}/versionexclusionsexclusiongroupIdorg.apache.shiro/groupIdartifactIdshiro-spring/artifactId/exclusion/exclusions/dependency!-- shiro-redis --dependencygroupIdorg.crazycake/groupIdartifactIdshiro-redis/artifactIdversion${shiro-redis.version}/versionexclusionsexclusiongroupIdorg.apache.shiro/groupIdartifactIdshiro-core/artifactId/exclusionexclusionartifactIdcheckstyle/artifactIdgroupIdcom.puppycrawl.tools/groupId/exclusion/exclusions/dependency!-- shiro 无法使用 spring boot 3.X 自带的jedis降版本处理 --dependencygroupIdredis.clients/groupIdartifactIdjedis/artifactIdversion2.9.0/version/dependencydependencygroupIdorg.apache.shiro/groupIdartifactIdshiro-spring/artifactIdclassifierjakarta/classifierversion${shiro.version}/version!-- 排除仍使用了javax.servlet的依赖 --exclusionsexclusiongroupIdorg.apache.shiro/groupIdartifactIdshiro-core/artifactId/exclusionexclusiongroupIdorg.apache.shiro/groupIdartifactIdshiro-web/artifactId/exclusion/exclusions/dependency!-- 引入适配jakarta的依赖包 --dependencygroupIdorg.apache.shiro/groupIdartifactIdshiro-core/artifactIdclassifierjakarta/classifierversion${shiro.version}/version/dependencydependencygroupIdorg.apache.shiro/groupIdartifactIdshiro-web/artifactIdclassifierjakarta/classifierversion${shiro.version}/versionexclusionsexclusiongroupIdorg.apache.shiro/groupIdartifactIdshiro-core/artifactId/exclusion/exclusions/dependencyknife4j
knife4j对于spring boot 3.X版本提供了支持不过相当于spring boot 2.X的版本来说差异比较大从springfox转换成了springdoc不能做到平滑升级以下是需要替换的注解列表.
knife4j升级参考文档
https://doc.xiaominfo.com/docs/quick-start/start-knife4j-version#22-spring-boot-3x
https://springdoc.org/#migrating-from-springfox
Api → TagApiIgnore → Parameter(hidden true) or Operation(hidden true) or HiddenApiImplicitParam → ParameterApiImplicitParams → ParametersApiModel → SchemaApiModelProperty(hidden true) → Schema(accessMode READ_ONLY)ApiModelProperty → SchemaApiOperation(value foo, notes bar) → Operation(summary foo, description bar)ApiParam → ParameterApiResponse(code 404, message foo) → ApiResponse(responseCode 404, description foo)
同样在初始化文档对象上也有区别以下前后替换
[Bean](https://my.oschina.net/bean)public GroupedOpenApi swaggerOpenApi() {return GroupedOpenApi.builder().group(default).packagesToScan(org.jeecg).build();}[Bean](https://my.oschina.net/bean)public OpenAPI customOpenAPI() {return new OpenAPI().info(new Info().title(JeecgBoot 后台服务API接口文档).version(1.0).contact(new Contact().name(北京国炬信息技术有限公司).url(www.jeccg.com).email(jeecgos163.com)).description( 后台API接口).termsOfService(NO terms of service).license(new License().name(Apache 2.0).url(http://www.apache.org/licenses/LICENSE-2.0.html)));}// ---------------------------替换后---------------------[Bean](https://my.oschina.net/bean)public GroupedOpenApi swaggerOpenApi() {return GroupedOpenApi.builder().group(default).packagesToScan(org.jeecg).build();}[Bean](https://my.oschina.net/bean)public OpenAPI customOpenAPI() {return new OpenAPI().info(new Info().title(JeecgBoot 后台服务API接口文档).version(1.0).contact(new Contact().name(北京国炬信息技术有限公司).url(www.jeccg.com).email(jeecgos163.com)).description( 后台API接口).termsOfService(NO terms of service).license(new License().name(Apache 2.0).url(http://www.apache.org/licenses/LICENSE-2.0.html)));}升级的maven地址 dependencygroupIdcom.github.xiaoymin/groupIdartifactIdknife4j-openapi3-jakarta-spring-boot-starter/artifactIdversion4.3.0/version/dependency在knife4j 4.X版本中首次在对swagger文档与spring cloud gateway进行了整合提供完整的解决方案做到了开箱即用以下是应用案例在jeecg中也得到了升级。 dependencygroupIdcom.github.xiaoymin/groupIdartifactIdknife4j-gateway-spring-boot-starter/artifactIdversion4.3.0/version/dependencyspring boot 3.x 生态增强平滑升级
以下为平滑升级即更换版本即可不需要做任何调整jeecg框架调整如下 !-- druid --dependencygroupIdcom.alibaba/groupIdartifactIddruid-spring-boot-3-starter/artifactIdversion1.2.20/version/dependency!-- 动态数据源 --dependencygroupIdcom.baomidou/groupIdartifactIddynamic-datasource-spring-boot3-starter/artifactIdversion4.1.3/version/dependency!-- spring boot-admin --dependencygroupIdde.codecentric/groupIdartifactIdspring-boot-admin-starter-server/artifactIdversion3.0.4/version/dependency
