GIN介绍
Gin是一个golang的微框架,封装比较优雅,API友好,源码注释比较明确,具有快速灵活,容错方便等特点
对于golang而言,web框架的依赖要远比Python,Java之类的要小。自身的net/http
足够简单,性能也非常不错
借助框架开发,不仅可以省去很多常用的封装带来的时间,也有助于团队的编码风格和形成规范
Gin 最擅长的就是 Api 接口的高并发,如果项目的规模不大,业务相对简单,这个时候我们也推荐您使用 Gin。
当某个接口的性能遭到较大挑战的时候,这个还是可以考虑使用 Gin 重写接口。
Gin 的官网: Gin Web Framework (gin-gonic.com)
安装
要安装 Gin 软件包,需要先安装 Go 并设置 Go 工作区。
1.下载并安装 gin:
$ go get -u github.com/gin-gonic/gin
2.将 gin 引入到代码中:
import "github.com/gin-gonic/gin"
3.(可选)如果使用诸如 http.StatusOK
之类的常量,则需要引入 net/http
包:
import "net/http"
http.statusok就是状态码200
基本路由
-
gin 框架中采用的路由库是基于httprouter做的
-
地址为:https://github.com/julienschmidt/httprouter
路由概述
路由(Routing)是由一个 URI(或者叫路径)和一个特定的 HTTP 方法(GET、POST 等)组成
的,涉及到应用如何响应客户端对某个网站节点的访问。
RESTful API 是目前比较成熟的一套互联网应用程序的 API 设计理论,所以我们设计我们的路由的
时候建议参考 RESTful API 指南。
GET(SELECT) | 从服务器取出资源(一项或多项) |
POST(CREATE) | 在服务器新建一个资源 |
PUT(UPDATE) | 在服务器更新资源(客户端提供改变后的完整资源) |
DELETE(DELETE) | 从服务器删除资源 |
简单的路由配置
测试我使用的是Apipost7测试工具
route.GET("/",func (c *gin.Context){c.String(http.StatusOK,"Get获取页面信息")})
gin.Context,封装了request和response
package main
// (可选)如果使用诸如 http.StatusOK 之类的常量,则需要引入 net/http 包:
import ("github.com/gin-gonic/gin""net/http")func main(){//创建一个默认路由route := gin.Default()//配置路由// gin.Context,封装了request和responseroute.GET("/",func (c *gin.Context){c.String(http.StatusOK,"Get获取页面信息")})route.GET("/ping",func(c *gin.Context){c.String(200,"可配置多个GET方法来进行测试")})route.POST("/add",func (c *gin.Context){c.String(http.StatusOK,"post方法主要用于在服务器新建一个资源")})route.PUT("justice",func(c *gin.Context){c.String(200,"put方法在服务器更新资源,客户端提供改变后的完整资源")})route.DELETE("/delete",func(c *gin.Context){c.String(200,"从服务器删除资源")})//定义监听的端口route.Run(":8210")
}
c.String() c.JSON() c.JSONP() c.XML() c.HTML()
返回一个字符串
r.GET("/",func(ctx *gin.Context) {ctx.String(http.StatusOK,"%v","返回的字符串")})
返回一个 JSON 数据
r.GET("/json" ,func(ctx *gin.Context) {ctx.JSON(http.StatusOK,map[string]interface{}{"title" :"地区","city":"城市",})})
//gin.H其实就是封装的是mapr.GET("/json1" ,func(ctx *gin.Context) {ctx.JSON(http.StatusOK,gin.H{"title" :"地区","city":"城市","province":"曹县",})})
gin.H其实就是封装的是map
搞一个结构体
package main
import("net/http""github.com/gin-gonic/gin")type Structdemo struct{Name string `json:"name"`Age int `json:"age"`Servant string `json:"servant"`
}func main(){r.GET("/json2",func(ctx *gin.Context) {a := &Structdemo{Name: "卫宫士郎",Age: 19,Servant: "sabar",}ctx.JSON(http.StatusOK,a)})}
切换标题的操作
r.GET("/json3",func(ctx *gin.Context) {type People struct{Name string `json:"name"`Servant string `json:"servant"`}b := &People{Name: "远坂凛",Servant: "archer",}ctx.JSON(http.StatusOK,b)
})
响应Jsonp请求
JSONP的原理是通过动态创建<script>标签,并设置其src属性为目标数据源的URL。目标数据源在服务端返回的响应数据需要用一个回调函数进行包裹,这样在客户端收到数据时,将会直接执行回调函数,从而将数据传递到客户端。这样就实现了在不同域之间获取数据的需求和跨域的限制。
// http://localhost:8080/jsonp?callback=xxxx
r.GET("/jsonp", func(ctx *gin.Context) {d := &Structdemo{Name: "卫宫士郎",Age: 19,Servant: "sabar",}ctx.JSONP(200, d)})
返回 XML 数据
r.GET("/xml", func(ctx *gin.Context) {ctx.XML(http.StatusOK,gin.H{"title":"页面","information":123,})})