与鸿蒙同行，Java Solon v3.0 正式发布（向下兼容）

2024-10-10 07:02:19

与 HarmonyOS NEXT 10月8日公测同行。Solon （开放原子开源基金会，孵化项目） v3.0 正式发布，
且将在 2025 年启动华为编程语言 “仓颉” 版开发（届时会有 Solon-Java 和 Solon-CJ 两大版本）。本次大版本更新，费时多月：

  • 与 Solon v2.9 保持兼容（向下兼容）
  • 与 JDK8, JDK11, JDK17, JDK21, JDK23 保持兼容（全系兼容）

Solon 框架！

Java “新式”应用开发框架，2017～2024。从零开始构建（非 java-ee 架构），有灵活的接口规范与开放生态。

  • 追求： 更快、更小、更简单
  • 提倡： 克制、简洁、高效、开放、生态
  • 官网： https://solon.noear.org

有什么特点？

特点 描述
更高的计算性价比 并发高 300%；内存省 50%
更快的开发效率 代码少；入门快；调试重启快 10 倍
更好的生产与部署体验 打包小 90%
更大的兼容范围 非 java-ee 架构；同时支持 java8 ～ java23，graalvm native image

更新与兼容详细说明：

1、概述

v3.0 版本主要是，内核删除了 20Kb 的弃用代码及相应的调整。最新内核为 0.3Mb。

  • 移除的配置，要认真检查；
  • 移除的事件，要认真检查；
  • 弃用接口移除等编译时会出错提醒，问题不大。

新增或重构插件有：

  • solon-data-sqlutils（编译大小为 10Kb 的小工具）
  • solon-web-webservices
  • solon-net-stomp
  • nami-channel-http（用于替代 nami-channel-http-okhttp）
  • solon-net-httputils（重构，添加 HttpURLConnection 适配；编译大小为 40Kb）

2、弃用配置移除对应表（要认真检查）

  • 移除
类型 移除配置名 替代配置名
启动参数 solon::
- config config.add
应用属性 solon::
- solon.config solon.config.add
  • 弃用
类型 弃用配置名 替代配置名
应用属性 solon-boot::
- server.session.state.domain server.session.cookieDomain
- server.session.state.domain.auto server.session.cookieDomainAuto
solon-web-staticfiles::
- solon.staticfiles.maxAge solon.staticfiles.cacheMaxAge

3、弃用事件移除对应表（要认真检查）

插件 移除事件 替代方案
solon @Bean bean? getBeanAsync(…class, …) / @Inject ..
@Component bean? getBeanAsync(…class, …) / @Inject ..
solon-serialization-fastjson FastjsonActionExecutor getBeanAsync(…class, …) / @Inject ..
FastjsonRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-fastjson2 Fastjson2ActionExecutor getBeanAsync(…class, …) / @Inject ..
Fastjson2RenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-fury FuryActionExecutor getBeanAsync(…class, …) / @Inject ..
solon-serialization-gson GsonActionExecutor getBeanAsync(…class, …) / @Inject ..
GsonRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-hessian HessianActionExecutor getBeanAsync(…class, …) / @Inject ..
solon-serialization-jackson JacksonActionExecutor getBeanAsync(…class, …) / @Inject ..
JacksonRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-jackson-xml JacksonXmlActionExecutor getBeanAsync(…class, …) / @Inject ..
JacksonXmlRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-properties PropertiesActionExecutor getBeanAsync(…class, …) / @Inject ..
PropertiesRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-serialization-protostuff ProtostuffActionExecutor getBeanAsync(…class, …) / @Inject ..
solon-serialization-snack3 SnackActionExecutor getBeanAsync(…class, …) / @Inject ..
SnackRenderFactory getBeanAsync(…class, …) / @Inject ..
solon-view-beetl GroupTemplate getBeanAsync(BeetlRender.class, …) / @Inject ..
solon-view-enjoy Engine getBeanAsync(EnjoyRender.class, …) / @Inject ..
solon-view-freemarker Configuration getBeanAsync(FreemarkerRender.class, …) / @Inject ..
solon-view-thymeleaf TemplateEngine getBeanAsync(ThymeleafRender.class, …) / @Inject ..
solon-view-velocity RuntimeInstance getBeanAsync(VelocityRender.class, …) / @Inject ..

以上事件替代的扩展方案（示例）：

@Configuration
public class App {
    public static void main(String[] args) {
        Solon.start(App.class, args, app -> {
            //1.第一时间手动获取（在其它注入前执行）
            app.context().getBeanAsync(Xxx.class, e -> {

            });
        });
    }

    //2.由扫描时自动注入
    @Bean
    public void cfg(Xxx xxx) {

    }
}

什么时候用事件扩展好（尽量不用）？

  • 需要及时扩展，但又不方便进入容器的对象。

4、弃用 Before、After 处理体系移除（编译会有提醒）

影响 替代方案
全局方面 由 RouterInterceptor 替代
本地网关方面 由 Filter 替代，或者自己可扩展
注解方面（控制器相关） 由 @Addition(Filter) 替代

其中“本地网关”，可以通过定制恢复旧版能力：https://solon.noear.org/article/214

5、弃用类型移除对应表（编译会有提醒）

插件 移除类型 替代类型
nami
@Body @NamiBody
NamiBodyAnno
@Mapping @NamiMapping
NamiMappingAnno
solon
@PathVar @Path
@PropertySource @Import
@ProxyComponent @Component
@Before(Handler) @Addition(Filter)
@After(Handler) @Addition(Filter)
Endpoint /
SolonBuilder /
ValHolder /
InitializingBean @Init
NdMap IgnoreCaseMap<Object>
solon-data
Serializer core::Serializer
solon-data-dynamicds
DynamicDsHolder DynamicDsKey
solon-logging
LogUtilToSlf4j /
solon-logging-log4j
SolonCloudAppender /
solon-logging-logback
SolonCloudAppender /
solon-serialization
JsonConverter core::Converter
StringSerializer core::Serializer<String>
solon-test
@TestPropertySource @Import
@TestRollback @Rollback
AbstractHttpTester HttpTester
HttpTestBase HttpTester

6、弃用接口方法移除对应表（编译会有提醒）

调整类 移除方法（或字段） 替代方法
nami::
- Constants CONTENT_TYPE_*
solon::
- ActionParamResolver resolvePathVar()
- ActionDefault before(.) / 只留 filter 体系
after(.) /
- AppContext beanOnloaded(.) lifecycle(.)
- Bean registered() delivered()
- BeanContainer getAttrs() attachment*(.)
beanAround*(.) beanInterceptor*(.)
- ClassUtil newInstance(.) tryInstance(.)
- ClassWrap getFieldAllWraps() getFieldWraps()
- Component registered() delivered()
- ConditionUtil ifMissing(.) ifMissingBean(.)
- Context ip() remoteIp()
param(key,def) paramOrDefault(key,def)
paramSet(.) paramMap().add(.)
paramsMap() paramMap().toValuesMap()
paramsAdd(.) paramMap().add(.)
files(.) fileValues(.)
filesMap() fileMap().toValuesMap()
cookie(key,def) cookieOrDefault(key,def)
header(key,def) headerOrDefault(key,def)
headersMap() headerMap().toValuesMap()
session(key,def) sessionOrDefault(key,def)
statusSet(.) status(.)
attr(key,def) attrOrDefault(key,def)
attrClear() attrsClear()
- DateAnalyzer getGlobal() global()
- EventBus pushAsync() publishAsync()
pushTry() publishTry()
push() publish()
- Gateway before(.) / 只留 filter 体系
after(.) /
- LifecycleBean prestop() preStop()
- LogUtil debugAsync() /
infoAsync() /
- MethodHolder getArounds() getInterceptors()
- MethodWrap getArounds() getInterceptors()
- MvcFactory resolveParam(.) resolveActionParam(.)
- NvMap (map) from(map)
getBean(.) toBean(.)
- Props getByParse(.) getByTmpl(.)
getXmap(.) getMap(.)
getBean(.) toBean(.)
- RenderManager mapping(.) Solon.app().render(key, )
register(.) Solon.app().render(null, .)
- ResourceUtil remClasspath(.) remSchema(.)
- Router matchOne(.) matchMain(.)
- RunUtil setExecutor(.) setParallelExecutor(.)
- SolonApp before(.) / 只留 filter 体系
after(.) /
- SolonProps source() app.source()
sourceLocation() app.sourceLocation()
- Utils TAG_classpath /
resolvePaths(.) /
hasClass(.) ClassUtil.hasClass(.)
loadClass(.) ClassUtil.loadClass(.)
newInstance(.) ClassUtil.tryInstance(.)
getResource*(.) ResourceUtil.getResource*(.)
transferTo*(.) IoUtil.transferTo*(.)
buildExt(.) getFolderAndMake(.)
solon-boot::
- HttpServerConfigure allowSsl(.) enableSsl(.)
solon-data::
- CacheService get(key) get(key, type)
solon-scheduling::
- IJobManager setJobInterceptor(.) addJobInterceptor(.)
solon-serialization-properties::
- PropertiesActionExecutor includeFormUrlencoded(.) allowPostForm(.)

7、弃用插件移除对应表

其中简化了快捷组合包（发现太多，容易混乱），只留两个基础的：

  • solon-lib（保持不变）
  • solon-web（移除了 solon-view-freemarker）
移除插件 替代插件 备注
:: cloud
solon.cloud.httputils solon-net-httputils
:: detector
detector-solon-plugin solon-health-detector
:: logging
log4j2-solon-plugin solon-logging-log4j2
logback-solon-plugin solon-logging-logback
:: scheduling
solon.extend.schedule /
:: testing
solon.test solon-test
:: web
solon.web.flux solon-web-rx
:: shortcuts
solon-api solon-web
solon-job / 改用 solon-lib +
solon-rpc / 改用 solon-web +
solon-beetl-web / 改用 solon-web +
solon-enjob-web / 改用 solon-web +
solon-web-beetl / 改用 solon-web +
solon-web-enjoy / 改用 solon-web +
solon-cloud-alibaba / 改用 solon-web + solon-cloud +
solon-cloud-water / 改用 solon-web + solon-cloud +

移除的快捷组合包，可通过以下方式组合：

  • solon-job=
    • solon-lib + solon-scheduling-simple
  • solon-rpc=
    • solon-web + nami-coder-snack3 + nami-channl-http-okhttp
  • solon-beetl-web（或 solon-web-beetl）=
    • solon-web + solon-view-beetl + beetlsql-solon-plugin
  • solon-enjoy-web（或 solon-web-enjoy）=
    • solon-web + solon-view-enjoy + activerecord-solon-plugin
  • solon-cloud-alibaba=
    • solon-web + solon-cloud + nacos-solon-cloud-plugin + rocketmq-solon-cloud-plugin + sentinel-solon-cloud-plugin
  • solon-cloud-water=
    • solon-web + solon-cloud + water-solon-cloud-plugin

8、部分插件名字调整对应表(旧名标为弃用，仍可用)

新的调整按以下插件命名规则执行：

插件命名规则 说明
solon-*（由 solon.* 调整而来） 表示内部架构插件
*-solon-plugin（保持不变） 表示外部适配插件
*-solon-cloud-plugin（保持不变） 表过云接口外部适配插件

对应的“旧名”，仍可使用。预计会保留一年左右。具体调整如下：

新名 旧名 备注
:: nami
nami-channel-http-hutool nami.channel.http.hutool
nami-channel-http-okhttp nami.channel.http.okhttp
nami-channel-socketd nami.channel.socketd
nami-coder-fastjson nami.coder.fastjson
nami-coder-fastjson2 nami.coder.fastjson2
nami-coder-fury nami.coder.fury
nami-coder-hessian nami.coder.hessian
nami-coder-jackson nami.coder.jackson
nami-coder-protostuff nami.coder.protostuff
nami-coder-snack3 nami.coder.snack3
:: base
solon-config-banner solon.banner
solon-config-yaml solon.config.yaml
solon-config-plus 从原 solon.config.yaml 里拆出来
solon-hotplug solon.hotplug
solon-i18n solon.i18n
solon-mvc solon.mvc
solon-proxy solon.proxy
solon-rx 新增
:: boot
solon-boot-jdkhttp solon.boot.jdkhttp
solon-boot-jetty-add-jsp solon.boot.jetty.add.jsp
solon-boot-jetty-add-websocket solon.boot.jetty.add.websocket
solon-boot-jetty solon.boot.jetty
solon-boot-jlhttp solon.boot.jlhttp
solon-boot-smarthttp solon.boot.smarthttp
solon-boot-socketd solon.boot.socketd
solon-boot-undertow-add-jsp solon.boot.undertow.add.jsp
solon-boot-undertow solon.boot.undertow
solon-boot-vertx solon.boot.vertx
solon-boot-websocket-netty solon.boot.websocket.netty
solon-boot-websocket solon.boot.websocket
solon-boot solon.boot
:: cloud
solon-cloud-eventplus solon.cloud.eventplus
solon-cloud-gateway solon.cloud.gateway
solon-cloud-metrics solon.cloud.metrics
solon-cloud-tracing solon.cloud.tracing
solon-cloud solon.cloud
:: data
solon-cache-caffeine solon.cache.caffeine
solon-cache-jedis solon.cache.jedis
solon-cache-redisson solon.cache.redisson
solon-cache-spymemcached solon.cache.spymemcached
solon-data-dynamicds solon.data.dynamicds
solon-data-shardingds solon.data.shardingds
solon-data solon.data
:: detector
solon-health-detector solon.health.detector
solon-health solon.health
:: docs
solon-docs-openapi2 solon.docs.openapi2
solon-docs-openapi3
solon-docs solon.docs
:: faas
solon-faas-luffy solon.luffy
:: logging
solon-logging-log4j2 solon.logging.log4j2
solon-logging-logback solon.logging.logback
solon-logging-simple solon.logging.simple
solon-logging solon.logging
:: native
solon-aot solon.aot
::net
solon-net-httputils solon.net.httputils
solon-net-stomp
solon-net solon.net
:: scheduling
solon-scheduling-quartz solon.scheduling.quartz
solon-scheduling-simple solon.scheduling.simple
solon-scheduling solon.scheduling
:: security
solon-security-auth solon.auth 旧名弃用
solon-security-validation solon.validation 旧名弃用
solon-security-vault solon.vault 旧名弃用
solon-security-auth solon.security.auth
solon-security-validation solon.security.validation
solon-security-vault solon.security.vault
:: serialization
solon-serialization solon.serialization
solon-serialization-fastjson solon.serialization.fastjson
solon-serialization-fastjson2 solon.serialization.fastjson2
solon-serialization-fury solon.serialization.fury
solon-serialization-gson solon.serialization.gson
solon-serialization-hessian solon.serialization.hessian
solon-serialization-jackson solon.serialization.jackson
solon-serialization-jackson-xml solon.serialization.jackson.xml
solon-serialization-kryo 略过（未发布）
solon-serialization-properties solon.serialization.properties
solon-serialization-protostuff solon.serialization.protostuff
solon-serialization-snack3 solon.serialization.snack3
:: view
solon-view solon.view
solon-view-beetl solon.view.beetl
solon-view-enjoy solon.view.enjoy
solon-view-freemarker solon.view.freemarker
solon-view-jsp solon.view.jsp
solon-view-jsp-jakarta 略过（未发布）
solon-view-thymeleaf solon.view.thymeleaf
solon-view-velocity solon.view.velocity
:: web
solon-sessionstate-jedis solon.sessionstate.jedis
solon-sessionstate-jwt solon.sessionstate.jwt
solon-sessionstate-local solon.sessionstate.local
solon-sessionstate-redisson solon.sessionstate.redisson
solon-web-cors solon.web.cors
solon-web-rx solon.web.rx
solon-web-sdl solon.web.sdl
solon-web-servlet solon.web.servlet
solon-web-servlet-jakarta solon.web.servlet.jakarta
solon-web-sse solon.web.sse
solon-web-staticfiles solon.web.staticfiles
solon-web-stop solon.web.stop
solon-web-webdav solon.web.webdav
上一篇：【HarmonyOS】HMRouter使用详解（二）路由跳转


下一篇：Gin解说