POP可以将用户传递的参数转换为后端需要的格式及对参数的简单验证;也可将业务方返回的参数转换,使接入方的参数名和字段值不暴露给用户,也让用户更易识别。
具体配置方法可参照:入参描述、返回参数描述。
- 入参、出参名称映射
可以配置后端参数名称和展示名间映射关系;使用name和tagName分别表示后端参数名称和展示名称。
- 入参、出参值映射
可以隐藏后端参数值,转换为展示名。可以使用Switch进行遍历匹配。
- 默认值配置
对于非必填参数可以设置默认值,使用default=””表示,用户不填写此参数时,默认补齐。
- 枚举值校验
可以配置入参枚举;使用value=”1,2,3”配置。若用户传递值不在枚举范围内,则会直接返回错误:Invalid{ParameterName},不会将请求转至后端。
- 必填项校验
可对进行必填性校验,可配置required中的true、false表示;若用户不传必填参数,则直接返回错误:Missing{ParameterName},不会将请求转至后端。
- 数值类型入参取值范围校验
可对数值型参数设置取值范围,可以配置:minValue、maxValue;当用户传值不在取值范围内时,则会直接返回错误:Invalid{ParameterName},不会将请求转至后端。