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

落雨便归尘2024-05-11 8:30

前言

在看是今天的内容之前，我们收先来探究一下：什么是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

  • Xml
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 路径和目录路径。
相关推荐
哎呦没4 分钟前
SpringBoot框架下的资产管理自动化
java·spring boot·后端
2401_857600956 分钟前
SpringBoot框架的企业资产管理自动化
spring boot·后端·自动化
并不会2 小时前
常见 CSS 选择器用法
前端·css·学习·html·前端开发·css选择器
龙鸣丿2 小时前
Linux基础学习笔记
linux·笔记·学习
NiNg_1_2344 小时前
SpringBoot整合SpringSecurity实现密码加密解密、登录认证退出功能
java·spring boot·后端
Nu11PointerException4 小时前
JAVA笔记 | ResponseBodyEmitter等异步流式接口快速学习
笔记·学习
Chrikk6 小时前
Go-性能调优实战案例
开发语言·后端·golang
亦枫Leonlew6 小时前
三维测量与建模笔记 - 3.3 张正友标定法
笔记·相机标定·三维重建·张正友标定法
幼儿园老大*6 小时前
Go的环境搭建以及GoLand安装教程
开发语言·经验分享·后端·golang·go
canyuemanyue6 小时前
go语言连续监控事件并回调处理
开发语言·后端·golang
热门推荐
01如何才能让手机厂商主动拥抱华为，接入鸿蒙系统？02【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【TC3xx芯片】TC3xx芯片电源管理系统PMS详解05基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测06【经验分享】Ubuntu22.04安装微信(linux官方版)07Macbook pro M1 安装Ubuntu教程08RAG 实践- Ollama+RagFlow 部署本地知识库09Windows10安装PCL1.14.0及点云配准10文件或文件夹名称中有空格如何批量去除