清晰架构(Clean Architecture)的Go微服务

2022-10-09,,,,

我用go和grpc创建了一个微服务项目,并试图找出最好的程序结构,它可以作为我其他项目的模板。我还将程序设计和编程的最佳实践应用于go microservice程序,例如清晰架构clean architecture),依赖注入(dependency injection),日志记录,错误处理等。我有java背景,并发现自己在java和go之间挣扎,它们之间的编程理念完全不同。我写了一系列关于在项目工作中做出的设计决策和取舍的文章。

阅读这些文章不需要熟悉go,但如果你有go基础绝对会有帮助。如果你不会go并且无法确定文章中的代码在做什么,那么你需要从这里go by example¹(你不必完成里面的所有主题,只需要前面几个)学习一些基本的go。本系列中的“事务支持”涉及到数据库,需要go中的一些数据库知识,你可以从go database / sql tutorial获取它²。如果你对go microservice编程感兴趣并思考和关心代码设计,程序结构,编码风格,日志记录,事务管理和依赖注入,那么这个系列非常适合你。

本系列的侧重点?

本系列不是关于如何快速创建程序原型,而是关于如何进行良好的程序设计使之能适应将来的变化。例如,你可能希望将一个服务的部分功能拆分为单独的微服务,或添加事务支持,或切换到更好的日志记录器,但不想更改代码中的每个日志记录语句。运用此项目中的程序设计,在进行上述更改时不会触及业务逻辑代码。你甚至很少更改任何现有代码(容器代码除外),多数时候只添加新代码,因此qa工作量大大减少。你可以使用此程序作为下一个微服务应用的基础框架,省去了从头开始的麻烦。你唯一需要做的就是熟悉本框架的内部结构。如果你有spring(java)背景或来自面向对象的经历,或者知道清晰架构(clean architecture)或solid (面向对象设计),那么这些代码应该对你很熟悉。

你无需按以下顺序阅读文章。 如果你熟悉清晰架构(clean architecture)³或solid (面向对象设计)⁴,你可以按任意顺序阅读文章而不会有任何问题。 但我还是建议你至少先读完第一篇,它将为你提供整个项目的概述,然后你可以选择后面的任何一篇的文章。

  1. 清晰架构(clean architecture)的go微服务: 程序结构

  2. 清晰架构(clean architecture)的go微服务: 程序设计

  3. 清晰架构(clean architecture)的go微服务: 设计原则

  4. 清晰架构(clean architecture)的go微服务: 编码风格

  5. 清晰架构(clean architecture)的go微服务: 事物管理

  6. 清晰架构(clean architecture)的go微服务: 日志管理

  7. 清晰架构(clean architecture)的go微服务: 程序容器(application container)

  8. 清晰架构(clean architecture)的go微服务: 依赖注入(dependency injection)

源程序:

完整的源程序链接 :

索引:

[1] go by example

[2] go database/sql tutorial

[3][the clean code blog]()

[4] s.o.l.i.d is for the first five object-oriented design (ood) principles introduced by robert c. martin, popularly known as uncle bob and the acronym is introduced later by michael feathers

《清晰架构(Clean Architecture)的Go微服务.doc》

下载本文的Word格式文档,以方便收藏与打印。