GraphQL vs. REST API

웹 앱 개발 프로젝트를 작업한 적이 있습니까? 그렇다면 "GraphQL"이라는 용어를 들어본 적이 있을 것입니다. 하지만 이것이 정확히 무엇을 의미할까요? 서버 측 또는 클라이언트 측 구성에 사용되나요? 또한 GraphQL 통합이 다른 대안에 비해 더 나은 경우는 언제일까요? 이 기사에서는 이러한 질문을 안내합니다.

인터넷 상에서 소프트웨어 구성 요소 간의 데이터 전송을 위한 통신 채널로서, API는 현대 웹 서비스 아키텍처에서 산소와 같이 필수적인 역할을 합니다. SOAP(웹 서비스 메시징 프로토콜), REST(아키텍처 스타일), GraphQL(쿼리 언어 및 도구)과 같은 API 기술은 서로 다른 서비스 간의 통합 및 데이터 교환을 지원하여 소프트웨어 개발을 더욱 편리하고 유연하게 합니다.

수많은 유형의 API가 있음에도 불구하고, 최근 몇 년 동안 논쟁은 주로 두 가지 주요 패러다임, 즉 REST(표현 상태 전송)와 GraphQL에 집중되어 왔습니다. 두 가지 모두 여러 가지 장점을 제공하며 전 세계 웹 프로젝트에서 사용됩니다. 그러나 데이터 통신을 관리하는 방식에서 크게 다릅니다.

REST API란 무엇인가?#

REST는 21세기 초에 개발된 구조화된 아키텍처 스타일로, 클라이언트와 서버 간의 상태 비저장, 캐시 가능한 통신 프로토콜을 채택하도록 설계되었습니다. REST API(RESTful API라고도 함)는 REST 아키텍처의 동인 역할을 합니다.

REST API는 리소스를 주소 지정하기 위해 통일된 리소스 식별자(URIs)를 사용합니다. REST API는 네트워크 리소스에 대한 CRUD(생성, 읽기, 업데이트, 삭제) 작업을 수행하기 위해 다양한 엔드포인트를 사용합니다. 미디어 유형 또는 MIME 유형으로 알려진 사전 정의된 데이터 형식의 의존하며 클라이언트에게 제공되는 리소스의 형식과 크기를 결정합니다. 가장 일반적인 형식은 JSON과 XML(때로는 HTML이나 일반 텍스트)입니다.

클라이언트가 리소스를 요청한 후, 서버는 쿼리를 처리하고 해당 리소스와 관련된 모든 데이터를 반환합니다. 응답에는 "200 OK"(성공한 REST 요청) 및 "404 Not Found"(존재하지 않는 리소스)와 같은 HTTP 응답 코드가 포함됩니다.

REST API는 어떻게 작동합니까?#

REST API는 HTTP를 통해 리소스를 노출하는 사전 정의된 엔드포인트를 기반으로 작동합니다. 각 엔드포인트는 사용자가나 포스트와 같은 리소스를 나타내며, 고유한 URL로 식별됩니다. REST 작업은 표준 HTTP 메서드인 GET, POST, PUT, DELETE와 연계되어 데이터의 검색, 생성, 업데이트, 삭제에 해당합니다.

예를 들어, GET /users에 대한 요청은 사용자의 전체 목록을 가져오고, GET /users/123은 해당 ID로 식별된 특정 사용자의 세부 정보를 가져옵니다. 또한 사용자의 조직 및 조직 역할과 같은 관련 데이터에 접근하려면 GET /users/123/organizations에 추가 호출을 해야 합니다.

REST는 리소스 중심의 접근 방식을 따르며, 개별 리소스의 접근 및 조작에 중점을 둡니다.

GraphQL이란 무엇인가?#

GraphQL은 API 유형(또는 쿼리 언어)과 해당 쿼리에 응답하는 런타임 엔진입니다. 간소화된 API를 제공하며, 특히 복잡한 아키텍처를 구현해야 하거나 특정 데이터 하위 집합이 필요한 모바일 애플리케이션에 적합합니다.

GraphQL을 통해 개발자는 API에서 가져오고자 하는 데이터를 명시할 수 있습니다. 이를 통해 모든 것을 한 번에 가져오는 대신 요구하여 필요한 데이터를 선택적으로 가져올 수 있으며, 변경이 즉시 적용되고, 타사 데이터 소스를 애플리케이션에 통합할 수 있습니다.

애플리케이션은 GraphQL 쿼리를 사용하여 GraphQL 서비스를 호출할 수 있습니다. 이러한 쿼리는 클라이언트가 요청한 정확한 데이터 요소를 반환합니다. 이는 여러 API 호출, 네트워크 대역폭, 후처리를 절약하여 데이터 중심 API에 매우 효율적인 솔루션을 제공합니다. 이는 특히 태블릿과 모바일 기기와 같은 사용 소비자 근처에 위치한 데이터 중심 API에 유리합니다.

GraphQL은 어떻게 작동합니까?#

GraphQL은 쿼리 기반의 접근 방식을 취합니다. 사전 정의된 엔드포인트 대신, GraphQL은 구조화된 쿼리를 허용하는 단일 엔드포인트를 노출합니다. 클라이언트는 쿼리 언어를 사용하여 필요한 정확한 데이터를 지정합니다.

따라서 전체 GraphQL 구현에는 스키마와 리졸버라는 두 부분이 있어야 합니다.

GraphQL 스키마#

스키마는 GraphQL 쿼리를 통해 가져올 수 있는 데이터 유형과 해당 필드를 정의합니다:

예를 들어, 다음과 같은 스키마가 있다고 가정합시다:

클라이언트는 다음 쿼리를 사용하여 사용자의 이름, 이메일, 조직 및 역할을 쿼리할 수 있습니다:

이 쿼리는 요청된 필드(이메일, 조직)만 가져오고 한 번의 요청으로 관련 데이터(역할)도 검색합니다.

GraphQL 리졸버#

GraphQL 리졸버는 클라이언트가 GraphQL 쿼리에서 요청한 데이터를 검색하거나 계산하는 방법을 결정하는 GraphQL 서버의 중요한 구성 요소입니다. 클라이언트가 쿼리를 보내면 각 쿼리의 필드는 해당 필드를 위한 데이터 검색 또는 계산 로직이 있는 리졸버와 일치됩니다.

위의 예에서 스키마의 리졸버는 다음과 같을 것입니다:

리졸버에는 두 가지 유형이 있습니다: 루트 리졸버와 필드 리졸버.

• 루트 리졸버: 스키마의 최상위 필드를 처리하며, Query, Mutation, Subscription 등이 포함됩니다.
• 필드 리졸버: 일반적으로 중첩 쿼리를 위해 유형 내 개별 필드를 처리합니다. 특정 필드에 대해 리졸버가 제공되지 않으면 GraphQL은 기본 리졸버를 사용해 부모 객체의 일치하는 필드 이름에서 값을 반환합니다.

GraphQL 작업#

GraphQL은 세 가지 유형의 작업을 지원합니다: 쿼리, 변이, 구독.

• 쿼리: 데이터를 읽는 데 사용됩니다.
• 변이: 데이터를 작성하는 데 사용하며, 데이터 추가, 수정, 삭제 작업이 포함됩니다.
• 구독: 데이터를 위한 지속적 연결을 요청하는 데 사용되며, 클라이언트가 관심 있는 이벤트 유형과 반환되어야 하는 데이터를 선언할 수 있도록 합니다.

GraphQL과 REST API의 차이점#

GraphQL과 REST API는 서로 다른 웹 서비스 간의 데이터 교환 도구이지만, 문제 해결에 대한 접근 방식이 다르기 때문에 다음과 같은 주요 차이점이 있습니다:

데이터 가져오기#

REST API는 종종 고정된 응답을 반환하므로 데이터를 과도하게 가져오거나 불충분하게 가져옵니다. GraphQL은 클라이언트에게 정확히 필요한 데이터를 요청하도록 하여 불필요한 데이터 전송을 줄임으로써 이를 해결합니다. 이는 복잡한 데이터 요구 사항이 있는 모바일 또는 저대역폭 환경의 애플리케이션에 이상적입니다.

위의 예에서 사용자의 정적 데이터, 조직 및 사용자가 할당된 조직 역할을 가져와야 한다고 가정해보십시오. REST API를 사용하면, 모든 데이터를 얻기 위해 서로 다른 엔드포인트에 여러 요청을 해야 합니다. 그러나 GraphQL을 사용하면 한 번의 요청으로 모든 데이터를 가져올 수 있습니다.

유연성#

REST의 엔드포인트 기반 구조는 간단하며 표준 CRUD 작업이 있는 간단한 애플리케이션에 잘 작동합니다. 이는 REST API가 리소스 중심으로 설계되었기 때문이며 각 엔드포인트는 특정 리소스를 나타냅니다. 이 접근 방식의 주요 제한 사항은 클라이언트 요구 사항이 빠르게 변경될 때 빠른 반복 및 변경을 허용하지 않는다는 점입니다. 클라이언트에 변경이 가해질 때마다 서버는 새 엔드포인트를 추가하거나 기존 엔드포인트를 업데이트하여 새로운 요구 사항을 수용해야 합니다. 이는 종종 많은 중복 엔드포인트 및 복잡한 API 버전 관리로 이어집니다.

반면 GraphQL은 더 유연하여 클라이언트가 필요한 데이터만 요청할 수 있습니다. 이는 클라이언트 요구 사항이 자주 변경되는 경우 서버 측 API 구현을 수정할 필요가 없어 특히 유용합니다. 클라이언트는 서버의 변경 없이 새로운 필드나 중첩 데이터를 요청할 수 있습니다.

캐싱#

데이터 가져오기 측면에서 GraphQL은 효율적이고 유연하지만, 캐싱에서는 단점이 있기 때문에 주의해야 합니다.

REST API는 성숙한 생태계를 가지고 있습니다. 상태 비저장 및 표준화된 특성 때문에 서버 및 클라이언트 수준 모두에서 응답을 쉽게 캐시할 수 있습니다. 이는 서버에 대한 요청 수를 크게 줄이고 성능을 향상시킬 수 있습니다.

그러나 GraphQL의 유연성 때문에 REST API에서 이용 가능한 많은 캐싱 기술이 GraphQL에는 적용되지 않습니다. 특정 사용 사례에 기반하여 클라이언트 측에서 캐싱을 처리해야 하며, 이는 클라이언트 개발에 추가 작업을 부여합니다.

장단점#

결론#

최근 몇 년 동안 새롭게 부상한 GraphQL은 강한 모멘텀을 얻었지만, REST API는 여전히 오랜 시간 동안 원자적 디자인과 엄격함으로 중요한 위치를 차지하고 있습니다.

REST와 GraphQL은 서로 다른 요구를 충족시키고 다양한 시나리오에서 뛰어난 성능을 발휘합니다. REST의 단순함은 간단한 애플리케이션 및 마이크로서비스에 적합합니다. GraphQL은 특히 다양한 클라이언트가 있거나 데이터 간의 복잡한 관계가 있는 애플리케이션에서 유연하고 효율적인 데이터 검색이 필요한 시나리오에서 돋보입니다. 둘 중 어느 것을 선택할지는 프로젝트의 특정 요구 사항, 팀의 전문성, 장기적인 확장성 필요에 따라 달라집니다.