Skip to main content

Hono

如果您想要生成 hono,请将 client 属性定义为 hono,将在目标文件和目录中生成 Hono 模板。您可以查看 Hono

orval.config.js 示例

生成模板

orval 生成如下文件:

  • petstore.ts: 初始化 hono 并定义端点。
  • handlers: 包含每个端点的模板。
  • petstore.schemas.ts: 定义请求和响应模式。
  • petstore.validator.ts: 实现 hono 验证器。
  • petstore.zod.ts: 使用 zod 定义验证模式。
  • petstore.context.ts: 定义端点的上下文。

在处理器中实现端点处理

OrvalHono 生成处理器模板。例如,查看 listPets.ts。 为请求和响应定义了验证。只是没有实现实际的处理逻辑。

您只需根据响应模式定义响应即可实现 API。

运行 Hono 开发服务器

您可以使用 wrangler dev 命令运行和检查。 入口点是 src/petstore.ts 而不是 src/index.ts

查看 这里 的完整示例。如果您想使用 HonofetchNext.jsTypeScript 开发前端和后端,请也查看 这里

OpenAPI 中使用复合路由和按标签分割的处理器

如果您想使用 tagstags-split 模式(按 OpenAPI 中定义的标签分割处理器),但想生成复合的单个 hono 路由文件,请将文件路径(如 src/routes.ts)定义到 override.hono.compositeRoute 属性,Hono 模板将在目标文件和目录中生成复合根文件。

然后它将按如下方式生成:

routes.ts 复合所有路由,如下所示:

您可以准备一个像 app.ts 这样的 hono 服务器,并像这样嵌入:

像往常一样运行 Hono 开发服务器。

查看 这里 的完整示例。

Was this page helpful?