gin框架学习笔记(二) ——相关数据与文件的响应-编程知识

前言

在看是今天的内容之前，我们收先来探究一下：什么是Web应用工作的原理？当然这个问题其实论述起来是很麻烦的，但是我们将它无限的缩小，其实可以简化为一个C/S模型，客户端(Client)负责发送请求，服务端(Server，也就使我们的Web应用)接收请求，来进行相关的操作,模型如下:
在这里插入图片描述
而今天我们所要介绍的就是服务端如何进行相关数据的响应

Http响应码

在HTTP协议定义了一组状态码，用于指示服务器对请求的处理结果，这里我们只对比较常见的做一下简单介绍，想要了解更多的话大家可以参考下面这篇博文:
HTTP状态码大全(常见 HTTP Status Code 含义查询)

200:成功，
404:资源未找到，
500:服务器内部错误

Json

在上一篇文章中我们利用gin框架实现了与浏览器的交互，在网页上面打印了hello world，这是一个很典型的响应字符串，而在响应Json中，除了一些细节以外本质上其实还是类似的,比如下面这个Json响应的代码:

package mainimport ("github.com/gin-gonic/gin"
)type UserInfo struct {Name string `json:"user"`Age  int    `json:"age"`
}func toJson(c *gin.Context) { //响应Json的函数user := UserInfo{Name: "Fengxu",Age:  23,}c.JSON(200, user)
}func main() {r := gin.Default()r.GET("/", toJson)err := r.Run(":8080")if err != nil {return}
}

运行我们会看到页面上出现了Json字符串:
在这里插入图片描述

关于Json响应的细节

Get函数
gin 包提供了 GET 函数来定义处理 HTTP GET 请求的路由，我们来看一下Get函数的签名：

func (group *RouterGroup) GET(relativePath string, handlers ...HandlerFunc) IRoutes {return group.handle(http.MethodGet, relativePath, handlers)
}

这里有两个参数：
1.path：path 是该路由的路径，可以包含参数，例如上面的路径就是:http://127.0.0.1:8080/
2.handlers:路由处理函数，这里用了可变参数，所以这里其实可以有多个路由处理函数

这里拓展一下Json响应的两种不同写法:

将信息存储到map中

func toJson(c *gin.Context) { //响应Json的函数usermap := map[string]string{"user": "张三","age":  "18",}c.JSON(200, usermap)
}

使用原始Json字符串

func toJson(c *gin.Context) { //响应Json的函数c.JSON(200, gin.H{"user": "zhangsan", "age": 18})
}

如果我们有些消息不想显示在网页上面，可以想下面这样写：

package mainimport ("github.com/gin-gonic/gin"
)type UserInfo struct {Name     string `json:"user"`Age      int    `json:"age"`password string `json:"-"`
}func toJson(c *gin.Context) { //响应Json的函数user := UserInfo{Name:     "luoyu",Age:      18,password: "123456",}c.JSON(200, user)
}func main() {r := gin.Default()r.GET("/", toJson)err := r.Run(":8080")if err != nil {return}
}

运行结果:
在这里插入图片描述

xml与yaml

package mainimport ("github.com/gin-gonic/gin"
)func toXml(c *gin.Context) { //响应Json的函数c.XML(200, gin.H{"user": "zhangsan", "age": 18})
}func main() {r := gin.Default()r.GET("/", toXml)err := r.Run(":8080")if err != nil {return}
}

在这里插入图片描述

Yaml

package mainimport ("github.com/gin-gonic/gin"
)func toYAml(c *gin.Context) { //响应Json的函数c.YAML(200, gin.H{"user": "zhangsan", "age": 18})
}func main() {r := gin.Default()r.GET("/", toYAml)err := r.Run(":8080")if err != nil {return}
}

YAML

package mainimport ("github.com/gin-gonic/gin"
)func toYAml(c *gin.Context) { //响应Json的函数c.YAML(200, gin.H{"user": "zhangsan", "age": 18})
}func main() {r := gin.Default()r.GET("/", toYAml)err := r.Run(":8080")if err != nil {return}
}

HTML

HTML与上面的几个不同，接下来我给大家演示一下如何加载一个HTML模版:

首先我们在项目里面创建一个template文件夹，然后我们创建index.html，尝试写一个简单的页面:

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
hello {{.username}} 
</body>
</html>

然后我们尝试响应HTML:

package mainimport ("github.com/gin-gonic/gin"
)func toHtml(c *gin.Context) { //响应Json的函数c.HTML(200, "index.html", gin.H{"username": "fengxu"})
}func main() {r := gin.Default()r.LoadHTMLGlob("template/*")r.GET("/", toHtml)err := r.Run(":8080")if err != nil {return}
}

运行结果为:
在这里插入图片描述

注意: 我们在使用c.HTML函数签，要先加载模版文件：

func (engine *Engine) LoadHTMLFiles(files ...string)  //加载单/多个html文件
func (engine *Engine) LoadHTMLGlob(pattern string)  //加载该路径下所有的html文件

文件响应

单个文件响应
这里我准备了一张照片，我们可以尝试来将它和浏览器交互，让我们可以在网页上看到它:

首先我在项目文件夹中创建source文件夹，表示这里存放一些相关资源，
然后我们可以使用StaticFile来实现上述操作,代码如下:

package mainimport ("github.com/gin-gonic/gin"
)func main() {r := gin.Default()r.StaticFile("/file", "Source/static/img.png")err := r.Run(":8080")if err != nil {return}
}

运行结果为；
在这里插入图片描述

响应指定文件夹里面的内容
有时候我们只希望Source里面指定文件夹可以访问，但是其他的不能访问，我们可以这样来写，首先我们创建一个文件夹public，在里面创建a.txt，内容如下:

aguihylsywiop;s1yho
hjgiuzoagiusu1i

然后我们尝试来加载这个文件夹:

package mainimport ("github.com/gin-gonic/gin""net/http"
)func main() {r := gin.Default()//r.StaticFile("/file", "Source/static/img.png")r.StaticFS("/static", http.Dir("Source/public"))err := r.Run(":8080")if err != nil {return}
}