概述
Bun 是一个全新的 JavaScript 和 TypeScript 运行时，它集成了 JavaScript 解释器、JavaScript 编译器、HTTP 客户端、HTTP 服务器、Web 框架、数据库 ORM 等多种功能。本章将介绍如何使用 Bun 创建 Web 服务器，并通过具体的例子来展示其基本功能和特性。
安装 Bun
在开始之前，确保你的系统已经安装了 Bun。如果你还没有安装，可以通过以下命令进行安装：
curl -fsSL https://bun.sh/install | bash
或者使用 Homebrew 在 macOS 上安装：
brew install bun
创建项目
首先，我们需要创建一个新的项目目录，并初始化项目。打开终端并执行以下命令：
mkdir my-bun-server cd my-bun-server bun init
这将生成 package.json 文件，用于管理项目的依赖项和其他配置。
安装依赖
Bun 自带了内置的包管理器，可以用来安装所需的依赖。为了创建一个简单的 Web 服务器，我们只需要 bun 本身即可。不过，为了演示更复杂的场景，我们可以安装一些常用的库，如 express 或者 fastify。这里我们选择 express 作为示例：
bun add express
创建基本的 HTTP 服务器
我们将使用 express 来创建一个基本的 HTTP 服务器。首先，在项目根目录下创建一个名为 server.js 的文件，并添加以下代码：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- ----- ---- - ----- ------------ ----- ---- -- - --------------- --------- --- ---------------- -- -- - ------------------- ------- -- ---------------------------- ---
这段代码定义了一个简单的 Express 应用程序，监听在 3000 端口上。当用户访问根路径时，服务器会返回 "Hello World!" 字符串。
运行服务器
现在，我们可以运行我们的服务器了。在终端中输入以下命令：
bun run server.js
如果一切正常，你应该会在控制台看到类似 "Server running at http://localhost:3000/" 的输出信息。打开浏览器并访问 http://localhost:3000/，你应该能看到 "Hello World!" 的消息。
使用中间件
Express 提供了强大的中间件支持，可以用来处理请求、响应和错误。下面是一个使用中间件的例子，我们将添加一个日志中间件，打印出每次请求的信息：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- ----- ---- - ----- -- ----- ------------- ---- ----- -- - ------------------ --------------------- ------------- ------------- ------- -- --------------- --- ------------ ----- ---- -- - --------------- --------- --- ---------------- -- -- - ------------------- ------- -- ---------------------------- ---
这段代码添加了一个中间件，每当有请求到达时，都会打印出当前的时间、请求方法和请求 URL。这样可以帮助我们更好地监控和调试应用程序。
处理 POST 请求
除了 GET 请求之外，我们还需要能够处理 POST 请求。下面是一个示例，展示了如何接收和处理 POST 请求的数据：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- ----- ---- - ----- -- ------ ---- -- ------------------------ ------------------- ----- ---- -- - ----- ---- - --------- ------------------ -------------- ------------ --- ---------------- -- -- - ------------------- ------- -- ---------------------------- ---
在这个例子中，我们首先添加了一个中间件 express.json() 来解析客户端发送的 JSON 数据。然后定义了一个处理 POST 请求的路由 /submit，当收到请求时，会打印出请求体中的数据，并返回 "Data received!"。
错误处理
在实际应用中，错误处理是非常重要的。Express 提供了一种简单的方式来处理错误。下面是一个错误处理的示例：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- ----- ---- - ----- ------------------------ ------------------- ----- ---- -- - ----- ---- - --------- ------------------ -------------- ------------ --- -- ------- ------------- ---- ---- ----- -- - ------------------------- ------------------------------- --------- --- ---------------- -- -- - ------------------- ------- -- ---------------------------- ---
在这个例子中，我们定义了一个错误处理中间件，它可以捕获到任何未被其他路由处理的错误，并将其记录下来，同时向客户端返回一个错误信息。
静态资源服务
对于静态资源（如图片、CSS 文件等），Express 提供了方便的方法来服务这些文件。下面是一个示例，展示了如何设置静态资源目录：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- --- - ---------- ----- ---- - ----- ---------------------------------- ------------ ----- ---- -- - ---------------------- - --------------- --- ---------------- -- -- - ------------------- ------- -- ---------------------------- ---
在这个例子中，我们使用 express.static 中间件来服务位于 public 目录下的静态资源。所有对静态资源的请求都会由这个中间件处理。例如，如果你在 public 目录下有一个 styles.css 文件，那么可以通过 http://localhost:3000/styles.css 访问到它。
总结
通过以上步骤，我们已经成功地使用 Bun 和 Express 创建了一个简单的 Web 服务器。从基础的 HTTP 服务器搭建，到中间件的应用、POST 请求的处理、错误处理以及静态资源服务，我们覆盖了构建 Web 应用所需的一些关键知识点。希望这些内容能帮助你在实际项目中更好地利用 Bun 进行前端开发。