用途:在编写 Helidon 4 应用(SE 或 MP)时提供最佳实践指导,避免沿用 Helidon 3 的旧 API 导致编译错误。
主要能力:给出 Helidon 3→4 的 API 对照(如 io.helidon.common.http.Http.Status 改为 io.helidon.http.Status,Service 改为 HttpService,Routing.Rules 改为 HttpRules,javax.* 改为 jakarta.*,helidon-microprofile-tests-junit5 改为 helidon-microprofile-testing-junit5 等);强调 Value.as(Class) 在 Helidon 4 返回 OptionalValue<T>。
使用方式:先确定项目用 SE 还是 MP,不要混用;使用 Java 21 及以上,用 Maven 或 Gradle 管理依赖,并通过 Helidon BOM 对齐版本。SE 采用显式组合与构造器注入,路由放在 HttpService 中,业务逻辑独立;MP 使用 CDI 构造器注入、Jakarta REST 与 MicroProfile Config。配置外置到 application.yaml/properties,密钥不得硬编码。Web 层使用专用 DTO、校验参数、返回合适状态码、集中错误处理。数据层使用 Helidon DB Client 或 Jakarta Persistence,参数化查询,注意 DbColumn.as 返回 OptionalValue、可空列用 asOptional()。测试用 JUnit 5,SE 用 @ServerTest/@RoutingTest,MP 用 @HelidonTest,避免硬编码端口。
适用场景:Helidon 4 的 SE/MP 应用开发、代码生成与评审、从 Helidon 3 迁移。
限制:资料未提供具体版本兼容矩阵、性能数据、收费信息或完整安全配置细节;安全部分原文在授权处截断,相关完整内容暂未提供。