构建微服务的十大 Golang 框架和库

2024-09-02 08:58

本文主要是介绍构建微服务的十大 Golang 框架和库,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

点击上方“朱小厮的博客”,选择“设为星标”

后台回复"书",获取

后台回复“k8s”,可领取k8s资料

现在已经有很多开源库 golang 支持构建应用程序,这些库设计简单,代码干净,性能良好,本文为大家精心挑选了十个实用的框架和库。

1CLI 命令 (spf13/cobra)

你想生成一些 CLI 命令吗?

Cobra 既是一个创建强大的现代 CLI 应用程序的库,也是一个生成应用程序和命令文件的程序。

我使用这个库来管理命令应用程序,执行 runner 应用程序,初始化配置,并启动 Rest API。

基于 Cobra 的应用组织结构:

├── app
│ ├── main.go
│ ├── cmd
│ └── root.go

在 app/main.go 中:

package main
import ("app/cmd"
)
func main() {cmd.Execute()
}

在 app/cmd/root.go 中:

package cmd
var rootCmd = &cobra.Command{Use:   "hugo",Short: "Hugo is a very fast static site generator",Long: `A Fast and Flexible Static Site Generator built with love by spf13 and friends in Go. Complete documentation is available at http://hugo.spf13.com`,Run: func(cmd *cobra.Command, args []string) {// Do Stuff Here},
}
func Execute() {if err := rootCmd.Execute(); err != nil {fmt.Println(err)os.Exit(1)}
}

Cobra:https://github.com/spf13/cobra

2配置读取器 (spf13/viper)

Viper 是一个完整的 Go 应用配置解决方案。

Viper 可以读取以下内容:

  • JSON

  • TOML

  • YAML

  • HCL

  • INI

  • envfile 以及Java 属性配置文件

示例 config/config.toml :

address="localhost"
port="9090"

读取 config.go:

func ReadConfig() {viper.SetConfigName("config/config.toml")viper.SetConfigType("toml")err := viper.ReadInConfig()if err != nil {panic(fmt.Errorf("Fatal error config file: %s \n", err))}
}

在 main.go 中使用 config 中的 value:

func main() {address := viper.Get("address")port := viper.Get("port")fmt.Printf("address: %s", address)fmt.Printf("port: %s", port)
}

Viper:https://github.com/spf13/viper

3Web 框架 (labstack/echo)

高性能、极简主义的 Go Web 框架

安装:

// go get github.com/labstack/echo/{version}
go get github.com/labstack/echo/v4

示例:

package main
import ("net/http""github.com/labstack/echo/v4""github.com/labstack/echo/v4/middleware"
)
func main() {// Echo instancee := echo.New()// Middlewaree.Use(middleware.Logger())e.Use(middleware.Recover())// Routese.GET("/", hello)// Start servere.Logger.Fatal(e.Start(":1323"))
}
// Handler
func hello(c echo.Context) error {return c.String(http.StatusOK, "Hello, World!")
}

4依赖注入 (uber-go/fx)

我发现这个库非常有用,你不需要生成任何东西。只是代码。非常模块化,层次清晰。

一个基于依赖注入的 Go 应用框架。

func main() {fx.New(injectModule()).Run()
}
func injectModule() fx.Option {return fx.Options(fx.Provide( NewTimeOutContext, NewDbConn, ),repository.Module, service.Module, outbound.Module, server.Module, controller.Module,)
}

Uber-go/fx: https://github.com/uber-go/fx

5Swagger 生成器、UI 和验证

在 swagger 部分,我必须使用不同的 3 个库,因为我找不到任何一个库可以在一个库中包含 3 个库。

 a. Swagger 生成器 (swaggo/swag)

Swag 将 Go 注释转换为 Swagger 文档 2.0。

我们已经为流行的 Go Web 框架 创建了各种插件。这使你可以快速地与现有的 Go 项目集成(使用 Swagger UI)。

支持的 Web 框架:

  • gin

  • echo

  • buffalo

  • net/http

Swag 已经处理了你的 swagger 文档。所以你不再需要写swagger.ymlswagger.json。你需要做的就是写注释。这是一个例子:

// @title Blueprint Swagger API
// @version 1.0
// @description Swagger API for Golang Project Blueprint.
// @termsOfService http://swagger.io/terms/
// @contact.name API Support
// @contact.email martin7.heinz@gmail.com
// @license.name MIT
// @license.url https://github.com/MartinHeinz/go-project-blueprint/blob/master/LICENSE
// @BasePath /api/v1
func main() {...r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))...
}

swaggo/swag:https://github.com/swaggo/swag

 b. Swagger UI (swaggo/echo-swagger)

因为我用的是 echo,所以我选择这个作为 swagger 的用户界面。

使用示例:

package main
import ("github.com/labstack/echo/v4""github.com/swaggo/echo-swagger"_ "github.com/swaggo/echo-swagger/example/docs" // docs is generated by Swag CLI, you have to import it.
)
// @title Swagger Example API
// @version 1.0
// @description This is a sample server Petstore server.
// @termsOfService http://swagger.io/terms/
// @contact.name API Support
// @contact.url http://www.swagger.io/support
// @contact.email support@swagger.io
// @license.name Apache 2.0
// @license.url http://www.apache.org/licenses/LICENSE-2.0.html
// @host petstore.swagger.io
// @BasePath /v2
func main() {e := echo.New()e.GET("/swagger/*", echoSwagger.WrapHandler)e.Logger.Fatal(e.Start(":1323"))
}

swaggo/echo-swagger:https://github.com/swaggo/echo-swagger

 c. Swagger 验证 (go-swagger/go-swagger)

这个包包含了 Swagger 2.0(也就是 OpenAPI 2.0)的 golang 实现:它知道如何序列化和反序列化 swagger 规范。

安装:

go get github.com/go-swagger/go-swagger/cmd/swagger

键入此命令以验证:

swagger validate api/docs/swagger.yaml

输出:

2021/01/30 22:47:01 
The swagger spec at "api/docs/swagger.yaml" is valid against swagger specification 2.0

go-swagger/go-swagger:https://github.com/go-swagger/go-swagger

6自定义记录器 (sirupsen/logrus)

Logrus 是一个适用于 Go(golang) 的结构化记录器,与标准库记录器完全 API 兼容。

示例:

package main
import (log "github.com/sirupsen/logrus"
)
func main() {log.WithFields(log.Fields{"animal": "walrus",}).Info("A walrus appears")
}

sirupsen/logrus:https://github.com/sirupsen/logrus

7模拟生成器 (vektra/mockery)

Golang 的模拟代码自动生成器

安装:

go get github.com/vektra/mockery/v2/.../

生成模拟:

./bin/mockery --all

输出:

vektra/mockery:https://github.com/vektra/mockery

8迁移 (golang-migrate/migrate)

用 Go 编写的数据库迁移。作为 CLI 使用或作为库导入。

数据库驱动程序运行迁移:

  • PostgreSQL

  • Redshift

  • Ql

  • Cassandra

  • SQLite(todo #165)

  • SQLCipher

  • MySQL/MariaDB

  • Neo4j

  • MongoDB

  • CrateDB(todo #170)

  • Shell(todo #171)

  • Google Cloud Spanner

  • CockroachDB

  • ClickHouse

  • Firebird

  • MS SQL Server

安装:

$ go get -u -d github.com/golang-migrate/migrate/cmd/migrate

键入命令创建迁移文件:

migrate create -ext sql -dir database/migrations -seq create_user

键入命令运行迁移:

migrate -database "mysql://user:pass@tcp(localhost:3600)/user" -path=database/migrations up

键入命令中断迁移:

migrate -database "mysql://user:pass@tcp(localhost:3600)/user" -path=database/migrations down

golang-migrate/migrate:https://github.com/golang-migrate/migrate

9消息传递 (NSQ)

NSQ 拓扑:

NSQ 组件:

  • nsqlookupd (守护进程管理拓扑 / 路由)

  • nsqd(守护进程管理接收、排队和传递消息)

  • nsqadmin(nsq 的默认 Web UI)

docker-compose 示例:(nsqlookupd, nsqd, nsqadmin)

version: '3'
services:
nsqlookupd:
image: nsqio/nsq
command: /nsqlookupd
ports:
- "4160:4160"
- "4161:4161"
nsqd:
image: nsqio/nsq
command: /nsqd --lookupd-tcp-address=nsqlookupd:4160
depends_on:
- nsqlookupd
ports:
- "4150:4150"
- "4151:4151"
nsqadmin:
image: nsqio/nsq
command: /nsqadmin --lookupd-http-address=nsqlookupd:4161
depends_on:
- nsqlookupd
ports:
- "4171:4171"

执行:

运行 docker:
$ docker-compose up -d
或者,如果使用名称 (docker-compose-nsq.yml):
$ docker-compose -f docker-compose-nsq.yml up -d
检查容器 docker:
$ docker-compose ps
查看日志:
$ docker-compose logs
检查 nsq Web UI(假设端口为 32770):
$ curl http://127.0.0.1:32770/ping

在 golang 中:

创建文件夹:
├── consume
│   └── consume.go
└── publish└── publish.go

consume.go:

package main
import (
"log"
"sync"
"github.com/nsqio/go-nsq"
)
func main() {
wg := &sync.WaitGroup{}
wg.Add(1)
decodeConfig := nsq.NewConfig()
c, err := nsq.NewConsumer("My_NSQ_Topic", "My_NSQ_Channel", decodeConfig)
if err != nil {
log.Panic("Could not create consumer")
}
c.AddHandler(nsq.HandlerFunc(func(message *nsq.Message) error {
log.Println("NSQ message received:")
log.Println(string(message.Body))
return nil
}))
err = c.ConnectToNSQD("127.0.0.1:4150")
if err != nil {
log.Panic("Could not connect")
}
log.Println("Awaiting messages from NSQ topic \"My NSQ Topic\"...")
wg.Wait()
}

运行 consume.go:

$ go run consume/consume.go

publish.go:

package main
import (
"log"
"github.com/nsqio/go-nsq"
)
func main() {
config := nsq.NewConfig()
p, err := nsq.NewProducer("127.0.0.1:4150", config)
if err != nil {
log.Panic(err)
}
err = p.Publish("My_NSQ_Topic", []byte("sample NSQ message"))
if err != nil {
log.Panic(err)
}

运行 publish.go:

$ go run publish/publish.go

nsqio/go-nsq:https://github.com/nsqio/go-nsq

10SQL (jmoiron/sqlx)

sqlx 是一个库,它在 Go 的标准 database/sql 库上提供了一组扩展。

我喜欢 sqlx 的一点是它们可以进行结构扫描。快速而简单的使用。

结构扫描示例:

  place := Place{}rows, err := db.Queryx("SELECT * FROM place")for rows.Next() {err := rows.StructScan(&place)if err != nil {log.Fatalln(err)} fmt.Printf("%#v\n", place)}

jmoiron/sqlx:https://github.com/jmoiron/sqlx

11额外附加

Go 例程分组 (sync/errgroup)

https://pkg.go.dev/golang.org/x/sync/errgroup

为 golang 生成流畅的 SQL (Masterminds/squirrel)。

https://github.com/Masterminds/squirrel

Golang Linter (golangci/golangci-lint)

https://github.com/golangci/golangci-lint

断路器 (gojek/heimdall)

https://github.com/gojek/heimdall

Go 工具生成标签 (fatih/gomodifytags)

https://github.com/fatih/gomodifytags

12总结

要建立应用程序,我们应该知道我们有什么特性,特别是如果我们想建立持续的应用程序和团队之间的合作。我建议有一个坚实的、可读性强的代码,这样在成为遗留代码之前(也许 5~10 年后),它可以更容易维护。

构建应用的 3 个关键:

  • 简单设计(项目结构和依赖关系)

  • 干净的代码(可读和可维护)

  • 模块化(实心骨架和柔性骨架)

为了把这些库都包装起来,我有一个设计简单、代码干净的模板或骨架项目。请看:https://github.com/kecci/goscription

作者介绍:

Kecci Kun,软件工程师。

原文链接:

https://keccikun.medium.com/top-10-framework-golang-library-to-build-microservice-391a2bb4c2cb

想知道更多?描下面的二维码关注我

后台回复"技术",加入技术群

后台回复“k8s”,可领取k8s资料

【精彩推荐】

  • 原创|OpenAPI标准规范

  • 中台不是万能药,关于中台的思考和尝试

  • ClickHouse到底是什么?为什么如此牛逼!

  • 原来ElasticSearch还可以这么理解

  • 面试官:InnoDB中一棵B+树可以存放多少行数据?

  • 微服务下如何解耦?对于已经紧耦合下如何重构?

  • 如何构建一套高性能、高可用、低成本的视频处理系统?

  • 架构之道:分离业务逻辑和技术细节

  • 星巴克不使用两阶段提交

点个赞+在看,少个 bug ????

这篇关于构建微服务的十大 Golang 框架和库的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1129539

相关文章

嵌入式QT开发:构建高效智能的嵌入式系统

摘要: 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发,详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程,包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发,涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用,以及嵌入式 QT 与硬件设备的交互,包括输入输出设

Retrieval-based-Voice-Conversion-WebUI模型构建指南

一、模型介绍 Retrieval-based-Voice-Conversion-WebUI(简称 RVC)模型是一个基于 VITS(Variational Inference with adversarial learning for end-to-end Text-to-Speech)的简单易用的语音转换框架。 具有以下特点 简单易用:RVC 模型通过简单易用的网页界面,使得用户无需深入了

【区块链 + 人才服务】可信教育区块链治理系统 | FISCO BCOS应用案例

伴随着区块链技术的不断完善,其在教育信息化中的应用也在持续发展。利用区块链数据共识、不可篡改的特性, 将与教育相关的数据要素在区块链上进行存证确权,在确保数据可信的前提下,促进教育的公平、透明、开放,为教育教学质量提升赋能,实现教育数据的安全共享、高等教育体系的智慧治理。 可信教育区块链治理系统的顶层治理架构由教育部、高校、企业、学生等多方角色共同参与建设、维护,支撑教育资源共享、教学质量评估、

【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

随着区块链技术的快速发展,越来越多的企业开始将其应用于实际业务中。然而,区块链技术的专业性使得其集成开发成为一项挑战。针对此,广东中创智慧科技有限公司基于国产开源联盟链 FISCO BCOS 推出了区块链集成开发平台。该平台基于区块链技术,提供一套全面的区块链开发工具和开发环境,支持开发者快速开发和部署区块链应用。此外,该平台还可以提供一套全面的区块链开发教程和文档,帮助开发者快速上手区块链开发。

cross-plateform 跨平台应用程序-03-如果只选择一个框架,应该选择哪一个?

跨平台系列 cross-plateform 跨平台应用程序-01-概览 cross-plateform 跨平台应用程序-02-有哪些主流技术栈? cross-plateform 跨平台应用程序-03-如果只选择一个框架,应该选择哪一个? cross-plateform 跨平台应用程序-04-React Native 介绍 cross-plateform 跨平台应用程序-05-Flutte

maven 编译构建可以执行的jar包

💝💝💝欢迎莅临我的博客,很高兴能够在这里和您见面!希望您在这里可以感受到一份轻松愉快的氛围,不仅可以获得有趣的内容和知识,也可以畅所欲言、分享您的想法和见解。 推荐:「stormsha的主页」👈,「stormsha的知识库」👈持续学习,不断总结,共同进步,为了踏实,做好当下事儿~ 专栏导航 Python系列: Python面试题合集,剑指大厂Git系列: Git操作技巧GO

Spring框架5 - 容器的扩展功能 (ApplicationContext)

private static ApplicationContext applicationContext;static {applicationContext = new ClassPathXmlApplicationContext("bean.xml");} BeanFactory的功能扩展类ApplicationContext进行深度的分析。ApplicationConext与 BeanF

OWASP十大安全漏洞解析

OWASP(开放式Web应用程序安全项目)发布的“十大安全漏洞”列表是Web应用程序安全领域的权威指南,它总结了Web应用程序中最常见、最危险的安全隐患。以下是对OWASP十大安全漏洞的详细解析: 1. 注入漏洞(Injection) 描述:攻击者通过在应用程序的输入数据中插入恶意代码,从而控制应用程序的行为。常见的注入类型包括SQL注入、OS命令注入、LDAP注入等。 影响:可能导致数据泄

数据治理框架-ISO数据治理标准

引言 "数据治理"并不是一个新的概念,国内外有很多组织专注于数据治理理论和实践的研究。目前国际上,主要的数据治理框架有ISO数据治理标准、GDI数据治理框架、DAMA数据治理管理框架等。 ISO数据治理标准 改标准阐述了数据治理的标准、基本原则和数据治理模型,是一套完整的数据治理方法论。 ISO/IEC 38505标准的数据治理方法论的核心内容如下: 数据治理的目标:促进组织高效、合理地

嵌入式Openharmony系统构建与启动详解

大家好,今天主要给大家分享一下,如何构建Openharmony子系统以及系统的启动过程分解。 第一:OpenHarmony系统构建      首先熟悉一下,构建系统是一种自动化处理工具的集合,通过将源代码文件进行一系列处理,最终生成和用户可以使用的目标文件。这里的目标文件包括静态链接库文件、动态链接库文件、可执行文件、脚本文件、配置文件等。      我们在编写hellowor