[golang gin框架] 1.Gin环境搭建,程序的热加载,路由GET,POST,PUT,DELETE

置顶 已于 2024-12-11 13:47:41 修改
阅读量4.3k 收藏 22
点赞数 3
分类专栏： golang # gin框架开发 文章标签： golang 开发语言
于 2023-02-12 16:27:42 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zhoupenghui168/article/details/128995199
版权
文章介绍了Gin作为Go语言的高性能HTTPweb框架，适合构建API接口和处理高并发场景。内容包括Gin的环境搭建、基本路由配置、HTTP方法的响应以及如何返回JSON、XML、HTML数据。此外，还讨论了热加载工具Fresh和Gin的路由设计遵循RESTfulAPI原则。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一.Gin 介绍

Gin 是一个 Go (Golang) 编写的轻量级 http web 框架，运行速度非常快，如果你是性能和高效的追求者，推荐你使用 Gin 框架.
Gin 最擅长的就是 Api 接口的高并发，如果项目的规模不大，业务相对简单，这个时候
也推荐使用 Gin.
当某个接口的性能遭到较大挑战的时候，这个还是可以考虑使用 Gin 重写接口.
Gin 也是一个流行的 golang Web 框架，Github Strat 量已经超过了 50k.
Gin 的官网： Gin Web Framework
Gin Github 地址： GitHub - gin-gonic/gin: Gin is a HTTP web framework written in Go (Golang). It features a Martini-like API with much better performance -- up to 40 times faster. If you need smashing performance, get yourself some Gin.

二.Gin 环境搭建

要安装 Gin 软件包，需要先安装 Go 并设置 Go 工作区,详情见: [go学习笔记.第二章] 2.go语言的开发工具以及安装和配置SDK

  1. 下载并安装 gin


#安装前准备：
#Gin 是基于 Go 语言开发的，因此需要先安装 Go 语言环境。

#下载 Go：访问 Go 官方网站，下载适合操作系统的安装包。
#安装 Go：按照下载页面的指引进行安装，并配置好 GOROOT 和 GOPATH。
#验证安装：在终端输入 go version，如果正确显示 Go 的版本号，说明 Go 安装成功

#安装步骤：
#1.初始化 Go 项目
#在开始使用 Gin 之前，我们需要创建并初始化一个新的 Go 项目。

#2.创建项目目录
mkdir gin-demo
cd gin-demo

#3.初始化 Go 模块
go mod init gin-demo

#4.安装 Gin 框架
#在项目初始化完成后，我们可以使用 go get 命令来安装 Gin 框架
go get -u github.com/gin-gonic/gin

#安装完成后，Gin 将作为项目的依赖添加到 go.mod 文件中

由于网络原因国内部分用户可能没法直接下载第三方包,go get 失败,Golang Gin中没法下载第三方包解决办法如下:

//打开终端并执行
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

2.将 gin 引入到代码中


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

3. 如果使用诸如 http.StatusOK 之类的常量，则需要引入 net/http 包


import "net/http"

4.新建main.go配置路由

package main

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

func main() {
// 创建gin的默认路由引擎
r := gin.Default()
// 配置路由
r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{ // c.JSON：返回 JSON 格式的数据
        "message": "Hello world!", })
    })

// 浏览器访问请求127.0.0.1:8080/ping路由时,调用回调函数
r.GET("/ping", func(c *gin.Context) {
        //浏览器输出
        //c.JSON(200, gin.H{
        //    "message": "pong",
        //})
         c.String(http.StatusOK, "值:%v", "你好")
    })

//监听并在 0.0.0.0:8080 上启动服务(启动一个web服务)
r.Run()
// 监听并在 0.0.0.0:8000 上启动服务(启动一个web服务)
//r.Run("8000") 
}

5.运行项目

go run main.go

6.要改变默认启动的端口

r.Run(":9000")

三.golang程序的热加载

所谓热加载就是当对代码进行修改时，程序能够自动重新加载并执行，这在开发中
是非常便利的，可以快速进行代码测试，省去了每次手动重新编译,beego 中可以使用官方给提供bee工具来热加载项目，但是 gin 中并没有官方提供的热加载工具，这个时候要实现热加载就可以借助第三方的工具

工具 1（推荐）：GitHub - gravityblast/fresh: Build and (re)start go web apps after saving/creating/deleting source files.

//进入终端执行
go get github.com/pilu/fresh
//然后运行命令
fresh

//或者进入终端执行
go install github.com/pilu/fresh@latest
//然后运行命令
fresh

工具 2：GitHub - codegangsta/gin: Live reload utility for Go web servers

//进入终端执行
go get -u github.com/codegangsta/gin
//然后运行命令
gin run main.go

四.Gin框架中的路由

1.路由概述

路由（Routing）是由一个 URI（或者叫路径）和一个特定的 HTTP 方法（GET、POST 等）
组成的，涉及到应用如何响应客户端对某个网站节点的访问 ,RESTful API 是目前比较成熟的一套互联网应用程序的 API 设计理论，所以在设计路由的时候建议参考 RESTful API 指南,在 RESTful 架构中，每个网址代表一种资源，不同的请求方式表示执行不同的操作：

GET（SELECT）

从服务器取出资源（一项或多项）

POST（CREATE）

在服务器新建一个资源

PUT（UPDATE）

在服务器更新资源（客户端提供改变后的完整资源）

DELETE（DELETE）

从服务器删除资源

  1. 简单的路由配置

当用 GET 请求访问一个网址的时候 
r.GET("网址", func(c *gin.Context) {
    c.String(200, "Get")
})
当用 POST 访问一个网址的时候 
r.POST("网址", func(c *gin.Context) {
    c.String(200, "POST")
})
当用 PUT 访问一个网址的时候 
r.PUT("网址", func(c *gin.Context) {
    c.String(200, "PUT")
})
当用 DELETE 访问一个网址的时候 
r.DELETE("网址", func(c *gin.Context) {
    c.String(200, "DELETE")
})
路由里面获取 Get 传值 
//  域名/news?aid=20
r.GET("/news", func(c *gin.Context) {
    aid := c.Query("aid")
    c.String(200, "aid=%s", aid)
})
动态路由 
// 域名/user/20
r.GET("/user/:uid", func(c *gin.Context) {
    uid := c.Param("uid")
    c.String(200, "userID=%s", uid)
})
完整的代码案例如下: 
package main

import (
    _ "fmt"
    "github.com/gin-gonic/gin"
    "net/http"
)

func main()  {
    r := gin.Default()  // 创建gin的默认路由引擎
    //配置路由
    // 浏览器访问请求127.0.0.1:8080/ping路由时,调用回调函数
    r.GET("/ping", func(c *gin.Context) {
        //浏览器输出
        //c.JSON(200, gin.H{
        //    "message": "pong",
        //})
        c.String(http.StatusOK, "值:%v", "你好")
    })
    r.GET("/news", func(c *gin.Context) {
        //使用http.StatusOK状态码
        c.String(http.StatusOK, "新闻页11面")
    })
    r.POST("/add", func(c *gin.Context) {
        c.String(200, "这是一个POST请求,主要用于增加数据")
    })
    r.PUT("/edit", func(c *gin.Context) {
        c.String(200, "这是一个PUT请求,主要用于修改数据")
    })
    r.DELETE("/delete", func(c *gin.Context) {
        c.String(200, "这是一个DELETE请求,主要用于增删除数据")
    })
    r.Run() // 监听并在 0.0.0.0:8080 上启动服务(启动一个web服务)
}

3.c.String() c.JSON() c.JSONP() c.XML() c.HTML()

返回一个字符串 
r.GET("/news", func(c *gin.Context) {
    aid := c.Query("aid")
    c.String(200, "aid=%s", aid)
})
返回一个 JSON 数据 
    //方法一:自己拼接JSON
    r.GET("/json", func(c *gin.Context) {
        //返回json数据,使用 map[string]interface
        //c.JSON(返回的状态码, 任意类型的数据(如:map,struct,...)
        c.JSON(200, map[string]interface{}{
            "success": true,
            "msg":     "你好",
        })
    })
    //方法二:gin中的H函数
    r.GET("/json2", func(c *gin.Context) {
        //返回json数据,使用gin中的H函数, gin.H 是 map[string]interface{}的缩写
        c.JSON(200, gin.H{
            "success": true,
            "msg":     "你好gin",
        })
    })
    //方法三:使用结构体
    r.GET("/json3", func(c *gin.Context) {
        //实例化一个结构体
        a := &Article{
            Title:   "标题",
            Desc:    "说明",
            Content: "内容",
        }
        c.JSON(200, a)
    })
JSOPN: jsonp请求 主要用来解决跨域问题 
    //jsonp请求 主要用来解决跨域问题
    //http://127.0.0.1:8080/jsonp?callback=call
    //call({"title":"标题-jsonp","desc":"说明-jsonp","content":"内容-jsonp"});
    r.GET("/jsonp", func(c *gin.Context) {
        //实例化一个结构体
        a := &Article{
            Title:   "标题-jsonp",
            Desc:    "说明-jsonp",
            Content: "内容-jsonp",
        }
        c.JSONP(200, a)
    })
返回 XML 数据 
    //方法一:使用gin.H返回
    r.GET("/xml", func(c *gin.Context) {
        c.XML(http.StatusOK, gin.H{
            "success": true,
            "msg":     "成功xml",
        })
    })
    //方法二:使用结构体
    r.GET("/xmlStruct", func(c *gin.Context) {
        //实例化一个结构体
        a := &Article{
            Title:   "标题-xmlStruct",
            Desc:    "说明-xmlStruct",
            Content: "内容-xmlStruct",
        }
        c.XML(200, a)
    })
返回HTML数据 
     //初始化路由
     r := gin.Default()
     //加载templates文件中所有模板文件,以便后续c.HTML()渲染文件时使用
     r.LoadHTMLGlob("templates/*")
     r.GET("/news", func(c *gin.Context) {
        //使用模板文件渲染HTML文件
        //前提: r.LoadHTMLGlob("templates/*")
        //HTML(状态码, 要渲染的文件名, 加载的参数)
        c.HTML(http.StatusOK, "news.html", gin.H{
            "title": "我是一个news",
        })
    })
完整代码案例如下: 
package main

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

type Article struct {
    Title   string `json:"title"`
    Desc    string `json:"desc"`
    Content string `json:"content"`
}

func main() {
    //初始化路由
    r := gin.Default()
    //加载templates文件中所有模板文件,以便后续c.HTML()渲染文件时使用
    r.LoadHTMLGlob("templates/*")
    //配置路由
    r.GET("/", func(c *gin.Context) {
        c.String(200, "首页")
    })
    r.GET("/json", func(c *gin.Context) {
        //返回json数据,使用 map[string]interface
        //c.JSON(返回的状态码, 任意类型的数据(如:map,struct,...)
        c.JSON(200, map[string]interface{}{
            "success": true,
            "msg":     "你好",
        })
    })
    r.GET("/json2", func(c *gin.Context) {
        //返回json数据,使用gin中的H函数
        c.JSON(200, gin.H{
            "success": true,
            "msg":     "你好gin",
        })
    })
    r.GET("/json3", func(c *gin.Context) {
        //实例化一个结构体
        a := &Article{
            Title:   "标题",
            Desc:    "说明",
            Content: "内容",
        }
        c.JSON(200, a)
    })
    //jsonp请求 主要用来解决跨域问题
    //http://127.0.0.1:8080/jsonp?callback=call
    //call({"title":"标题-jsonp","desc":"说明-jsonp","content":"内容-jsonp"});
    r.GET("/jsonp", func(c *gin.Context) {
        //实例化一个结构体
        a := &Article{
            Title:   "标题-jsonp",
            Desc:    "说明-jsonp",
            Content: "内容-jsonp",
        }
        c.JSONP(200, a)
    })
    r.GET("/xml", func(c *gin.Context) {
        c.XML(http.StatusOK, gin.H{
            "success": true,
            "msg":     "成功xml",
        })
    })
    r.GET("/news", func(c *gin.Context) {
        //使用模板文件渲染HTML文件
        //前提: r.LoadHTMLGlob("templates/*")
        //HTML(状态码, 要渲染的文件名, 加载的参数)
        c.HTML(http.StatusOK, "news.html", gin.H{
            "title": "我是一个news",
        })
    })
    r.GET("/goods", func(c *gin.Context) {
        //使用模板文件渲染HTML文件
        //前提: r.LoadHTMLGlob("templates/*")
        //HTML(状态码, 要渲染的文件名, 加载的参数)
        c.HTML(http.StatusOK, "goods.html", gin.H{
            "title": "我是一个goods",
            "price": 12.99,
        })
    })
    r.Run() // 启动一个web服务
}

[下一节][golang gin框架] 2.Gin HTML模板渲染以及模板语法,自定义模板函数,静态文件服务

【Golang】Gin框架中跨域问题解决方案
景天科技苑
10-25 5万+
在使用Go语言进行Web开发时，Gin框架因其简洁、高效的特点而被广泛使用。然而，在实际开发中，跨域问题（CORS, Cross-Origin Resource Sharing）是一个常见的挑战。跨域问题主要源于浏览器的同源策略（Same-Origin Policy），当一个网页尝试从不同的源（协议、域名或端口不同）请求资源时，就会产生跨域问题。本文将结合实际案例，详细介绍在Gin框架中解决跨域问题的多种方法。
Golang Gin 的路由的详解
canduecho的专栏
05-30 1381
路由是 web 应用程序中的一种机制，它将到达服务器的请求与应该处理该请求的代码关联起来。简单来说，路由就是指定在访问某个 URL 时会执行的代码。Gin 使用 HTTP 方法和 URL 路径来定义路由。例如，当一个 GET 请求到达/hello路径时，该请求将被处理并返回一个响应。路由的实现原理是通过在服务器上监听传入的请求，并将其与定义的路由规则进行匹配。当请求与某个路由相匹配时，服务器将执行与该路由关联的代码，并返回响应。
Golang Gin框架
ayaoweiyou的博客
03-06 508
Golang Gin框架 涉及到的context和middleware的使用示例 用到的库: go get -u go.uber.org/zap go get -u github.com/gin-gonic/gin 地址： https://pkg.go.dev/go.uber.org/zap （zap：Package zap provides fast, structured, leveled logging.） https://github.com/gin-gonic/gin package main
Gin框架
最新发布
hsuhwsb的博客
03-22 597
被请求的资源已永久移动到新位置，并且将来任何对此资源的引用都应该使用本响应返回的若干个 URI 之一。如果可能，拥有链接编辑功能的客户端应当自动把请求的地址修改为从服务器反馈回来的地址。由于这样的重定向是临时的，客户端应当继续向原有地址发送以后的请求。Gin是一个非常受欢迎的Golang Web框架，在GitHub上已经有47k的星星，它和Golang的语法一样简洁明了，使得初学者得以迅速入门。不是标准也不是协议。当验证不通过时，会给出错误的信息，但是原始的错误信息不太友好，不利于用户查看。
golang — gin框架
元宝的博客
04-29 1261
gin gin框架搭建的项目，项目入口大致写法: // 以gin框架搭建的项目入口 func main() { //1. 设置默认路由引擎,Default()中默认包含Logger(), Recovery()这两个中间件的使用 /*r := gin.New() r.Use(gin.Recovery())*/ r := gin.Default() // 2.具体实现 Router(r) //3. 启动 _ = r.Run(":8080") } func Router(r *gin.Eng
Gin 项目引入热加载
淘小欣的博客
01-05 1748
热加载（Hot Reloading）是指在应用程序运行时，对代码进行修改后，系统能够自动重新加载这些修改，而无需停止和重新启动整个应用程序。这使得开发者能够在不中断应用程序运行的情况下进行代码的调试和修改。热加载的主要目的是提高开发效率，减少开发过程中的重复操作，以便更快地验证和测试代码的修改。这对于大型项目和复杂框架的开发尤其有益，因为传统的停止-编译-启动的周期会消耗大量时间。在不同的编程语言和框架中，热加载的实现方式可能有所不同。
Golang gin框架
book_longker的专栏
03-27 2万+
gin框架学习一、Gin 介绍二、Gin 环境搭建三、golang 程序的热加载四、Gin 框架中的路由五、Gin HTML 模板渲染六、静态文件服务七、路由详解八、Gin 中自定义控制器九、Gin 中间件十、Gin 中自定义Model十一、Gin 文件上传十二、Gin 中的Cookie十三、Gin 中的Session十四、Gin 中使用GORM 操作mysql 数据库十五、原生 SQL 和 SQL 生成器十六、Gin 中使用GORM 实现表关联查询十七、 GORM 中使用事务十八、Gin 中使用go
gin框架安装以及gin的请求路由
01-20
下面的例子展示了如何设置GET、POST、PUT、DELETE和ANY方法的路由： ```go package main import "github.com/gin-gonic/gin" func main() { r := gin.Default() r.GET("/get", func(c *gin.Context) { c.JSON...
使用 Golang 和 Gin 开发 RESTful API.pdf
11-16
设计端点时需要考虑到用户的需求，以及如何通过HTTP方法（GET、POST、PUT、DELETE等）来表达对资源的操作。例如，一个端点可能是`/albums`，它允许客户端使用GET方法获取所有专辑的信息，而使用POST方法则可以添加新...
【Golang】Gin框架中如何定义路由
热门推荐
景天科技苑
10-21 5万+
Gin是一个用Go语言编写的Web框架，具有高性能和易于使用的特点。在Gin框架中，路由是核心功能之一，通过路由可以将不同的URL路径绑定到相应的处理函数上。本文将结合实际案例，详细介绍Gin框架的路由用法。
gin框架
lzp2011150309的专栏
08-29 1075
1.Benchmarks 基准 (性能测试) (1): Total Repetitions    [所有的文件数] (2): Single Repetition Duration (ns/op)   [单个文件单次循环的时间]     (3): Heap Memory (B/op)     [单次循环的堆内存] (4): Average Allocations per Repetition
gin 框架
weixin_35756624的博客
12-30 640
Gin 是一个用于构建 Web 应用程序的 Go 语言框架。它旨在提供一种简单，快速的方式来构建 Web 应用程序。Gin 使用了一种名为底层感知(low-level awareness)的技术，可以最大化应用程序的性能。Gin 还具有丰富的中间件(middleware)库，可以方便地扩展应用程序的功能。 使用 Gin 框架开发 Web 应用程序的一般步骤如下： 安装 Gin 框架：使用 Go ...
gin框架热加载
安的博客
10-07 495
为gin框架配置热加载，可以引入codegangsta/gin工具。
掌握Gin框架：Go语言GET/POST参数处理实战
资源摘要信息:"Go语言中的gin框架之GET/POST请求参数接收传值" 1. Go语言概述 Go语言（又称Golang）是由Google开发的一种静态类型、编译型、并发型，并具有垃圾回收功能的编程语言。它支持快速的开发和高效的执行，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值