这与其说是一个错误,不如说是Servlet规范的限制。如何处理 JAX-RS 的细节是特定于实现的,我不能代表所有实现,但我猜典型的方法是简单地将其用作 servlet URL 模式。以泽西岛的 ServletContainerInitializer 实现为例,您会发现 addServletWithApplication()
方法负责创建 servlet 并映射来处理请求,您可以看到它确实使用 Jersey ServletContainer 映射路径中的路径。@ApplicationPath
@ApplicationPath
不幸的是,自古以来,Servlet 规范只允许少数几种将 servlet 映射到 URL 路径的方法。Servlet 3.0 的当前选项,在规范的第 12.2 节中给出 - 可悲的是只能以 PDF 格式提供,因此不能按部分链接 - 是:
-
/.../*
其中,初始值为零个或多个路径元素/...
-
*.<ext>
哪里是一些匹配的扩展<ext>
- 空字符串,仅映射到空路径/上下文根目录
-
/
,单个斜杠,表示上下文中的“默认”servlet,它处理与其他任何内容都不匹配的任何内容
- 任何其他字符串,这些字符串被视为要匹配的文本值
规范的同一部分还对匹配规则的应用顺序有特定的规则,但简短的版本是这样的:要使资源类在上下文根目录下应答请求,您必须使用或作为路径。如果使用 ,则将替换容器的默认 servlet,该 servlet 通常负责处理静态资源。如果你使用 ,那么你就让它变得太贪婪了,并说它应该一直匹配所有内容,并且默认的servlet永远不会被调用。/
/*
/
/*
因此,如果我们接受我们处于由 servlet URL 模式的局限性决定的框中,那么我们的选择就相当有限。以下是我能想到的:
1) 使用 ,并按名称或扩展名显式映射静态资源到容器的默认 servlet(在 Tomcat 和 Jetty 中名为“default”,不确定其他资源)。在网络.xml中,它看起来像@ApplicationPath("/")
<!-- All html files at any path -->
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.html</url-pattern>
</servlet-mapping>
<!-- Specifically index.html at the root -->
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/index.html</url-pattern>
</servlet-mapping>
或者使用 ServletContextInitializer,例如
public class MyInitializer implements ServletContainerInitializer {
public void onStartup(Set<Class<?>> c, ServletContext ctx) {
ctx.getServletRegistration("default").addMapping("*.html");
ctx.getServletRegistration("default").addMapping("/index.html");
}
}
由于匹配规则的编写方式,扩展模式胜过默认的 servlet,因此您只需要为每个静态文件扩展名添加映射,只要这些扩展与 API 中可能发生的任何“扩展”之间没有重叠即可。这非常接近您链接的论坛帖子中提到的不良选项,我只是为了完整性并添加ServletContextInitializer部分而提及它。
2) 将 API 保持映射到 ,并使用筛选器来标识对 API 的请求并将其转发到该路径。这样,您就可以打破 Servlet URL 模式框,并可以按照所需的任何方式匹配 URL。例如,假设所有 REST 调用都指向以 “/foo” 开头或正好是 “/bar” 的路径,并且所有其他请求都应转到静态资源,则如下所示:/rest/*
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.regex.Pattern;
@WebFilter(urlPatterns = "/*")
public class PathingFilter implements Filter {
Pattern[] restPatterns = new Pattern[] {
Pattern.compile("/foo.*"),
Pattern.compile("/bar"),
};
@Override
public void doFilter(ServletRequest request, ServletResponse response,
FilterChain chain) throws IOException, ServletException {
if (request instanceof HttpServletRequest) {
String path = ((HttpServletRequest) request).getServletPath();
for (Pattern pattern : restPatterns) {
if (pattern.matcher(path).matches()) {
String newPath = "/rest/" + path;
request.getRequestDispatcher(newPath)
.forward(request, response);
return;
}
}
}
chain.doFilter(request, response);
}
@Override
public void init(FilterConfig filterConfig) throws ServletException {}
@Override
public void destroy() {}
}
通过上述操作,您基本上可以按如下方式翻译请求:
http://example.org/foo -> http://example.org/rest/foo
http://example.org/foox -> http://example.org/rest/foox
http://example.org/foo/anything -> http://example.org/rest/foo/anything
http://example.org/bar -> http://example.org/rest/bar
http://example.org/bart -> http://example.org/bart
http://example.org/index.html -> http://example.org/index.html
3)意识到前面的选项基本上是URL重写,并使用现有的实现,例如Apache的mod_rewrite,Tuckey重写过滤器或ocpsoft Rewrite。