java - Spring Boot Jersey : allow Jersey to serve static content

Question

该应用程序使用 JDK 8、Spring Boot 和 Spring Boot Jersey starter，并打包为 WAR(尽管它通过 Spring Boot Maven 插件在本地运行)。

我想做的是获取我动态生成的文档(在构建时)作为欢迎页面。

我尝试了几种方法:

1. 通过在 application.properties 中配置让 Jersey 提供静态内容 the proper init parameter如所述here
2. 引入 metadata-complete=false web.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 应用程序类(我尝试添加一个 application.properties 和 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);
    }
}

Answer 1

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

---

关于您的第一种方法，请查看 Jersey ServletProperties .您尝试配置的属性是 FILTER_STATIC_CONTENT_REGEX .它指出:

The property is only applicable when Jersey servlet container is configured to run as a Filter, otherwise this property will be ignored

Spring Boot 默认将 Jersey servlet 容器配置为 Servlet(如 here 所述):

By default Jersey will be set up as a Servlet in a @Bean of type ServletRegistrationBean named jerseyServletRegistration. You can disable or override that bean by creating one of your own with the same name. You can also use a Filter instead of a Servlet by setting spring.jersey.type=filter (in which case the @Bean to replace or override is jerseyFilterRegistration).

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

仅供引用，无论是配置为 Servlet Filter 还是 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);
    }
}