是否建议使用 Swagger 编辑器生成服务器或客户端代码?

Is it recommended to use Swagger editor generated server or client code?

正如 Hugh Lauer 在讨论 Pilot 操作系统的构建时所说:“如果同样的人有两倍的时间,他们可以用一半的代码开发出同样好的系统。”所以 Less Code is better Code

我认为使用 Swagger 编辑器生成的代码(或 openapi 生成器)是个好主意。这也解耦了 REST 层,允许您稍后切换它并让您专注于您的核心逻辑。谷歌搜索没有显示其他人这样做的任何迹象。所以,我想知道使用 Swagger 编辑器生成服务器或客户端代码是坏习惯还是好习惯?有人可以与 Swagger 编辑器分享他们的经验或意见吗?为什么要编写可以由工具轻松生成的相同代码(并测试它!)?

谢谢!

这是个好问题。 在我看来,创建 REST server/client 代码是定义明确、常规且不复杂的工作,从程序员的角度来看,它在“手动”创建时需要高度关注:在更复杂的界面设计中存在 make 风险一些错误或错误,修复这些错误或错误可能很耗时且不太容易。 因此,使用像 Swagger code-gen 这样的自动化工具可以避免浪费时间并加快开发过程。 另一方面,Swagger code-gen 的自动生成代码有时会有错误(我在 C# 生成的代码中发现它们,在枚举处理中),因此应该对其进行验证和修复。当然,这些错误是重复的并且定义明确,所以在创建几个项目后,您将确切地知道需要修复什么以及如何修复 - 而且花费的时间相对较少 - 可能比“手动”创建整个代码要少得多. 最后:我同意你的看法,这似乎是一个很好的做法。