Gin 框架入门实战系列（一）

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和response
	route.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其实就是封装的是map
	r.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,
		})
	})