首页 » 技术分享 » 【Gin框架一】Gin简介

【Gin框架一】Gin简介

　
评论关闭　812次浏览

概述

Gin是一个golang的微框架，封装比较优雅，API友好。具有快速灵活，容错方便等特点。Gin自身的net/http足够简单，性能也非常不错

Gin下载： https://github.com/gin-gonic/gin
英文文档：https://gin-gonic.com/docs/

安装

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

测试

  1. 导包

    import "github.com/gin-gonic/gin"   
import "net/http"   //项目中使用了 http.StatusOK

  2. 步骤

    1. 注册一个路由器

      router := gin.Default()

    2. 注册路由处理

      router.GET("/", func(c *gin.Context) {
   c.String(http.StatusOK, "Hello World")
})

    3. 运行（默认是8080端口）

      if true{
  router.Run()  //默认端口：8080     http://localhost
}else{
  router.Run(":9999")  //指端端口：9999    http://localhost:9999
}

切换输出的格式

  1. 返回json格式 
    func (c *Context) JSON(code int, obj interface{})
  2. 返回xml格式 
    func (c *Context) XML(code int, obj interface{})
  3. 返回yaml格式 
    func (c *Context) YAML(code int, obj interface{})
  4. 返回string格式 
    func (c *Context) String(code int, format string, values ...interface{})
  5. 渲染html模板后返回 
    func (c *Context) HTML(code int, name string, obj interface{})

状态码

这个状态码不仅可以手动指定一个数字，比如200，500，404；也可以使用http包中的状态码，语义化的状态码更好理解；

http-status文档：http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
http状态码详解：http://tool.oschina.net/commons?type=5

HTTP状态码的分类

分类 描述
1** 信息，服务器收到请求，需要请求者继续执行操作
2** 成功，操作被成功接收并处理
3** 重定向，需要进一步的操作以完成请求
4** 客户端错误，请求包含语法错误或无法完成请求
5** 服务器错误，服务器在处理请求的过程中发生了错误

常用的状态码

200 请求成功
404 请求失败，服务器无法根据客户端的请求找到资源（网页）
500 服务器内部错误，无法完成请求

项目中导入

import "net/http"

package http

const (  
    StatusOK                   = 200 // RFC 7231, 6.3.1
    StatusMultipleChoices   = 300 // RFC 7231, 6.4.1
    StatusNotFound                     = 404 // RFC 7231, 6.5.4
    StatusInternalServerError           = 500 // RFC 7231, 6.6.1
)

示例

package main

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

func main() {
  //1. 注册一个路由器
  router := gin.Default()

  //2. 注册路由处理

  //默认请求  http://localhost:8080/
  router.GET("/", func(c *gin.Context) {
     c.String(http.StatusOK, fmt.Sprintln(gin.H{"data":"默认请求"}))
  })
  
  //post 请求  string 格式话   http://localhost:8080/string
  router.GET("/string", func(c *gin.Context) {
     c.String(http.StatusOK, fmt.Sprintln("post 请求  string 格式话"))
  })

  //post 请求  json 格式话    http://localhost:8080/json
  router.POST("/json",func (c *gin.Context)  {
    c.JSON(http.StatusOK,gin.H{"name":"post 请求  json 格式话","age":18})
  })

  //delete 请求 xml 格式化   http://localhost:8080/xml
  router.DELETE("/xml",func (c *gin.Context)  {
    c.XML(http.StatusOK,gin.H{"name":"delete 请求 xml 格式化","age":18})
  })

  //patch 请求  yaml 格式化   http://localhost:8080/yaml
  router.PATCH("/yaml",func (c *gin.Context)  {
    c.YAML(http.StatusOK,gin.H{"name":"patch 请求 yaml 格式化","age":18})
  })

  //get请求 html界面显示   http://localhost:8080/html
  router.GET("/html",func (c *gin.Context)  {
    router.LoadHTMLGlob("../view/tem/index/*")  //这是前台的index
    // router.LoadHTMLGlob("../view/tem/admin/*")  //这是后台的index
    // router.LoadHTMLFiles("../view/tem/index.html")  //指定加载某些文件
    c.HTML(http.StatusOK,"index.html",nil)
  })

  //3. 运行（默认是8080端口）
  router.Run()
}

前端

路径：$GOPATH/src/view/tem/index/

<!DOCTYPE html>
<html lang="zh-cn" dir="ltr">
  <head>
    <meta charset="utf-8">
    <title></title>
  </head>
  <body>
    <h1>前端 index</h1>
  </body>
</html>

转载自原文链接, 如需删除请联系管理员。

原文链接：【Gin框架一】Gin简介，转载请注明来源！

赞 0