[typescript] GraphQL-js에서의 스키마 기반 타입 시스템 구현

22 Dec 2023

typescript

GraphQL-js는 JavaScript용 GraphQL 서버 구현체로, 강력한 스키마 기반 타입 시스템을 제공합니다. 이 기능을 사용하면 GraphQL 서버에서 지원하는 데이터 모델 및 쿼리 유형을 명확하게 정의할 수 있습니다. 이 기사에서는 GraphQL-js에서의 스키마 기반 타입 시스템을 구현하는 방법에 대해 살펴보겠습니다.

스키마 정의하기

GraphQL-js에서 스키마를 정의하는 첫 번째 단계는 객체 타입을 정의하는 것입니다. 예를 들어, 사용자 데이터 모델에 대한 객체 타입을 정의하려면 다음과 같은 코드를 작성할 수 있습니다.

import { GraphQLObjectType, GraphQLString, GraphQLInt } from 'graphql';

const UserType = new GraphQLObjectType({
  name: 'User',
  fields: {
    id: { type: GraphQLInt },
    name: { type: GraphQLString },
    email: { type: GraphQLString }
  }
});

위의 코드에서 UserType은 GraphQL-js에서 사용할 수 있는 객체 타입을 정의합니다. 여기에는 사용자의 id, name, email과 같은 속성이 정의되어 있습니다.

스키마 조합하기

다음으로는 위에서 정의한 객체 타입을 기반으로 전체 스키마를 조합하는 것입니다. 이를 위해 GraphQLSchema 객체를 사용하여 스키마를 정의합니다.

import { GraphQLSchema } from 'graphql';

const schema = new GraphQLSchema({
  query: UserType
});

위의 코드에서는 UserType을 query로 사용하는 스키마를 정의했습니다. 이제 GraphQL 서버에서 이 스키마를 사용하여 쿼리를 처리할 수 있습니다.

리졸버 함수 작성하기

마지막으로, 각각의 필드에 대한 리졸버 함수를 작성해야 합니다. 이 함수들은 해당 필드에 대한 실제 데이터를 반환하는 역할을 합니다.

const resolvers = {
  Query: {
    user: (root, args, context, info) => {
      // 사용자 데이터를 반환하는 로직
    }
  }
};

위의 예제에서는 user 필드에 대한 리졸버 함수를 정의했습니다. 이 함수는 사용자 데이터를 반환하는 데 사용됩니다.

이제 위에서 정의한 스키마, 리졸버 함수, 및 데이터 모델을 결합하여 GraphQL-js에서의 스키마 기반 타입 시스템을 구현할 수 있습니다.

GraphQL-js의 스키마 기반 타입 시스템을 이용하면, 코드의 가독성과 유지보수성이 향상되며, API의 쿼리 유형이 명확해지므로 개발 과정이 더욱 효율적으로 진행됩니다.

이상으로 GraphQL-js에서의 스키마 기반 타입 시스템 구현에 대한 내용을 살펴보았습니다.

스키마 정의하기

스키마 조합하기

리졸버 함수 작성하기

참고 자료