tio-http-server 与 tio-boot 的使用边界
tio-http-server 提供 HTTP 服务与 Handler 等底层能力;tio-boot 在其上提供应用启动、配置、Controller、拦截器和扩展集成。两者文档中的启动方式不能直接混合。
如何选择
| 需求 | 阅读入口 |
|---|---|
| 独立创建基础 HTTP 服务,自己组织生命周期 | 基础 HTTP 服务 |
| 在已有 tio-boot 中增加路由 | 增加 HttpRequestHandler、Handler 入门 |
| 自行处理参数和返回值 | Handler 常用操作、方法与错误响应 |
| 查找 Handler 与 Controller 的优先级 | 分发源码说明 |
已有 tio-boot 服务时,通过其 TioBootServer 路由器注册 Handler 即可。不要为了增加一个路径,再在同一端口启动第二个基础 HTTP 服务。
不能混用的假设
- 裸 HTTP 服务没有自动执行业务工程的
BootConfiguration;需要由其启动代码完成相应配置。 TioBootTest只帮助初始化环境和 AOP,不会自动监听 HTTP 端口。- Handler 路由存在不表示数据库、存储或鉴权已配置。
- 在 tio-boot 中返回 null 的后续分发行为应以其分发器为准,不能仅根据基础服务示例推断。
完成接入后至少验证实际外部地址、HTTP 方法、异常响应和关闭资源行为;测试方法见 真实 HTTP 测试。
