OpenAPI-为更改的api生成服务器代码？

Question

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

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

虽然看起来不错而且花哨的东西，但服务器代码只是简单地存根，然后需要大量手动插入服务。 虽然这看起来很不错，但是下次我更新界面时，在我看来，唯一的两个选择是

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

这些选项对吗？ 如果是这样，似乎使用代码生成api spec文件确实是唯一明智的选择。

Answer 1

我建议您使用API​​ First方法，在其中您可以在yaml文件中描述您的API并随新增加的内容进行生成。

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

如果要确保文件不会被覆盖，也可以使用生成器随附的.ignore文件。