前言
在看是今天的内容之前，我们收先来探究一下：什么是Web应用工作的原理？当然这个问题其实论述起来是很麻烦的，但是我们将它无限的缩小，其实可以简化为一个C/S模型，客户端(Client)负责发送请求，服务端(Server，也就使我们的Web应用)接收 请求，来进行相关的操作,模型如下:
而今天我们所要介绍的就是服务端如何进行相关数据的响应
Http响应码
在HTTP协议定义了一组状态码，用于指示服务器对请求的处理结果，这里我们只对比较常见的做一下简单介绍，想要了解更多的话大家可以参考下面这篇博文:
HTTP状态码大全(常见 HTTP Status Code 含义查询)
- 200:成功，
- 404:资源未找到，
- 500:服务器内部错误
Json
在上一篇文章中我们利用gin框架实现了与浏览器的交互，在网页上面打印了hello world，这是一个很典型的响应字符串，而在响应Json中，除了一些细节以外本质上其实还是类似的,比如下面这个Json响应的代码:
package main import ( "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 main import ( "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
- Xml
package main import ( "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 main import ( "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 main import ( "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 main import ( "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 main import ( "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 main import ( "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 } }
这样我们指定文件就可以访问了:
补充：
函数解析：
- StaticFile:
- StaticFile 函数用于将单个静态文件映射到指定的 URL 路径上。
- 它接受两个参数：URL 路径和文件路径。
- StaticFS 函数
- 用于将一个目录中的所有静态文件映射到指定的 URL 路径上。
- 它接受两个参数：URL 路径和目录路径。
