REST 路径参数与资源路径冲突？

Question

这个问题是在我使用 JAX-RS 构建后端时出现的，但这确实适用于任何 REST API。

JAX-RS 如何处理可能由于参数路径变量而发生冲突的路径？ 假设你有

@POST
@Path('createBox/{boxName}')
foo()

@POST
@Path('createBox/small')
bar()

有人想用路径参数调用第一个端点small 。 在这种情况下会发生什么？ 如果foo()和bar()具有不同的参数（可能像@FormParam ），这有助于区分吗？ 如果它们在没有 arguments 的情况下完全相同怎么办？ 行为是不确定的吗？

Answer 1

参考： RESTful Java with JAX-RS 2.0, 2nd Edition by Bill Burke

1. "/customers/{id: .+} <-- getCustomer
2. "/customers/{id: .+}/address" <-- 获取地址

优先规则

JAX-RS 规范为匹配 URI 表达式定义了严格的排序和优先级规则，并且基于最具体的匹配获胜算法。

1. 排序的主键是完整 URI 匹配模式中的文字字符数，并且按降序排列（getCustomer 中为 11，getAddress 中为 18）
2. 排序的辅助键是嵌入在模式中的模板表达式的数量——即{id}或{id: .+} 。 这种排序是按降序排列的。
3. 排序的第三个键是非默认模板表达式的数量。 默认模板表达式是一个没有定义正则表达式的模板，即{id}

你的例子：

bar()获胜，因为根据规则 1，它具有更多文字字符