Gin是由Manfred Touron开发的，他是一位来自法国的软件开发者，他在2012年开发了Gin，并在2013年发布了Gin的第一个版本。
Gin是一个用Go（Golang）编写的Web框架，它的目标是提供一个开发Web应用程序的快速、简单和可扩展的方法。Gin的设计受到了Martini框架的启发，但是它比Martini更快、更简单、更灵活，它可以更好地满足Web开发的需求。Gin的设计和实现都是基于Go语言的，它可以更好地利用Go语言的特性，比如goroutine、channel等，从而提供更好的性能和更高的可扩展性。
Gin框架具有许多优点
- 简洁：Gin框架的API非常简洁，只需要几行代码就可以实现一个功能，使用起来非常方便。
- 高性能：Gin框架的性能非常高，比其他框架快了40倍，可以满足大多数应用的需求。
- 支持中间件：Gin框架支持中间件，可以在请求和响应之间添加一些处理逻辑，比如日志记录、权限验证等。
- 支持路由组：Gin框架支持路由组，可以将相似的路由放在一个组里，方便管理。
- 支持模板引擎：Gin框架支持模板引擎，可以使用模板引擎来渲染HTML页面，提高开发效率。
Gin的发展前景
Gin的发展前景非常乐观，它的性能和可扩展性使它成为一个非常受欢迎的Web框架。此外，Gin的社区也非常活跃，可以提供帮助和支持。在国内，许多大型企业和创业公司都在使用gin，比如阿里巴巴、百度、京东等。
Hello world
实现Gin的Hello world示例，首先需要安装Gin：
go get -u github.com/gin-gonic/gin然后，创建一个新的Go文件，例如main.go，并在文件中添加以下代码：
package main
import "github.com/gin-gonic/gin"
func main() {
r := gin.Default()
r.GET("/", func(c *gin.Context) {
c.String(200, "Hello World!")
})
r.Run()
}最后，运行以下命令来启动服务器：
go run main.go在浏览器中访问http://localhost:8080，会看到“Hello World！”
获取GET请求参数
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
// 获取路由上的参数
router.GET("/user/:name", func(c *gin.Context) {
name := c.Param("name")
c.String(http.StatusOK, "Hello %s", name)
})
// 获取路由上的多个参数
router.GET("/user/:name/*action", func(c *gin.Context) {
name := c.Param("name")
action := c.Param("action")
message := name + " is " + action
c.String(http.StatusOK, message)
})
// 获取路由上的查询参数
router.GET("/welcome", func(c *gin.Context) {
firstname := c.DefaultQuery("firstname", "Guest")
lastname := c.Query("lastname") // 没有默认值
c.String(http.StatusOK, "Hello %s %s", firstname, lastname)
})
router.Run(":8080")
}
访问：
http://localhost:8080/user/joe
http://localhost:8080/user/joe/run
http://localhost:8080/welcome?firstname=joe&lastname=smith
输出：
Hello joe
joe is run
Hello joe smith获取post请求数据
func main() {
r := gin.Default()
r.POST("/form_post", func(c *gin.Context) {
message := c.PostForm("message")
nick := c.DefaultPostForm("nick", "anonymous") //有默认值
fmt.Println(message, nick)
})
r.Run(":8080")
}获取ajax请求数据
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.POST("/post", func(c *gin.Context) {
// 获取表单数据
message := c.PostForm("message")
nick := c.DefaultPostForm("nick", "anonymous")
c.JSON(200, gin.H{
"status": "posted",
"message": message,
"nick": nick,
})
})
router.Run(":8080")
}上面的代码实现了一个简单的ajax请求，当客户端发送POST请求到/post时，服务器会返回一个JSON格式的响应。
参数绑定
使用ShouldBind可以将请求参数绑定到结构体中，从而实现参数的自动解析
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
type User struct {
Name string `form:"name"`
Age int `form:"age"`
}
func main() {
router := gin.Default()
router.POST("/post", func(c *gin.Context) {
var user User
if err := c.ShouldBind(&user); err != nil {
c.JSON(http.StatusBadRequest, gin.H{
"error": err.Error(),
})
return
}
c.JSON(http.StatusOK, gin.H{
"name": user.Name,
"age": user.Age,
})
})
}上传文件
//单文件上传
func DoUpload1(ctx *gin.Context) {
file, _ := ctx.FormFile("file")
fmt.Println(file.Filename)
time_unix_int := time.Now().Unix()
time_unix_str := strconv.FormatInt(time_unix_int, 10)
dst := "upload/" + time_unix_str + file.Filename
ctx.SaveUploadedFile(file, dst)
ctx.String(http.StatusOK, "上传成功")
}
//多文件上传
func DoUpload2(ctx *gin.Context) {
form, _ := ctx.MultipartForm()
files := form.File["file"]
for _, file := range files {
fmt.Println(file.Filename)
time_unix_int := time.Now().Unix()
time_unix_str := strconv.FormatInt(time_unix_int, 10)
dst := "upload/" + time_unix_str + file.Filename
ctx.SaveUploadedFile(file, dst)
}
ctx.String(http.StatusOK, "上传成功")
}其他数据格式输出
func OutJson(ctx *gin.Context) {
ctx.JSON(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutAsciiJson(ctx *gin.Context) {
ctx.AsciiJSON(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutJsonP(ctx *gin.Context) {
ctx.JSONP(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutPureJson(ctx *gin.Context) {
ctx.PureJSON(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutSecureJSON(ctx *gin.Context) {
ctx.SecureJSON(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutXml(ctx *gin.Context) {
ctx.XML(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}
func OutYaml(ctx *gin.Context) {
ctx.YAML(http.StatusOK, gin.H{
"code": 200,
"tag": "<br/>",
"msg": "提交成功",
"html": "<b>Hello,world!</b>",
})
}重定向的使用
func RedirectA(ctx *gin.Context) {
fmt.Println("这是A路由")
ctx.Redirect(http.StatusFound, "redirect_b")
}
func RedirectB(ctx *gin.Context) {
fmt.Println("这是B路由")
ctx.String(http.StatusOK, "这是B路由")
}