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