环境：
MAC M1，Go 1.17.2，GoLand
默认执行指令的终端，如果没有特别说明，指的都是goland->Terminal
创建项目
Goland中新建项目，在$GOPATH/src/目录下建立t_gin项目。
进入项目，在goland的Terminal终端下（默认pwd是项目所在目录）执行指令下载gin：
go get -u github.com/gin-gonic/gin
很快就会安装好。
然后在t_gin下建立一个新的go文件：main.go，用来作为项目的入口文件。
GET与POST请求参数处理
在main.go中开始编写代码，框架的话就先从接收参数开始。
package t_gin
import (
"github.com/gin-gonic/gin"
"net/http"
)
func main() {
r := gin.Default()
//Get 参数
r.GET("/getTest", func(c *gin.Context) {
name := c.Query("name")
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": name,
})
})
//Post 参数
r.POST("/postTest", func(c *gin.Context) {
name := c.PostForm("name")
bankNoArr := c.PostFormArray("bankNo")
var ret []string
for _, bankNo := range bankNoArr {
ret = append(ret, bankNo)
}
result := make(map[string]interface{})
result["name"] = name
result["bankNos"] = ret
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": result,
})
})
r.Run()
}
好的，执行一下看看
$ go run main.go
package command-line-arguments is not a main package
没有运行成功，报了错误，这个错误提示比较浅显，是package的问题，执行应该是main包，我们调整一下代码如下部分：
package main
然后再运行看看
$ go run main.go
[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
- using env: export GIN_MODE=release
- using code: gin.SetMode(gin.ReleaseMode)
[GIN-debug] GET /getTest --> main.main.func1 (3 handlers)
[GIN-debug] POST /postTest --> main.main.func2 (3 handlers)
[GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080
好的，现在运行成功了，由于没有指定端口（在r.run()中可以指定端口），所以默认使用8080端口启动。
在测试代码里，我写了get和post两种请求方式的参数获取，这也是日常最常见的请求方式。
我们用postman对这两个接口做一下测试，看看参数获取是否正确。
先测试Get：
get请求的参数能够正确获取。
那我们再测试一下post：
很好，post请求参数也能够正常接收。
上传文件
在开发过程中，经常遇到的请求类型，除了Get和Post的接口请求，可能就是上传文件的请求了，当然，上传文件也属于Post请求的一种。
下面我们再来测试一下上传文件的基本实现，首先为了存放上传的文件，我们在t_gin目录下建立一个新的文件夹upload专门用来存放上传的文件。
测试上传文件的代码如下：
r.POST("/upload", func(c *gin.Context) {
f, err := c.FormFile("uploadFile")
if err != nil {
panic(err.Error())
}
err = c.SaveUploadedFile(f, "./upload/"+f.Filename)
if err != nil {
panic(err.Error())
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": f.Filename,
})
})
还是用postman进行测试：
测试是成功的，那我们看看t_gin/upload/目录下是不是已经有了上传的文件呢？
已经有了对不对，符合我们的预期。
上传多个文件
上传文件的操作，有些时候可能会一次上传多个文件，那这种情况怎么处理呢？我们也来尝试一下这种场景。
测试多个文件上传的代码如下：
r.POST("/multiUpload", func(c *gin.Context) {
multiForm, _ := c.MultipartForm()
files := multiForm.File["uploadFile"]
var result []string
for _, file := range files {
result = append(result, file.Filename)
err := c.SaveUploadedFile(file, "./upload/"+file.Filename)
if err != nil {
log.Println("file save error:" + file.Filename)
continue
}
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": result,
})
})
同样的，我们还是将上传的文件放到./t_gin/upload/目录下，用postman测试一下看看：
好的，接口提示是上传成功了，我们再看一下upload目录下是不是已经有了上传的文件：
确实是有了，那多个文件上传的基本操作也成功了。
文件下载
既然说了文件上传，那就可能有文件下载，我们也来尝试一下文件下载的实现。
测试代码如下：
r.GET("/downloadFile", func(c *gin.Context) {
//c.File("./upload/cat1.HEIC")
c.FileAttachment("./upload/cat1.HEIC", "mycat.HEIC")
})
浏览器试了一下，ok。
JSON参数处理
想想还有什么呢。。。。
对了，日常的请求中，使用最多的应该是json格式的参数，再尝试一下json格式的参数处理：
测试代码如下：
r.POST("/jsonTest", func(c *gin.Context) {
type jsonParam struct {
Name string `json:"name"`
Age int `json:"age"`
Sex string `json:"sex"`
}
var jsonP jsonParam
err := c.BindJSON(&jsonP)
if err != nil {
log.Panic(err.Error())
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": jsonP,
})
})
看代码可以发现，当参数是json形式时，是将json参数bind到了一个struct上。
有没有什么似曾相识的感觉？？
对，就是java，和java的参数接收十分相像
ok，我们也用Postman测试一下看看：
好的，没什么问题。
路由分组
还有个不是参数相关的，属于路由范畴，算是路由分组，实际开发中总会遇到不同的模块，而模块内的接口前半部分大多情况下是相同的，这就属于路由分组了。
我们看下gin中怎么实现的，分组通常会有多个路由在一起，所以处理方法我们也集中起来放，这里我们在t_gin/目录下再建立一个controller文件夹，用来存放处理方法。
建好controller文件夹后，在其中新建learn.go代码文件，代码如下：
package controller
import (
"github.com/gin-gonic/gin"
"net/http"
)
type LearnController struct {
}
func (l *LearnController) First(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{
"code":0,
"data":"this is first handle",
})
}
func (l *LearnController) Second(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{
"code":0,
"data":"this is second handle",
})
}
由于是做测试用，这里我在方法内部直接做了返回。
好的，现在处理方法有了，我们来处理路由分组，这部分是在main.go当中：
rg := r.Group("/learn")
{
learnCtrl := controller.LearnController{}
rg.GET("/first", learnCtrl.First)
rg.GET("/second", learnCtrl.Second)
}
同样我们也测试一下，看看是否符合我们的预期
ok，没什么问题。
常用的基本就这些，还有其它的一些偶尔也会用到，有需要再去翻文档吧。
今天就到这里。
