翻译:

基于类的控制器和 网络安全网关 页:1 双关,服务于 Bun.serve 有标准 作装饰. 没有 JavaScript 路由器: Bun 内置 routes 处理路径 参数和 HTTP 方法.

HTTP 和 WebSockets 共享一个 listen()一个服务器和一个端口,没有 express, (中文(简体) ), ws 或者说 socket.io。 。 。 .

安装

bun add @dunx/http @dunx/core @dunx/transform

添加 preload = ["@dunx/transform/preload"] 改为 bunfig.toml 用于构造器 注射,一次在顶级,一次在下 [test]。 。 。 .

使用量

import { inject, Module } from '@dunx/core';
import { Controller, Get, HttpFactory, Post, type Input } from '@dunx/http';
import { z } from 'zod'; // or Valibot, or ArkType, or none at all

const createUser = { body: z.object({ name: z.string() }) } as const;
const oneUser = { params: z.object({ id: z.coerce.number() }) } as const;

@Controller('users')
export class UsersController {
  readonly #users = inject(UsersService);

  @Get('/')
  list() {
    return this.#users.findAll(); // plain values become Response.json()
  }

  @Get('/:id', oneUser)
  one(input: Input<typeof oneUser>) {
    return this.#users.find(input.params.id); // a number, already validated
  }

  @Post('/', createUser)
  create(input: Input<typeof createUser>) {
    return this.#users.create(input.body.name); // 201, no Response.json()
  }
}

@Module({ controllers: [UsersController], providers: [UsersService] })
export class UsersModule {}

const app = await HttpFactory.create(AppModule);
app.enableShutdownHooks();
await app.listen(3000);

这是什么

每行链接到覆盖它的向导.

子路径

@dunx/http/internal 用于 dunx 自己的软件包 : @dunx/dashboard, (中文(简体) ), @dunx/mcp 财务报告和审定财务报表 @dunx/openapi。不要从应用程序导入它,因为它可以改变任何 释放.

页:1

• 路线在靴子上找到,包括从基类继承的路线,所以 抽象控制器的子类服务于其父的 @Get 方法也一样.
• 两个相同方法和路径的处理器在启动时失败, 错误名称 都一样 否则Bun会不说就留着其中一个.
• 处理器可以返回一个 Response,任何JSON可循环值,或 undefined 一个204.
• Authorize 财务报告和审定财务报表 gate() 保护管理员页面。 他们收到原始请求 当拒绝访问时回答404,或发送 Response 你继续往前走, 例如,登录页. @dunx/dashboard 财务报告和审定财务报表 @dunx/openapi 都接受一个, 所以你写了一次访问规则.
• Schemas,解析器和状态代码在启动时一出. 处理a 请求中没有元数据查询.
• 每个请求都加入呼叫者的W3C跟踪(traceparent) (中文(简体) ). 它的日志线携带 traceId, (中文(简体) ), spanId, (中文(简体) ), parentSpanId 财务报告和审定财务报表 traceFlags,而反应包含 (单位:千美元) traceresponse 头曰. requestLogging: { trace: false } 关掉两个. { traceResponse: false } 保留跟踪字段,只放信头, 它可以保存大约500纳秒的请求。 没有单独的关联 id.
• metrics: true 添加请求数和每个路线的直径图,用于 大约35纳斯请求.
• @dunx/http/connect 为连接和gRPC-Web服务,但不是本地的gRPC. 土著 gRPC将其状态发送到HTTP拖车中 Bun.serve 无法发送, 所以 请求与 content-type: application/grpc 得到一个415 解释原因. @connectrpc/connect 财务报告和审定财务报表 @bufbuild/protobuf 是可选的同伴依赖关系, 你留着你自己的 .proto 工具链. ThrottleGuard 适用于 RPC 路径 还有.

许可证

麻省理工学院