创建一个用例的 Go 项目

一分耕耘，一分收获！既然都打开这篇《创建一个用例的 Go 项目》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新Golang相关的内容，希望对大家都有所帮助！

我正在构建一个与多个第三方提供商通信的 go 服务。该 go-service 充当这些多个提供者之间的接口，我的内部应用程序仅使用该 go 服务的一个 api。

我的应用程序现在具有以下结构

- app
- config
- controllers
- dto 
- exceptions
- providers - all external api calls to thrid-party happens here
- services - business logic
- tests

我必须集成到 10 多个第三方 api，并且我对如何保留 json 编组和解组的结构感到困惑。

从维护的角度来看，我在重组应用程序时需要注意一些事情

• 每个第三方服务都可以由开发人员独立集成，而不会互相干扰而扰乱其他人的代码。开发人员可能只需要知道他/她的第三方集成的集成。

• 每个第三方可能都有一些可以利用的常见实用程序，例如：身份验证机制或日志记录或哨兵之类的东西。

• 所有外部 api 调用的请求和响应结构体放在哪里？

我的计划是

• dto
  • thirdparty1requeststruct
  • thirdparty1responsestruct
  • thirdparty2requeststruct
  • thirdparty2responsestruct ...等等。

但是当我有大约 20 个第三方 api 时，就会有很多请求-响应结构，从可读性的角度来看，目录会太大。

我的问题是

How would you as a go developer go about structuring the application keeping the above requirements in mind?

请忍受这个问题，因为我对编程还很陌生。请理解，这是固执己见的，但对于这个特定的用例，它是如何工作的呢？我在网上找不到任何资源。

解决方案

除了 @muhamed keta 所写的内容之外，我还建议添加对每个提供程序使用子包的建议，而不是使用一个包含 10 个提供程序的大型包。这看起来像这样：

/cmd/app
/config
...
/lib # or /utils 
/providers
    /provider1
        dtos.go
        client.go
        ...
    /provider2
        dtos.go
        client.go
        ...

在 go 中，包名称成为一个命名空间和一个供客户端代码使用的非可选标识符/鉴别器。通过这种方式，您可以避免编写更长、冗余、有时甚至是口吃的名称来区分不同的提供者：

因此，在使用您的提供程序的代码中，您将拥有 provider1.client，而不是编写 providers.provider1client。这似乎是一种常见的 go 模式/最佳实践。

这也意味着与每个提供程序的实现密切相关的所有代码都非常接近，从而防止名称冲突并帮助专门关注提供程序的开发人员。

我添加了一个 lib（或 utils）包，其中包含可以在许多提供程序之间共享的通用代码。

这是主观的，但希望我已经在考虑到语言限制的情况下概述了一些合理的优点。

首先，请注意，这个问题在一定程度上是主观的，并且没有正确的答案.

我个人喜欢有 cmd/app、config 子目录，因为它们包含启动/运行应用程序的逻辑，这样捆绑时我感觉很好。

对于应用程序的其余部分，我喜欢采用扁平结构，仅在存在严重耦合时才进入子目录。将处理程序、数据库（如果有）和外部 api（如果有）之间的层分开非常重要。

我建议类似：

/cmd/app
/config
/provider
  provider1.go // contains the request response structs in itself
  provider2.go // contains the request response structs in itself
provider.go

最终，更多的代码可能看起来不太可维护，但它比大量耦合的代码要好。如果一个 api 突然决定切换有效负载格式，那么在其中一个文件中查找整个过程要容易得多，而不是在非常不同的子目录中搜索 3 个文件。

好了，本文到此结束，带大家了解了《创建一个用例的 Go 项目》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！