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