炫耀核心球衣 2.X 与资源配置

Question

我正试图在我的申请中加入炫耀。

我正在遵循这个指南https://github . com/Swagger-API/Swagger-Core/wiki/Swagger-Core-Jersey-2。x-Project-Setup-1.5 #使用-a-custom-application-subclass

但我将Jersey配置为ResourceConfig，如下所示：

    @ApplicationPath("/resources/api")
     public class ApiApplication extends ResourceConfig {

    public ApiApplication() {
        super(MultiPartFeature.class);
        packages("my.rest.resources");
        register(io.swagger.jaxrs.listing.ApiListingResource.class);
        register(io.swagger.jaxrs.listing.SwaggerSerializers.class);

        BeanConfig beanConfig = new BeanConfig();
        beanConfig.setVersion("1.0.2");
        beanConfig.setSchemes(new String[]{"http"});
        beanConfig.setHost("localhost:8080");
        beanConfig.setBasePath("/resources/api");
        beanConfig.setResourcePackage("my.rest.resources");
        beanConfig.setScan(true);
    }
  }

这是正确的吗？

没有昂首阔步。json生成。

根据我的理解，swagger文件应该在下面的链接上 http://localhost/api/api-docs/swagger.json

已将BasePath更改为resources/api

我在tomcat日志中也收到以下异常：

    SEVERE: Servlet /XXXXXX threw load() exception
java.lang.NoSuchMethodError: org.reflections.util.ClasspathHelper.forPackage(Ljava/lang/String;[Ljava/lang/ClassLoader;)Ljava/util/Collection;
    at io.swagger.jaxrs.config.BeanConfig.classes(BeanConfig.java:189)
    at io.swagger.jaxrs.config.BeanConfig.setScan(BeanConfig.java:168)
    at my.rest.resources.apps.ApiApplication.<init>(ApiApplication.java:34)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57)
    at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)

Answer 1

java.lang.NoSuchMethodError：org.reflections.util.ClasspathHelper.forPackage（Ljava/lang/String；[Ljava/lang/ClassLoader；）Ljava/util/Collection；在io.swagger.jaxrs.config.BeanConfig.classes（BeanConfig.java:189）在io.swagger.jaxrs.config.BeanConfig.setScan（BeanConfig.java:168）在my.rest.resources.apps.ApiApplication.（ApiApplication.java:34）在sun.reflect.NativeConstructorAccessorImpl.newInstance0（本机方法）

通过上述堆栈跟踪，观察到如下情况:

实际上，您使用的是Jersey1. x支持的jar，即reflections-0.9.9-RC1.jar，因此请将泽西2. x支持的jarreflections-0.9.9.jar添加到您的libs文件夹或类路径中。这将解决上述问题

Answer 2

>

ApiListingResource（swagger数据的来源）只不过是另一个JAX-RS（Jersey）资源类。

@Path("/")
public class ApiListingResource {
    ...
    @GET
    ...
    @Path("/swagger.{type:json|yaml}")
    public Response getListing(..) {...}
    ...
}

因此，资源路径将是基本@ApplicationPath（“/资源/api”）和变量资源路径 /swagger.json。因此，您需要访问 /resources/api/swagger.json。

您需要在BeanConfig中修复您的基本路径。此基本路径用于为swagger UI创建URL。使用基本路径"/api"意味着URL数据将导致UI访问不存在的/api/your Resources。基本路径应该是servlet上下文（我猜在您的情况下没有）和泽西基本路径（即/Resources/api）的组合。因此将BeanConfig基本路径设置为"/Resources/api"