Как правильно использовать плагин Swagger Maven с существующим проектом? - PullRequest
0 голосов
/ 07 февраля 2019

У меня есть проект Jetty, использующий Spring-MVC.Теперь я ввел swagger для создания файла .yaml с новым файлом спецификации API (v2 API, так как мне приходится писать новые API, оставляя существующие API одни из-за устаревших причин).

Я установил swagger-maven-plugin (https://github.com/swagger-api/swagger-codegen/tree/master/modules/swagger-codegen-maven-plugin) для генерации моделей и интерфейсов API в моей папке src / main.

Это правильный способ сделать это или нет?

По умолчаниюон генерирует эти файлы в целевую / автоматически генерируемую папку, которую я не понимаю, почему

1 Ответ

0 голосов
/ 07 февраля 2019

Зачем вам регистрировать созданные исходные файлы, которые создаются каждый раз, когда вы касаетесь входного файла?Это означает, что у вас всегда есть избыточный коммит , если вы меняете свой входной файл.Но это даже хуже, другой разработчик (не знакомый с вашим решением) может подумать, что в исходной папке есть java-код, поэтому он может просто внести небольшое изменение, чтобы исправить проблему.Это может даже работать на его локальной машине.Но после загрузки в SCM и полной сборки maven на сервере сборки его изменения исчезнут.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...