사용자 지정 리졸버 정의

새 사용자 지정 리졸버 만들기

App Services UI의 탐색 사이드바에서 GraphQL을 클릭한 다음 Custom Resolvers 탭을 선택합니다.

Add a Custom Resolver 버튼을 클릭하여 새 사용자 지정 리졸버에 대한 구성 화면을 엽니다.

리졸버 필드 이름 정의

GraphQL Field Name 입력란에 리졸버에 대한 App Servicese 이름을 지정합니다. App Servicese는 이 이름을 사용하여 상위 유형에 사용자 지정 리졸버를 노출하므로 이 이름은 GraphQL API로 작업하는 개발자에게 유용한 방식으로 리졸버가 수행하는 작업을 설명해야 합니다.

상위 유형 정의

App Servicese는 모든 사용자 지정 리졸버를 상위 유형의 필드로 노출합니다. 상위 유형은 루트 수준 쿼리 또는 변형되거나 생성된 문서 유형일 수 있습니다.

Parent Type 드롭다운에서 다음 옵션 중 하나를 선택합니다:

type Query {
  myCustomQuery: DefaultPayload
  ...
}

type Mutation {
  myCustomMutation: DefaultPayload
  ...
}

type Task {
  myCustomTaskProperty: DefaultPayload
  ...
}

입력 유형 정의

사용자 지정 리졸버는 수신 쿼리 또는 변형의 입력 매개 변수를 받아들일 수 있습니다. 기존에 생성된 입력 유형을 사용하거나 리졸버를 위해 특별히 새로운 사용자 지정 입력 유형을 정의할 수 있습니다.

입력 유형을 지정하는 경우 App Services는 사용자 지정 리졸버의 생성된 GraphQL 스키마 정의에서 input 매개 변수를 지정된 입력 유형을 허용하는 선택적 매개 변수로 노출합니다. 입력 유형을 지정하지 않으면 사용자 지정 리졸버가 어떤 인수도 허용하지 않습니다.

Input Type 드롭다운에서 다음 옵션 중 하나를 선택합니다:

옵션	설명
None	리졸버는 어떠한 입력도 받지 않습니다. 예제 입력을 허용하지 않는 myCustomQuery 사용자 지정 리졸버에는 다음과 같은 스키마가 생성됩니다: type Query { myCustomQuery: DefaultPayload ... }
Scalar	리졸버는 생성된 GraphQL 스키마의 기존 스칼라 유형을 사용합니다. 두 번째 드롭다운 입력에서 단일 스칼라 또는 동일한 유형의 다중 스칼라 배열을 선택합니다. 예제 Scalar Type 옵션을 사용하여 DateTiem 입력 유형을 지정하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같이 스키마가 생성됩니다: type Query { myCustomQuery(input: DateTime): DefaultPayload ... }
Existing Type	리졸버는 생성된 GraphQL 스키마의 기존 입력 유형을 사용합니다. 두 번째 드롭다운 입력에서 단일 입력 객체 또는 동일한 유형의 다중 입력 객체 배열을 선택합니다. 예제 Existing Type 옵션을 사용하여 TaskInsertInput 입력 유형을 지정하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같이 스키마가 생성됩니다: type Query { myCustomQuery(input: TaskInsertInput): DefaultPayload ... }
Custom Type	App Services는 사용자가 정의한 스키마를 기반으로 리졸버에 대한 새로운 입력 유형을 생성합니다. 스키마는 하나 이상의 속성과 생성된 입력 유형에 대한 고유 이름을 정의하는 title 필드를 포함하는 object여야 합니다. 예제 입력 유형이 MyCustomQueryInput인 Custom Type 옵션을 사용하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같은 스키마가 생성됩니다: input MyCustomQueryInput { someArgument: String; } type Query { myCustomQuery(input: MyCustomQueryInput): DefaultPayload ... }

페이로드 유형 정의

모든 GraphQL 리졸버는 스키마의 특정 유형을 준수하는 페이로드를 반환해야 합니다. 사용자 정의 리졸버의 경우, 기존에 생성된 문서 유형을 사용하거나, 리졸버를 위해 특별히 새로운 사용자 정의 페이로드 유형을 정의하거나, 기본 페이로드를 사용할 수 있습니다. App Services는 사용자 지정 리졸버에서 생성한 GraphQL 스키마 정의에 지정된 페이로드 유형을 포함합니다.

Payload Type 드롭다운에서 다음 옵션 중 하나를 선택합니다:

옵션	설명
DefaultPayload	리졸버는 다음 서명이 있는 자동으로 생성된 DefaultPayload 유형을 반환합니다. type DefaultPayload { status: String! } status 필드는 리졸버 함수의 반환 값에 관계없이 항상 "complete"(으)로 해결됩니다. { status: "complete" } 예제 DefaultPayload 옵션을 사용하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같은 스키마가 생성됩니다: type Query { myCustomQuery: DefaultPayload ... }
Scalar	리졸버는 생성된 GraphQL 스키마의 기존 스칼라 유형을 사용합니다. 두 번째 드롭다운 입력에서 단일 스칼라 또는 동일한 유형의 다중 스칼라 배열을 선택합니다. 예제 Scalar Type 옵션을 사용하여 DateTime의 페이로드 유형을 지정하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같이 스키마가 생성됩니다: type Query { myCustomQuery: DateTime ... }
Existing Type	리졸버는 생성된 GraphQL 스키마에서 기존 문서 유형을 반환합니다. 두 번째 드롭다운 입력에서 단일 문서 유형 또는 동일한 유형의 다중 문서 배열을 선택합니다. 예제 Existing Type 옵션을 사용하여 TaskInsertInput 입력 유형을 지정하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같이 스키마가 생성됩니다: Existing Type 옵션을 사용하여 [Task]의 페이로드 유형을 지정하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같이 스키마가 생성됩니다: type Query { myCustomQuery: [Task] ... }
Custom Type	App Services는 사용자가 정의한 스키마를 기반으로 리졸버를 위해 특별히 새로운 페이로드 유형을 생성합니다. 스키마는 하나 이상의 속성과 생성된 입력 유형에 대한 고유 이름을 정의하는 title 필드를 포함하는 object여야 합니다. 예제 Custom Type 옵션과 MyCustomQueryPayload라고 명명된 페이로드 유형을 사용하는 myCustomQuery 사용자 지정 리졸버에는 다음과 같은 스키마가 생성됩니다: input MyCustomQueryPayload { someValue: String; } type Query { myCustomQuery: MyCustomQueryPayload ... }

리졸버 함수 정의

사용자가 사용자 지정 리졸버를 호출하면 App Services는 리졸버 함수를 실행하고 결과를 반환합니다. 이는 리졸버의 Payload Type을 준수해야 합니다.

App Services는 해당하는 경우 작업의 모든 입력 데이터를 함수에 전달합니다. 리졸버가 문서 유형의 계산된 속성인 경우 App Services는 리졸버가 호출된 특정 문서를 함수에 전달합니다.

사용자 지정 리졸버 함수에는 입력을 허용하는지 여부에 따라 두 가지 중 하나의 서명이 포함됩니다:

리졸버 함수를 정의하려면 Function 드롭다운을 클릭하고 기존 함수를 선택하거나 새 함수를 생성합니다.

리졸버 저장 및 배포

리졸버를 구성한 후 Save를 클릭하고 애플리케이션을 배포합니다. 배포가 완료되면 GraphQL API를 통해 사용자 정의 리졸버를 호출할 수 있습니다.