์„ค์น˜

yarn add @apollo/react-hooks apollo-boost graphql

์‚ฌ์šฉ๋ฒ•

  • GraphQL API๋กœ ์š”์ฒญ์„ ๋ณด๋‚ผ๋•Œ๋Š”, ์š”์ฒญ๋ฌธ์„ axios๋‚˜ fetch๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ POST ๋ฉ”์†Œ๋“œ๋กœ ๋ณด๋‚ด์•ผํ•จ.

  • ํ•˜์ง€๋งŒ Apollo๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด, ์œ„์™€๊ฐ™์ด ํ•˜์ง€ ์•Š์•„๋„ ๋œ๋‹ค.

    • ๋จผ์ €, Apollo client๋ฅผ ๋งŒ๋“ค์–ด์•ผํ•จ.

Apollo client ์…‹์—…

๋‹ค์Œ๊ณผ ๊ฐ™์ด, apollo.js ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜๊ณ , client๋ฅผ ๋งŒ๋“ค์–ด์ฃผ์ž. uri์—๋Š” graphQL ์„œ๋ฒ„์˜ ์ฃผ์†Œ๊ฐ€ ๋“ค์–ด๊ฐ€๋ฉด ๋œ๋‹ค.

// src/apollo.js
import ApolloClient from "apollo-boost";
 
const client = new ApolloClient({
  uri: "http://localhost:4000/",
});
 
export default client;

๊ทธ๋ฆฌ๊ณ  ๋‹ค์Œ๊ณผ ๊ฐ™์ด index.js์—์„œ ์—ฐ๊ฒฐํ•˜์ž

// src/index.js
...
import client from "./apollo";
import { ApolloProvider } from "@apollo/react-hooks";
 
ReactDOM.render(
   <ApolloProvider client={client}>
      <App />
   </ApolloProvider>,
   document.getElementById("root")
);

์ฟผ๋ฆฌ ์ž‘์„ฑ ๋ฐ ์‚ฌ์šฉ๋ฒ•

import { useQuery } from "@apollo/client";
import { gql } from "apollo-boost";

์•„๋ž˜์™€ ๊ฐ™์ด ์ฟผ๋ฆฌ๋ฌธ ์ž‘์„ฑ

const GET_MOVIES = gql`
  {
    movies {
      id
      medium_cover_image
    }
  }
`;

์•„๋ž˜์™€ ๊ฐ™์ด ์‚ฌ์šฉ. useQuery์— ์ฟผ๋ฆฌ๋ฌธ์„ ๋„ฃ๊ณ , loading, error, data๋ฅผ ์–ป์„ ์ˆ˜ ์žˆ๋‹ค.

const { loading, error, data } = useQuery(GET_MOVIES);
 
if (loading) {
  return "loading...";
} else if (data && data.movies) {
  return data.movies.map((m) => <h1>{m.id}</h1>);
}
  • paremeter๊ฐ€ ์žˆ๋Š” get

    ์•„๋ž˜์™€ ๊ฐ™์ด ์ฟผ๋ฆฌ๋ฌธ ์ž‘์„ฑ. paremeter๊ฐ€ ์—†์„ ๋•Œ๋Š” ๊ทธ๋ƒฅํ•ด๋„ ๋˜์ง€๋งŒ, ์žˆ์„ ๋•Œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด query getMovie($id:Int!) ๋ผ๋Š” ์ด๋ฆ„์œผ๋กœ ๋ถˆ๋Ÿฌ์ฃผ์ž.

    ์ด๋•Œ, ๊ผญ graphQL ์„œ๋ฒ„์— ์žˆ๋Š” ์ด๋ฆ„์œผ๋กœ ํ˜ธ์ถœํ•  ํ•„์š”๋Š” ์—†๋‹ค. ์ฆ‰, ๋‹ค์Œ์ฝ”๋“œ์—์„œ getMovie ๋Œ€์‹  get๋งŒ ์จ๋„ ๋œ๋‹ค๋Š” ๊ฒƒ์ด๋‹ค.

    ํƒ€์ž…๋งŒ ์ž˜ ์ ์–ด์ฃผ์ž.

    const GET_MOVIE = gql`
      query getMovie($id: Int!) {
        movie(id: $id) {
          id
          title
          medium_cover_image
          description_intro
        }
      }
    `;

    ํ˜ธ์ถœ : ๋‚˜๋จธ์ง€๋Š” ๋˜‘๊ฐ™๋˜, useQuery์˜ ๋‘๋ฒˆ์งธ ์ธ์ž์— ๊ฐ์ฒด๋ฅผ ๋„ฃ๊ณ , variable ํ•„๋“œ์— ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ๋„ฃ์–ด์ฃผ์ž

    const Detail = () => {
      const { id } = useParams();
      const { loading, data } = useQuery(GET_MOVIE, {
        variables: { id: parseInt(id) },
      });
     
      if (loading) {
        return "loading";
      }
      if (data && data.movie) {
        return data.movie.title;
      }
    };

Apollo Cache

  • react apollo๊ฐ€ ๋ญ”๊ฐ€๋ฅผ ์–ป์œผ๋ฉด ๊ทธ๊ฒƒ์„ ์ €์žฅํ•˜์—ฌ ๊ฐ™์€ ๋ฐ์ดํ„ฐ๋ฅผ ์š”์ฒญํ•˜๋ฉด, ๊ทธ๋Œ€๋กœ ์บ์‹œ์— ์žˆ๋Š” ๊ฒƒ์„ ๋ณด์—ฌ์ค€๋‹ค.

  • ๋ชจ๋“  ๊ฑธ apollo client์—์„œ ์ž๋™์œผ๋กœ ํ•ด์ค€๋‹ค.

Local State

  • Apollo cache์— ์žˆ๋Š” ๋ฐ์ดํ„ฐ๋ฅผ client ์—์„œ ๋ณ€๊ฒฝํ•˜์—ฌ ์‚ฌ์šฉํ•˜๊ธฐ

  • client์—์„œ ๋งŒ๋“  ๋ฐ์ดํ„ฐ ๊ฐ€์ ธ์˜ค๊ธฐ

    // src/routes/Home.js
    const GET_MOVIES = gql`
      {
        movies {
          id
          medium_cover_image
          isLiked @client
        }
      }
    `;
    • ์ด๋ ‡๊ฒŒ @client๋ฅผ ๋ถ™์—ฌ์ค˜์•ผ apollo๊ฐ€ ๋ฐฑ์—”๋“œ๋กœ ๋ณด๋‚ด์ง€ ์•Š๊ณ  client์˜ ๋ฐ์ดํ„ฐ์ž„์„ ์•ˆ๋‹ค.
  • ๋ฐ์ดํ„ฐ ๋„ฃ๊ธฐ

    • ์•„๋ž˜์™€ ๊ฐ™์ด, resolvers ์•ˆ์— ๋„ฃ๊ณ ์žํ•˜๋Š” ๋ฐ์ดํ„ฐ ํƒ€์ž…์— ๋„ฃ๊ณ ์žํ•˜๋Š” ํ•„๋“œ๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ๋œ๋‹ค.
     resolvers: {
          Movie: {
             isLiked: () => false, // ๋””ํดํŠธ๋กœ false ๊ฐ’ ์ง€๋‹ˆ๋„๋ก.
          },
       },
  • ๋ฐ์ดํ„ฐ ์ˆ˜์ •ํ•˜๊ธฐ

    • ์•„๋ž˜์™€ ๊ฐ™์ด, resolver ์•ˆ์— Mutation ์„ ์ถ”๊ฐ€ํ•˜๊ณ , ์ฟผ๋ฆฌ์—์„œ์™€ ๋˜‘๊ฐ™์ด ์ž‘์„ฑํ•˜๋ฉด ๋œ๋‹ค.
     resolvers: {
         ...
          Mutation: {
             likeMovie: (_, { id }, { cache }) => {
                cache.modify({
                   id: `Movie:${id}`,
                   fields: {
                      isLiked: (isLiked) => !isLiked,
                   },
                });
             },
          },
       },
    • ์ด๋•Œ, cache.modify๋ฅผ ํ†ตํ•ด ๋ณ€๊ฒฝํ•œ๋‹ค.
    • cache.modify
      • id : ์–ด๋А ๋ฐ์ดํ„ฐ๋ฅผ ๋ณ€๊ฒฝํ•  ๊ฒƒ์ธ์ง€ ๋ช…์‹œ. apollo dev tool๋กœ ํ˜•์‹์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.
        • ๋ณดํ†ต ๋ฐ์ดํ„ฐ ํƒ€์ž… + id ๋กœ ๊ตฌ์„ฑ
      • fields : ๋ณ€๊ฒฝํ•˜๊ณ ์žํ•˜๋Š” ํ•„๋“œ์™€ ๋ณ€๊ฒฝ ๋ฐฉ์‹์„ ์ •์˜ํ•œ๋‹ค.
  • ๋ฐ์ดํ„ฐ ๋ณ€๊ฒฝ ์š”์ฒญ

    • ์•„๋ž˜์™€ ๊ฐ™์ด @client๋งŒ ๋ถ™์ด๊ณ  ๋˜‘๊ฐ™์ด ํ•˜๋ฉด ๋œ๋‹ค.
    • useMutation์„ ์‚ฌ์šฉํ•œ๋‹ค.
    • ์ด hook์œผ๋กœ ๋งŒ๋“ค์–ด์ง„ ํ•จ์ˆ˜๋ฅผ ํ˜ธ์ถœํ•˜๋ฉด, ์š”์ฒญ์ด ๋‚ ์•„๊ฐ„๋‹ค.
    const LIKE_MOVIE = gql`
       mutation likeMovie($id: Int!) {
          likeMovie(id: $id) @client
       }
    `;
    ...
    const [likeMovie] = useMutation(LIKE_MOVIE, {
          variables: { id: parseInt(id) },
       });
    ...
    <button onClick={likeMovie}>{isLiked ? "Unlike" : "Like"}</button>