Qraph QL ์ด ํ•ด๊ฒฐํ•  ์ˆ˜ ์žˆ๋Š” ๋ฌธ์ œ

  • over-fetching : ์š”์ฒญํ•œ ๊ฒƒ๋ณด๋‹ค ๋งŽ์ด ๋ณด๋‚ด์คŒ. ex) username๋งŒ ํ•„์š”ํ•œ๋ฐ, ํ”„๋กœํ•„ ์‚ฌ์ง„๋„ ๋ณด๋ƒ„

  • under-fetching : ํ•˜๋‚˜์˜ ์ž‘์—…์„ ์œ„ํ•ด ์—ฌ๋Ÿฌ ์š”์ฒญ์„ ๋ณด๋‚ด๊ฒŒ ํ•˜๋Š” ๊ฒƒ.

  • QraphQL์—๋Š” URL์ด ์กด์žฌํ•˜์ง€ ์•Š์Œ.

    • ํ•˜๋‚˜์˜ ์—”๋“œํฌ์ธํŠธ๋งŒ ์žˆ๊ณ , ๊ทธ๊ณณ์œผ๋กœ ์ฟผ๋ฆฌ๋ฅผ ๋ณด๋‚ด๋ฉด, ์ฟผ๋ฆฌ์— ๋งž์ถฐ์„œ ์•Œ์•„์„œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ณด๋‚ด์ค€๋‹ค.
    • ์ฆ‰, ์ •ํ™•ํžˆ ์š”์ฒญํ•œ ๋ฐ์ดํ„ฐ๋งŒ ๋ณด๋‚ด์ค€๋‹ค.

์‹œ์ž‘

https://www.npmjs.com/package/graphql-yoga

  • yarn add graphql-yoga

    • ์‹œ์ž‘ํ• ๋•Œ, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์‹œ์ž‘์„ ํ•˜๋“ , ๋ฐ”๋ฒจ ์„ค์ •์„ ํ•ด์ค˜์•ผํ•œ๋‹ค.
  • ๊ธฐ๋ณธ ๊ตฌ์กฐ

    import { GraphQLServer } from "graphql-yoga";
     
    const server = new GraphQLServer({});
     
    server.start(() => console.log("graph Ql server running"));
    • ์œ„ ์ฝ”๋“œ๋Š” ์Šคํ‚ค๋งˆ๊ฐ€ ์ •์˜๋˜์–ด์žˆ์ง€ ์•Š๊ธฐ์— ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ•จ.

Scheme

  • ๋ฌด์—‡์„ ๋ฐ›๊ณ , ๋ฌด์—‡์„ ์ค„์ง€์— ๋Œ€ํ•œ ์„ค๋ช….
  • Query : ์ •๋ณด๋ฅผ ๋ฐ›์„ ๋•Œ ์‚ฌ์šฉ
  • Mutation : ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋“ฑ์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ”๊ฟ€๋•Œ ์‚ฌ์šฉ.

๊ตฌ์กฐ

// /graphql/resolvers.js
const resolvers = {
   Query: {
      name: () => "seongil",
   },
};
export default resolvers;
 
 
// /graphql/schema.graphql
type Query {
   name: String!
}
 
// index.js
...
import resolvers from "./graphql/resolvers";
 
const server = new GraphQLServer({
   typeDefs: "graphql/schema.graphql",
   resolvers: resolvers,
});
...

์œ„์™€ ๊ฐ™์ด resolver์™€, Query๋ฅผ ์„ ์–ธํ•ด์ฃผ๊ณ , index.js์—์„œ server์™€ ์—ฐ๋™์‹œ์ผœ์ฃผ๋ฉด ๋œ๋‹ค.

์œ„์™€ ๊ฐ™์ด ํ•  ๊ฒฝ์šฐ, ์•„๋ž˜์™€ ๊ฐ™์ด Query๋ฅผ ๋ณด๋‚ด๋ฉด

Query {
    name
}

์•„๋ž˜์™€ ๊ฐ™์ด ์˜ค๊ฒŒ ๋œ๋‹ค.

{
  "data": {
    "name": "seongil"
  }
}

๊ตฌ์กฐ : ์ข€ ๋” ์ž์„ธํžˆ

schema๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํ–ˆ๋‹ค.

type Query {
   name: String!
}

์ด ์˜๋ฏธ๋Š” name์— String ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š”๋ฐ, !๋ฅผ ์ฃผ์–ด required๋ผ๊ณ  ํ‘œ์‹œํ•˜๋Š” ๊ฒƒ์ด๋‹ค.

resolver๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ์–ด๋–ป๊ฒŒ ๋ณด๋‚ด์ค„ ๊ฒƒ์ธ์ง€ ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ๋กœ ์ž‘์„ฑํ•˜๋Š” ๊ฒƒ์ด๋‹ค.

๊ทธ๋Ÿผ ๊ฐ์ฒด๋ฅผ ๋ณด๋‚ด๊ณ  ์‹ถ์„๋•Œ๋Š” ์–ด๋–ป๊ฒŒ ํ• ๊นŒ

// /graphql/resolvers.js
const seongil = {
   name: "seongil",
   age: 24,
   gender: "male",
};
const resolvers = {
   Query: {
      name: () => seongil,
   },
};
export default resolvers;
 
 
// /graphql/schema.graphql
type Person {
   name: String!
   age: Int!
   gender: String!
}
 
type Query {
   person: Person!
}

์ด๋ ‡๊ฒŒ ํ•ด์ฃผ๋ฉด ๋œ๋‹ค.

์š”์ฒญ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ณด๋‚ธ๋‹ค. ๊ฐ์ฒด ์•ˆ์˜ ์š”์†Œ๋ฅผ ํ•˜๋‚˜ํ•˜๋‚˜ ์„ ํƒํ•˜์—ฌ ๋ฐ›์•„์˜ฌ ์ˆ˜ ์žˆ๋‹ค.

Query {
    person {
        name
        age
    }
}