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:.*}")

Embedded template parameters are allowed and are of the form :

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 "}"