使用 Deno 和 Oak 实现 HTTP 服务器

前言

在前端开发中,我们经常需要自己搭建一个 HTTP 服务器来模拟后端接口或提供静态文件服务等,而 Node.js 是目前最流行的实现方式之一。然而,随着 Deno 的出现,我们有了一种更现代和安全的方式来编写 JavaScript 服务器端代码。

Deno 是一个由 Rust 编写的运行时,可以直接运行 JavaScript 和 TypeScript 代码。它有类似 Node.js 的 API,但是在安全性方面更加强大,没有 NPM 等中心化的包管理系统,而是通过 URL 来引入依赖包。

Oak 是 Deno 中的一个基于中间件的 HTTP 框架,提供了类似于 Koa 的 API,但是在性能和错误处理方面有所优化。

本文将介绍如何使用 Deno 和 Oak 实现一个简单的 HTTP 服务器,并讨论一些常见的问题和最佳实践。

准备工作

首先,我们需要安装 Deno 运行时。可以使用 curl 或 PowerShell 在命令行中进行安装:

安装完成后,在命令行中输入 deno --version 确认安装成功。

接下来,我们需要创建一个新的文件夹,用于放置我们的服务器代码和示例文件。在该文件夹中,创建 server.ts 文件作为我们的入口文件,以及 index.html 文件用于测试服务器的静态文件。

创建 HTTP 服务器

首先,我们需要引入 Oak:

import { Application, Router, Response } from "https://deno.land/x/oak/mod.ts";

然后,我们可以创建一个新的应用程序实例:

const app = new Application();

接着,我们可以创建一个 Router 实例来处理路由:

const router = new Router();

我们可以使用 router.get()router.post() 等方法来指定不同路由的处理函数。下面是一个简单的处理函数,用于返回 index.html 文件:

router.get("/", ctx => {
  const content = await Deno.readFile("./index.html");
  ctx.response.body = content;
  ctx.response.headers.set("Content-Type", "text/html");
});

在这个处理函数中,我们使用 Deno.readFile() 方法来读取 index.html 文件内容,然后将其赋值给 HTTP 响应的 body 属性,并将响应头的 Content-Type 设置为 text/html

最后,我们需要将路由挂载到应用程序实例上:

app.use(router.routes());

现在,我们的 HTTP 服务器已经创建完成,并监听在默认端口 8000 上。我们可以使用以下代码来启动服务器:

await app.listen({port: 8000});
console.log("Server started at http://localhost:8000");

静态文件服务

除了路由处理,我们还需要为服务器提供静态文件服务。可以使用 Deno.stat() 方法来检查文件是否存在,以及 Deno.open() 方法来打开并读取文件。

下面是一个处理静态文件的方法,用于读取和发送文件内容:

async function serveFile(ctx, path) {
  try {
    const fileInfo = await Deno.stat(path);
    if (fileInfo.isFile) {
      const file = await Deno.open(path);
      ctx.response.body = file;
      ctx.response.headers.set("Content-Type", "text/plain");
      return true;
    }
  } catch (e) {
    // Ignore error
  }
  return false;
}

该方法接收一个 ctx 参数,表示 HTTP 请求上下文,以及一个 path 参数,表示要访问的文件路径。如果文件存在并且是一个文件(而不是目录或符号链接),则将文件作为响应的主体内容发送,并将响应头的 Content-Type 设置为 text/plain

我们可以将此方法与路由处理函数结合使用,以实现静态文件服务:

router.get("/static/(.*)", async (ctx) => {
  const path = "./" + ctx.params[0];
  if (!await serveFile(ctx, path)) {
    ctx.response.status = 404;
    ctx.response.body = "File not found";
  }
});

在这个路由处理函数中,我们使用正则表达式来捕获 URL 中的文件路径,然后调用 serveFile() 方法来读取和发送文件内容。如果文件不存在,则返回 404 状态码和 "File not found" 消息。

总结

使用 Deno 和 Oak 实现 HTTP 服务器并不难,但是我们需要注意一些常见的问题和最佳实践,例如安全性、性能优化、错误处理和代码组织等方面。希望本文能对读者在前端开发中实现服务器有所帮助。

完整代码示例:

import { Application, Router, Response } from "https://deno.land/x/oak/mod.ts";

const app = new Application();
const router = new Router();

async function serveFile(ctx, path) {
  try {
    const fileInfo = await Deno.stat(path);
    if (fileInfo.isFile) {
      const file = await Deno.open(path);
      ctx.response.body = file;
      ctx.response.headers.set("Content-Type", "text/plain");
      return true;
    }
  } catch (e) {
    // Ignore error
  }
  return false;
}

router.get("/", async (ctx) => {
  const content = await Deno.readFile("./index.html");
  ctx.response.body = content;
  ctx.response.headers.set("Content-Type", "text/html");
});

router.get("/static/(.*)", async (ctx) => {
  const path = "./" + ctx.params[0];
  if (!await serveFile(ctx, path)) {
    ctx.response.status = 404;
    ctx.response.body = "File not found";
  }
});

app.use(router.routes());

await app.listen({port: 8000});
console.log("Server started at http://localhost:8000");

来源:JavaScript中文网 ,转载请注明来源 本文地址:https://www.javascriptcn.com/post/658fa4dfeb4cecbf2d54184d


纠错
反馈