java - Swagger 和自动资源发现

Question

我根据本教程使用 Swagger for Jersey2:https://github.com/swagger-api/swagger-core/wiki/Swagger-Core-Jersey-2.X-Project-Setup-1.5使用自定义应用程序类。为了让 Swagger 正确初始化，需要实现对 getClasses() 的覆盖。

不幸的是，这也意味着我必须手动将资源中的每个类添加到 HashSet。如果我不这样做，所有端点都会返回 404。但是当我不使用 Swagger 时，我不必重写该方法，并且我的所有 REST 资源都会由 JAX-RS 注释自动发现。

有没有办法在注册 Swagger 类的同时保留对我的个人资源的自动发现？

Answer 1

使用 ResourceConfig ，它扩展了 Application。 ResourceConfig有一个packages方法通过包扫描注册所有类，你可以在ResourceConfig<上调用register注册Swagger组件。您可以在构造函数中执行所有这些操作。

@ApplicationPath("/api")
public class AppConfig extends ResourceConfig {
    public AppConfig() {
        packages("the.packages.to.scan");
        register(SwaggerComponent.class);
    }
}

另请参阅:

• Swagger overrides Path-Annotations另一种选择。它使用标准的 JAX-RS API。但另请参阅有关类路径扫描的链接以及为什么不应该使用它。更好、更快地扫描包裹。