Reactive GraphQL 완주 가이드. 추천 읽기 순서와 전체 목차.
📚 심화 · 통신 · 7편
Reactive GraphQL
클라이언트가 필요한 필드만 정확히 요청하는 선언적 API 쿼리 언어 GraphQL을 Spring WebFlux·Reactor와 결합. 기본 스키마부터 Query·Mutation·Subscription·DataLoader·Federation·보안·테스트까지 7편으로 풀어쓴 심화 학습 자료입니다.
어떤 분이 읽으면 좋아요
이 시리즈는 REST API의 Over-fetching·Under-fetching 문제를 해결하고 싶은 백엔드 개발자, 또는 모바일·웹 클라이언트가 다양해 단일 엔드포인트로 유연한 응답이 필요한 분을 염두에 두고 썼어요. Spring Boot 3.x + Spring for GraphQL 스택을 사용하며, 리액티브 통합(Mono·Flux)이 포함되어 있어 WebFlux 기초가 있으면 더 수월합니다.
처음 들어오신 분은 1편(기본 개념·스키마)→ 6편(Spring for GraphQL)→ 2편(Query·Mutation·Variables) 순서로 첫 GraphQL API를 만들어보세요. 실시간 구독은 5편(Subscription), 리액티브 Mono·Flux 통합은 4편, N+1 문제 해결은 고급 7편(DataLoader)을 보시면 됩니다.
추천 읽기 순서
- GraphQL 입문 → 1편(기본 개념·Schema) → 6편(Spring for GraphQL) → 2편(Query·Mutation·Variables)
- 리액티브 통합 → 4편(Mono/Flux·WebFlux 통합) → 5편(Subscription·실시간 구독)
- 운영·보안·테스트 → 3편(Security·Testing)
- 고급 운영 → 7편(DataLoader·Federation·운영)
전체 목차
| 편 | 제목 | 핵심 |
|---|---|---|
| 1편 | 기본 개념·Schema | SDL·타입 시스템·Resolver·REST 비교 |
| 2편 | Query·Mutation·Variables | 쿼리 구조·변수·aliases·fragment |
| 3편 | Security·Testing | 인증·인가·깊이 제한·GraphQL Tester |
| 4편 | Mono/Flux·WebFlux 통합 | @QueryMapping·Mono·Flux·DataFetcher |
| 5편 | Subscription·실시간 구독 | Publisher·WebSocket 전송·SSE·Flux 스트림 |
| 6편 | Spring for GraphQL | @SchemaMapping·@Controller·런타임 와이어링 |
| 7편 | 고급 (DataLoader·Federation·운영) | N+1 해결·DataLoader·스키마 연합·운영 패턴 |
다음 단계
GraphQL로 유연한 API 쿼리를 익혔다면, 관측·메트릭 계층으로 넘어가거나 전체 심화 백엔드 로드맵을 확인해보세요. 전체 시리즈 로드맵은 series 페이지에서 확인하세요.
- Grafana 입문에서 운영까지 — 완주 가이드 (시각화·알림·SLO)
- Reactive Programming 마스터 — 완주 가이드 (Reactor 코어)
- Spring WebFlux — 완주 가이드 (논블로킹 HTTP)
- 전체 시리즈 로드맵