기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS AppSync JavaScript 해석기 컨텍스트 객체 참조

AWS AppSync 는 요청 및 응답 핸들러 작업을 위한 변수 및 함수 집합을 정의합니다. 이렇게 하면 GraphQL을 사용하는 데이터에 대한 논리적 조작이 더 쉬워집니다. 이 문서에서는 이러한 함수를 설명하고 예를 제공합니다.

context에 액세스

요청 및 응답 핸들러의 context 인수는 해석기 호출에 대한 모든 컨텍스트 정보를 포함하는 객체입니다. 이 변수의 구조는 다음과 같습니다.

type Context = {
  arguments: any;
  args: any;
  identity: Identity;
  source: any;
  error?: {
    message: string;
    type: string;
  };
  stash: any;
  result: any;
  prev: any;
  request: Request;
  info: Info;
};

context 객체의 각 필드는 다음과 같이 정의됩니다.

context 필드

자격 증명

identity 섹션에는 호출자에 대한 정보가 포함되어 있습니다. 이 섹션의 모양은 의 권한 부여 유형에 따라 달라집니다 AWS AppSync API.

AWS AppSync 보안 옵션에 대한 자세한 내용은 권한 부여 및 인증을 참조하세요.

각 필드는 다음과 같이 정의됩니다.

요청 헤더에 액세스

AWS AppSync 는 클라이언트에서 사용자 지정 헤더를 전달하고 를 사용하여 GraphQL 해석기에서 액세스하도록 지원합니다ctx.request.headers. 그런 다음 데이터 소스에 데이터 삽입 또는 권한 부여 검사 등과 같은 작업에 헤더 값을 사용할 수 있습니다. 다음 예제와 같이 명령줄의 API 키와 $curl 함께 를 사용하여 단일 또는 다중 요청 헤더를 사용할 수 있습니다.

단일 헤더의 예

다음과 같이 값이 nadia인 custom의 헤더를 설정한다고 가정해 보겠습니다.

curl -XPOST -H "Content-Type:application/graphql" -H "custom:nadia" -H "x-api-key:<API-KEY-VALUE>" -d '{"query":"mutation { createEvent(name: \"demo\", when: \"Next Friday!\", where: \"Here!\") {id name when where description}}"}' https://<ENDPOINT>/graphql

그러면 ctx.request.headers.custom을 사용하여 이 헤더에 액세스할 수 있습니다. 예를 들어, DynamoDB에 대한 다음 코드에 있을 수 있습니다.

"custom": util.dynamodb.toDynamoDB(ctx.request.headers.custom)

다중 헤더의 예

또한 단일 요청에서 여러 헤더를 전달하고 해석기 핸들러에서 이러한 헤더에 액세스할 수 있습니다. 예를 들어, custom 헤더가 다음 두 값으로 설정되어 있는 경우:

curl -XPOST -H "Content-Type:application/graphql" -H "custom:bailey" -H "custom:nadia" -H "x-api-key:<API-KEY-VALUE>" -d '{"query":"mutation { createEvent(name: \"demo\", when: \"Next Friday!\", where: \"Here!\") {id name when where description}}"}' https://<ENDPOINT>/graphql

이러한 두 값에는 배열(예: ctx.request.headers.custom[1])로 액세스할 수 있습니다.

사용자 지정 도메인 이름 요청 액세스

AWS AppSync 는 의 GraphQL 및 실시간 엔드포인트에 액세스하는 데 사용할 수 있는 사용자 지정 도메인 구성을 지원합니다APIs. 사용자 지정 도메인 이름으로 요청하는 경우 ctx.request.domainName을 사용하여 도메인 이름을 가져올 수 있습니다.

기본 GraphQL 엔드포인트 도메인 이름을 사용하는 경우 값은 null입니다.

정보

이 info 섹션에는 GraphQL 요청에 대한 정보가 포함되어 있습니다. 이 섹션은 다음과 같은 형식으로 되어 있습니다.

type Info = {
  fieldName: string;
  parentTypeName: string;
  variables: any;
  selectionSetList: string[];
  selectionSetGraphQL: string;
};

각 필드는 다음과 같이 정의됩니다.

예를 들어, 다음 쿼리의 getPost 필드를 해석하는 경우:

query {
  getPost(id: $postId) {
    postId
    title
    secondTitle: title
    content
    author(id: $authorId) {
      authorId
      name
    }
    secondAuthor(id: "789") {
      authorId
    }
    ... on Post {
      inlineFrag: comments: {
        id
      }
    }
    ... postFrag
  }
}

fragment postFrag on Post {
  postFrag: comments: {
    id
  }
}

핸들러를 처리할 때 사용할 수 있는 전체 ctx.info 변수는 다음과 같습니다.

{
  "fieldName": "getPost",
  "parentTypeName": "Query",
  "variables": {
    "postId": "123",
    "authorId": "456"
  },
  "selectionSetList": [
    "postId",
    "title",
    "secondTitle"
    "content",
    "author",
    "author/authorId",
    "author/name",
    "secondAuthor",
    "secondAuthor/authorId",
    "inlineFragComments",
    "inlineFragComments/id",
    "postFragComments",
    "postFragComments/id"
  ],
  "selectionSetGraphQL": "{\n  getPost(id: $postId) {\n    postId\n    title\n    secondTitle: title\n    content\n    author(id: $authorId) {\n      authorId\n      name\n    }\n    secondAuthor(id: \"789\") {\n      authorId\n    }\n    ... on Post {\n      inlineFrag: comments {\n        id\n      }\n    }\n    ... postFrag\n  }\n}"
}

selectionSetList는 현재 유형에 속하는 필드만 노출합니다. 현재 유형이 인터페이스 또는 집합인 경우 인터페이스에 속하는 선택된 필드만 노출됩니다. 예를 들어 다음과 같은 스키마가 있습니다.

type Query {
    node(id: ID!): Node
}

interface Node {
    id: ID
}

type Post implements Node {
    id: ID
    title: String
    author: String
}

type Blog implements Node {
    id: ID
    title: String
    category: String
}

그리고 다음과 같은 쿼리가 있습니다.

query {
    node(id: "post1") {
        id
        ... on Post {
            title
        }

        ... on Blog {
            title
        }
    }
}

Query.node 필드 해상도에서 ctx.info.selectionSetList를 호출하면 id만 노출됩니다.

"selectionSetList": [
    "id"
]