Go语言GIN框架安装与入门

HELLOWORLD24242023-08-17 11:39

Go语言GIN框架安装与入门

文章目录

  • Go语言GIN框架安装与入门
    • [1. 创建配置环境](#1. 创建配置环境)
    • [2. 配置环境](#2. 配置环境)
    • [3. 下载最新版本Gin](#3. 下载最新版本Gin)
    • [4. 编写第一个接口](#4. 编写第一个接口)
    • [5. 静态页面和资源文件加载](#5. 静态页面和资源文件加载)
    • [6. 各种传参方式](#6. 各种传参方式)
      • [6.1 URL传参](#6.1 URL传参)
      • [6.2 路由形式传参](#6.2 路由形式传参)
      • [6.3 前端给后端传递JSON格式](#6.3 前端给后端传递JSON格式)
      • [6.4 表单形式传参](#6.4 表单形式传参)
    • [7. 路由和路由组](#7. 路由和路由组)
    • [8. 项目代码main.go](#8. 项目代码main.go)
    • [9. 总结](#9. 总结)

之前学习了一周的GO语言，学会了GO语言基础，现在尝试使用GO语言最火的框架GIN来写一些简单的接口。看了B站狂神说的GIN入门视频，基本明白如何写接口了，下面记录一下基本的步骤。

1. 创建配置环境

我们使用Goland创建第一个新的开发环境，这里只要在windows下面安装好Go语言，Goroot都能自动识别。

新的项目也就只有1个go.mod的文件，用来表明项目中使用到的第三方库。

2. 配置环境

我们使用第三方库是需要从github下载的，但是github会经常连不上，所以我们就需要先配置第三方的代理地址。我们再Settings->Go->Go Modules->Environment下面配上代理地址。

bash 复制代码 
GOPROXY=https://goproxy.cn,direct

3. 下载最新版本Gin

在IDE里面的Terminal下面安装Gin框架，使用下面的命令安装Gin，安装完成以后，go.mod下面require就会自动添加依赖。

bash 复制代码 
go get -u github.com/gin-gonic/gin

4. 编写第一个接口

创建main.go文件，然后编写以下代码，这里定义了一个/hello的路由。

go 复制代码 
package main

import "github.com/gin-gonic/gin"

func main() {

	ginServer := gin.Default()
	ginServer.GET("/hello", func(context *gin.Context) {
		context.JSON(200, gin.H{"msg": "hello world"})
	})

	ginServer.Run(":8888")

}

编译运行通过浏览器访问，就可以输出JSON。

5. 静态页面和资源文件加载

使用下面代码加入项目下面的静态页面(HTML文件)，以及动态资源(JS)。

go 复制代码 
	// 加载静态页面
	ginSever.LoadHTMLGlob("templates/*")

	// 加载资源文件
	ginSever.Static("/static", "./static")

这是项目的资源文件列表

其中index.html文件如下

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>我的第一个GO web页面</title>
    <link rel="stylesheet" href="/static/css/style.css">
    <script src="/static/js/common.js"></script>
</head>
<body>

<h1>谢谢大家支持</h1>

获取后端的数据为：
{{.msg}}

<form action="/user/add" method="post">
        <p>username: <input type="text" name="username"></p>
        <p>password: <input type="text" name="password"></p>
        <button type="submit"> 提 交 </button>
</form>


</body>
</html>

接着就可以响应一个页面给前端了。

go 复制代码 
	// 响应一个页面给前端
	ginSever.GET("/index", func(context *gin.Context) {
		context.HTML(http.StatusOK, "index.html", gin.H{
			"msg": "这是go后台传递来的数据",
		})
	})

6. 各种传参方式

6.1 URL传参

在后端获取URL传递来的参数。

go 复制代码 
	// 传参方式
	//http://localhost:8082/user/info?userid=123&username=dfa
	ginSever.GET("/user/info", myHandler(), func(context *gin.Context) {
		// 取出中间件中的值
		usersession := context.MustGet("usersession").(string)
		log.Println("==========>", usersession)

		userid := context.Query("userid")
		username := context.Query("username")
		context.JSON(http.StatusOK, gin.H{
			"userid":   userid,
			"username": username,
		})
	})

其中上面多加了一个中间键，就是接口代码运行之前执行的代码，myHandler的定义如下：

go 复制代码 
// go自定义中间件
func myHandler() gin.HandlerFunc {
	return func(context *gin.Context) {
		// 设置值，后续可以拿到
		context.Set("usersession", "userid-1")
		context.Next() // 放行
	}
}

6.2 路由形式传参

go 复制代码 
	// http://localhost:8082/user/info/123/dfa
	ginSever.GET("/user/info/:userid/:username", func(context *gin.Context) {
		userid := context.Param("userid")
		username := context.Param("username")
		context.JSON(http.StatusOK, gin.H{
			"userid":   userid,
			"username": username,
		})
	})

6.3 前端给后端传递JSON格式

go 复制代码 
	// 前端给后端传递json
	ginSever.POST("/json", func(context *gin.Context) {
		// request.body
		data, _ := context.GetRawData()
		var m map[string]interface{}
		_ = json.Unmarshal(data, &m)
		context.JSON(http.StatusOK, m)

	})

6.4 表单形式传参

go 复制代码 
	ginSever.POST("/user/add", func(context *gin.Context) {
		username := context.PostForm("username")
		password := context.PostForm("password")
		context.JSON(http.StatusOK, gin.H{
			"msg":      "ok",
			"username": username,
			"password": password,
		})
	})

7. 路由和路由组

go 复制代码 
	// 路由
	ginSever.GET("/test", func(context *gin.Context) {
		context.Redirect(http.StatusMovedPermanently, "https://www.baidu.com")
	})

	// 404
	ginSever.NoRoute(func(context *gin.Context) {
		context.HTML(http.StatusNotFound, "404.html", nil)
	})

	// 路由组
	userGroup := ginSever.Group("/user")
	{
		userGroup.GET("/add")
		userGroup.POST("/login")
		userGroup.POST("/logout")
	}

	orderGroup := ginSever.Group("/order")
	{
		orderGroup.GET("/add")
		orderGroup.DELETE("delete")
	}

8. 项目代码main.go

go 复制代码 
package main

import (
	"encoding/json"
	"github.com/gin-gonic/gin"
	"log"
	"net/http"
)

// go自定义中间件
func myHandler() gin.HandlerFunc {
	return func(context *gin.Context) {
		// 设置值，后续可以拿到
		context.Set("usersession", "userid-1")
		context.Next() // 放行
	}
}

func main() {
	// 创建一个服务
	ginSever := gin.Default()
	//ginSever.Use(favicon.New("./icon.png"))

	// 加载静态页面
	ginSever.LoadHTMLGlob("templates/*")

	// 加载资源文件
	ginSever.Static("/static", "./static")

	//ginSever.GET("/hello", func(context *gin.Context) {
	//	context.JSON(200, gin.H{"msg": "hello world"})
	//})
	//ginSever.POST("/user", func(c *gin.Context) {
	//	c.JSON(200, gin.H{"msg": "post,user"})
	//})
	//ginSever.PUT("/user")
	//ginSever.DELETE("/user")

	// 响应一个页面给前端
	ginSever.GET("/index", func(context *gin.Context) {
		context.HTML(http.StatusOK, "index.html", gin.H{
			"msg": "这是go后台传递来的数据",
		})
	})

	// 传参方式
	//http://localhost:8082/user/info?userid=123&username=dfa
	ginSever.GET("/user/info", myHandler(), func(context *gin.Context) {
		// 取出中间件中的值
		usersession := context.MustGet("usersession").(string)
		log.Println("==========>", usersession)

		userid := context.Query("userid")
		username := context.Query("username")
		context.JSON(http.StatusOK, gin.H{
			"userid":   userid,
			"username": username,
		})
	})

	// http://localhost:8082/user/info/123/dfa
	ginSever.GET("/user/info/:userid/:username", func(context *gin.Context) {
		userid := context.Param("userid")
		username := context.Param("username")
		context.JSON(http.StatusOK, gin.H{
			"userid":   userid,
			"username": username,
		})
	})

	// 前端给后端传递json
	ginSever.POST("/json", func(context *gin.Context) {
		// request.body
		data, _ := context.GetRawData()
		var m map[string]interface{}
		_ = json.Unmarshal(data, &m)
		context.JSON(http.StatusOK, m)

	})

	// 表单
	ginSever.POST("/user/add", func(context *gin.Context) {
		username := context.PostForm("username")
		password := context.PostForm("password")
		context.JSON(http.StatusOK, gin.H{
			"msg":      "ok",
			"username": username,
			"password": password,
		})
	})

	// 路由
	ginSever.GET("/test", func(context *gin.Context) {
		context.Redirect(http.StatusMovedPermanently, "https://www.baidu.com")
	})

	// 404
	ginSever.NoRoute(func(context *gin.Context) {
		context.HTML(http.StatusNotFound, "404.html", nil)
	})

	// 路由组
	userGroup := ginSever.Group("/user")
	{
		userGroup.GET("/add")
		userGroup.POST("/login")
		userGroup.POST("/logout")
	}

	orderGroup := ginSever.Group("/order")
	{
		orderGroup.GET("/add")
		orderGroup.DELETE("delete")
	}

	// 端口
	ginSever.Run(":8888")

}

9. 总结

以上就是Gin入门的所有内容了，大家觉得还有帮助，欢迎点赞收藏哦。

相关推荐
utmhikari19 分钟前
【架构艺术】Go语言微服务monorepo的代码架构设计
后端·微服务·架构·golang·monorepo
蜡笔小新星22 分钟前
Flask项目框架
开发语言·前端·经验分享·后端·python·学习·flask
IT猿手24 分钟前
2025最新群智能优化算法：海市蜃楼搜索优化（Mirage Search Optimization, MSO）算法求解23个经典函数测试集，MATLAB
开发语言·人工智能·算法·机器学习·matlab·机器人
夏天的味道٥3 小时前
使用 Java 执行 SQL 语句和存储过程
java·开发语言·sql
IT、木易4 小时前
大白话JavaScript实现一个函数，将字符串中的每个单词首字母大写。
开发语言·前端·javascript·ecmascript
Mr.NickJJ5 小时前
JavaScript系列06-深入理解 JavaScript 事件系统：从原生事件到 React 合成事件
开发语言·javascript·react.js
Archer1946 小时前
C语言——链表
c语言·开发语言·链表
My Li.6 小时前
c++的介绍
开发语言·c++
功德+n7 小时前
Maven 使用指南：基础 + 进阶 + 高级用法
java·开发语言·maven
达斯维达的大眼睛7 小时前
qt小项目，简单的音乐播放器
开发语言·qt
热门推荐
01DeepSeek各版本说明与优缺点分析02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03如何在WPS和Word/Excel中直接使用DeepSeek功能04苍穹外卖面试总结05DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具06本地部署DeepSeek教程（Mac版本）07Coze扣子平台完整体验和实践（附国内和国际版对比）08Windows 11 安装 Dify 完整指南 非docker环境09保姆级教程：利用Ollama与Open-WebUI本地部署 DeedSeek-R1大模型10macOS 上部署 RAGFlow