GraphQL: HTTP 기반 REST의 대안
GraphQL API가 어떻게 추가 기능을 제공하고 개발 시간을 단축할 수 있는지 알아보세요.
애플리케이션 구축 및 배포를 위한 많은 오픈 소스 아키텍처 표준이 존재합니다. REST(Representational State Transfer), SOAP(Simple Object Access Protocol), RPC(Remote Procedural Call) 및 GraphQL API가 가장 많이 사용됩니다.
RESTful API는 가장 많이 사용되는 API 아키텍처 표준입니다. 많은 엔드포인트가 포함된 복잡한 RESTful API를 작성했다면 API가 얼마나 복잡할 수 있는지 깨달았을 것입니다. 이는 끝점 간에 약간의 차이만 있는 경우 특히 그렇습니다.
RESTful API는 특정 데이터를 선택할 만큼 유연하지 않기 때문에 데이터 가져오기에 문제가 발생할 수도 있습니다. GraphQL은 RESTful API의 이러한 문제를 해결합니다.
GraphQL이란 무엇입니까?
GraphQL(Graph Query Language)은 API 구축을 위한 쿼리 언어이자 런타임입니다. 데이터 소비를 위한 많은 엔드포인트가 있는 REST API와 달리 GraphQL API에는 하나의 진입점이 있습니다. 쿼리에 설명하여 특정 데이터를 가져올 수 있습니다.
GraphQL 사양은 쿼리 언어와 GraphQL 서버 작동 방식을 정의합니다. Python에서 Javascript까지, 그리고 HTTP를 지원하는 모든 언어로 GraphQL API를 구축하고 사용할 수 있습니다.
Meta는 HTTP 기반 구축을 위한 REST의 대안으로 2012년에 GraphQL을 구축했습니다. 이들은 2015년에 GraphQL을 오픈 소스 표준으로 출시했습니다. 현재 GraphQL 재단은 GraphQL 사양 개발을 감독합니다.
GraphQL은 도입률이 낮은 상당히 새로운 기능이며 사용 시 숨겨진 비용이 있습니다. GraphQL API 구축은 불필요하게 복잡할 수 있으며, 특히 엔드포인트가 몇 개 있는 소규모 프로젝트의 경우 더욱 그렇습니다.
또한 모든 GraphQL 요청은 요청 상태에 관계없이 결국 상태 코드 200을 반환합니다.
GraphQL은 어떻게 작동하나요?
리소스 지향적인 REST와 달리 GraphQL에서는 데이터와 상호 작용하기 위해 데이터를 그래프로 생각해야 합니다. 데이터 구조를 지정할 수 있으며 사양은 HTTP를 통해 API와 상호 작용하기 위한 강력한 쿼리 인터페이스를 제공합니다. 사용하려는 GraphQL 패키지나 라이브러리에 따라 다양한 기능을 사용할 수 있습니다.
GraphQL 스키마에는 요청 가능한 객체와 사용 가능한 필드를 정의하는 객체 유형이 포함되어 있습니다. API 쿼리 및 변형에서 GraphQL 패키지는 쿼리의 유효성을 검사하고 지정된 처리기 함수(해석기)를 기반으로 쿼리를 실행합니다.
GraphQL을 사용해야 하는 이유는 무엇입니까?
REST는 사용하기 쉬운 표준이며 대부분의 프로그래밍 언어에는 RESTful API를 빠르게 구축하기 위한 도구가 있습니다. 그러나 RESTful API를 구축하고 사용하는 데는 많은 문제가 있습니다.
다음은 개발자가 일부 사용 사례에서 GraphQL을 선호하게 만드는 REST 관련 문제 중 일부입니다.
비효율적인 데이터 가져오기
RESTful API는 엔드포인트 사양에 따라 데이터를 중계합니다. 엔드포인트의 핸들러 기능에 하드 코딩된 것 이상의 데이터를 검색할 만큼 유연하지 않습니다.
엔드포인트가 호출 시 데이터 목록을 반환하고 필드에 대한 값이나 기준을 지정해야 한다고 가정합니다. 이 경우 개발자는 끝점을 만들고 데이터를 반환하는 비즈니스 논리를 정의해야 합니다. 귀중한 리소스를 수동으로 구문 분석할 수 있으며, 이는 결국 더 많은 시간이 소요됩니다.
GraphQL은 API를 쿼리하여 기준과 사양에 따라 유연하게 데이터를 반환할 수 있으므로 비효율적인 데이터 가져오기 문제를 해결합니다.
GraphQL API는 대화형입니다. 쉽고 읽기 쉬운 구문으로 검색해야 하는 데이터를 지정할 수 있습니다.
{
user(where: {age: {_eq: "89"}}) {
name
school(where: {alive: {_eq: true}}) {
bio
nationality
}
}
}
위의 GraphQL 쿼리는 age 필드가 89인 항목에 대해 user 스키마를 쿼리합니다. 쿼리에는 alive 필드가 있는 항목에 대한 쿼리가 내장되어 있습니다. 참으로 평가됩니다. 스키마에서 이름, 약력, 국적 필드를 반환합니다.
신속한 개발
특히 프로젝트 규모가 커질수록 REST를 사용하는 것보다 GraphQL API를 구축하고 사용하는 것이 더 쉽습니다. 개발 단계에서는 RESTful API를 개발할 때처럼 많은 경로와 핸들러 기능을 개발할 필요가 없습니다. GraphQL API를 사용하는 것은 RESTful API만큼 지루하지 않습니다.
REST에서는 단일 엔드포인트가 있는 GraphQL과 달리 다양한 엔드포인트가 다양한 리소스에 대한 액세스를 제공합니다. 이를 통해 유연성과 성능이 향상되며 쿼리는 다양한 확인 기능을 호출할 수 있습니다.
GraphQL 스키마 정의 언어
GraphQL SDL(스키마 정의 언어)은 GraphQL 서비스에 대한 스키마를 지정합니다.
GraphQL SDL 구문은 읽고 이해하기 쉽습니다. .graphql 또는 .graphqls 확장자를 가진 파일에 스키마 구조를 지정합니다.
type Human {
name: String!
age: Int!
}
input AddHuman {
name: String!
age: Int!
}
type Mutation {
CreateHuman(input: AddHuman!): Human!
DeleteHuman(id: Int!): String!
UpdateHuman(id: Int!): String!
}
type Query {
GetHuman(id: Int!): Human!
GetHumans: [Human!]!
}
위의 GraphQL 코드는 요청에 대한 API 구조를 정의하는 GraphQL API의 스키마입니다. 스키마는 API에 대한 CRUD 기능을 정의합니다.
클라이언트 측에서는 스키마의 구조와 클라이언트의 데이터 또는 작업을 기반으로 클라이언트가 쿼리(REST에서 GET 또는 DELETE) 또는 변형(PUT 또는 DELETE)을 실행할 수 있습니다. 우편).
다음은 Human 스키마를 쿼리하는 예입니다.
query Human {
name
age
}
위의 쿼리는 인간 스키마의 name 및 age 필드 데이터를 반환합니다.
GraphQL 돌연변이는 쿼리와 달리 구문이 상당히 다릅니다. 다음은 Human 스키마에 대한 변형 작업의 예입니다.
mutation {
CreateHuman(input:{ name:"man", age:1000000000000000,}) {
name
age
}
}
변이 코드는 클라이언트에 name 및 age 필드를 입력하고 해당 필드의 데이터를 반환합니다.
GraphQL API를 구축할 때 지속성을 위한 데이터 저장소가 필요합니다. REST 및 대부분의 HTTP 기반 웹 아키텍처와 마찬가지로 GraphQL은 상태 비저장이며 앱에 모든 데이터 저장소나 데이터베이스를 사용할 수 있습니다.
GraphQL API 구축
GraphQL은 사양이므로 가장 널리 사용되는 서버 측 언어로 GraphQL을 구축할 수 있습니다. 프로젝트에 필요한 기능을 갖춘 라이브러리를 찾아야 합니다.
GraphQL 라이브러리를 선택할 때 모든 GraphQL 유형과 작업을 지원하는 기능이 풍부한 라이브러리를 사용하려고 합니다. 대부분의 라이브러리는 스키마 우선 또는 코드 우선 접근 방식을 취합니다. 전자에서는 GraphQL 스키마를 정의하고 라이브러리가 해석기 및 상용구 코드를 생성합니다. 후자의 경우 스키마를 정의하지 않고 해석기를 하드 코딩합니다.
GraphQL이 채택되고 있습니다
GraphQL이 출시된 이후 개발자와 기업은 GraphQL 사용을 단순화하는 도구를 출시했습니다. 이를 통해 중소 규모 프로젝트의 개발 시간을 단축할 수 있습니다.
자세한 내용은 오픈 소스 GraphQL 클라이언트, GraphQL 문서 및 해당 사양을 확인하세요.


