Swagger 2.x JaxrsAnnotationScanner找不到位于ear中的资源类

Question

我目前正在尝试用swagger Core记录一个现有的API。我使用swagger Core2.7和resteasy 3，因为我部署在Wildfly10上。我有一个包含rest servlet的war和一些位于ear中的模型类，该ear也包含war。模型类使用@schema进行注释，因此需要依赖于swagger-annotations。我遵循了https://github.com/swagger-api/swagger-core/wiki/swagger-2.x---Integration-and-configuration的教程

因此，我将依赖项添加到WAR的pom.xml中，并将注释模块依赖项添加到包含模型类的模块中。它会编译和部署，但当我浏览/myapp/openapi.yaml时，我在web.xml中定义的每个资源（war中包含的资源除外）的wildfly控制台中看到以下警告

我的web.xml配置：

    <servlet>
    <servlet-name>rserve-resteasy-servlet</servlet-name>
    <servlet-class>
        org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher
    </servlet-class>
    <init-param>
        <param-name>resteasy.servlet.mapping.prefix</param-name>
        <param-value>/</param-value>
    </init-param>
    <!-- specify scanner implementation -->
    <init-param>
        <param-name>openApi.configuration.scannerClass</param-name>
        <param-value>io.swagger.v3.jaxrs2.integration.JaxrsAnnotationScanner</param-value>
    </init-param>
    <!-- pretty print -->
    <init-param>
        <param-name>openApi.configuration.prettyPrint</param-name>
        <param-value>true</param-value>
    </init-param>
    <!-- specify resource classes to scan -->
    <init-param>
        <param-name>openApi.configuration.resourceClasses</param-name>
        <param-value>
        rserve.web.RService,
        at.prismasolutions.test.RServeBean.evaluation.REvaluationObject,
        at.prismasolutions.test.RServeBean.evaluation.optima.REvaluationObservationObject,
        at.prismasolutions.test.render.RPlotFormatParam
        </param-value>
    </init-param>
</servlet>

只找到位于war文件中的rserve.web.rservice。有没有使用包含耳朵的资源来设置swagger的经验？

Answer 1

遗憾的是，我不记得是哪些步骤真正导致了解决这个问题，但我最终从web.xml中删除了resourceClasses（war中包含的服务endpoint类resourceService除外）

我没有使用javax.ws.rs.application的任何派生，而是使用参数resteasy.scan注册资源

我的web.xml配置包含

<context-param>
    <param-name>resteasy.scan</param-name>
    <param-value>true</param-value>
</context-param>

    <listener>
    <listener-class>
        org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap</listener-class>
</listener>
<servlet>
    <servlet-name>rserve-resteasy-servlet</servlet-name>
    <servlet-class>
        org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class>
    <init-param>
        <param-name>resteasy.servlet.mapping.prefix</param-name>
        <param-value>/</param-value>
    </init-param>
    <!-- specify scanner implementation -->
    <init-param>
        <param-name>openApi.configuration.scannerClass</param-name>
        <param-value>io.swagger.v3.jaxrs2.integration.JaxrsAnnotationScanner</param-value>
    </init-param>
    <!-- pretty print -->
    <init-param>
        <param-name>openApi.configuration.prettyPrint</param-name>
        <param-value>true</param-value>
    </init-param>
    <!-- specify resource classes to scan -->
    <init-param>
        <param-name>openApi.configuration.resourceClasses</param-name>
        <param-value> rweb.RService </param-value>
    </init-param>
</servlet>

看一看：

例如jboss ClassLoading：ear中的类不能引用war类加载器加载的类

类依赖项引用不同的类，因为它们注册了两次（war类加载器、ear类加载器）