go语言的webengine叫什么Java教程
Linux入门
更多
首页
?
Go语言WEB框架(Gin)详解
在 Go语言开发的 Web 框架中,有两款著名 Web 框架分别是 Martini 和 Gin,两款 Web 框架相比较的话,Gin 自己说它比 Martini 要强很多 。
Gin 是 Go语言写的一个 web 框架,它具有运行速度快,分组的路由器,良好的崩溃捕获和错误处理 , 非常好的支持中间件和 json 。总之在 Go语言开发领域是一款值得好好研究的 Web 框架,开源网址:
首先下载安装 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
}
编译运行程序,打开浏览器,访问页面显示:
{"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 是动态站点的模板 。
当然这个目录结构是一种约定,可以根据情况来修改 。整个项目已经开源,可以访问来详细了解:具体每个站点的功能怎么实现呢?请看下面有关每个功能的讲述:
静态资源站点
一般网站开发中,我们会考虑把 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
这些目录下资源是可以随时更新,而不用重新启动程序 。现在编译运行程序 , 静态站点就可以正常访问了 。
Go语言HTTPServer开发的六种实现学完了 net/http 和 fasthttp 两个HTTP协议接口的客户端实现 , 接下来就要开始Server的开发,不学不知道一学吓一跳,居然这两个库还支持Server的开发,太方便了 。
相比于Java的HTTPServer开发基本上都是使用Spring或者Springboot框架 , 总是要配置各种配置类,各种 handle 对象 。Golang的Server开发显得非常简单,就是因为特别简单,或者说没有形成特别统一的规范或者框架,我发现了很多实现方式,HTTP协议基于还是 net/http 和 fasthttp,但是 handle 语法就多种多样了 。
先复习一下: Golang语言HTTP客户端实践 、 Golang fasthttp实践。
在Golang语言方面,实现某个功能的库可能会比较多,有机会还是要多跟同行交流,指不定就发现了更好用的库 。下面我分享我学到的六种Server开发的实现Demo 。
基于 net/http 实现,这是一种比较基础的,对于接口和 handle 映射关系处理并不优雅,不推荐使用 。
第二种也是基于 net/http , 这种编写语法可以很好地解决第一种的问题,handle和path有了类似配置的语法,可读性提高了很多 。
第三个基于 net/http 和 github.com/labstack/echo ,后者主要提供了 Echo 对象用来处理各类配置包括接口和handle映射,功能很丰富,可读性最佳 。
第四种依然基于 net/http 实现,引入了 github.com/gin-gonic/gin 的路由,看起来接口和 handle 映射关系比较明晰了 。
第五种基于 fasthttp 开发 , 使用都是 fasthttp 提供的API , 可读性尚可,handle配置倒是更像Java了 。
第六种依然基于 fasthttp ,用到了 github.com/buaazp/fasthttprouter ,有点奇怪两个居然不在一个GitHub仓库里 。使用语法跟第三种方式有点类似,比较有条理,有利于阅读 。
golang 微服务开发(二)gin路由自动加载实现 // main.go
mirco_learn/routes/routes.go实现路由注册和路由的初始化
mirco_learn/app/app.go
mirco_learn/app/api/route.go
GO语言(十三):使用 Go 和 Gin 开发 RESTful API(下)当客户端在 发出POST请求时/albums , 您希望将请求正文中描述的专辑添加到现有专辑数据中 。
为此 , 您将编写以下内容:
1、编写代码
a.添加代码以将专辑数据添加到专辑列表 。
在此代码中:
1)用于Context.BindJSON 将请求正文绑定到newAlbum 。
2) album将从 JSON 初始化的结构附加到albums 切片 。
3)向响应添加201状态代码,以及表示您添加的专辑的 JSON 。
b.更改您的main函数,使其包含该router.POST函数,如下所示 。
在此代码中:
1)将路径中的POST方法与 /albumspostAlbums函数相关联 。
使用 Gin,您可以将处理程序与 HTTP 方法和路径组合相关联 。这样,您可以根据客户端使用的方法将发送到单个路径的请求单独路由 。
a.如果服务器从上一节开始仍在运行,请停止它 。
b.从包含 main.go 的目录中的命令行,运行代码 。
c.从不同的命令行窗口 , 用于curl向正在运行的 Web 服务发出请求 。
该命令应显示添加专辑的标题和 JSON 。
d.与上一节一样 , 使用curl检索完整的专辑列表,您可以使用它来确认添加了新专辑 。
该命令应显示专辑列表 。
当客户端向 发出请求时GET /albums/[id],您希望返回 ID 与id路径参数匹配的专辑 。
为此,您将:
a.在您在上一节中添加的函数下方postAlbums,粘贴以下代码以检索特定专辑 。
此getAlbumByID函数将提取请求路径中的 ID,然后找到匹配的专辑 。
在此代码中:
(1)Context.Param用于从 URL 中检索id路径参数 。当您将此处理程序映射到路径时,您将在路径中包含参数的占位符 。
(2)循环album切片中的结构,寻找其ID 字段值与id参数值匹配的结构 。如果找到,则将该album结构序列化为 JSON,并将其作为带有200 OK HTTP 代码的响应返回 。
如上所述,实际使用中的服务可能会使用数据库查询来执行此查找 。
(3)如果找不到专辑,则返回 HTTP 404错误 。
b.最后,更改您的main,使其包含对router.GET的新调用 , 路径现在为/albums/:id,如以下示例所示 。
在此代码中:
(1)将/albums/:id路径与getAlbumByID功能相关联 。在 Gin 中,路径中项目前面的冒号表示该项目是路径参数 。
a.如果服务器从上一节开始仍在运行 , 请停止它 。
b.在包含 main.go 的目录中的命令行中,运行代码以启动服务器 。
c.从不同的命令行窗口,用于curl向正在运行的 Web 服务发出请求 。
该命令应显示您使用其 ID 的专辑的 JSON 。如果找不到专辑,您将收到带有错误消息的 JSON 。
恭喜!您刚刚使用 Go 和 Gin 编写了一个简单的 RESTful Web 服务 。
本节包含您使用本教程构建的应用程序的代码 。
GoLang -- Gin框架? 何为框架:
框架一直是敏捷开发中的利器 , 能让开发者很快的上手并做出应用,甚至有的时候,脱离了框架,一些开发者都不会写程序了 。成长总不会一蹴而就,从写出程序获取成就感,再到精通框架,快速构造应用 , 当这些方面都得心应手的时候,可以尝试改造一些框架,或是自己创造一个 。
Gin是一个golang的微框架,封装比较优雅,API友好,源码注释比较明确,已经发布了1.0版本 。具有快速灵活,容错方便等特点 。其实对于golang而言,web框架的依赖要远比Python,Java之类的要小 。自身的net/http足够简单,性能也非常不错 。框架更像是一些常用函数或者工具的集合 。借助框架开发 , 不仅可以省去很多常用的封装带来的时间,也有助于团队的编码风格和形成规范 。
(1)首先需要安装,安装比较简单,使用go get即可
go getgithub.com/gin-gonic/gin
如果安装失败,直接去Github clone下来,放置到对应的目录即可 。
(2)代码中使用:
下面是一个使用Gin的简单例子:
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.GET("/ping", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "pong",
})
})
router.Run(":8080") // listen and serve on 0.0.0.0:8080
}
简单几行代码,就能实现一个web服务 。使用gin的Default方法创建一个路由handler 。然后通过HTTP方法绑定路由规则和路由函数 。不同于net/http库的路由函数,gin进行了封装,把request和response都封装到gin.Context的上下文环境 。最后是启动路由的Run方法监听端口 。麻雀虽小 , 五脏俱全 。当然,除了GET方法,gin也支持POST,PUT,DELETE,OPTION等常用的restful方法 。
Gin可以很方便的支持各种HTTP请求方法以及返回各种类型的数据 , 详情可以前往查看 。
2.1 匹配参数
我们可以使用Gin框架快速的匹配参数,如下代码所示:
冒号:加上一个参数名组成路由参数 。可以使用c.Param的方法读取其值 。当然这个值是字串string 。诸如/user/rsj217,和/user/hello都可以匹配,而/user/和/user/rsj217/不会被匹配 。
浏览器输入以下测试:
返回结果为:
其中c.String是gin.Context下提供的方法,用来返回字符串 。
其中c.Json是gin.Context下提供的方法,用来返回Json 。
下面我们使用以下gin提供的Group函数,方便的为不同的API进行分类 。
我们创建了一个gin的默认路由,并为其分配了一个组 v1 , 监听hello请求并将其路由到视图函数HelloPage,最后绑定到 0.0.0.0:8000
C.JSON是Gin实现的返回json数据的内置方法,包含了2个参数,状态码和返回的内容 。http.StatusOK代表返回状态码为200,正文为{"message": “welcome"} 。
注:Gin还包含更多的返回方法如c.String, c.HTML, c.XML等,请自行了解 。可以方便的返回HTML数据
我们在之前的组v1路由下新定义一个路由:
下面我们访问
可以看到,通过c.Param(“key”)方法,Gin成功捕获了url请求路径中的参数 。同理,gin也可以捕获常规参数,如下代码所示:
在浏览器输入以下代码:
通过c.Query(“key”)可以成功接收到url参数 , c.DefaultQuery在参数不存在的情况下 , 会由其默认值代替 。
我们还可以为Gin定义一些默认路由:
这时候,我们访问一个不存在的页面:
返回如下所示:
下面我们测试在Gin里面使用Post
在测试端输入:
附带发送的数据,测试即可 。记住需要使用POST方法.
继续修改,将PostHandler的函数修改如下
测试工具输入:
发送的内容输入:
返回结果如下:
备注:此处需要指定Content-Type为application/x-www-form-urlencoded,否则识别不出来 。
一定要选择对应的PUT或者DELETE方法 。
Gin框架快速的创建路由
能够方便的创建分组
支持url正则表达式
支持参数查找(c.Param c.Query c.PostForm)
请求方法精准匹配
支持404处理
快速的返回给客户端数据,常用的c.String c.JSON c.Data
【go语言gin离线 go语言如何】go语言gin离线的介绍就聊到这里吧,感谢你花时间阅读本站内容,更多关于go语言如何、go语言gin离线的信息别忘了在本站进行查找喔 。
推荐阅读
- 怎么设置触屏路由器密码,触屏无线路由器怎样设置
- evga1050显卡怎么样,evga1070显卡
- win7虚拟机中文版,win732虚拟机
- 怎么把歌上传到视频号里,怎么把歌曲上传
- python函数元祖 python元祖方法
- redis扩容自动迁移数据,redis 自动扩容
- 喜欢什么颜色视频网站,都喜欢什么颜色
- linux命令ln命令 linux中ln命令的用法
- 专业电视柜定制怎么样,电视柜定制效果图