Go Gin 框架系列 - 入门篇

简介: 本文将会对 Go Gin 框架进行简单介绍,括它的一些优势和特点,然后通过一个入门示例,演示了如何安装和使用 Gin 启动一个 WEB 服务器并注册路由。

后面将会持续输出 go Gin 框架系列的文章,从简到繁,由浅入深,对这一系列感兴趣的小伙伴,欢迎关注动态更新,让我们一起学习,一起进步!

Gin 框架介绍

Gin 是一个用 Go (Golang) 编写的 Web 框架。 它具有类似 martini 的 API,性能要好得多,多亏了 httprouter,速度提高了 40 倍。 如果您需要性能和良好的生产力,您一定会喜欢 Gin。[1]

上述内容摘自官网文档。从描述中我们可以知道 Gin 是一个 WEB 框架,其在性能方面有显著的优势。除此之外,Gin 框架还具备着其他优势和特点,例如 简单高效轻量级设计对用户友好的 API灵活的路由与中间件配置 以及 内置良好的错误处理机制 等。

如果你刚开始学习 Go 语言并且正在寻找一个易于上手的 web 框架,那么 Gin 框架无疑是你的最佳选择。

对于那些追求高性能并且希望快速推进项目的开发团队,Gin 框架是一个值得考虑的选项。

Gin 初体验

安装

go 版本要求 1.13 及以上版本

  • 1、下载并安装 gin

    go get -u github.com/gin-gonic/gin
    
  • 2、代码引入

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

示例

一个完整的示例代码如下所示:

package main

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

func main() {
   
   
    r := gin.Default()
    r.GET("/hello", func(ctx *gin.Context) {
   
   
        ctx.JSON(200, gin.H{
   
   
            "message": "你好,世界!欢迎关注 Go技术干货 公众号,一起学习一起进步!",
        })
    })
    r.Run(":8080")
}

运行代码之后,我们可以通过多种方式来测试所定义的接口:
一是通过终端中的 curl 命令(执行 curl http://127.0.0.1:8080/hello);
二是直接在浏览器地址栏输入对应的 URL
三是利用 API 工具例如 Postman 进行测试。Postman 测试结果如下所示:

p2.png

代码分析:

  • 首先,我们通过 gin.Default() 函数获取到一个 Gin 框架默认实例,该实例会自动添加了两个预配置的中间件: Logger 日志处理中间件和处理 panicRecovery 中间件。如果你需要一个创建空配置的 Gin 实例,你可以使用 gin.New() 函数。
  • 其次,获取到 gin 实例之后,我们通过 GET() 方法注册一个 GET 请求的路由,其路径设置为 /hello。在这个路由的处理函数中,我们使用 ctx.JSON() 方法来构造并发送一个 JSON 格式的响应。其中,gin.H 是一个 map[string]any 的简写,用于方便地定义 JSON 响应的键值对。
  • 最后,我们通过 r.Run() 方法启动一个 WEB 服务器,并传入 :8080 作为参数。这样会让 WEB 服务器监听 8080 端口。需要注意的是,这个端口参数是可选的,如果没有指定端口,Gin 会默认使用 8080 端口。

小结

本文首先简单介绍了 Go Gin 框架,包括它的一些优势和特点,然后通过一个入门示例,演示了如何安装和使用 Gin 启动一个 WEB 服务器并注册路由。通过短短几行代码就能启动一个 WEB 服务器,可知 Gin 是一个简单、高效且易于使用的框架,非常适合快速开发和迭代。

后续文章将介绍 Go Gin 框架的其他主题内容,敬请期待。

参考资料

[1] Gin 介绍:https://gin-gonic.com/zh-cn/docs/introduction/

作者:陈明勇

个人网站:chenmingyong.cn

文章持续更新,如果本文能让您有所收获,欢迎点赞收藏加关注本号。

微信阅读可搜《Go技术干货》。这篇文章已被收录于 GitHub https://github.com/chenmingyong0423/blog ,欢迎大家 Star 催更并持续关注。

目录
相关文章
|
1月前
|
Go 数据安全/隐私保护
go 基于gin编写encode、decode、base64加密接口
go 基于gin编写encode、decode、base64加密接口
15 2
|
2月前
|
Go API 数据库
【Go 语言专栏】Go 语言中的 ORM 框架使用与比较
【4月更文挑战第30天】本文对比分析了Go语言中的常见ORM框架:GORM、XORM和BeeORM。GORM功能强大,支持复杂查询和关联关系处理,但可能影响性能;XORM以其简单易用和高性能受到青睐,但文档不全;BeeORM简洁高效,适合基础应用场景。选择ORM应考虑功能、性能、易用性和社区支持,根据项目需求进行评估和选择,以提升开发效率和应用性能。
|
7天前
|
Go
Go 项目自动重载解决方案 —— Air 使用入门
**Air**: 提升Go开发效率的利器!自动重载工具,监听文件变化,实时编译运行,无需频繁重启。安装:启用Go Module后,运行`GO111MODULE=on go install github.com/cosmtrek/air@latest`。启动项目:`air`,配置文件默认为`air.toml`。集成到项目,忽略`tmp/`目录。让代码更改即时生效,专注编码,告别手动重启。适用于开发环境,生产环境禁用。[更多详情](https://github.com/cosmtrek/air)
10 1
|
1月前
|
JavaScript 前端开发 Java
Go语言入门【java->go】
Go语言入门【java->go】
27 2
|
18天前
|
编译器 Go 开发者
|
2月前
|
存储 关系型数据库 MySQL
|
2月前
|
Java 编译器 Go
【字节跳动青训营】后端笔记整理-1 | Go语言入门指南:基础语法和常用特性解析(一)
本文主要梳理自第六届字节跳动青训营(后端组)-Go语言原理与实践第一节(王克纯老师主讲)。
54 1
|
26天前
|
Go 数据库
Go语言之GORM框架(四)——预加载,关联标签与多态关联,自定义数据类型与事务(完结篇)
Go语言之GORM框架(四)——预加载,关联标签与多态关联,自定义数据类型与事务(完结篇)
|
26天前
|
SQL Go
Go语言之GORM框架(三)——Hook(钩子)与Gorm的高级查询
Go语言之GORM框架(三)——Hook(钩子)与Gorm的高级查询
|
26天前
|
SQL Go 数据库
Go语言之GORM框架(二) ——GORM的单表操作
Go语言之GORM框架(二) ——GORM的单表操作