无数据源解析程序映射模板参考 - Amazon AppSync
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

无数据源解析程序映射模板参考

这些区域有:AmazonAppSync 解析器映射模板与类型的数据源一起使用,使您能够调整请求AmazonAppSync 本地操作。

请求映射模板

映射模板很简单,使您能够通过 payload 字段传递尽可能多的上下文信息。

{ "version": string, "payload": any type }

下面是请求映射模板的 JSON 架构表示形式(解析后):

{ "definitions": {}, "$schema": "https://json-schema.org/draft-06/schema#", "$id": "https://aws.amazon.com/appsync/request-mapping-template.json", "type": "object", "properties": { "version": { "$id": "/properties/version", "type": "string", "enum": [ "2018-05-29" ], "title": "The Mapping template version.", "default": "2018-05-29" }, "payload": {} }, "required": [ "version" ], "additionalProperties": false }

通过 VTL 上下文属性传递字段参数,这一点对于这一点对于$context.arguments

{ "version": "2018-05-29", "payload": $util.toJson($context.arguments) }

payload 字段的值将转发到响应映射模板并可用于 VTL 上下文属性 ($context.result) 上。

这是一个表示 payload 字段的内插值的示例:

{ "id": "postId1" }

版本

对于所有请求映射模板都相同,version字段定义模板使用的版本。

version 字段为必填项。

例如:

"version": "2018-05-29"

有效负载

payload 字段是一个容器,可用于将任何格式正确的 JSON 传递到响应映射模板。

payload 字段为可选项。

响应映射模板

由于不存在任何数据源,payload 字段的值将转发到响应映射模板并在 context 对象上设置(此对象可通过 VTL $context.result 属性提供)。

如果 payload 字段值的形状与 GraphQL 类型的形状完全相符,您可以使用以下响应映射模板转发响应:

$util.toJson($context.result)

没有必填字段,也没有形状限制应用于响应映射模板。但是,由于 GraphQL 是强类型化的,因此解析的映射模板必须与预期的 GraphQL 类型匹配。