GraphQL 구조

작동 원리

💡 Query를 이용해 원하는 데이터를 요청
💡 데이터를 수정하는 경우에는 Mutation을 이용
💡 구독(Subscription)이라는 개념을 제공하며 이를 이용해 실시간 업데이트를 구현
-Query 또는 Mutation과 달리, 발행/구독(pub/sub) 모델
-클라이언트는 서버와 WebSocket을 기반으로 지속적인 연결을 형성하고 유지

Query

📗 필드(field)
쿼리와 결과가 정확하게 같은 모양이어야 함

//query
{
  hero {
    name
    # 주석 작성하는 방법
    friends {
      name
    }
  }
}
//결과
{
  "data": {
    "hero": {
      "name": "R2-D2",
      "friends": [
        {
          "name": "Luke Skywalker"
        },
        {
          "name": "Han Solo"
        },
        {
          "name": "Leia Organa"
        }
      ]
    }
  }
}

✅ 원하는 필드를 중첩하여 쿼리하는 것도 가능

📗 전달인자(Arguments)

//query
{
  human(id: "1000") {
    name
    height
  }
}
//결과
{
  "data": {
    "human": {
      "name": "Luke Skywalker",
      "height": 1.72
    }
  }
}

✅ REST와 같은 시스템에서는 단일 인수 집합(요청의 쿼리 매개변수 및 URL 세그먼트)만 전달 가능

📗 별명(Aliases)

//틀린 query
{
  hero(episode: EMPIRE) {
    name
  }
  hero(episode: JEDI) {
    name
  }
}
//query
{
  empireHero: hero(episode: EMPIRE) {
    name
  }
  jediHero: hero(episode: JEDI) {
    name
  }
}
//결과
{
  "data": {
    "empireHero": {
      "name": "Luke Skywalker"
    },
    "jediHero": {
      "name": "R2-D2"
    }
  }
}

✅ 필드 이름을 중복해서 사용할 수 없음

📗 오퍼레이션 네임(Operation name)

//query
query HeroNameAndFriends {
  hero {
    name
    friends {
      name
    }
  }
}
//결과
{
  "data": {
    "hero": {
      "name": "R2-D2",
      "friends": [
        {
          "name": "Luke Skywalker"
        },
        {
          "name": "Han Solo"
        },
        {
          "name": "Leia Organa"
        }
      ]
    }
  }
}

✅ 오퍼레이션 타입에는 query, mutation, subscription, describes 등 존재
✅ 모호하게 표기하지 않도록

📗 변수(Variables)

query HeroNameAndFriends($episode: Episode) {
  hero(episode: $episode) {
    name
    friends {
      name
    }
  }
}

✅ $변수 이름: 타입 형태
✅ $episode: Episode! 는 episode는 반드시 Episode

mutation

mutation CreateReviewForEpisode($ep: Episode!, $review: ReviewInput!) {
  createReview(episode: $ep, review: $review) {
    stars
    commentary
  }
}

Schema/Type

type Character {
  name: String!
  appearsIn: [Episode!]!
}

✅ Character GraphQL 객체 타입(필드가 존재)
✅ name / appearIn Character 타입의 필드
✅ String 내장된 스칼라 타입(그외 ID, Int 등)
단일 스칼라 객체. 쿼리에서 하위 선택이 불가능
✅ ! 이 필드는 nullable하지 않고 반드시 값이 존재
✅ [ ]는 배열

Resolver

요청에 대한 응답을 결정해주는 함수

const db = require("./../db")
const resolvers = {
  Query: {
		getUser: async (_, { email, pw }) => {
			db.findOne({
				where: { email, pw }
			}) ... 
			...
		}
  },
  Mutation: {
		createUser: async (_, { email, pw, name }) => {
			...
		}
  }
  Subscription: { 
    newUser: async () => {
      ...
		}
  }
};