Linux入门
更多>>
首页
Go语言WEB框架(Gin)详解
在 Go语言开发的 Web 框架中，有两款著名 Web 框架分别是 Martini 和 Gin，两款 Web 框架相比较的话，Gin 自己说它比 Martini 要强很多。
Gin 是 Go语言写的一个 web 框架，它具有运行速度快，分组的路由器，良好的崩溃捕获和错误处理，非常好的支持中间件和 json。总之在 Go语言开发领域是一款值得好好研究的 Web 框架，开源网址：https://github.com/gin-gonic/gin
首先下载安装 gin 包：
go get -u github.com/gin-gonic/gin
一个简单的例子：
package main
import "github.com/gin-gonic/gin"
func main() {
//Default返回一个默认的路由引擎
r := gin.Default()
r.GET("/ping", func(c *gin.Context) {
//输出json结果给调用方
c.JSON(200, gin.H{
"message": "pong",
})
})
r.Run() // listen and serve on 0.0.0.0:8080
}
编译运行程序，打开浏览器，访问http://localhost:8080/ping页面显示：
{"message":"pong"}
gin 的功能不只是简单输出 Json 数据。它是一个轻量级的 WEB 框架，支持 RestFull 风格 API，支持 GET，POST，PUT，PATCH，DELETE，OPTIONS 等 http 方法，支持文件上传，分组路由，Multipart/Urlencoded FORM，以及支持 JsonP，参数处理等等功能，这些都和 WEB 紧密相关，通过提供这些功能，使开发人员更方便地处理 WEB 业务。
Gin 实际应用
接下来使用 Gin 作为框架来搭建一个拥有静态资源站点，动态 WEB 站点，以及 RESTFull API 接口站点（可专门作为手机 APP 应用提供服务使用）组成的，亦可根据情况分拆这套系统，每种功能独立出来单独提供服务。
下面按照一套系统但采用分站点来说明，首先是整个系统的目录结构，website 目录下面 static 是资源类文件，为静态资源站点专用；photo 目录是 UGC 上传图片目录，tpl 是动态站点的模板。
当然这个目录结构是一种约定，可以根据情况来修改。整个项目已经开源，可以访问来详细了解：https://github.com/ffhelicopter/tmm具体每个站点的功能怎么实现呢？请看下面有关每个功能的讲述：
静态资源站点
一般网站开发中，我们会考虑把 js，css，以及资源图片放在一起，作为静态站点部署在 CDN，提升响应速度。采用 Gin 实现起来非常简单，当然也可以使用 net/http 包轻松实现，但使用 Gin 会更方便。
不管怎么样，使用 Go 开发，我们可以不用花太多时间在 WEB 服务环境搭建上，程序启动就直接可以提供 WEB 服务了。
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
// 静态资源加载，本例为css,js以及资源图片
router.StaticFS("/public", http.Dir("D:/goproject/src/github.com/ffhelicopter/tmm/website/static"))
router.StaticFile("/favicon.ico", "./resources/favicon.ico")
// Listen and serve on 0.0.0.0:80
router.Run(":80")
}
首先需要是生成一个 Engine，这是 gin 的核心，默认带有 Logger 和 Recovery 两个中间件。
router := gin.Default()
StaticFile 是加载单个文件，而 StaticFS 是加载一个完整的目录资源：
func (group *RouterGroup) StaticFile(relativePath, filepath string) IRoutes
func (group *RouterGroup) StaticFS(relativePath string, fs http.FileSystem) IRoutes
这些目录下资源是可以随时更新，而不用重新启动程序。现在编译运行程序，静态站点就可以正常访问了。
和有些小伙伴一样，本人是从php转到了go,从事php时使用symfony框架一直享受其丰富的功能带来的便利，转到其他语言时比较直观的感觉就是twig真强，为什么其他语言没有扩展twig呢？
虽然前后端的开发模式，让模板引擎这个东西慢慢淡去，但是有时候还是需要用到这种东西，所以就有了，go调用php实现twig模板引擎的想法。
原理，go 通过exec.Command调用php,通过STDIN,STDOUT 方式进行数据交互
go在初始化阶段提供一些配置参数，比如模板引擎的为止，是否为开发环境等，php接收数据并初始化
初始换环境完毕后，当需要渲染模板，go再讲模板文件和数据以json字符串的形式写入STDIN告知php,
php接收到数据后，解析数据，选取指定的模板并渲染，然后通过STDOUT返回给go
这样一次渲染就结束了
整理好的文件打包在github上了
如果喜欢就动动你的小手指点个赞，star一下吧！
欢迎golang同胞！在本教程中，我们将研究如何在基于 Go 的程序中与 GraphQL 服务器进行交互。在本教程结束时，我们应该知道如何执行以下操作：
在本教程中，我们将专注于学习 GraphQL 的数据检索方面，并且我们将使用内存中的数据源来支持它。这应该为我们在后续教程的基础上建立一个良好的基础。
好的，所以在我们深入研究之前，我们应该真正了解 GraphQL 的基础知识。作为开发人员，使用它对我们有什么好处？
好吧，考虑使用每天处理数十万甚至数百万请求的系统。传统上，我们会使用位于数据库前面的系统 API，它会返回大量 JSON 响应，其中包含许多我们可能不一定需要的冗余信息。
如果我们正在处理大规模的应用程序，发送冗余数据的成本可能会很高，并且由于有效负载大小会阻塞我们的网络带宽。
GraphQL基本上可以让我们以减少噪音和描述数据，我们希望让我们的检索，从我们的API中检索 只有 我们需要为我们当前的任务/视图/不管。
这只是该技术为我们提供的众多好处的一个例子。希望在接下来的教程系列中，我们会提前看到更多这些好处。
需要注意的重要一点是，GraphQL 不像我们传统的 SQL 那样是一种查询语言。它是位于我们 API 前面的抽象， 不 依赖于任何特定的数据库或存储引擎。
这真的很酷。我们可以建立一个与现有服务商交互的 GraphQL 服务器，然后围绕着这个新的 GraphQL 服务器构建，而不必担心修改现有的 REST API。
让我们看看 RESTful 方法与 GraphQL 方法有何不同。现在，假设我们正在构建一个返回该站点上所有教程的服务，如果我们想要特定教程的信息，我们通常会创建一个 API 端点，允许我们根据 ID 检索特定教程：
如果给定一个 valid ID，这将返回一个响应，看起来像这样：
现在，假设我们想创建一个小部件，列出该作者撰写的书籍 5 个帖子。我们可以点击/author/:id端点以检索该作者撰写的所有帖子，然后进行后续调用以检索前 5 个帖子中的每一个。或者，我们可以制作一个全新的端点来为我们返回这些数据。
这两种解决方案听起来都不是特别吸引人，因为它们会创建不需要的请求量或返回过多的数据，这突出了 RESTful 方法开始出现一些裂缝的地方。
这就是 GraphQL 发挥作用的地方。使用 GraphQL，我们可以定义我们希望在查询中返回的数据的确切结构。所以如果我们想要上面的信息，我们可以创建一个看起来像这样的查询：
这将随后返回我们的教程、该教程的作者和一组表示该作者编写的教程的教程 ID，而无需发送额外的 x 多个 REST 请求来获取信息！那有多好？
好的，现在我们对 GraphQL 以及对它的用途有了更多的了解，让我们在实践中看看它。
我们将使用graphql-go/graphql实现在 Go 中创建一个简单的 GraphQL 服务器 。
让我们首先使用go mod init以下方法初始化我们的项目：
接下来，让我们创建一个名为main.go. 我们将从简单开始创建一个非常简单的 GraphQL 服务器，它具有一个非常简单的解析器：
现在，如果我们尝试运行它，让我们看看会发生什么：
所以，如果一切正常，那么我们就可以设置一个非常简单的 GraphQL 服务器并对这个服务器进行非常简单的查询。
让我们分解上面代码中发生的事情，以便我们可以进一步扩展它。在lines 14-21我们定义我们的Schema. 当我们对我们的 GraphQL API 进行查询时，我们基本上定义了我们想要返回给我们的对象上的哪些字段，因此我们必须在我们的 Schema 重新定义这些字段。
在 上line 17，我们定义了一个解析器函数，每当field请求此特定内容时就会触发该解析器函数。现在，我们只是返回字符串 "world"，但我们将实现从这里查询数据库的能力。
让我们看一下main.go文件的第二部分。在line 30我们开始定义query请求领域hello。
然后我们创建一个params结构，其中包含对我们定义的Schema以及我们的RequestString请求的引用 。
最后，在line 36我们执行请求并将请求的结果填充到r. 然后我们进行一些错误处理，然后将响应编组为 JSON 并将其打印到我们的控制台上。
现在我们已经启动并运行了一个非常简单的 GraphQL 服务器，并且我们能够对其进行查询，让我们更进一步，构建一个更复杂的示例。
我们将创建一个 GraphQL 服务器，它返回一系列内存中的教程及其作者，以及对这些特定教程的任何评论。
让我们定义一些struct代表 a Tutorial、 anAuthor和 a 的's Comment：
然后我们可以创建一个非常简单的populate()函数，它将返回一个类型数组Tutorial：
这将为我们提供一个简单的教程列表，然后我们可以稍后解决。
我们将从使用 GraphQL 创建一个新对象开始graphql.NewObject()。我们将使用 GraphQL 的严格类型定义 3 种不同的类型，它们将与structs我们已经定义的 3 种相匹配。
我们的Commentstruct 可以说是最简单的，它只包含一个 string Body，所以我们可以commentType很容易地将其表示为：
接下来，我们将处理该Author结构并将其定义为一个新的 graphql.NewObject(). 这会稍微复杂一些，因为它既有一个 String字段，也有一个Int值列表，这些值代表他们编写的教程的 ID。
最后，让我们定义我们的tutorialTypewhich 将封装 an author和comment's的数组以及 anID和 a title：
现在我们已经定义了我们的Type系统，让我们着手更新我们的 Schema 以反映这些新类型。我们将定义 2 个 distinct Field，第一个将是我们的tutorial字段，它允许我们Tutorials 根据传入查询的 ID检索个人。第二个将是一个list字段，它将允许我们检索Tutorials我们在内存中定义的完整数组。
所以我们已经创建了我们的类型并更新了我们的 GraphQL 模式，我们做得还不错！
让我们尝试使用我们的新 GraphQL 服务器并处理我们提交的查询。让我们来尝试我们的list架构改变query ，我们已经在我们得到main()的功能：
让我们分解一下。所以在我们的查询中，我们有一个特殊的root对象。然后我们在其中说我们想要该list对象上的字段。在返回的名单list，我们希望看到的id，title，comments和 author。
当我们运行它时，我们应该会看到以下输出：
正如我们所见，我们的查询以 JSON 格式返回了我们所有的教程，看起来非常像我们初始查询的结构。
现在让我们尝试对我们的tutorial模式进行查询：
再一次，当我们运行它时，我们应该看到它已经成功地检索了内存中的单独教程ID=1：
完美，看起来我们已经让list我们的tutorial模式和我们的模式都按预期工作了。
这就是我们将在这个初始教程中介绍的全部内容。我们已经成功地设置了一个简单的 GraphQL 服务器，该服务器由内存数据存储支持。
在下一个教程中，我们将研究 GraphQL 突变并更改我们的数据源以使用 SQL 数据库
