一.介绍
Gin
是一个用Go语言编写的web框架。它是一个类似于martini
但拥有更好性能的API框架, 由于使用了httprouter
,速度提高了近40倍。 如果你是性能和高效的追求者, 你会爱上Gin
。
下载
go get -u github.com/gin-gonic/gin
二.Gin示例
学习的时候,写在一个文件中的,所以就不分开描述了,看注释吧
package main
import (
"fmt"
"github.com/gin-gonic/gin"
"log"
)
//Restful风格的AIP
/*
1.获取文章 /blog/getXxx restful : GET /blog/Xxx
2.修改 /blog/updateXxx POST /blog/Xxx
3.增加 /blog/addXxx PUT /blog/Xxx
4.删除 /blog/delXxx DELETE /blog/Xxx
*/
// Get请求的时候调用这个函数
func getting(c *gin.Context) {
c.String(200, "this is Getting")
}
func postting(c *gin.Context) {
c.String(200, "this is Posting")
}
func putting(c *gin.Context) {
c.String(200, "this is Putting")
}
func delete(c *gin.Context) {
c.String(200, "this is Delete")
}
func Get_username(c *gin.Context) {
name := c.Param("name")
c.String(200, name)
}
func DefQuery(c *gin.Context) {
name := c.DefaultQuery("name", "jack")
c.String(200, fmt.Sprintf("Hello %s", name))
}
func logFun(c *gin.Context) {
//表单参数设置默认值
type1 := c.DefaultPostForm("type", "alert")
//接收其他的
username := c.PostForm("username")
password := c.PostForm("password")
//多选框
hobbys := c.PostFormArray("hobby")
c.String(200, fmt.Sprintf("type:%s username:%s password:%s hobbys:%v", type1, username, password, hobbys))
}
func loadFun(c *gin.Context) {
//表单取文件
file, err := c.FormFile("file")
if err != nil {
fmt.Println("Get file err:", err)
}
log.Println(file.Filename)
//传到项目根目录下,用本身名字就行,如果指定目录,就是第三个参数
c.SaveUploadedFile(file, file.Filename)
c.String(200, fmt.Sprintf("Uploaded %s", file.Filename))
}
#获取多个图片
func loadFunc1(c *gin.Context) {
forms, err := c.MultipartForm()
if err != nil {
fmt.Println("Multipart err:", err)
return
}
//获取所有图片
files := forms.File["files"]
for _, file := range files {
if err := c.SaveUploadedFile(file, file.Filename); err != nil {
fmt.Println("Upload file err:", err)
}
c.String(200, fmt.Sprintf("Uploaded %s", file.Filename))
}
}
// demo 访问返回200,打印hello world
func main() {
//创建一个路由
//默认使用了两个中间件,Logger,Recovery
r := gin.Default()
//文件大小默认为32MB
//设置接收文件大小为8MB
r.MaxMultipartMemory = 8 << 20
//也可以创建不带中间件的路由
//r1 := gin.New()
//绑定路由规则 封装了request和response
r.GET("/get_test", getting)
r.POST("/post_test", postting)
r.PUT("/put_test", putting)
r.DELETE("/delete_test", delete)
//API参数: name可以作为参数,有冒号
r.GET("/user/:name", Get_username)
//URL参数可以使用DefaultQuery,Query获取,前者若参数不存在,返回默认值,后者返回空串
r.GET("/welcome", DefQuery)
//表单传输,POST请求
/*
有json格式 x-www.form-urlencoded请求体 xml form-data
*/
r.POST("/form", logFun)
//文件上传 格式:multipart/form-data
r.POST("/upload", loadFun)
//上传多个图片
r.POST("/upload1", loadFunc1)
//监听端口
r.Run("127.0.0.1:8000")
}
三.测试
1.测试上传单张图片,对应了loadFun函数
用于测试的HTML文件
<!-- 对应的load测试html文件 -->
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>上传单张图片</title>
</head>
<body>
<form action="http://localhost:8000/upload" method="post" enctype="multipart/form-data">
头像:
<input type="file" name="file">
<br>
<input type="submit",value="提交">
</form>
</body>
</html>
编译后执行可执行文件
执行HTML文件
点击选择图片,在文件资源管理器中选择一张图片cl.jpg,并且点击提交
响应
提交成功,工程根目录下出现cl.jpg
2.测试上传多种图片,对应了loadFunc1函数
用于测试的HTML文件,不熟悉HTML语言的话,要注意一下与第一个例子里面变量的变化,才能实现选取多张图片
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>上传多张图片</title>
</head>
<body>
<form action="http://localhost:8000/upload1" method="post" enctype="multipart/form-data">
头像:
<input type="file" name="files" multiple>
<br>
<input type="submit",value="提交">
</form>
</body>
</html>
执行HTML文件
按住ctrl+鼠标点击图片,这里我选择了cl1.jpg和fengjing.jpg,点击提交
响应:
查看工程根目录下多了两张对应照片
3.其他测试,对应于logFun函数
用于测试的HTML文件
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>登录</title>
</head>
<body>
<form action="http://localhost:8000/form" method="post" enctype="application/x-www-form-urlencoded">
用户名:<input type="text" name="username"><br>
<br>
密  码:<input type="password" name="password"><br>
兴  趣:
<input type="checkbox" value = "singingAndDancing" name="hobby">唱跳
<input type="checkbox" value = "rap" name="hobby">rap
<input type="checkbox" value = "basketball" name="hobby">篮球
<br>
<input type="submit" value="登录">
</form>
</body>
</html>
执行HTML文件
点击登录:
成功获取到输入
四.路由组
package main
import (
"fmt"
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
v1 := r.Group("/v1")
//{}只是为了看的更清晰 不加也可以
{
v1.GET("/log", loginFun)
v1.GET("/sumit", sumitFun)
}
v2 := r.Group("/v2")
{
v2.POST("log", loginFun)
v2.POST("sumit", sumitFun)
}
r.Run("127.0.0.1:8000")
}
func loginFun(c *gin.Context) {
name := c.DefaultQuery("name", "jack")
c.String(200, fmt.Sprintf("hello %s", name))
}
func sumitFun(c *gin.Context) {
name := c.DefaultQuery("name", "kris")
c.String(200, fmt.Sprintf("hello %s", name))
}
测试:v1使用GET,v2使用POST
运行exe文件
验证v1/log
验证v1/sumit
验证v2/log
验证v2/sumit
响应如下
五.路由机制
Gin框架中的路由使用的是httprouter这个库。
其基本原理就是构造一个路由地址的前缀树。
/目录下,按照前缀字母,相同的在一个节点下,不同的字母就在另外分支。
六.参考
go语言大牛李文周老师