配置解析器 (JavaScript)

登录到 Amazon Web Services Management Console，然后打开 AppSync 控制台。

1. 在 API 控制面板中，选择您的 GraphQL API。

2. 在侧边栏中，选择架构。

输入架构和数据源详细信息。有关更多信息，请参阅设计架构和附加数据源小节。

在架构编辑器旁边，具有一个名为解析器的窗口。该框包含架构窗口中定义的类型和字段列表。您可以将解析器附加到字段。您很可能会将解析器附加到字段操作。在本节中，我们将了解简单的查询配置。在 Query 类型下面，选择您的查询字段旁边的附加。

在附加解析器页面上的解析器类型下面，您可以在管道解析器和单位解析器之间进行选择。有关这些类型的更多信息，请参阅解析器。本指南将使用pipeline resolvers。

对于解析器运行时，选择 APPSYNC_JS 以启用 JavaScript 运行时环境。

您可以为该 API 启用缓存。我们建议暂时关闭该功能。选择创建。

在编辑解析器页面上，具有一个名为解析器代码的代码编辑器，可用于实施解析器处理程序和响应的逻辑（预备步骤和后续步骤）。有关更多信息，请参阅 JavaScript 解析器概述。

import {util} from '@aws-appsync/utils';

export function request(ctx) {
    return {};
}

export function response(ctx) {
    return ctx.prev.result;
}

在该部分下面，具有有一个名为函数的表。函数用于实施可以在多个解析器中重复使用的代码。您可以将源代码存储为函数以在需要时添加到解析器中，而不是不断重新编写或复制代码。

函数占据了管道的操作列表中的很大部分。在解析器中使用多个函数时，您可以设置函数顺序，将按该顺序运行它们。它们在请求函数运行之后和响应函数开始之前执行。

要添加新函数，请在函数下面选择添加函数，然后选择创建新函数。或者，您可能会看到一个创建函数按钮可供选择。

1. 选择一个数据源。这是解析器处理的数据源。

   注意

   在我们的示例中，我们为 getPost 附加一个解析器，它按 id 检索 Post 对象。假设我们已为该架构设置一个 DynamoDB 表。其分区键设置为 id 并且为空。

2. 输入一个Function name。

3. 在函数代码下面，您需要实施函数的行为。这可能会令人困惑，但每个函数具有自己的本地请求和响应处理程序。先运行请求，然后调用数据源以处理请求，最后由响应处理程序处理数据源响应。结果存储在上下文对象中。然后，运行列表中的下一个函数；如果是最后一个函数，则将其传递给后续步骤响应处理程序。

   注意

   在我们的示例中，我们将一个解析器附加到 getPost，它从数据源获取 Post 对象列表。我们的请求函数从表中请求数据，表将其响应传递给上下文 (ctx)，然后响应在上下文中返回结果。Amazon AppSync 的优势在于它与其他 Amazon 服务之间的互连。由于我们使用的是 DynamoDB，因此，我们具有一组操作以简化此类操作。我们还具有其他数据源类型的一些样板示例。

   我们的代码将如下所示：

   import { util } from '@aws-appsync/utils';
   
   /**
    * Performs a scan on the dynamodb data source
    */
   export function request(ctx) {
     return { operation: 'Scan' };
   }
   
   /**
    * return a list of scanned post items
    */
   export function response(ctx) {
     return ctx.result.items;
   }

   在该步骤中，我们添加了两个函数：

   • request：请求处理程序对数据源执行检索操作。参数包含上下文对象 (ctx) 或为执行特定操作的所有解析器提供的一些数据。例如，它可能包含授权数据、解析的字段名称等。返回语句执行 Scan 操作（请参阅此处的示例）。由于我们使用的是 DynamoDB，因此，我们可以使用该服务中的一些操作。扫描对表中的所有项目执行基本获取。该操作的结果作为 result 容器存储在上下文对象中，然后再传递给响应处理程序。request 在管道中的响应之前运行。

   • response：返回 request 输出的响应处理程序。参数是更新的上下文对象，返回语句是 ctx.prev.result。在本指南的当前阶段，您可能还不熟悉该值。ctx 指的是上下文对象。prev 指的是管道中的以前操作，也就是 request。result 包含在管道中执行解析器的结果。如果将它们放在一起，ctx.prev.result 将返回最后执行的操作的结果，即请求处理程序。

4. 在完成后，选择创建。

返回到解析器屏幕，在函数下面选择添加函数下拉列表，然后将您的函数添加到函数列表中。

选择保存以更新解析器。

登录到 Amazon Web Services Management Console，然后打开 AppSync 控制台。

1. 在 API 控制面板中，选择您的 GraphQL API。

2. 在侧边栏中，选择架构。

在解析器部分的 Mutation 类型下面，选择您的字段旁边的附加。

在附加解析器页面上的解析器类型下面，选择pipeline resolvers。提醒一下，您可以在此处找到有关解析器的更多信息。对于解析器运行时，选择 APPSYNC_JS 以启用 JavaScript 运行时环境。

您可以为该 API 启用缓存。我们建议暂时关闭该功能。选择创建。

选择添加函数，然后选择创建新函数。或者，您可能会看到一个创建函数按钮可供选择。

1. 选择您的 数据源。这应该是使用变更处理数据的源。

2. 输入一个Function name。

3. 在函数代码下面，您需要实施函数的行为。这是一个变更，因此，理想情况下，请求将对调用的数据源执行某种状态更改操作。结果由响应函数进行处理。

   注意

   createPost 在表中添加或“放置”新的 Post，并将我们的参数作为数据。我们可能会添如下内容：

   import { util } from '@aws-appsync/utils';
   
   /**
    * Sends a request to `put` an item in the DynamoDB data source
    */
   export function request(ctx) {
     return {
       operation: 'PutItem',
       key: util.dynamodb.toMapValues({id: util.autoId()}),
       attributeValues: util.dynamodb.toMapValues(ctx.args.input),
     };
   }
   
   /**
    * returns the result of the `put` operation
    */
   export function response(ctx) {
     return ctx.result;
   }

   在该步骤中，我们还添加了 request 和 response 函数：

   • request：请求处理程序接受上下文以作为参数。请求处理程序返回语句执行 PutItem 命令，这是内置的 DynamoDB 操作（请参阅此处或此处的示例）。PutItem 命令获取分区 key 值（由 util.autoid() 自动生成）以及来自上下文参数输入的 attributes（这些是在请求中传递的值），以将 Post 对象添加到我们的 DynamoDB 表中。key 是 id，attributes 是 date 和 title 字段参数。它们通过 util.dynamodb.toMapValues 帮助程序预先设置格式以与 DynamoDB 表一起使用。

   • response：响应接受更新的上下文，并返回请求处理程序的结果。

4. 在完成后，选择创建。

返回到解析器屏幕，在函数下面选择添加函数下拉列表，然后将您的函数添加到函数列表中。

选择保存以更新解析器。