简介
Gin是目前应用比较广泛的Golang web框架。Gin提供了web开发的一些基本功能。比如路由,中间件,日志,参数获取等。Gin的路由功能是基于https://github.com/julienschmidt/httprouter 这个项目实现的。它是一个类似于martini但拥有更好性能的API框架,由于使用了httprouter,速度提高了40倍。gin中文文档,地址https://gin-gonic.com/zh-cn/docs/
Gin安装和使用
下载并安装
go get -u github.com/gin-gonic/gin
安装完毕后,可以在当前系统得$GOPATH目录下得src/github.com目录中找到gin-goni目录,该目录下存放的就是gin框架的源码 go env 可以查看GOPATH路径
在文档服务器里面
1.首先创建mod
git mod init 项目名
2.go get -u -v 把需要的包拉到mod
3.完成后生成 .sum
使用
示例
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
//创建一个默认的路由引擎
r := gin.Default()
//GET:请求方式; /hello :请求的路径
//当客户端以GET方法请求/hello路径时,会执行后面的匿名函数
r.GET("/hello", func(c *gin.Context) {
//c.Json:返回JSON格式的数据
c.JSON(200, gin.H{
"message": "Hello world",
})
})
//启动HTTP服务,默认在0.0.0.0:8080 启动服务
r.Run()
err !=nil{
log.Fatal(err.Error)
}
}
1.func Default()*Engine{ }
gin.Default()返回的是一个指针类型,路由引擎
2.返回的指针类型包含了一个run()方法,run方法返回一个error类型
3.可以用err接收返回的error类型,判断是否为空,如果不为空的话,就打印log.Fatal(err.Error())
4.返回的指针类型engine还包含get方法,第一个参数是解析的路径,第二个是func函数处理get请求,
发现端口已被占用
法一:修改监听的端口
法二:将端口释放
查看端口的占用情况(linux)
-t (tcp) 仅显示tcp相关选项
-u (udp)仅显示udp相关选项
-n 拒绝显示别名,能显示数字的全部转化为数字
-l 仅列出在Listen(监听)的服务状态
-p 显示建立相关链接的程序名
根据端口找到对应的进程
restful API
REST是客户端与web服务器之间进行交互的时候,使用HTTP协议中的4个请求方法代表不同的动作。
GET用来获取资源
POST用来新建资源
PUT用来更新资源
DELETE永安里删除资源
只要API程序遵循了REST风格,那就可以称其为RESTful API 。前后端基本都是通过RESTful API来进行交互。
编写一个管理书籍的系统,查询对一本书进行查询,创建,更新和删除等操作,我们在编写程序的时候就要设计客户端浏览器与我们web服务端交互的方式和路径。按照经验我们通常设计如下模式
同样的需求我们按照RESTful AP设计
相关代码
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
//创建一个默认的路由引擎
r := gin.Default()
//GET:请求方式; /hello :请求的路径
//当客户端以GET方法请求/hello路径时,会执行后面的匿名函数
r.GET("/book", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "GET",
})
})
r.POST("/book", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "POST",
})
})
r.PUT("/book", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "PUT",
})
})
r.DELETE("/book", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "DELETE",
})
})
//
//r.Run()启动HTTP服务,默认在0.0.0.0:8080 启动服务 如果是自己电脑就是本地ip(127.0.0.1)
//但是此时我用的环境的ip是192.168.12.112:9000 所以访问的时候用192.168.12.112
r.Run("0.0.0.0:9000")
}
}
开发RESTful API的时候我们通常使用Postman来作为客户端测试工具
GET请求
POST请求
PUT请求
DELETE请求
Gin渲染
HTML渲染
首先定义一个存放模板文件的templates文件夹,然后再内部按照业务分别定义一个posts文件夹和users文件夹,posts/index.html文件的内容如下:
{{define "posts/index.html"}}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>posts/index</title>
</head>
<body>
{{.title}}
</body>
</html>
{{end}}
user/index.html文件内容如下:
{{define "users/index.html"}}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>users/index</title>
</head>
<body>
{{.title}}
</body>
</html>
{{end}}
新建一个mod
完成后又生成了一个sum文件
之后可以执行正常的go 命令
Gin框架中使用LoadHTMLGlob()或者LoadHTMLFiles()方法进行HTML模板渲染
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
//创建一个默认的路由引擎
r := gin.Default()
r.LoadHTMLGlob("/home/liyingzhi/workspace/git.chinaddos.com/templates/**/*")
r.GET("/posts/index", func(c *gin.Context) {
c.HTML(http.StatusOK, "posts/index.html", gin.H{
"title": "posts/index",
})
})
r.GET("users/index", func(c *gin.Context) {
c.HTML(http.StatusOK, "users/index.html", gin.H{
"title": "users/index",
})
})
//
//0.0.0.0:8080但是此时我用的环境的ip是192.168.12.112:9000 所以访问的时候用192.168.12.112:9000
r.Run(":9000")
}