Dataway 实践
7 篇文章将接口配置、调试和发布集成到现有应用。
- 新版 Dataway：架构、接口与数据迁移指南
对照 old-hasor 的 Dataway 实现，说明新版的模块、配置、核心接口、SPI、脚本和元数据变化，并提供迁移步骤与离线辅助工具。
- Dataway header 传参
请求头常用于传递链路编号、客户端版本等信息。本文读取 X-Trace-Id，把它放进 JSON 结果并写入响应头，让调用方能够关联一次请求与响应。
- Dataway 整合 Swagger2，让 API 管理更顺畅
Dataway 可以把已发布且启用的接口生成为 Swagger 2.0 文档，Swagger UI 加载文档后便能展示参数并发起请求。本文让一个消息接口在控制台发布后，直接进入 Swagger UI 调试。
- 完美兼容老项目！Dataway 返回结构的全面控制
应用已经约定 ok、code、message、data 四个响应字段时，可以用 Structure 结果处理器配置同样的结构。本文让成功和脚本失败共用一份模板，并说明直接返回原始值的方式。
- 通过 Dataway 配置一个带有分页查询的接口
分页接口需要同时返回当前页记录和总数。本文使用 SQL 执行器完成数据库分页，接收从 1 开始的 page 和每页数量 size，并将两部分数据组成一个响应。
- Dataway 配置数据接口时和前端进行参数对接
前端传入人员名称，接口返回匹配人员的编号和姓名。本文明确请求与响应的字段约定，再把 JSON 请求参数绑定到 SQL，最后转换为前端约定的结果结构。
- 让 Spring Boot 不再需要 Controller、Service、DAO、Mapper
查询类接口通常需要接收参数、执行 SQL 和返回 JSON。Dataway 把这些步骤放入可编辑、可调试、可发布的脚本中；应用负责提供数据源和身份识别。本文以人员查询为例，完成从 Spring 配置到 HTTP 调用的过程。