@Path注释中冒号（:)的含义

Question

我是Restful服务的新手。 我正在查看代码并找到了这一行

@GET

@Path("{image:image/.*}")

有人可以解释一下上述语法的含义和用法吗？

Answer 1

@Path表示法支持匹配路径的正常字符串或匹配模式的正则表达式。 在你的情况下

@Path("{image:image/.*}")

似乎只是匹配一种模式

路径参数{image}具有任何模式，如image /.*，它基本上转换为图像/任何东西，这里的任何东西都不是指“任何”这个词，而是它的字面意思，即任何有效的文本。

更正：有关完整详细信息，请参阅@Sotirios Delimanolis答案。 谢谢配偶纠正输入。

Answer 2

该表示法称为URI路径模板，并在文档中进行了描述 。

您可以通过在括号{}声明它来定义新模板变量。 JX-RS环境将绑定从请求的URI到声明的@PathParam处理程序方法参数的相应路径段。

从文档中

URI路径模板是URI，其中包含嵌入在URI语法中的变量。 这些变量在运行时被替换，以便资源基于替换的URI响应请求。 变量用大括号（ {和} ）表示 。 例如，查看以下@Path注释：

 @Path("/users/{username}") 

在这种示例中，提示用户键入他或她的姓名，然后配置为响应对此URI路径模板的请求的JAX-RS Web服务进行响应。 例如，如果用户键入用户名“Galileo”，则Web服务会响应以下URL：

 http://example.com/users/Galileo 

要获取用户名的值，可以在请求方法的方法参数上使用@PathParam注释 ，如以下代码示例所示：

 @Path("/users/{username}") public class UserResource { @GET @Produces("text/xml") public String getUser(@PathParam("username") String userName) { ... } } 

然后，文档继续指定表示法的语法

默认情况下，URI变量必须与正则表达式“[^ /] +？”匹配 。 可以通过在变量名称后指定不同的正则表达式来自定义此变量 。 例如，如果用户名必须仅包含小写和大写字母数字字符，请覆盖变量定义中的默认正则表达式：

 @Path("users/{username: [a-zA-Z][a-zA-Z_0-9]}") 

在此示例中，username变量将仅匹配以一个大写或小写字母开头的用户名以及零个或多个字母数字字符和下划线字符。 如果用户名与该模板不匹配，则会向客户端发送404（未找到）响应。

所以你的榜样

@Path("{image:image/.*}")

定义名为image的URI模板变量，其中包含与正则表达式匹配的段

image/.*

因此，JAX-RS环境将使用带注释的方法来处理URI匹配的请求

http://somehost.com/context-path/image/[anything]

据推测，你的方法会有一个参数

@Path("{image:image/.*}")
public Response handle(@PathParam("image") String path) { /* handling */ }

和path的值为"image/[anything]" 。