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

更新

我最近对这个框架进行了重大升级,虽然所做的改动不大,但成效显著。这次更新修复了旧框架中的所有主要问题,尽管它的的主要项目结构和接口都没有改变,具体改动内容请参见清晰架构(Clean Architecture)的Go微服务—重大升级。 现在它几乎拥有了我理想框架中的所有内容。它是一个轻量级的框架,但功能强大,并且还是可插拔的。我写了如下4篇文章来讲述新的框架。

  1. "一个可以自我进化的微服务框架"

  2. "一个非侵入的Go事务管理库——如何使用"

  3. "一个非侵入的Go事务管理库——工作原理"

  4. 清晰架构(Clean Architecture)的Go微服务—重大升级

如果你想上一个新的项目,那么我建议你从新的框架开始。至于我写的讲述旧的框架的文章大部分仍然有效。在新的框架中有三种模式,从简单到复杂。旧的框架是基于第三种模式的,是最复杂的。由于新的文章只覆盖了新的内容,旧的文章仍然需要阅读。至于阅读顺序,是先读新的还是先读旧的到关系不大,如果你没有读过任何一篇,那么你可以从新的入手,再读旧的。如果你已经读了旧的,那么再读新的,可能会对整个脉络比较清晰。如果有些文章中有一些不一致的地方,那么以新的文章为准。改动比较多的是事务管理和日志管理,程序结构也有一些小的改动。

原文

我用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)

源程序:

完整的源程序链接 github: https://github.com/jfeng45/servicetmpl

索引:

[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

posted @ 2020-02-17 09:36  倚天码农  阅读(589)  评论(0编辑  收藏  举报