Solon v3.7 更新与兼容说明

兼容说明

这个版本默认依赖包（主要是指 solon-lib 和 solon-web ），配置增强和序列化的插件由 snack3 切换为 snack4 （snack3 的适配仍可使用）

兼容问题1：

• 启用 EggG 作为类的元信息管理（如果有兼容问题，可暂时退回 v3.6.4）

兼容问题2：

• snack3 与 snack4 并不兼容，但是可以共存（部分类名相同，要注意包名的区分）。
  • snack3 的类包名为：org.noear.snack.*，maven依赖包为：org.noear:snack3
  • snack4 的类包名为：org.noear.snack4.*，maven依赖包为：org.noear:snack4
• 如果要继续使用 snack3
  • 排除 solon-config-snack4 和 solon-serialization-snack4
  • 引入 solon-config-snack3 和 solon-serialization-snack3
• 如果已使用别的序列化插件
  • 要排除 solon-serialization-snack4（之前是排除 solon-serialization-snack3）
• 如果有其它依赖包依赖了 snack3
  • 也可单独再引入 org.noear:snack3
• solon-config-snack4 的潜在可能影响
  • snack4 的反序列化注入更严格，比如：字符串单值 "xx" 不能注入给 List<String> 集合（snack3 则是可以）。//后续会完善这种兼容性

snack3 用得好好的，为什么要换 snack4 ？

• 首先要说明一下，solon 是个很开放的架构基座。也可以完全不用 snack3
• 那为什么要换？snack3 的架构陈旧，扩展无力。无法作为下一代 Solon v4.0 的伴侣。
• 为什么要用 snack？，因为可以更好的为 Solon 提供定制响应。
• snack4 由 AI 协助，历时半年重构完成。并通过了已有的 snack3 和 solon 相关单测。

兼容问题3:

• 所有 solon.xxx 和 nami.xxx 的依赖包不再发布（v2.9 时声明弃用），请改用 solon-xxx 风格的包
• 如果有第三方包仍依赖 solon.xxx，可排除后引入对应的 solon-xxx

兼容问题4:

• 控制器方法返回 String 时，默认 content-type 改为 text/plain。
  • 可以使用 @Produces 注解，按需指定
  • 之前有 json 插件引入时，默认为 application/json （有些人反对，认为不合理）。//确实也不合理，尤其在 MCP 开发时，对 content-type 很是敏感。

部分弃用对照表：

ps: v3.7.0 时旧接口被移除了；v3.7.2-SNAPSHOT 已恢复

具体更新

• 升级 snack3 切换为 snack4
• 新增 solon-config-snack3 插件
• 新增 solon-config-snack4 插件
• 添加 solon preStop 方法名（替代 prestop），后者标为弃用。两者都可用
• 添加 solon Router:addPathPrefix(path, tester) 方法
• 添加 solon Context:localPort() 方法
• 添加 solon-server-smarthttp 有 tomcat 时的启动控制
• 优化 solon-web-staticfiles StaticResourceHandler 的 Cache-Control 处理（允许外部设定并优先）
• 优化 solon-ai-core ToolSchemaUtil:paramOf 方法，增加泛型支持
• 优化 solon-ai-core ToolSchemaUtil:outputSchema 泛型处理
• 调整 solon-config-plus 标为弃用，由 solon-config-snack3 或 solon-config-snack4 替代
• 调整 solon-net WebSocket:remoteAddress, localAddress 移除 throws IOException
• 调整 solon ActionLoader, ActionLoaderFactory 内部接口设计
• 调整 solon RouterWrapper 标为弃用，功能转到 Router 接口上
• 调整 solon ChainManager:addInterceptor （内部接口）更名为 addRouterInterceptor 强化语义
• 调整 solon 不再对 remoting 注册作 mapping 限制（改成跟控制器一样的策略）
• 调整 solon Router:getBy 更名为 findBy （前者标为弃用），避免下 get 疑似冲突
• 调整 solon-server 允许不输出 content-type
• 修复 solon-ai parseToolCall 接收 stream 中间消息时可能会异常（添加 hasNestedJsonBlock 检测）
• 修复 solon-ai-mcp 可能出现 Unknown media type 错误（取消 request.contentType 空设置）
• 移除 solon.xxx 和 nami.xxx 风格的发布包
• 启用 eggg 作为类元信息构建机制
• redisx 升为 1.8.2（snack3 切换为 snack4）
• wood 升为 1.4.2（snack3 切换为 snack4）
• snack4 升为 4.0.8
• log4j 升为 2.25.2
• logback 升为 1.3.16
• jakarta.logback 升为 1.5.20
• micrometer 升为 1.15.5
• opentelemetry 升为 1.55.0
• socketd 升为 2.5.20
• smartsocket 升为 1.7.4
• smarthttp 升为 2.5.16
• undertow 升为 2.2.38.Final

快捷组合包调整情况（如果有排除，别搞错了）：

关于配置的几个插件说明（solon 是个很开放的架构基座）：