如何在Armeria Server中创建含冒号(:)的HTTP端点？

Armeria默认会把路径中的冒号:解析为路径参数的分隔符，所以直接使用/someresource:validate会触发格式错误。这里有几个可行的解决办法：

• 使用精确匹配前缀：在路径前添加=标记，让Armeria将整个路径视为精确字符串，不再解析冒号。配置示例：

  server.route()
       .post("=/someresource:validate")
       .handler((ctx, req) -> HttpResponse.of(200));
  

  这个方法最适配Google API自定义方法的固定路径场景，推荐优先使用。

• 转义冒号字符：在冒号前添加反斜杠进行转义，告知Armeria这是普通字符。注意Java字符串中需要使用双反斜杠：

  server.route()
       .post("/someresource\\:validate")
       .handler((ctx, req) -> HttpResponse.of(200));
  

• 自定义路径解析器（全局配置）：如果需要全局禁用冒号的参数解析功能，可以自定义PathPatternParser并配置给服务器：

  PathPatternParser parser = PathPatternParser.builder()
                                              .disableColonPrefixParameter()
                                              .build();
  Server server = Server.builder()
                        .pathPatternParser(parser)
                        .route()
                        .post("/someresource:validate")
                        .handler((ctx, req) -> HttpResponse.of(200))
                        .then()
                        .build();
  

  这个方法适合有大量类似路径需要处理的场景，但会改变全局路径解析行为，需谨慎使用。

内容的提问来源于stack exchange，提问作者Aiono