1.2.2. 映射规则的匹配

映射规则的匹配由前缀执行,可以是任意复杂的。符号遵循 OpenAPI 和 ActiveDocs 规格:

  • 映射规则必须以正斜杠(/)开头。
  • 您可以在字面字符串的路径上执行匹配项(例如: /hello)。
  • 映射规则可以包含查询字符串或正文上的参数(例如: /{word}?value={value})。APIcast 获取参数的方式如下:

    • GET 方法:来自查询字符串。
    • POSTDELETEPUT 方法:来自正文。
  • 映射规则可以包含命名通配符(例如: /{word})。此规则将匹配占位符 {word} 中的任何内容,使请求(如 /morning )与规则匹配。通配符可以在斜杠或斜杠与点之间出现。参数也可以包含通配符。
  • 默认情况下,根据您指定的排序,从第一个到最后一个到最后一个映射规则评估所有映射规则。如果您添加规则 /v1 ,它将与路径以 /v1 开头的请求匹配(例如: /v1/word/v1/sentence)。
  • 您可以在模式的末尾添加一个美元符号($)来指定完全匹配项。例如,/v1/word$ 将仅匹配 /v1/word requests,并且不匹配 /v1/word/hello 请求。要完全匹配,还必须确保禁用了与所有(/)匹配的默认映射规则。
  • 多个映射规则可以匹配请求路径,但如果都不匹配,则会使用 HTTP 404 状态代码丢弃该请求。