Spring Boot 에서 GraphQL 사용하기 (1)

🦥 1. Spring for GraphQL 개요 및 요구사항

Spring GraphQL은 Spring 애플리케이션에 Java용 GraphQL 을 제공한다. 

💡 Spring GraphQL 사용하기 위한 필요 조건

1. JDK 8

2. Spring Framework 5.3  / Spring Boot 2.7 이상

-- GraphQL Java 18과 Spring Data , 최신 QueryDSL 에서 사용 가능(?) 

🦥  2. 서버 전송

Spring GraphQL 은 HTTP, WebSocket, RSocket 상에서 GraphQL 을 다루는 것을 지원한다. 

2.1 HTTP

GraphQLHttpHandler 는 HTTP 요청을 GraphQL 로 다루고 Http 요청에 대한 수행을 위해 인터셉터에게 위임한다. 

GraphQL 요청은 반드시 HTTP POST 를 사용해야하고 HTTP에서 동작하는 GraphQL 이라는 목적을 정의하여 request body에 붙이고 JSON 을 포함해야한다. media type 의 가장 기본이고 선호되는 것은 application/graphql+json 이다. application/json 도 지원하지만 구체적으로 명시하는 application/graphql+json 을 쓰는게 좋다. 

 

🦥  3. GraphQLSource

GraphQLSource는 request를 수행하기 위해 사용하는 인스턴스인 graphql.Graphql 에 접근하기 위한 가장 핵심적인 추상 클래스이다.

Spring Boot Starter는 GraphQlSource 인스턴스를 기본 클래스인 GraphQlSource.Builder를 통해 초기화하고 아래와 같은 과정을 거친다. 

🦥  4. GraphQL Schema 파일의 위치

GraphQlSource.Builder 는 자원 인스턴스들과 함께 설정될 수 있다. 이것은 GraphQL 스키마 파일들이 어떤 위치에 있든지 로드될 수 있다는 뜻이다. 기본적으로 Spring Boot Starter는 classpath:graphql/**  즉 src/main/resources/graphql 하위에 위치해 있는 확장자 .graphqls 가 붙은 스키마 파일이나 .gqls 가 붙은 스키마 파일을 찾는다.