创建基本查询 (JavaScript)

登录 Amazon Web Services Management Console 并打开AppSync控制台。

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

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

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

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

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

对于 Resolver 运行时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. 在APIs控制面板中，选择您的 GraphQL API。

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

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

在附加解析器页面上的解析器类型下面，选择pipeline resolvers。提醒一下，您可以在此处找到有关解析器的更多信息。对于 Resolver 运行时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. 在完成后，选择创建。

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

选择保存以更新解析器。