构建微服务的十大 Go 框架/库

服务器 服务器产品 前端
现在,很多开源库都支持构建应用程序。我应该向你推荐一些库,它们可以帮助启动具有简单设计、干净代码和良好性能的项目。

现在,很多开源库都支持构建应用程序。我应该向你推荐一些库,它们可以帮助启动具有简单设计、干净代码和良好性能的项目。

01 CLI 命令(spf13/cobra)

你想要构建一些 CLI 命令吗?

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

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

基于 cobra 的应用组织结构:

  1. ├── app 
  2. │ ├── main.go 
  3. │ ├── cmd 
  4. │ └── root.go 

app/main.go 的代码如下:

  1. package main 
  2. import ( 
  3.    "app/cmd" 
  4. func main() { 
  5.    cmd.Execute() 

app/cmd/root.go 代码如下:

 

  1. package cmd 
  2. var rootCmd = &cobra.Command{ 
  3.    Use:   "hugo"
  4.    Short: "Hugo is a very fast static site generator"
  5.    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`, 
  6.    Run: func(cmd *cobra.Command, args []string) { 
  7.       // Do Stuff Here 
  8.    }, 
  9. func Execute() { 
  10.    if err := rootCmd.Execute(); err != nil { 
  11.       fmt.Println(err) 
  12.       os.Exit(1) 
  13.    } 

项目地址:https://github.com/spf13/cobra。

02 配置读取器(spf13/viper)

Viper 是 Go 应用程序的完整配置解决方案。

Viper 支持以下格式配置:

  • JSON
  • TOML
  • YAML
  • HCL
  • INI
  • envfile
  • Java properties config files

例如 config/config.toml:

 

  1. address="localhost" 
  2. port="9090" 

响应操作的文件 config.go:

 

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

然后在 main.go 中使用 config 的值:

 

  1. func main() { 
  2.    address := viper.Get("address"
  3.    port := viper.Get("port"
  4.    fmt.Printf("address: %s", address) 
  5.    fmt.Printf("port: %s", port) 

项目地址:https://github.com/spf13/viper。

03 Web 框架(labstack/echo)

Echo 是一个高性能、极简主义的 Go Web 框架。

安装

 

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

例子

 

  1. package main 
  2.  
  3. import ( 
  4.   "net/http" 
  5.   "github.com/labstack/echo/v4" 
  6.   "github.com/labstack/echo/v4/middleware" 
  7.  
  8. func main() { 
  9.   // Echo instance 
  10.   e := echo.New() 
  11.  
  12.   // Middleware 
  13.   e.Use(middleware.Logger()) 
  14.   e.Use(middleware.Recover()) 
  15.  
  16.   // Routes 
  17.   e.GET("/", hello) 
  18.  
  19.   // Start server 
  20.   e.Logger.Fatal(e.Start(":1323")) 
  21.  
  22. // Handler 
  23. func hello(c echo.Context) error { 
  24.   return c.String(http.StatusOK, "Hello, World!"

项目地址:https://github.com/labstack/echo。

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

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

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

 

  1. func main() { 
  2.  fx.New(injectModule()).Run() 
  3.  
  4. func injectModule() fx.Option { 
  5.  return fx.Options( 
  6.   fx.Provide(  
  7.        NewTimeOutContext,  
  8.        NewDbConn,  
  9.   ), 
  10.   repository.Module,  
  11.   service.Module,  
  12.   outbound.Module,  
  13.   server.Module,  
  14.   controller.Module, 
  15.  ) 

项目地址:https://github.com/uber-go/fx。

04 Swagger Generator, UI 和 Validation

在 swagger 部分,我必须使用不同的 3 个库,因为我没有找到 1 个库同时包含这个 3 个库功能的。如果你有推荐,请评论告知。

a、Swagger generator (swaggo/swag)

Swag 将 Go 注释转换为 Swagger Documentation 2.0。

我们为流行的 Go Webb 框架[1]创建了各种各样的插件。这允许你快速集成一个现有的 Go 项目(使用 Swagger UI)。

支持的 Web 框架:

  • gin
  • echo
  • buffalo
  • net/http

Swag 已经处理了你那些 swagger 文件。所以你不再需要写 swagger.yml 或 swagger.json。你需要做的只是编写注释。看一个例子:

 

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

项目地址:https://github.com/swaggo/swag。

b、Swagger UI (swaggo/echo-swagger)

因为我正在使用 echo,所以我为 swagger 选择了这个 user interface。

使用示例:

 

  1. package main 
  2. import ( 
  3.  "github.com/labstack/echo/v4" 
  4.  "github.com/swaggo/echo-swagger" 
  5.  _ "github.com/swaggo/echo-swagger/example/docs" // docs is generated by Swag CLI, you have to import it. 
  6. // @title Swagger Example API 
  7. // @version 1.0 
  8. // @description This is a sample server Petstore server. 
  9. // @termsOfService http://swagger.io/terms/ 
  10. // @contact.name API Support 
  11. // @contact.url http://www.swagger.io/support 
  12. // @contact.email support@swagger.io 
  13. // @license.name Apache 2.0 
  14. // @license.url http://www.apache.org/licenses/LICENSE-2.0.html 
  15. // @host petstore.swagger.io 
  16. // @BasePath /v2 
  17. func main() { 
  18.  e := echo.New() 
  19.  e.GET("/swagger/*", echoSwagger.WrapHandler) 
  20.  e.Logger.Fatal(e.Start(":1323")) 

项目地址:https://github.com/swaggo/echo-swagger。

c、Swagger validation (go-swagger/go-swagger)

这个包包含了 Swagger 2.0(又名 OpenAPI 2.0[2])的 golang 实现: 它知道如何序列化和反序列化 Swagger 规范。

安装:

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

运行以验证:

  1. swagger validate api/docs/swagger.yaml 

输出如下:

 

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

项目地址:https://github.com/go-swagger/go-swagger。

06、自定义 Logger (sirupsen/logrus)

Logrus 是 Go (golang)的结构化 Logger,完全兼容标准库 Log。

例子:

 

  1. package main 
  2.  
  3. import ( 
  4.   log "github.com/sirupsen/logrus" 
  5.  
  6. func main() { 
  7.   log.WithFields(log.Fields{ 
  8.     "animal""walrus"
  9.   }).Info("A walrus appears"

项目地址:https://github.com/sirupsen/logrus。

07、Mock 生成器 (vektra/mockery)

一个 Mock 代码自动生成器

安装:

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

生成 mock:

  1. ./bin/mockery --all 

输出:

 

 

 

项目地址:https://github.com/vektra/mockery。

08、Migrate (golang-migrate/migrate)

用 Go 编写的数据库迁移工具。作为 CLI[3] 使用或作为库[4]导入。

支持如下数据库:

  • 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

安装:

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

创建迁移文件:

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

运行升级版本:

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

降版本:

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

项目地址:< https://github.com/golang-migrate/migrate>。

09、Messaging (NSQ)

NSQ 拓扑:

NSQ 组件:

  • nsqlookupd (daemon manage topologies / routes)
  • nsqd (daemon manage receives, queues, and delivers messages)
  • nsqadmin (default Web UI of nsq)

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

 

  1. version: '3' 
  2. services: 
  3. nsqlookupd: 
  4. image: nsqio/nsq 
  5. command: /nsqlookupd 
  6. ports: 
  7. "4160:4160" 
  8. "4161:4161" 
  9. nsqd: 
  10. image: nsqio/nsq 
  11. command: /nsqd --lookupd-tcp-address=nsqlookupd:4160 
  12. depends_on: 
  13. - nsqlookupd 
  14. ports: 
  15. "4150:4150" 
  16. "4151:4151" 
  17. nsqadmin: 
  18. image: nsqio/nsq 
  19. command: /nsqadmin --lookupd-http-address=nsqlookupd:4161 
  20. depends_on: 
  21. - nsqlookupd 
  22. ports: 
  23. "4171:4171" 

执行:

 

  1. To run docker: 
  2. $ docker-compose up -d 
  3. or if use name (docker-compose-nsq.yml): 
  4. $ docker-compose -f docker-compose-nsq.yml up -d 
  5. To check container docker: 
  6. $ docker-compose ps 
  7. To see logs: 
  8. $ docker-compose logs 
  9. To check nsq web ui: (assuming port is 32770) 
  10. $ curl http://127.0.0.1:32770/ping 

Go 代码目录:

 

  1. Create Folder: 
  2. ├── consume 
  3. │   └── consume.go 
  4. └── publish 
  5.     └── publish.go 

consume.go 代码:

 

  1. package main 
  2. import ( 
  3.     "log" 
  4.     "sync" 
  5.     "github.com/nsqio/go-nsq" 
  6. func main() { 
  7.     wg := &sync.WaitGroup{} 
  8.     wg.Add(1) 
  9.     decodeConfig := nsq.NewConfig() 
  10.     c, err := nsq.NewConsumer("My_NSQ_Topic""My_NSQ_Channel", decodeConfig) 
  11.     if err != nil { 
  12.       log.Panic("Could not create consumer"
  13.     } 
  14.     c.AddHandler(nsq.HandlerFunc(func(message *nsq.Message) error { 
  15.         log.Println("NSQ message received:"
  16.         log.Println(string(message.Body)) 
  17.       return nil 
  18.     })) 
  19.     err = c.ConnectToNSQD("127.0.0.1:4150"
  20.     if err != nil { 
  21.       log.Panic("Could not connect"
  22.     } 
  23.     log.Println("Awaiting messages from NSQ topic \"My NSQ Topic\"..."
  24.     wg.Wait() 

运行 consume.go:

  1. $ go run consume/consume.go 

publish.go 代码:

 

  1. package main 
  2. import ( 
  3.     "log" 
  4.     "github.com/nsqio/go-nsq" 
  5. func main() { 
  6.     config := nsq.NewConfig() 
  7.     p, err := nsq.NewProducer("127.0.0.1:4150", config) 
  8.     if err != nil { 
  9.       log.Panic(err) 
  10.     } 
  11.     err = p.Publish("My_NSQ_Topic", []byte("sample NSQ message")) 
  12.     if err != nil { 
  13.       log.Panic(err) 
  14.     } 

运行 publish:

  1. $ go run publish/publish.go 

项目地址:https://github.com/nsqio/go-nsq。

10、SQL (jmoiron/sqlx)

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

我喜欢的 sqlx 是因为它们可以 scan 结构!使用简单。

StrucScan 的例子:

 

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

项目地址:https://github.com/jmoiron/sqlx。

11、附加的一些库

  • Go routine grouping (sync/errgroup):https://pkg.go.dev/golang.org/x/sync/errgroup
  • Fluent SQL generation for golang (Masterminds/squirrel):https://github.com/Masterminds/squirrel
  • Golang Linter (golangci/golangci-lint):https://github.com/golangci/golangci-lint
  • Circuit Breaker (gojek/heimdall):https://github.com/gojek/heimdall
  • Go tool generate tags (fatih/gomodifytags):https://github.com/fatih/gomodifytags

12、总结

要构建应用程序,我们应该知道有什么功能,特别是如果我们是团队协作,建议使用可读性强的代码,这样在成为遗留代码之前(也许 5-10 年之后) ,代码可以更容易维护。

构建应用程序的三个关键:

  • 简单设计(项目结构和依赖关系)
  • Clean Code (可读性和可维护性)
  • Modular(模块化) (Solid & flexible skeleton)

为了封装所有这些库,我有一个模板或框架项目,其设计简单,代码清晰。看看这个:https://github.com/kecci/goscription。

以上就是我常用的 10 大 Go 框架/库和一些附加库。

我希望你喜欢我的推荐,如果你有其他的推荐,请留言!

参考资料

[1]Go Webb 框架: https://github.com/swaggo/swag#supported-web-frameworks

[2]OpenAPI 2.0: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md

[3]CLI: https://github.com/golang-migrate/migrate#cli-usage

[4]库: https://github.com/golang-migrate/migrate#use-in-your-go-project

责任编辑:未丽燕 来源: Go语言中文网2
相关推荐

2019-10-21 08:31:34

容器微服务docker

2018-02-08 09:00:22

框架移动应用移动混合应用

2017-11-22 13:01:03

Go技术栈构建

2009-02-23 10:17:36

Javascript框架应用

2021-11-21 22:43:10

Java开发框架

2009-04-09 14:41:08

PHP框架MVCPHP

2021-08-11 13:54:19

微服务系统架构开发者

2020-05-25 15:54:58

JavaScript框架开发

2012-04-05 10:00:15

2021-09-06 11:34:47

架构微服务Hystrix

2023-04-10 15:47:42

PythonGUI 库开发

2011-12-30 11:16:55

2011-07-05 18:01:18

2013-09-02 09:56:54

云服务企业亚马逊

2022-06-07 08:19:30

gRPCBallerina微服务

2012-03-07 10:19:38

云计算

2021-04-30 08:00:00

数据工程师开发工具

2020-09-14 07:00:00

测试自动化框架

2020-11-03 09:00:00

API微服务JavaScript框

2020-10-28 09:37:08

React代码数据
点赞
收藏

51CTO技术栈公众号