什么是 Deno？
Deno 是一个基于 V8 引擎的 JavaScript 和 TypeScript 运行时，由 Node.js 的创始人 Ryan Dahl 开发。与 Node.js 不同的是，Deno 不需要使用包管理器和 npm，而是直接使用 URL 导入模块。Deno 还提供了一些安全机制，如默认禁止访问文件系统和网络，需要显式授权才能访问。
RESTful API 的基本概念
RESTful API 是一种基于 HTTP 协议的 Web 服务架构风格，采用统一的接口设计，使用 HTTP 动词（GET、POST、PUT、DELETE 等）表示对资源的操作。RESTful API 的特点包括：
- 资源是通过 URL 访问的，每个 URL 代表一类资源。
- 资源的状态由 HTTP 方法表示，如 GET 获取资源、POST 创建资源、PUT 更新资源、DELETE 删除资源。
- 资源的表现形式由 MIME 类型表示，如 JSON、XML、HTML 等。
使用 Deno 开发 RESTful API 的步骤和技巧
下面介绍使用 Deno 开发 RESTful API 的基本步骤和技巧。
步骤一：安装和配置 Deno
首先需要安装 Deno，可以通过以下命令安装：
curl -fsSL https://deno.land/x/install/install.sh | sh
安装完成后，需要配置环境变量，将 Deno 的可执行文件路径添加到 PATH 环境变量中。
步骤二：创建项目和依赖
可以使用 Deno 自带的包管理器 deno.land/x 来创建项目和安装依赖，也可以使用其他包管理器如 npm。
mkdir myapi cd myapi touch mod.ts
在 mod.ts 文件中添加以下代码：
// javascriptcn.com 代码示例
import { Application } from "https://deno.land/x/oak/mod.ts";
const app = new Application();
app.use((ctx) => {
ctx.response.body = "Hello, Deno!";
});
await app.listen({ port: 8000 });这段代码使用 Oak 框架创建了一个简单的 Web 服务器，监听 8000 端口，并返回 "Hello, Deno!" 字符串。
可以通过以下命令启动服务器：
deno run --allow-net mod.ts
访问 http://localhost:8000 可以看到返回的字符串。
步骤三：编写 RESTful API
接下来可以开始编写 RESTful API，以实现对资源的增删改查操作。
GET 方法
首先编写 GET 方法，用于获取资源列表或单个资源。可以使用路由来区分不同的资源和操作。
// javascriptcn.com 代码示例
import { Router } from "https://deno.land/x/oak/mod.ts";
const router = new Router();
interface Todo {
id: string;
title: string;
completed: boolean;
}
let todos: Todo[] = [
{ id: "1", title: "Learn Deno", completed: false },
{ id: "2", title: "Build RESTful API", completed: false },
];
router.get("/todos", (ctx) => {
ctx.response.body = todos;
});
router.get("/todos/:id", (ctx) => {
const todo = todos.find((t) => t.id === ctx.params.id);
if (todo) {
ctx.response.body = todo;
} else {
ctx.response.status = 404;
ctx.response.body = { message: "Todo not found" };
}
});
app.use(router.routes());这段代码定义了一个 Todo 接口和一个 todos 数组，用于存储 Todo 对象。GET /todos 路由返回整个 todos 数组，GET /todos/:id 路由根据 id 返回对应的 Todo 对象。如果找不到对应的 Todo 对象，则返回 404 状态码和错误信息。
POST 方法
接下来编写 POST 方法，用于创建新的资源。
// javascriptcn.com 代码示例
import { v4 } from "https://deno.land/std/uuid/mod.ts";
router.post("/todos", async (ctx) => {
const { value } = await ctx.request.body();
const todo: Todo = { id: v4.generate(), ...value };
todos.push(todo);
ctx.response.status = 201;
ctx.response.body = todo;
});这段代码使用 uuid 库生成唯一的 id，从请求体中获取新 Todo 对象的信息，创建新的 Todo 对象并添加到 todos 数组中。返回 201 状态码和新创建的 Todo 对象。
PUT 方法
接下来编写 PUT 方法，用于更新已有的资源。
// javascriptcn.com 代码示例
router.put("/todos/:id", async (ctx) => {
const { id } = ctx.params;
const { value } = await ctx.request.body();
const index = todos.findIndex((t) => t.id === id);
if (index !== -1) {
todos[index] = { ...todos[index], ...value };
ctx.response.body = todos[index];
} else {
ctx.response.status = 404;
ctx.response.body = { message: "Todo not found" };
}
});这段代码根据 id 找到对应的 Todo 对象，更新 Todo 对象的信息，并返回更新后的 Todo 对象。如果找不到对应的 Todo 对象，则返回 404 状态码和错误信息。
DELETE 方法
最后编写 DELETE 方法，用于删除已有的资源。
// javascriptcn.com 代码示例
router.delete("/todos/:id", (ctx) => {
const { id } = ctx.params;
const index = todos.findIndex((t) => t.id === id);
if (index !== -1) {
todos.splice(index, 1);
ctx.response.status = 204;
} else {
ctx.response.status = 404;
ctx.response.body = { message: "Todo not found" };
}
});这段代码根据 id 找到对应的 Todo 对象，从 todos 数组中删除该 Todo 对象，并返回 204 状态码。如果找不到对应的 Todo 对象，则返回 404 状态码和错误信息。
步骤四：测试 RESTful API
编写完 RESTful API 后，可以使用工具如 Postman 或 curl 来测试 API 是否正常工作。
以 Postman 为例，可以创建一个 GET 请求，访问 http://localhost:8000/todos，可以看到返回的 todos 数组。
可以创建其他请求来测试 POST、PUT 和 DELETE 方法，确保 API 正常工作。
总结
本文介绍了使用 Deno 进行 RESTful API 开发的步骤和技巧，包括安装和配置 Deno、创建项目和依赖、编写 RESTful API 和测试 API。通过本文的学习，读者可以了解 Deno 的基本特点和 RESTful API 的基本概念，掌握使用 Deno 开发 RESTful API 的基本步骤和技巧，为后续的 Web 开发工作打下坚实的基础。
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/6558197cd2f5e1655d253b81