Spring-Boot Jersey：允许 Jersey 提供静态内容

该应用程序使用 JDK 8、Spring Boot 和 Spring Boot Jersey 启动器，并打包为 WAR（尽管它是通过 Spring Boot Maven 插件在本地运行）。

我想做的是将我动态（在构建时）生成的文档作为欢迎页面。

我尝试了几种方法：

1. 让 Jersey 通过配置来提供静态内容application.properties 正确的初始化参数 https://github.com/spring-projects/spring-boot/blob/master/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/jersey/JerseyProperties.java#L61如上所述here https://stackoverflow.com/questions/12422660/jersey-servlet-mapping-causes-404-error-for-static-resources
2. 介绍一个metadata-complete=false web.xml以便将生成的 HTML 文档列为欢迎文件。

这些都没有成功。

我想避免必须启用 Spring MVC 或创建 Jersey 资源只是为了提供静态文件。

任何想法？

这是 Jersey 配置类（我尝试添加一个但没有成功）ServletProperties.FILTER_STATIC_CONTENT_REGEX there):

@ApplicationPath("/")
@ExposedApplication
@Component
public class ResourceConfiguration extends ResourceConfig {

   public ResourceConfiguration() {
      packages("xxx.api");
      packages("xxx.config");
      property(ServerProperties.BV_DISABLE_VALIDATE_ON_EXECUTABLE_OVERRIDE_CHECK, true);
      property(ServerProperties.BV_SEND_ERROR_IN_RESPONSE, true);
   }
}

这是 Spring Boot 应用程序类（我尝试添加一个application.properties with spring.jersey.init.jersey.config.servlet.filter.staticContentRegex=/.*html但它不起作用，我不太确定这里的属性键应该是什么）：

@SpringBootApplication
@ComponentScan
@Import(DataConfiguration.class)
public class Application extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

首先我要声明，静态内容不会被提供的原因是 Jersey servlet 的默认 servlet 映射，即/*，并占用所有请求。因此无法访问提供静态内容的默认 servlet。除了下面的解决方案之外，另一个解决方案是简单地更改 servlet 映射。您可以通过注释您的ResourceConfig子类与@ApplicationPath("/another-mapping")或设置application.properties财产spring.jersey.applicationPath.

关于您的第一种方法，请看一下球衣ServletProperties https://jersey.github.io/apidocs/2.26/jersey/org/glassfish/jersey/servlet/ServletProperties.html。您尝试配置的属性是FILTER_STATIC_CONTENT_REGEX https://jersey.github.io/apidocs/2.26/jersey/org/glassfish/jersey/servlet/ServletProperties.html#FILTER_STATIC_CONTENT_REGEX。它指出：

该属性仅在 Jersey servlet 容器配置为作为 Filter 运行时适用，否则该属性将被忽略

Spring Boot 默认将 Jersey servlet 容器配置为 Servlet（如前所述here http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-jersey):

默认情况下，Jersey 将被设置为 Servlet@Bean类型的ServletRegistrationBean named jerseyServletRegistration。您可以通过创建您自己的同名 bean 来禁用或覆盖该 bean。您还可以通过设置使用 Filter 而不是 Servletspring.jersey.type=filter（在这种情况下@Bean替换或覆盖是jerseyFilterRegistration).

所以只需设置属性spring.jersey.type=filter在你的application.properties，它应该可以工作。我已经测试过这个。

仅供参考，无论配置为 Servlet Filter 还是 Servlet，就 Jersey 而言，功能都是相同的。

顺便说一句，而不是使用FILTER_STATIC_CONTENT_REGEX，当您需要设置一些复杂的正则表达式来处理所有静态文件时，您可以使用FILTER_FORWARD_ON_404 https://jersey.github.io/apidocs/2.26/jersey/org/glassfish/jersey/servlet/ServletProperties.html#FILTER_FORWARD_ON_404。这实际上是我用来测试的。我刚刚将其设置在我的ResourceConfig

@Component
public class JerseyConfig extends ResourceConfig {

    public JerseyConfig() {
        packages("...");
        property(ServletProperties.FILTER_FORWARD_ON_404, true);
    }
}