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

前言

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

而今天我们所要介绍的就是服务端如何进行相关数据的响应

Http响应码

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

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

Json

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

go 复制代码

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函数的签名：

go 复制代码

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中

go 复制代码

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

使用原始Json字符串

go 复制代码

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

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

go 复制代码

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

go 复制代码

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

go 复制代码

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

go 复制代码

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，尝试写一个简单的页面:

html 复制代码

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

然后我们尝试响应HTML:

go 复制代码

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函数签，要先加载模版文件：

go 复制代码

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

文件响应

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

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

go 复制代码

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，内容如下:

txt 复制代码

aguihylsywiop;s1yho
hjgiuzoagiusu1i

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

go 复制代码

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 路径和目录路径。