OpenAPI - 为不断变化的api生成服务器代码？

Question

我正在维护一个Java应用程序，我们不断添加新功能（api中的更改）。我想转向使用OpenAPI作为记录api的方法。我看到两种思想流派：

1. 编写代码，使用一些注释生成OpenAPI规范。
2. 编写OpenAPI，用它来生成一些服务器代码。

虽然两者看起来都很好而且花花公子，但服务器代码只是简单地存在，然后需要大量手动插入服务。虽然这似乎是一次性成本，但下次我更新界面时，在我看来只有两个选项

1. 再次生成它们，重新进行所有手动接线。
2. 手动编辑先前生成的类以匹配新的spec文件（可能引入错误）。

我对这些选项是否正确？如果是这样，似乎使用代码生成api spec文件确实是唯一合理的选择。

Answer 1

我建议使用API​​ First方法，在yaml文件中描述您的API，并在每次添加新内容时生成。

现在你如何处理发电机覆盖手动工作？您可以使用继承根据生成的代码创建模型和控制器。

如果要确保文件没有被覆盖，也可以使用随生成器提供的.ignore文件。