GraphQL에서 Node.js와 Express를 사용하여 REST API 연동하기

핵심 기술

이 문서는 Node.js와 Express 프레임워크, 그리고 express-graphql 라이브러리를 사용하여 GraphQL 서버를 구축하고, 내부적으로 axios 라이브러리를 통해 외부 REST API를 호출하여 데이터를 가져오는 방법을 안내합니다. 이는 기존 RESTful 서비스의 재사용성을 유지하면서 프론트엔드에 GraphQL의 유연성을 제공하는 실용적인 접근법입니다.

기술적 세부사항

• GraphQL 스키마 정의: buildSchema를 사용하여 GraphQL 타입(User) 및 쿼리(user(id: ID!))를 명확히 정의합니다.
• REST API 호출 resolver 구현: axios를 사용하여 비동기적으로 외부 REST API(https://jsonplaceholder.typicode.com/users/)를 호출하고, 반환된 JSON 데이터를 GraphQL 스키마에 맞게 가공하여 반환합니다.
• Express 서버 설정: express 애플리케이션을 생성하고, /graphql 경로에 graphqlHTTP 미들웨어를 마운트합니다. 이때 스키마, resolver(rootValue), 그리고 개발 편의를 위한 GraphiQL 인터페이스를 활성화합니다.
• 실행 및 테스트: node index.js 명령어로 서버를 시작하고, 제공된 URL(http://localhost:4000/graphql)에 접속하여 GraphQL 쿼리를 실행하여 REST API 데이터가 정상적으로 조회되는지 확인합니다.

개발 임팩트

• 기존 RESTful API 엔드포인트를 그대로 활용하여 백엔드 변경 없이 프론트엔드 경험을 개선할 수 있습니다.
• 클라이언트는 필요한 데이터만 정확하게 요청할 수 있어 네트워크 트래픽을 줄이고 애플리케이션 성능을 향상시킬 수 있습니다.
• 점진적인 현대화 전략을 구현하기에 용이하며, 레거시 시스템을 유지하면서 최신 기술을 도입하는 데 효과적입니다.

커뮤니티 반응

명시적인 커뮤니티 반응에 대한 언급은 없으나, REST API를 GraphQL로 감싸는 방식은 개발자 커뮤니티에서 매우 일반적이고 권장되는 패턴 중 하나입니다.