无法在 Websphere Liberty Profile 上获得 Swagger Annotations 输出答案

【问题标题】：Can't get Swagger Annotations output on Websphere Liberty Profile无法在 Websphere Liberty Profile 上获得 Swagger Annotations 输出
【发布时间】：2017-05-21 04:35:31
【问题描述】：

我正在尝试在部署到 WAS Liberty Profile 16.0.0.3 的 Web 应用程序中使用 Swagger (1.5.12) 注释。但是，当我访问 /swagger.json URL 时，会抛出以下异常：

[err] [Default Executor-thread-13] WARN org.reflections.Reflections - 无法从 url 创建 Vfs.Dir。忽略异常并继续 [err] org.reflections.ReflectionsException：无法从 url 创建 Vfs.Dir，找不到匹配的 UrlType [wsjar:file:/opt/ibm/WebSphere/Liberty-ND-16.0.0.3/wlp/usr/servers/defaultServer /workarea/org.eclipse.osgi/61/data/cache/com.ibm.ws.app.manager_87/.cache/!/WEB-INF/classes/] 使用 fromURL(final URL url, final List urlTypes) 或使用静态 setDefaultURLTypes(final List urlTypes) 或 addDefaultURLTypes(UrlType urlType) 与您的专门 UrlType。 [错误] 在 org.reflections.vfs.Vfs.fromURL(Vfs.java:109)

你知道如何解决这个问题吗？我想将此 swagger.json 输出与 /ibm/api/explorer/ 上下文下的 WLP 附带的 REST API 文档一起使用。

谢谢，欢迎提出任何建议！

【问题讨论】：

标签： jax-rs swagger websphere-liberty

【解决方案1】：

我解决了在 server.xml 中添加以下设置的问题：

<classloading useJarUrls="true"/>

我还不得不降级到 Swagger 1.5.3

【讨论】：

【解决方案2】：

是的，目前 WebSphere Liberty 支持 Swagger 注释 1.5.3。如果使用 1.5.4，您不会收到编译器错误，但还没有对该版本的完全支持。

Open Source 中的 annotations 包的版本升级很快，但请放心，在接下来的几个月里，WebSphere Liberty 将与最新版本同步。

【讨论】：