Spring MVC：RESTful URI 的控制器方法的正确注释，包括 ';'

Question

设计我的 RESTful API，我想使用以下 URI，

http://[HOST]/[PLANET]/[LAT];[LONG]

例如

http://myserver/earth/50.2;29.1

Spring MVC 中此类方法的适当注释是什么？下面这个可以吗？

@RequestMapping(value = "/{planet}/{lat};{long}", method = RequestMethod.GET)
public String showInfoAboutCoords(
  @PathVariable final String planet, 
  @PathVariable final String lat,
  @PathVariable final String long, 
  final HttpServletResponse response) {
        // Implementation
}

如果这个没问题 - @MaskFormat("###-##-####") 有什么用？

Answer 1

您的 URI 模式有两个问题：

• 某些 servlet 容器可能会将 ; 视为分隔符并修剪 URI（例如 Tomcat 的 错误 30535）。因此，作为解决方法，您可以使用一些不同的字符，例如 ,。
• 默认情况下，Spring MVC 将 URI 中的点视为扩展分隔符并对其进行修剪。您可以通过为路径变量指定正则表达式模式来覆盖它。

因此，您将看到类似的内容

@RequestMapping(value = "/{planet}/{lat:.*},{long:.*}", method = RequestMethod.GET) 

，请注意，由于您禁用了 Spring 的扩展处理，因此如果需要，您必须手动启用它（这还需要更严格的正则表达式，以避免将小数点与扩展分隔符混淆）

@RequestMapping(value = 
    {"/{planet}/{lat:.*},{long:\\d+\\.\\d+}", 
         "/{planet}/{lat:.*},{long:\\d+\\.\\d+}.*"}, 
    method = RequestMethod.GET)

： 您可能指的是来自 mvc-showcase 的注释（请注意，它是内置注释）。它与 MaskFormatAnnotationFormatterFactory 一起演示了将路径变量（即字符串）转换为方法参数的新格式化工具。实际上，它将 String 转换为 String，因此它仅用于验证。