REST API 曝露GET,POST,DELETE和PUT

无需加好友免费技术支持

假如你正在写任何方式的物品 Web 那么我很有可能会与应用软件协作 1 个或几个 REST API 互动，填好应用软件动态的一部分，实行升级或删除数据库中的信息等每日任务。

在这样一个实例教程中，我们将建立一个彻底完善的REST API 曝露GET，POST，DELETE和PUT随后，端点将容许您全方位开展CRUD实际操作。

为了能保持简单，致力于基本要素，我们不会与一切后面数据库系统互动储存我们将要所使用的文章。但是，我们将要以这样的方式写这书 REST API，那样我们就能很方便地升级界定的函数，便于他们能够后面启用数据库系统去执行一切必须的函数CRUD实际操作。

如果你想知道怎么使用它 Go 更多和数据库系统互动的数据，客户程序下列文章：

转至 MySQL 实例教程去 ORM 实例教程源码- 这儿都可以找到文中的一体化源码：

TutorialEdge/create-rest-api-in-go-tutorial

你需要在研发设备上组装它 Go 1.11 版本号。在实例教程结束后，你将懂得如何 Go 打造自己的 REST-ful API，解决各种问题。你将懂得如何在你的工程中创建它REST端点，能够解决POST，GET，PUT和 DELETEHTTP请求。

现如今，REST 从网址到公司使用，RESTful 架构风格是单独软件组件中间给予通讯的重要方式。 REST API 和消费者经营者能够很方便地分离，一般设计成无状态。

注 -倘若想知道 REST API 想要了解更多关于基本知识的数据，请参阅什么叫 RESTful API？

因为这个实例教程，我们将使用这些 JavaScript 庆幸的是，作为一种推送和接受全部信息的形式，目标表达法是幸运的 Go 应用标准库包 encoding/json 给这些格式编码和解码带来了一些出色的适用。

留意 -相关 encoding/json 其他信息，请参阅政府文件： encoding/json

为了能使我们比较容易，我们可以非常容易地选择所谓组队的东西了 GO 将算法设计转换成 JSON，它也会产生一个字节切成片，里面有一个比较长的字符串数组，没有更多的空缺。

最先，我们应该创建一个可以处理 HTTP 网络服务器规定非常简单。因此，我们将要创建一个名字main.go. 在这样一个 main.go我们应该在文档中界定它 3 函数不一样。一个homePage函数将解决我们的根 URL 全部规定，一个handleRequests将 URL 途径配对和界定函数配对函数main我将逐渐 API 的函数。

main.go

假如现在我们在大家的设备上运作它，我们要看到我们比较简单 API 在端口号 10000 它可能没被另一个全过程占有，之前运行。假如现在我们在当地电脑浏览器中导航栏，我们要Welcome to the HomePage!在屏上见到 打印内容。这就意味着己经很好地设立了我们将要创建的东西了 REST API 的前提。

留意 -如果你想要根据怎样创建更深层次的基本 Go 的 Web 请在这里查询服务器教程： Creating a Simple Web Server with Go(Lang)

我们将要创建一个REST API，让我们可以CREATE，READ，UPDATE和 DELETE大家网站上的文章。在我们讨论它时CRUDAPI 大家是指可以解决这所有的一切每日任务 API：创建、载入、刷新和删掉。

我们应该在开始前界定大家Article构造。Go 这类构造的定义特别适合这样的事情。使我们创造一个Article标题，叙述 (desc) 和的内容 构造如下所示：

我们自己的 Struct 它包括意味着大家平台上全部文章所需要的具体内容 3 个特性。为了能使它工作中，大家也必须 "encoding/json"包导进我们自己的导进目录。

如今使我们升级大家的main为我们自己的Articles之后可以查找和调整的自变量添充一些虚拟数据。

极致，使我们再次造就我们自己的/articles端点，这将回到大家刚界定的全部文章。

在教学视频的这一部分，我们将要创建一个新的 REST 当接到端点HTTP GET请求时，这将回到大家网站上的全部文章。

我们将要最先创建一个名字 新的函数returnAllArticles，该函数将回到新填充料Articles以 JSON 自变量文件格式编号的头号公敌：

main.go

启用将json.NewEncoder(w).Encode(article)我们自己的文章二维数组编号为 JSON 字符串数组，随后做为回应的一部分载入。

在它起效以前，我们依然需要大家handleRequests 加上一个新的路由函数，它把所有启用投射

新定义的函数。

我们现在已通过实际操作编码实现了此项工作go run main.go，随后

浏览器打开，你就应该见到文章目录 JSON 表明如下所示：

回应

己经很好地界定了我们第一个 API 端点。

您将于本系列下一部分升级 REST API 以便用gorilla/mux无线路由器而非常规net/http路由器。

互换无线路由器将使你比较容易出任务，比如，剖析可能滞留HTTP以后我们必须在请求中传送一切途径或查询参数 。

如今标准库足够让你自己简易 REST API 运行和运作所需要的一切，但是现在己经理解了基本要素，我觉得是情况下引进第三方无线路由器包了。最著名和使用率最高的是 gorilla/mux 无线路由器，由器 Github 上面有 2,281 颗星。

我们可以升级大家目前的main.go并互换一个文档gorilla/mux 根据HTTP无线路由器路由器替代了之前的标准库。

改动您的handleRequests创建新路由器的函数。

main.go

如果你如今实际操作它时，你肯定不会看到我们全面的工作方式出现了真正意义上的转变。它依然会在同一端口号运行并回到同样的结论，主要取决于您点一下的端点。

唯一真正意义上的区别在于现在我们有一个 gorilla/mux 无线路由器容许大家在本实例教程后边轻轻松松实行查找途径和查询参数等行为。

$ 去运作 main.go

到现在为止，一切都很成功，大家创造了一个特别简单的 REST API，它返回一个首页跟我们每一个文章。但如果大家只想要查询一篇文章会有什么呢？

得益于 gorilla mux 在无线路由器中，我们可以在途径中加入自变量，再根据这种变量选择我们要想返回文章。handleRequests在我们自己的/articles路线下边：

一定要注意，大家加了它{id}在大家的道路上。这将会意味着大家 id 自变量，当我们要想只返回具备准确键的文章时，我们将要能使用它。现阶段，我们自己的Article构造并没有 Id 特性。如今使我们补充一下：

随后我们可以升级大家的main在字符串中添充函数Id值 Articles：

我们现在已经完成，在咱们的returnSingleArticle在函数中，我们可以{id}从我们自己的 URL 为了获取这一值，我们可以回到合乎这些条件的文章。由于我们并没有在任何时候存放数据，因此我们只能回到传送给电脑浏览器 Id。

假如我们

你就应该在如今运作后见到导航栏Key: 打印出用浏览器中。

我们要用这一key值回到与键相匹配的特殊文章。

根据启用实际操作go run main.go，随后

浏览器打开：

回应

如今你将看到和1作为一个 JSON 返回键配对文章。

我们将在教学视频的这一部分创建哪些Create，Update和 DELETE一个一部分CRUDREST API。己经包括了R阅读文章每篇文章以及所有文章能力。

再一次，你必须创建一个新函数来创建这篇文章新文章。

使我们从createNewArticle()在咱们的main.go在文档中创建函数逐渐。

界定此函数后，您现在能将路由器导入到函数中界定的路由器页面上handleRequests。但这一次，我们将要加上它.Methods("POST") 特定大家只想要在路由器的结尾传到请求HTTP POST请求时启用此函数：

再试一次，随后尝试递交HTTP POST包含下列POST文字规定：

我们自己的端点将开启并显示文本中的所有值。

你现在早已证明了新端点有没有问题工作中，使我们升级大家createNewArticle函数，那样它就能本里的函数 JSON 解组为新的Article建筑结构，能够额外到的身上Articles数组里：

令人惊讶的！如果说你实际操作它，POST并向大家的应用软件推送同样的请求，你将看见它回到与之前同样的请求 JSON 文件格式，但是它也会给你加上新文章Articles数组里。

点一下认证如今

回应

你如今通过了Create一个新的 REST API加上函数！

在实例教程的后一部分，你将了解怎么添加一个新的 API 容许您删掉文章的端点。

有时候你可能还需要删掉它 REST API 公开数据。因而，你需要DELETE在 API 公布一个端点，该端点将接受标志符并删掉与标志符有关的所有具体内容。

在教学视频的这一部分，你将创建另一个端点，接受端点HTTP DELETE请求、删掉和给出Id配对途径参数文章 。

向大家的main.go在文档中加入新函数，我们将要启用函数deleteArticle：

又一次，你必须去handleRequests投射到一个新的deleteArticle函数函数加上路由器：

试着向 推送新HTTP DELETE请求

这将会删除你文章二维数组里的第二篇文章，如果你接着

传出HTTP GET请求时，你就应该看见它如今只包括一个Article.

留意- 以便简易考虑，大家正在更新一个全世界自变量。但是，我们不会做出任何查验，以保证我们自己的编码并没有竞争条件。为了能安全代码进程，个人觉得查询我的信息Go Mutexes 的许多实例教程

你必须完成的最后一个端点是 Update 端点。这一端点将是一个端点。HTTP PUT根据端点，必须受到一个Id途径主要参数就像我对他们的一样HTTP DELETE相同的端点，以及一个 JSON 请求文章正文。

传到HTTP PUT请求文章正文里的此 JSON升级版本将包括我们要想升级更新的文章。

试着在updateArticle在函数中创建函数和对应的路由器 handleRequests。这将会与PUT请求配对。进行此程序后，请选择函数中常用的同样编码来达到此实际操作updateArticle它能够剖析函数HTTP请求正文createNewArticle。

最终，你需要赋值Articles配对并升级二维数组里的文章。

这个案例意味着了一个应用 Go 写得很简易 RESTful API。在具体工程中，我们一般把与数据库系统结合起来，便于大家回到真实值。

源码- 这儿都可以找到本实例教程的一体化源码：

TutorialEdge/create-rest-api-in-go

如果喜欢这篇文章文章，你也有可能喜爱下列实例教程：

设计方案生产制造准备就绪 REST API转至 MySQL 实例教程