[typescript] GraphQL-js에서의 타입 동적 로딩 및 모듈화

22 Dec 2023

typescript

GraphQL은 강력한 타입 시스템을 제공하여 API를 설계하고 구축하는 데 매우 유용합니다. GraphQL-js는 JavaScript에서 GraphQL 서버를 구현하는 데 매우 인기 있는 도구 중 하나입니다. 타입을 동적으로 로딩하고 모듈화하는 기능은 GraphQL-js에서 매우 유용하며, 본문에서는 이에 대해 자세히 알아보겠습니다.

타입 동적 로딩

GraphQL-js에서 타입을 동적으로 로딩하는 것은 스키마를 런타임 시에 확장하고 유연하게 다룰 수 있는 기능을 제공합니다. 이를 위해 여러 가지 방법이 있지만, 가장 일반적인 방법은 GraphQLSchema의 type 메서드를 사용하여 동적으로 타입을 로딩하는 것입니다.

아래는 타입 동적 로딩의 간단한 예시입니다.

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

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

const schema = new GraphQLSchema({
  query: new GraphQLObjectType({
    name: 'Query',
    fields: {
      user: {
        type: UserType,
        resolve: () => {
          // Resolve user data
        },
      },
    },
  }),
});

위 예시에서 UserType이 정적으로 정의되어 있지만, 실제 상황에서는 타입이 동적으로 로딩될 수 있습니다. 이는 실제 데이터베이스와의 상호 작용 또는 외부 API에서 타입을 동적으로 가져올 때 유용합니다.

타입 모듈화

GraphQL-js에서 타입을 모듈화하면 코드를 구성 및 유지 관리하는 데 도움이 됩니다. 다양한 타입을 각각의 모듈로 분리하여 개별적으로 관리할 수 있으며, 그러한 모듈들을 필요에 맞게 조합하여 하나의 완전한 스키마를 만들 수 있습니다.

아래는 타입 모듈화의 간단한 예시입니다.

// UserType.js
import { GraphQLObjectType, GraphQLString } from 'graphql';

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

// QueryType.js
import { GraphQLObjectType, GraphQLNonNull, GraphQLID } from 'graphql';
import { UserType } from './UserType';

export const QueryType = new GraphQLObjectType({
  name: 'Query',
  fields: {
    user: {
      type: UserType,
      args: { id: { type: new GraphQLNonNull(GraphQLID) } },
      resolve: () => {
        // Resolve user data
      },
    },
  },
});

위 예시에서 UserType과 QueryType이 각각의 모듈로 분리되어 있습니다. 그리고 이러한 모듈들을 필요에 따라 조합하여 스키마를 만들 수 있습니다.

이렇듯 GraphQL-js에서는 타입을 동적으로 로딩하고 모듈화하여 스키마를 유연하게 다룰 수 있습니다. 이를 통해 코드의 가독성과 유지 보수성을 높이는데 도움이 됩니다.

위 내용은 GraphQL-js 공식 문서를 참고하여 작성되었습니다.