package main

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

func main() {
  r := gin.New()
  r.GET("/ping", func(c *gin.Context) {
    c.String(200, "hello world")
  })
  r.Run() // listen and serve on 0.0.0.0:8080
}

(c *Context) Query(key string) string        // 獲取 GET 參數(shù)
(c *Context) QueryArray(key string) []string    // 獲取 GET 參數(shù)數(shù)組
(c *Context) DefaultQuery(key, defaultValue string) // 獲取 GET 參數(shù)，并提供默認(rèn)值
(c *Context) Param(key string) string        // 獲取 Param 參數(shù)，類(lèi)似于 "/user/:id"
(c *Context) GetRawData() ([]byte, error)      // 獲取 body 數(shù)據(jù)

type HelloWorldReq struct {
  Token  string `json:"token"`
  ID    int  `json:"id" uri:"id"`
  Email  string `json:"email" form:"email"`
  Password string `json:"password" form:"password"`
}

req := &HelloWorldReq{
  Token: c.GetHeader("Authorization"),  // 頭部字段無(wú)法 bind，可以通過(guò) GetHeader 獲取
}

// 用請(qǐng)求中的 Param 參數(shù)填充結(jié)構(gòu)體中的 uri 字段
if err := c.BindUri(req); err != nil {
  return nil, nil, http.StatusBadRequest, fmt.Errorf("bind uri failed. err: [%v]", err)
}

// GET 請(qǐng)求中用 Query 參數(shù)填充 form 字段
// 非 GET 請(qǐng)求，將 body 中的 json 或者 xml 反序列化后填充 form 字段
if err := c.Bind(req); err != nil {
  return nil, nil, http.StatusBadRequest, fmt.Errorf("bind failed. err: [%v]", err)
}

(c *Context) String(code int, format string, values ...interface{}) // 返回一個(gè)字符串
(c *Context) JSON(code int, obj interface{})            // 返回一個(gè) json
(c *Context) Status(code int)                    // 返回一個(gè)狀態(tài)碼

fh, err := ctx.FormFile("file")
if err != nil {
  return err
}

src, err := fh.Open()
if err != nil {
  return err
}
defer src.Close()

(c *Context) File(filepath string)

import "github.com/gin-contrib/cors"

r := gin.New()
r.Use(cors.New(cors.Config{
  AllowOrigins:   []string{"a.example.com", "b.example.com"},
  AllowMethods:   []string{"PUT", "POST", "GET", "OPTIONS"},
  AllowHeaders:   []string{"Origin", "Content-Type", "Content-Length", "Accept-Encoding", "X-CSRF-Token", "Authorization", "Accept", "Cache-Control", "X-Requested-With"},
  AllowCredentials: true,
}))

// maxAge 為過(guò)期時(shí)間
// domain 是網(wǎng)站的地址，如需跨域共享 cookie，可以設(shè)置成域名，
//   比如 a.example.com 和 b.example.com，可以將 domain 設(shè)置成 example.com
// secure 為 https 設(shè)為 true，http 設(shè)為 false
// httpOnly 設(shè)置為 false，否則 axios 之類(lèi)的庫(kù)訪問(wèn)不到 cookie
(c *Context) SetCookie(name, value string, maxAge int, path, domain string, secure, httpOnly bool)