十年网站开发经验 + 多家企业客户 + 靠谱的建站团队
量身定制 + 运营维护+专业推广+无忧售后,网站问题一站解决
如何在golang中使用gin网络框架?很多新手对此不是很清楚,为了帮助大家解决这个难题,下面小编将为大家详细讲解,有这方面需求的人可以来学习下,希望你能有所收获。
为乐安等地区用户提供了全套网页设计制作服务,及乐安网站建设行业解决方案。主营业务为成都网站设计、网站制作、乐安网站设计,以传统方式定制建设网站,并提供域名空间备案等一条龙服务,秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求,就会得到认可,从而选择与我们长期合作。这样,我们也可以走得更远!golang 原生 http 库已经可以很方便地实现一个 http server 了,但对于复杂的 web 服务来说,路由解析,请求参数解析,对象返回等等,原生 api 就显得有些不太够用了,而 gin 是一个功能完备,性能很高的 web 网络框架,特别适合 web api 的开发
hello world
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 }
如这个 hello world 程序所示 gin 所有的业务逻辑都在 func(c *gin.Context) 函数中实现,请求和返回都通过这个 gin.Context 传递
请求参数解析
gin 提供了丰富的请求参数获取方式
(c *Context) Query(key string) string // 获取 GET 参数 (c *Context) QueryArray(key string) []string // 获取 GET 参数数组 (c *Context) DefaultQuery(key, defaultValue string) // 获取 GET 参数,并提供默认值 (c *Context) Param(key string) string // 获取 Param 参数,类似于 "/user/:id" (c *Context) GetRawData() ([]byte, error) // 获取 body 数据
但这些函数我都不建议使用,建议用结构体来描述请求,再使用 bind api 直接将获取请求参数
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"), // 头部字段无法 bind,可以通过 GetHeader 获取 } // 用请求中的 Param 参数填充结构体中的 uri 字段 if err := c.BindUri(req); err != nil { return nil, nil, http.StatusBadRequest, fmt.Errorf("bind uri failed. err: [%v]", err) } // GET 请求中用 Query 参数填充 form 字段 // 非 GET 请求,将 body 中的 json 或者 xml 反序列化后填充 form 字段 if err := c.Bind(req); err != nil { return nil, nil, http.StatusBadRequest, fmt.Errorf("bind failed. err: [%v]", err) }
http 的客户端 ip 一般在请求头的 X-Forwarded-For 和 X-Real-Ip 中,gin 提供了 (c *Context) ClientIP() string 来获取 ip
返回包体
(c *Context) String(code int, format string, values ...interface{}) // 返回一个字符串 (c *Context) JSON(code int, obj interface{}) // 返回一个 json (c *Context) Status(code int) // 返回一个状态码
文件上传和返回
从请求中获取文件
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)
cros 跨域
服务端返回的头部中有个字段 "Access-Control-Allow-Origin",如果该字段和请求的域不同,浏览器会被浏览器拒绝,其实这个地方我理解应该是客户端没有权限访问,服务端不该返回结果,浏览器认为结果不可用,所以提示跨域错误,而这个头部字段还只能写一个地址,或者写成 *,对所有网站都开放,要想对多个网站开发,我们可以根据请求的 "Origin" 字段,动态地设置 "Access-Control-Allow-Origin" 字段,满足权限得设置成请求中的 "Origin" 字段,gin 的有个插件 github.com/gin-contrib/cors 就是专门用来做这个事情的,可以在 AllowOrigins 中设置多个网站,还可以设置通配符(需设置 AllowWildcard 为 true)
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, }))
cookies
// maxAge 为过期时间 // domain 是网站的地址,如需跨域共享 cookie,可以设置成域名, // 比如 a.example.com 和 b.example.com,可以将 domain 设置成 example.com // secure 为 https 设为 true,http 设为 false // httpOnly 设置为 false,否则 axios 之类的库访问不到 cookie (c *Context) SetCookie(name, value string, maxAge int, path, domain string, secure, httpOnly bool)
看完上述内容是否对您有帮助呢?如果还想对相关知识有进一步的了解或阅读更多相关文章,请关注创新互联成都网站设计公司行业资讯频道,感谢您对创新互联成都网站设计公司的支持。
另外有需要云服务器可以了解下创新互联scvps.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、网站设计器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。