本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

解析程式

設定 API 欄位的解析程式GraphQL。 AWS Serverless Application Model (AWS SAM) 支援JavaScript 管線解析器。

語法

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

YAML

OperationType:
  LogicalId:
    Caching: CachingConfig
    CodeUri: String
    FieldName: String
    InlineCode: String 
    MaxBatchSize: Integer
    Pipeline: List
    Runtime: Runtime
    Sync: SyncConfig

屬性

範例

使用 AWS SAM 生成的解析器函數代碼並將字段另存為變量

以下是我們範例的GraphQL結構描述：

schema {
  query: Query
  mutation: Mutation
}

type Query {
  getPost(id: ID!): Post
}

type Mutation {
  addPost(author: String!, title: String!, content: String!): Post!
}

type Post {
  id: ID!
  author: String
  title: String
  content: String
}

這是我們的 AWS SAM 模板的一個片段：

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLApi:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      ...
      Functions:
        preprocessPostItem:
          ...
        createPostItem:
          ...
      Resolvers:
        Mutation:
          addPost:
            Runtime:
              Name: APPSYNC_JS
              Version: 1.0.0
            Pipeline:
            - preprocessPostItem
            - createPostItem

在我們的 AWS SAM 範本中，我們不指定CodeUri或InlineCode。在部署時， AWS SAM 自動為我們的解析器生成以下內聯代碼：

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

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

此預設解析程式碼會將要求重新導向至第一個管線函式，並接收來自最後一個管線函式的回應。

在我們的第一個管道函數中，我們可以使用提供的args字段來解析請求對象並創建我們的變量。然後，我們可以在我們的函數中使用這些變量。下面是我們的preprocessPostItem功能的一個例子：

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

export function request(ctx) {
  const author = ctx.args.author;
  const title = ctx.args.title;
  const content = ctx.args.content;
  
  // Use variables to process data
  
}

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