更新

我最进对这个框架进行了重大升级，虽然所做的改动不大，但成效显著。这次更新修复了旧框架中的所有主要问题，尽管它的的主要项目结构和接口都没有改变，具体改动内容请参见清晰架构（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