跳转到主要内容
在本页

基于文件的路由

如果您使用过像 Next.js 这样的框架,您可能熟悉基于文件的路由——在一个特定目录中添加一个文件,它会自动成为一个路由。本教程演示如何创建一个使用基于文件路由的简单 HTTP 服务器。

路由请求 跳转到标题

创建一个名为 server.ts 的新文件。此文件将用于路由请求。设置一个名为 handler 的异步函数,该函数将请求对象作为参数。

server.ts
async function handler(req: Request): Promise<Response> {
  const url = new URL(req.url);
  const path = url.pathname;
  const method = req.method;
  let module;

  try {
    module = await import(`.${path}.ts`);
  } catch (_error) {
    return new Response("Not found", { status: 404 });
  }

  if (module[method]) {
    return module[method](req);
  }

  return new Response("Method not implemented", { status: 501 });
}

Deno.serve(handler);

handler 函数设置了一个包含从请求 URL 提取的路径的 path 变量,以及一个包含请求方法的 method 变量。

然后它会尝试根据路径导入一个模块。如果找不到该模块,则返回 404 响应。

如果找到该模块,它会检查该模块是否具有针对请求方法的方法处理程序。如果找到方法处理程序,它将使用请求对象调用方法处理程序。如果找不到方法处理程序,则返回 501 响应。

最后,它使用 Deno.serve 提供 handler 函数。

路径可以是任何有效的 URL 路径,例如 /users/posts 等。对于 /users 这样的路径,将导入 ./users.ts 文件。然而,更深层次的路径,例如 /org/users,将需要 ./org/users.ts 文件。您可以通过创建嵌套目录和文件来创建嵌套路由。

处理请求 跳转到标题

在与 server.ts 相同的目录中创建一个名为 users.ts 的新文件。此文件将用于处理对 /users 路径的请求。我们将使用 GET 请求作为示例。您可以添加更多 HTTP 方法,例如 POSTPUTDELETE 等。

users.ts 中,设置一个名为 GET 的异步函数,该函数将请求对象作为参数。

users.ts
export function GET(_req: Request): Response {
  return new Response("Hello from user.ts", { status: 200 });
}

启动服务器 跳转到标题

要启动服务器,请运行以下命令

deno run --allow-net --allow-read server.ts

这将在 localhost:8080 上启动服务器。现在,您可以向 localhost:8000/users 发出 GET 请求,您应该会看到响应 Hello from user.ts

此命令需要 --allow-net--allow-read 权限标志 才能允许访问网络以启动服务器并从文件系统读取 users.ts 文件。

🦕 现在您可以根据文件结构在您的应用程序中设置路由。您可以扩展此示例以根据需要添加更多路由和方法。

感谢 @naishe 贡献本教程。