GraphQL과 Apollo 두번째 이야기 - REST API란?

 

 

카카오페이 | 마음 놓고 금융하다

 

 

GraphQL과 타입스크립트로 개발하는 웹 서비스:설계부터 개발·배포까지 따라 하며 완성하는 웹 풀

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

🗂 목차

✅ GraphQL과 Apollo 첫번째 이야기 - 개념 익히기
✅ GraphQL과 Apollo 두번째 이야기 - REST API란?
✅ GraphQL과 Apollo 세번째 이야기 - GraphQL의 정보 주고 받는 방식
✅ GraphQL과 Apollo 네번째 이야기 - Apollo란?
✅ GraphQL과 Apollo 다섯번째 이야기 - GraphQL을 간단하게 구현해 보아요 😀
✅ GraphQL과 Apollo 여섯번째 이야기 - GraphQL Module화에 대해 알아보아요 😀
✅ GraphQL과 Apollo 일곱번째 이야기 - GraphQL Data Type에 대해 알아보아요 😀
✅ GraphQL과 Apollo 여덟번째 이야기 - GraphQL Union과 Interface 그리고 인자와 인풋 타입에 대해 알아보아요 😀
✅ GraphQL과 Apollo 아홉번째 이야기 - Java + Spring Boot에서 GraphQL 사용해 보기 - 실습 환경 구성
✅ GraphQL과 Apollo 열번째 이야기 - Java + Spring Boot에서 GraphQL 사용해 보기 - 실습 해보기
✅ GraphQL과 Apollo 열 한번째 이야기 - TypeScript + Nest.js에서 GraphQL 사용해 보기 - 실습 환경 구성
✅ GraphQL과 Apollo 열 두번째 이야기 - TypeScript + Nest.js에서 GraphQL 사용해 보기 - 실습 환경 테스트
✅ GraphQL과 Apollo 열 세번째 이야기 - TypeScript + Nest에서 GraphQL 사용해 보기 - 실습 해보기
✅ GraphQL과 Apollo 열 네번째 이야기 - React와 Apollo Client
✅ GraphQL과 Apollo 열다섯번째 이야기 - React와 Apollo Client - Query와 Mutation 사용하여 웹 페이지 만들기
✅ GraphQL과 Apollo 열 여섯번째 이야기 - Kotlin + Spring Boot에서 GraphQL 사용해 보기 - 실습 환경 구성
✅ GraphQL과 Apollo 열 일곱번째 이야기 - Kotlin + Spring Boot에서 GraphQL 사용해 보기 - 실습 해보기

🤔 내가 만난 문제

⚠️ [Nest.js] TypeORM Table 관계가 맺어졌을 때, Seeding (feat. Migration)
⚠️ [Spring Boot 3.0] Could not resolve org.springframework.boot:spring-boot-gradle-plugin
⚠️ [Spring Boot 3] Spring Doc(Swagger) White Label Error

📋 부록

🔍 [Nest.js] 초기 환경 구성 (feat. TypeORM, QueryBuilder, GraphQL, Apollo)
🔍 [SOLID][Nest.js][Java + Spring] Interface를 활용한 결합도 분리 (Interface를 이용한 Dependency Injection - DI)

 

 

 

🚀 REST API

    🔽 REST API

        📦 개념

예전에 주니가 REST API에 대해 공부한 자료가 있는데, 이것도 참고해 보시면 좋을 거 같아요.

[도전 기술!] REST API

728x90

예전 글에서 좀 더 지식이 쌓인 주니가 다시 한번 REST API에 대해 정리해 보고자 해요.
위의 글을 작성할 때보다 지식이 꽤 많이 쌓였기 때문이에요.

REST API는 소프트웨어간 정보를 주고 받는 방식이에요.
이는 GraphQL이 나오기 전부터 사용하고 있었고, GraphQL이 REST API보다 좋고, 나쁨의 차이가 아니라 어떤 상황과 용도와 작업 특성에 따라 적합한 것을 사용하면 되는 거에요.

REST API에서 좋은 예제는 Client(클라이언트)와 Server(서버) 간의 정보를 주고 받는 걸 예시로 들 수 있어요.
우리가 웹 브라우저나 스마트폰을 사용하여 어떤 서비스를 이용할 때, 해당 클라이언트는 서버와의 데이터를 주고 받아야 합니다.

이 때, 클라이언트는 Request param 혹은 Request Body를 통해 서버에 데이터를 요청하게 돼요.
그럼 서버는 요청 받은 데이터에 대한 작업을 통한 뒤 응답(Response)로 데이터를 전달하게 될거에요.

이런 엄청난 요청과 응답을 클라이언트와 서버는 지속적으로 무수히 많이 반복하기 때문에 이런 형식을 만들어 놓았다면 더욱 편리하겠지요?

예를 들어 사람들이 우편을 주고 받을 때도 위와 같이 우편물 송장에 보내는 사람과 받는 사람의 정보를 입력할 수 있는 형식을 정해 놓고 사용 하잖아요? 

REST API의 형식은 URI 형식(어떤 정보를) X 요청 방식(어떻게 요청할 것인가?)로 이뤄져 있어요.

요청 형식	용 도
GET	서버로 부터 정보 받아오기
POST	서버에 정보 입력 및 저장하기
PUT/PATCH	서버에 저장된 정보 수정하기
DELETE	서버에 저장된 정보 삭제하기

간단하게 GET Method를 이용하여 서버 정보를 가져오는 것에 대해 알아볼게요.

GET localhost:3000/api/team

 

REST API 방식에서 위와 같이 클라이언트가 서버에 정보를 가져오고 싶을 때, URI(/api/team) 즉, 팀의 정보를 GET으로 요청하겠다로 하여 team 정보를 가져오겠다는 의미가 되는 거에요.

REST API는 URI와 Http Method를 이용하여 정보를 주고 받는 방식이에요.

 

 

 

 

 

 

    🔽 REST API 한계

        📦 GraphQL이 나온 배경

그렇다면 GraphQL은 왜 나왔고, REST API의 한계는 무엇일까요?

예를 들어 어떤 회사에 각 팀의 관리자와 사무실 호수 정보만 얻고 싶을 때, REST API를 사용하게 되면 클라이언트는 팀에 정보를 요청하게 될 거고, 서버는 그 정보에 해당 하는 정보를 모두 전달할 거에요.

즉, 알고 싶지 않는 정보까지 모두 전달한다는 한계가 있답니다. 이는 낭비되는 데이터의 양이 있다는 것이고, 이를 처리하기 위한 서버에 자원이 소모된다는 단점을 가지고 있는 거에요. 이런 문제를 Overfetching이라고 부르고 있어요.

또 하나의 한계가 있는데, 바로 특정 팀의 관리자와 팀원들 명단이 필요하다는 상황이에요.
즉, 내가 원하는 정보들이 여러 계층의 데이터에 걸쳐 있을 때가 있어요.

GET localhost:3000/api/team

반응형

 

http://localhost:3000/api/people

예를 들어 위와 같이 팀들의 정보를 받아오는 요청이 따로 있고, 해당 팀원의 정보를 받아오는 요청이 따로 있어야 해요.

물론 이 부분을 서버에서 데이터 베이스 조회 시 Join 등을 사용해서 한번에 가져올 수도 있지만 그렇게 구성이 되어 있지 않다면? 두 번의 요청을 보내 두 번의 응답을 받아야 한다는 한계가 발생해요.

위의 문제는 너무 방대한 정보를 전달한다는 것이 문제지만, 이번에는 너무 적은 정보가 전달된다는 문제 즉, Underfetching이 발생한다는 한계에 즉면하고 있어요.

GraphQL은 위와 같이 Overfetching과 Underfetching 문제를 해결하여 최소한의 요청으로 내가 원하는 정보만 딱 얻고 싶다!의 필요성에서 나오게 된 친구에요.

 

 

 

GraphQL과 타입스크립트로 개발하는 웹 서비스:설계부터 개발·배포까지 따라 하며 완성하는 웹 풀

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

 

🧐 참고 자료

해당 내용은 아래 강의를 공부하면서 정리한 내용임을 알려 드립니다.

[무료] 얄팍한 GraphQL과 Apollo - 인프런 | 강의

 

 

 

 

카카오페이 | 마음 놓고 금융하다