java - Swagger : Multiple locations for API not being picked up

Question

在我的项目中有包含 Rest API 的不同包

e.g.
com.mypackage.rest
com.mypackage2.rest
com.mypackage3.rest

我想记录所有这些。

我有一个带有 swagger 插件的 Maven 项目，在其中我尝试为 Rest API 指定多个位置，如下所示

<locations>
  com.mypackage.rest;
  com.mypackage2.rest;
  com.mypackage3.rest
</locations>

但是当我执行 mvn clean install 时，它没有生成 swagger json 文件。

PS。如果我只使用一个位置，则会正确生成 json 文件。另外，如果我尝试将其如下所示，则只会生成最后一个包 json 文件。

<locations>com</locations>

需要帮助!

Answer 1

<locations>com.mypackage.rest;com.mypackage2.rest;com.mypackage3.rest</locations>应该可以解决问题，至少它对我有用(版本 3.1.x)

将来(尚未发布)语法将是:

<locations>
  <location>com.mypackage.rest</location>
  <location>com.mypackage2.rest</location>
  <location>com.mypackage3.rest</location>
</locations>

参见https://github.com/kongchen/swagger-maven-plugin/issues/328