gin框架 教程

gin 是一个使用 Go 语言编写的 Web 后端框架,具有简洁、轻量、支持高并发、封装优雅、API 友好、快速灵活、容错方便等特点。

gin 和 beego 是 Go 语言编写 Web 应用最常用的后端框架。

使用 Go 语言开发 Web 应用,对于框架的依赖要比其它编程语言要小。Go 语言内置的 net/http 包简单轻便,性能优良。而且,大多数的 Go 语言 Web 框架都是在其之上进行的封装。

官方网站:https://gin-gonic.github.io/gin/

Github地址:https://github.com/gin-gonic/gin

 

1. 为什么使用 gin 框架

框架是指半成品的应用,一般需要填充少许代码或者无需填充代码就可以运行,只是这样的应用缺少业务逻辑。

我们使用框架开发,主要工作就是在框架上补充业务逻辑代码。所以,借助框架进行开发,不仅可以减少开发时间、提高效率,也有助于团队统一编码风格,形成 编程规范

gin 框架是一个 Web 框架,它封装了 路由CookieSession、参数处理、数据编解码以及中间件等功能,简单高效,降低了开发 Web 应用的难度。

 

2. 安装 gin 框架

要安装 gin 框架软件包,您需要首先安装 Go,可以参考 Go 语言教程 章节的内容。

如果您使用了 Go 包管理工具来管理项目,那么通常不需要手动安装 gin,完全可以省略以下步骤,因为包管理工具会自动帮您下载安装,无需人工干预。比如使用包管理工具 go mod。

安装 gin 框架:

打开一个终端窗口(比如 Linux Shell 或者 Windows Cmd),运行以下命令。

$ go get -u github.com/gin-gonic/gin

 

3. 使用 gin 框架

使用 gin 框架也非常简单,将其导入代码中即可:

import "github.com/gin-gonic/gin"

通常还需要导入 net/http 包,因为代码中一般需要一些常量,比如返回码 http.StatusOK。

import "net/http"

 

4. gin 框架使用范例

我们可以使用 gin,开发和运行 Web 应用 Hello World。

package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

func main() {
   // 1.创建路由
   engine := gin.Default()
   // 2.绑定路由规则,执行的函数
   // gin.Context,封装了request和response
   engine.GET("/", func(c *gin.Context) {
      c.String(http.StatusOK, "Hello World!")
   })
   // 3.监听端口,默认在8080
   engine.Run(":8080")
}

打开浏览器,输入 http://localhost:8080,就可以看到浏览器输出 Hello World。

路由(route)就是根据 HTTP 请求的 url 路径,设置由哪个函数来处理请求。路由是 web 框架的核心功能。Gin 的路由支持 HTTP 的 GET , POST , PUT , DELETE , PATCH , HEAD , OPTIONS 方法的请求,同时还有一个 Any 函数,可以同时支持以上的所有请求。