如何正确使用从摇摇欲坠的规范生成的服务器存根？

Question

我正在使用Swagger 2.0和swagger-codegen（实际上是Maven的swagger-codegen-
plugin）以Java为目标语言来指定，记录和生成API。

已经设置了该项目以构建服务器存根（JAX-RS）和文档，并且Eclipse可以识别项目buildPath中生成的代码。

我不确定这里合适的工作流程是什么。：-/

我不认为我应该修改生成的类，否则，每当我更改swagger规范时，我的更改就会被覆盖，并且我希望随着开发的进行，我对API的更多了解也会改变。

那我该怎么办？从生成的类（哪些？）继承还是将它们包括在我自己的类中？

Answer 1

这里有两个解决方案的步骤。

1. 将 / * Controller.java或 / * Impl.java添加到.swagger-codegen-ignore文件。根据使用的语言，默认实现在 Controller.java或 Impl.java文件中提供。一旦默认实现从生成中排除，您就可以在自己的类中实现生成的接口。您自己的类中的代码将不会在mvn clean上刷新。

2. .swagger-codegen-ignore文件本身是自动生成的文件，因此在执行mvn清理时，将刷新在步骤1中添加的内容。为了避免这种情况，请将您的的版本保留.swagger-codegen-ignore在resources文件夹中，然后将以下插件添加到pom中，以便在Mavenhtml" target="_blank">生命周期开始时复制该文件：

   <plugin>
   
   <groupId>org.apache.maven.plugins</groupId>
   
   <artifactId>maven-resources-plugin</artifactId>
   
   <executions>
   
       <execution>
   
           <id>copy-resources</id>
   
           <phase>initialize</phase>
   
           <goals>
   
               <goal>copy-resources</goal>
   
           </goals>
   
           <configuration>
   
               <outputDirectory>${project.build.directory}/generated/swagger</outputDirectory>
   
               <resources>
   
                   <resource>
   
                       <directory>${basedir}/src/main/resources</directory>
   
                       <includes>
   
                           <include>.swagger-codegen-ignore</include>
   
                       </includes>
   
                   </resource>
   
               </resources>
   
           </configuration>
   
       </execution>
   
   </executions>