GraphQL에 대해서

GraphQL는 웹 애플리케이션에서 데이터를 관리하기 위한 쿼리 언어입니다.

RESTful API와 비교하면, GraphQL은 클라이언트가 필요한 데이터를 서버에서 정확하게 요청할 수 있는 새로운 방법을 제공합니다.

GraphQL은 간단한 구조를 가지고 있으며, 스키마를 사용하여 데이터 타입을 정의합니다. 이 스키마는 데이터 소스에서 어떤 유형의 데이터를 가져올 수 있는지 정의합니다. 그리고 클라이언트는 이러한 스키마를 사용하여 필요한 데이터를 요청하고 응답을 받습니다.

GraphQL은 RESTful API보다 유연하고 효율적인 데이터 요청 방법을 제공합니다. RESTful API는 클라이언트가 필요한 데이터를 모두 가져오거나, 다수의 요청을 보내야 하기 때문에 데이터를 가져오는 과정이 비효율적일 수 있습니다. 하지만 GraphQL은 클라이언트가 필요한 데이터만 요청할 수 있기 때문에 데이터를 더욱 효율적으로 가져올 수 있습니다.

GraphQL은 많은 기업에서 사용되고 있으며, Facebook에서 개발되었습니다. 많은 개발자들이 GraphQL을 사용하여 웹 애플리케이션을 개발하고 있습니다.

 

GraphQL의 가장 큰 장점 중 하나는 데이터 요청 및 응답을 완전히 커스터마이징할 수 있다는 것입니다. 클라이언트는 필요한 데이터만 요청할 수 있으며, 서버는 해당 요청에 대해 정확히 필요한 데이터만 반환할 수 있습니다. 이는 데이터 전송량을 최소화하고 응답 시간을 단축시켜줍니다.

GraphQL은 여러 데이터 소스에서 데이터를 가져오는 것도 가능합니다. 이는 RESTful API와 달리 클라이언트가 다수의 엔드포인트를 요청할 필요가 없으므로 애플리케이션의 복잡성을 줄여줍니다.

GraphQL은 문서화가 용이하다는 장점도 있습니다. 스키마 정의를 통해 데이터의 구조와 필드에 대한 정보를 쉽게 이해할 수 있습니다. 또한 GraphQL에서는 특정 쿼리에 대한 예상 결과를 직접 제공하는 툴도 제공되므로 개발자들이 API를 이해하고 사용하는 데 도움이 됩니다.

마지막으로 GraphQL은 다양한 프로그래밍 언어와 프레임워크에서 지원됩니다. 따라서 개발자들은 자신이 선호하는 도구와 언어를 사용하여 GraphQL을 적용할 수 있습니다.

 

GraphQL의 간단한 예시를 살펴보겠습니다.

예를 들어, 영화 정보를 관리하는 웹 애플리케이션을 개발하려고 한다고 가정해봅시다. GraphQL을 사용하여 클라이언트가 필요한 데이터를 요청하고 서버가 해당 데이터를 반환하도록 할 수 있습니다.

GraphQL에서는 스키마를 사용하여 데이터의 타입과 필드를 정의합니다. 우리가 만들고자 하는 웹 애플리케이션에서는 "Movie"라는 데이터 타입을 정의하고, 이 데이터 타입은 "title", "year", "director" 등의 필드를 가지고 있다고 가정해봅시다.

이렇게 정의된 스키마를 사용하여 클라이언트가 서버로 데이터를 요청할 수 있습니다. 예를 들어, 클라이언트가 "title" 필드만 필요하다면 다음과 같은 쿼리를 보낼 수 있습니다.

 

query {
  movie {
    title
  }
}

이러한 쿼리는 서버에서 해당 데이터만 반환하도록 요청합니다. 서버는 이 요청을 받아 해당 데이터를 찾아 클라이언트에게 반환합니다.

GraphQL은 이와 같이 필요한 데이터만 요청할 수 있도록 제공하는 것이 가장 큰 장점 중 하나입니다. 이를 통해 데이터 전송량을 최소화하고 응답 시간을 단축시킬 수 있습니다.

 

백엔드에서는 이렇게 정리해 볼 수 있습니다.

 

GraphQL의 백엔드에서는 스키마를 정의하고, 이를 기반으로 쿼리를 수행하여 데이터를 반환하는 함수를 구현해야 합니다. 이를 위해 보통은 GraphQL 서버를 구현하는 라이브러리나 프레임워크를 사용합니다.

예를 들어, Node.js에서 가장 많이 사용되는 GraphQL 서버 구현 라이브러리 중 하나인 Apollo Server를 사용하여 백엔드를 구현할 수 있습니다.

아래는 Apollo Server를 사용하여 스키마와 쿼리를 정의하고, 해당 데이터를 반환하는 간단한 예제 코드입니다.

 

const { ApolloServer, gql } = require('apollo-server');

// 스키마 정의
const typeDefs = gql`
  type Movie {
    title: String
    year: Int
    director: String
  }

  type Query {
    movie: Movie
  }
`;

// 데이터 정의
const movies = [
  { title: '영화1', year: 2021, director: '감독1' },
  { title: '영화2', year: 2022, director: '감독2' },
  { title: '영화3', year: 2023, director: '감독3' }
];

// 쿼리 수행 함수 정의
const resolvers = {
  Query: {
    movie: () => movies[0] // 첫 번째 영화 데이터 반환
  }
};

// Apollo Server 생성
const server = new ApolloServer({ typeDefs, resolvers });

// 서버 시작
server.listen().then(({ url }) => {
  console.log(`🚀  서버가 시작되었습니다! ${url}`);
});

위 코드에서는 스키마를 정의한 후, 영화 정보를 담은 데이터 배열을 정의합니다. 그리고 쿼리 수행 함수를 정의하여 해당 데이터를 반환하도록 합니다. 마지막으로 Apollo Server를 생성하고, listen 함수를 호출하여 서버를 시작합니다.

이렇게 구현된 GraphQL 서버는 클라이언트로부터 전달된 쿼리를 받아 해당 데이터를 찾아서 반환하게 됩니다.

 

RESP API에 비해서...

 

GraphQL은 REST API와 비교하여 다양한 이점이 있습니다.

첫째, 클라이언트는 필요한 데이터만 요청할 수 있어서 데이터 전송량을 최소화할 수 있습니다.

둘째, GraphQL 스키마를 통해 데이터 구조를 명확히 정의할 수 있어서 API의 변화에 대한 예측 가능성이 높아집니다.

셋째, 여러 개의 REST 엔드포인트를 요청하는 대신, GraphQL 스키마에 정의된 하나의 쿼리만으로도 여러 종류의 데이터를 요청할 수 있습니다.

 

또한 GraphQL은 클라이언트와 백엔드 간의 협업을 좀 더 쉽게 만들어줍니다.

클라이언트 개발자는 스키마를 통해 서버에서 제공하는 데이터의 구조와 내용을 이해할 수 있으며, 백엔드 개발자는 스키마를 통해 필요한 데이터를 정확하게 파악할 수 있습니다. 또한, 쿼리의 파라미터를 통해 필요한 데이터를 조작할 수 있으므로, 클라이언트 개발자와 백엔드 개발자는 이를 통해 데이터 요청에 대한 의사소통을 원활하게 할 수 있습니다.

 

마지막으로 GraphQL은 여러 프로그래밍 언어에서 지원되므로, 다양한 환경에서 사용할 수 있습니다. 이를 통해 서버와 클라이언트 간의 데이터 요청 및 응답이 언어에 구애받지 않게 되어 개발 생산성이 향상됩니다.

GraphQL은 최근에 많은 기업에서 사용되고 있으며, GraphQL 기술을 사용하여 다양한 서비스를 개발할 수 있습니다.

 

출처: https://www.mobilelive.ca/blog/graphql-vs-rest-what-you-didnt-know