开关

使用 switch 组件基于所满足的指定条件执行组合件的众多部分之一。

网关支持

表 1. 显示哪些网关支持此策略以及对应策略版本的表格
网关	策略版本
DataPower® Gateway (v5 compatible)	1.0.0
DataPower API Gateway	2.0.0

本主题介绍了如何在 Assembly 用户界面中配置策略；有关如何在您的 OpenAPI 源中配置策略的详细信息，请参阅 switch。

switch 构造提供基于多种条件来确定组合件分支的方法。每个 switch 组件都包含多个案例，每个案例都对应于仅当满足或使用案例指定的条件或操作时执行的组合件的一部分。此外，如果不满足任何其他案例，那么会执行 otherwise 案例。

通过单击 + 案例来添加新案例，并通过单击 + otherwise来添加 otherwise 案例。

如果满足多个案例，将执行最高优先级的案例。点击 “向上移动 "上移" 图标 ”和 “向下移动 "下移" 图标 ”图标，即可更改案件的优先级。

要配置调用特定操作时执行的案例，请使用搜索操作字段，并从列表中选择操作。您可以通过在搜索操作字段中输入内容来优化搜索结果。

要根据 GatewayScript 条件配置要执行的案例，请单击编辑条件，然后在条件编辑器窗口中输入脚本。提供脚本后，可以在条件字段中或者通过单击编辑条件来编辑脚本。

如果要使用 DataPower Gateway (v5 compatible)，请在条件编辑器中直接在代码区中输入条件 GatewayScript 。如果您正在使用 DataPower API Gateway，条件编辑器提供了一个脚本生成器，可帮助您编写条件脚本；有关详细信息，请参阅《使用 Switch 策略条件编辑器》。

要删除一个案例，请点击 “删除案例 ”图标 "除去案例" 图标。

如果要在满足案例条件时执行一个或多个策略或构造，请将新策略或构造拖至 switch 构造的案例部分中显示的某个虚线框。

注: 交换机案例必须至少包含一个策略，否则网关服务器将返回错误。

构造属性详细信息

您可以在组合视图的属性工作表中配置构造的属性。

表 2. switch 结构的特性
属性	必需	描述
标题	False	构造的定制标题（显示在画布中时）。如果未指定标题，那么缺省情况下会使用 `switch`。
描述	False	构造描述，不显示在画布中。
case	是（一个或多个）	指定一个或多个操作，或者为条件编写脚本。使用“条件编辑器”来构造条件脚本。请参阅 “使用交换机策略条件编辑器 ”。使用 GatewayScript 来提供条件。可使用 `apim.getvariable('context.location.variable')` 格式来引用变量，其中 `context` 是要引用的上下文，`location` 是此上下文中变量的位置，`variable` 是变量的名称。有关可用于生成条件的上下文变量列表，请参阅 API ConnectAI Gateway 上下文变量。
否则	False	如果不满足任何其他案例时要执行组合件的某一部分，请添加 otherwise 案例。