From 4875598bee305ba51b20b5d9f3d0fb86cf0ab715 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E6=B5=B7=E4=B8=9C?= <41251046+lhd951220@users.noreply.github.com> Date: Tue, 2 Jun 2020 11:50:56 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BD=BF=E7=94=A8=20Deno=20=E5=92=8C=20Oak=20?= =?UTF-8?q?=E6=9E=84=E5=BB=BA=20CRUD=20API=20(#7124)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 使用 Deno 和 Oak 构建 CRUD API 使用 Deno 和 Oak 构建 CRUD API * 使用 Deno 和 Oak 构建 CRUD API 使用 Deno 和 Oak 构建 CRUD API * 已根据第一位校对者意见完成修改 * Update building-crud-apis-using-deno-and-oak.md Co-authored-by: sun <776766759@qq.com> --- .../building-crud-apis-using-deno-and-oak.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/article/2020/building-crud-apis-using-deno-and-oak.md b/article/2020/building-crud-apis-using-deno-and-oak.md index f0babbc4..b4a78fb4 100644 --- a/article/2020/building-crud-apis-using-deno-and-oak.md +++ b/article/2020/building-crud-apis-using-deno-and-oak.md @@ -2,26 +2,26 @@ > * 原文作者：[Kailas Walldoddi](https://medium.com/@kailashwall) > * 译文出自：[掘金翻译计划](https://github.com/xitu/gold-miner) > * 本文永久链接：[https://github.com/xitu/gold-miner/blob/master/article/2020/building-crud-apis-using-deno-and-oak.md](https://github.com/xitu/gold-miner/blob/master/article/2020/building-crud-apis-using-deno-and-oak.md) -> * 译者： -> * 校对者： +> * 译者：[lhd951220](https://github.com/lhd951220) +> * 校对者：[MangoTsing](https://github.com/MangoTsing) -# Building CRUD APIs using Deno and oak +# 使用 Deno 和 Oak 构建 CRUD API ![Building CRUD api’s using Deno and oak](https://cdn-images-1.medium.com/max/2420/1*7H0kXkVQGqg-pto23TY_eQ.png) -Deno is fairly new environment compared to Node. One of the first thing that a developer would want to do while learning Deno is to build CRUD api’s. Deno has several several projects which help us achieve this namely, [deno-express](https://github.com/NMathar/deno-express), [oak](https://github.com/oakserver/oak), [servest](https://github.com/keroxp/servest), [deno-drash](https://github.com/drashland/deno-drash),and [pogo](https://github.com/sholladay/pogo). In this article we will learn about building a todo list using Deno and Oak. +相对于 Node 来说，Deno 是相当新的环境。开发者在学习 Deno 的时候通常想做的第一件事就是构建 CRUD API。Deno 有一系列的项目帮助我们实现这个目的，包括 [deno-express](https://github.com/NMathar/deno-express)、[oak](https://github.com/oakserver/oak)、[servest](https://github.com/keroxp/servest)、[deno-drash](https://github.com/drashland/deno-drash) 和 [pogo](https://github.com/sholladay/pogo)。在这篇文章，我们将会使用 Deno 和 Oak 学习构建一个待办事项清单。 -#### What are we building? +#### 我们要构建什么? -Oak is project that has been inspired by [Koa](https://github.com/koajs/koa), a popular Node.js HTTP middle-ware framework. We will use oak and Deno to build a small application which will deal with todos list. The api we are going to build will have following end points. +Oak 是一个受到 [Koa](https://github.com/koajs/koa) 启发的项目，Koa 是一个很受欢迎并提供 HTTP 服务的 Node.js 中间件框架。我们将会使用 oak 和 Deno 构建一个处理待办实现清单的小应用。我们将要创建的 API 如下面的 Endpoint 显示。 ![List of API end points](https://cdn-images-1.medium.com/max/2000/1*gIltBeBAq5xdY7vpW-sFag.png) -#### How are we building it? +#### 我们如何构建它? -we need to create two files **app.ts** and **routes.ts** in our project repository. one for app and other one for serving routes. +我们需要在我们的项目库中创建两个文件，分别是 **app.ts** 和 **routes.ts**。一个用于应用，另一个则是用于服务的路由。 -The content of **app.ts** file is as shown in following gist file. Look at how we are importing Application module from oak in **app.ts** file. We create a new oak application at line #8. we make this app use the routes we will later define in **routes.ts** file. Now this app will run on the specified host and port given on line#5 and line #6. +**app.ts** 文件的内容如下面的文件显示。看看我们是如何在 **app.ts** 文件中从 oak 引入 Application 模块的。我们在第 8 行创建了新的 oak 应用。我们让这个应用使用了稍后将会在 **routes.ts** 文件中定义的路由。现在，这个应用将可以运行在第 6 行指定的地址和第 5 行指定的端口上。 ```TypeScript import { Application } from 'https://deno.land/x/oak/mod.ts'; @@ -41,7 +41,7 @@ console.log(`Listening on port ${PORT}...`) await app.listen(`${HOST}:${PORT}`) ``` -We will create an interface for Todo in **routes.ts** which will have two fields **id** and **description**. we will store todo id and todo description in these fields respectively. We also have a **todos** list with initial values to be returned for the first time. +我们将会在 **routes.ts** 中创建一个 Todo 接口，该接口包含两个字段 **id** 和 **description**。我们将会使待办事项的 id 和待办事项的描述分别存储在这两个字段上。我们还有一个待办事项清单，其中包含首次返回时使用的初始清单。 ```TypeScript interface Todo { @@ -61,7 +61,7 @@ let todos: Array = [ ] ``` -We will now define functions to support the listing operation of todos, fetching specific todo by id, creation of new todo, update/delete of specific todo description by id. The code for the same can be seen in following gist file. +我们现在来定义一些支持待办事项的列表操作的相关函数，通过 id 获取指定的待办事项，创建新的待办事项，通过 id 更新/删除指定待办事项的描述。可以从下面的文件中看到类似的代码。 ```TypeScript export const getTodos = ({ response }: { response: any }) => { @@ -160,7 +160,7 @@ export const getHome = ({ response }: { response: any }) => { } ``` -We have created and exported routes to consume these functions as following. +我们通过下面的函数创建并导出了路由。 ```TypeScript import { Router } from 'https://deno.land/x/oak/mod.ts' @@ -175,11 +175,11 @@ router .delete('/todos/:id', removeTodo) ``` -Run the following command to get the app running on [http://localhost:4000,](http://localhost:4000,) +运行以下命令即可让应用运行在 [http://localhost:4000](http://localhost:4000) 上 > **deno run — allow-env — allow-net app.ts** -Now that the app is running on localhost:4000, use postman or similar apps for testing the api endpoints. Following are screenshot of the results in postman. +现在，应用运行在 localhost:4000 上，使用 postman 或者其他类似的工具来测试这些 API 路由接口。以下是使用 postman 测试得到的结果的屏幕截图。 ![Health Check API respone](https://cdn-images-1.medium.com/max/2814/1*t3M9YRG9BL6SLkZ8c8rk9w.png) @@ -191,9 +191,9 @@ Now that the app is running on localhost:4000, use postman or similar apps for t ![DELETE operation to delete todo by Id.](https://cdn-images-1.medium.com/max/2820/1*9gQDicmapSbarTQsNgCcnA.png) -**If you simple want to clone the code, I used in this article and see how it is working. you can checkout the code from GitHub using following link.** +**如果你想克隆我在文章中使用的代码，以此观察它是如何工作的。你可以使用下面的链接在 GitHub 上查看。** -**Source-Code link :**[ https://github.com/Kailashw/deno-api-oak](https://github.com/Kailashw/deno-api-oak) +**源码链接 :**[ https://github.com/Kailashw/deno-api-oak](https://github.com/Kailashw/deno-api-oak) > 如果发现译文存在错误或其他需要改进的地方，欢迎到 [掘金翻译计划](https://github.com/xitu/gold-miner) 对译文进行修改并 PR，也可获得相应奖励积分。文章开头的 **本文永久链接** 即为本文在 GitHub 上的 MarkDown 链接。