java - PathParam 中的嵌入路径

Question

我要构建的 API 将包含以下资源：

@GET
@Path("document/{embedded_path"})
@Produces("text/plain")
public String getDocument(@PathParam("embedded_path") String path){ ... }

这样就可以像这样访问它：

http://example.com/document/relative/path/to/document.txt

到目前为止，我所读到的任何内容都没有明确禁止或允许其中包含“/”字符的资源参数。可以这样处理吗？（如果重要的话，客户端可能是 javascript）

Answer 1

通配符可以做到这一点。

@Path("/document/{embedded_path:.*}")

允许嵌入模板参数，格式如下：

param = "{" *WSP name *WSP [ ":" *WSP regex *WSP ] "}"
name = (ALPHA / DIGIT / "_")*(ALPHA / DIGIT / "." / "_" / "-" ) ; \w[\w\.-]*
regex = *( nonbrace / "{" *nonbrace "}" ) ; where nonbrace is any char other than "{" and "}"