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

Question

该应用程序使用JDK8、Spring Boot和Spring Boot Jersey starter，并被打包为WAR（尽管它是通过Spring Boot Maven插件在本地运行的）。

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

我尝试了几种方法：

1. 通过在application.properties中配置正确的init参数，让Jersey提供静态内容，如下所述
2. 引入元数据-complete=falseweb.xml以便将生成的HTML文档列为欢迎文件。

这些都没有成功。

我希望避免启用Spring MVC或创建一个仅用于服务静态文件的Jersey资源。

下面是Jersey配置类（我尝试在其中添加ServletProperties.filter_static_content_regex，但未成功）：

@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应用程序类（我尝试用Spring.jersey.init.jersey.config.servlet.filter.StaticContentRegex=/.*HTML添加application.properties，但没有成功，我不确定这里的属性键应该是什么）：

@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);
    }
}

Answer 1

首先让我声明，静态内容不会被提供的原因是Jersey servlet的默认servlet映射，它是/*，并且占用了所有请求。因此无法访问为静态内容提供服务的默认servlet。除了下面的解决方案之外，另一个解决方案是简单地更改servlet映射。可以通过使用@applicationPath（“/othere-mapping”）注释ResourceConfig子类或设置application.properties属性spring.jersey.applicationPath来实现。

关于您的第一种方法，请看一下泽西ServletProperties。您尝试配置的属性是filter_static_content_regex。它指出：

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

Spring Boot默认情况下将Jersey servlet容器配置为servlet（如这里所述）：

默认情况下，Jersey将被设置为ServletRegistrationBean类型的@html" target="_blank">bean中的Servlet（名为JerseyServletRegistration）。您可以通过创建一个同名的bean来禁用或重写该bean。您还可以通过设置spring.jersey.type=Filter（在这种情况下，要替换或覆盖的@bean是jerseyfilterregistration)来使用过滤器而不是Servlet。

因此，只需在application.properties中设置属性spring.jersey.type=filter，它就应该起作用了。我测试过这个。

另外，无论配置为Servlet过滤器还是Servlet，就Jersey而言，功能都是相同的。

另外，您可以使用filter_static_content_regex来处理所有静态文件，而不是使用filter_forward_on_404。这其实是我过去测试的。我只是在resourceConfig中设置了它

@Component
public class JerseyConfig extends ResourceConfig {

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