0Pricing
React Academy · 강의

RTK Query: 엔드포인트와 자동 캐싱

createApi로 쿼리 및 변형 엔드포인트를 정의하고 RTK Query가 캐싱을 관리하도록 합니다.

RTK Query: 엔드포인트와 자동 캐싱은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 수업에서는 RTK Query의 createApi로 쿼리 및 변이 엔드포인트를 정의하고, 캐싱과 로딩 상태 및 데이터 가져오기를 자동으로 관리하도록 합니다.

RTK Query란 무엇인가요

RTK Query는 Redux Toolkit에 내장된 데이터 가져오기 및 캐싱 계층입니다. 수동으로 로딩 및 오류 상태를 관리할 필요를 없애고, 요청의 중복을 제거하며, 엔드포인트와 인수별로 응답을 캐시합니다.

createApi로 API 만들기

reducerPath, baseQuery, endpoints와 함께 createApi()를 호출합니다. 결과에는 자동으로 생성된 React 훅이 포함됩니다.
import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react';

export const userApi = createApi({
  reducerPath: 'userApi',
  baseQuery: fetchBaseQuery({ baseUrl: '/api' }),
  endpoints: (builder) => ({
    getUser: builder.query({ query: (id) => '/users/' + id }),
    getUsers: builder.query({ query: () => '/users' }),
  }),
});

export const { useGetUserQuery, useGetUsersQuery } = userApi;

스토어에 API 추가하기

생성된 리듀서와 미들웨어를 configureStore에 추가합니다. 미들웨어가 캐시의 생명주기와 무효화 및 다시 가져오기를 처리합니다.
import { configureStore } from '@reduxjs/toolkit';
import { userApi } from './userApi';

export const store = configureStore({
  reducer: { [userApi.reducerPath]: userApi.reducer },
  middleware: (gDM) => gDM().concat(userApi.middleware),
});

쿼리 훅 사용하기

컴포넌트에서 생성된 훅을 호출합니다. 훅은 data, isLoading, isError, 다시 가져오기 기능을 반환합니다. 데이터는 인수별로 캐시되므로 동일한 인수로 동일한 훅을 호출하면 캐시된 데이터를 즉시 반환합니다.
function UserCard({ id }) {
  const { data, isLoading, isError } = useGetUserQuery(id);
  if (isLoading) return <Spinner />;
  if (isError) return <p>Error</p>;
  return <p>{data.name}</p>;
}

자동 중복 제거

두 컴포넌트가 동시에 마운트되어 useGetUsersQuery()를 호출하면 RTK Query는 네트워크 요청을 하나만 보내고 두 컴포넌트가 응답을 공유하도록 합니다.

keepUnusedDataFor를 사용한 캐시 TTL

모든 구독자의 마운트가 해제된 후 캐시된 데이터가 스토어에 얼마나 오래 남아 있을지 제어합니다. 기본값은 60초이며 엔드포인트별로 설정할 수 있습니다.
endpoints: (builder) => ({
  getUser: builder.query({
    query: id => '/users/' + id,
    keepUnusedDataFor: 300, // 5 minutes
  }),
})

실시간 데이터 폴링

훅 호출에 `pollingInterval`을 전달하면 N밀리초마다 자동으로 데이터를 다시 가져옵니다. 대시보드와 실시간 피드에 유용합니다.
const { data } = useGetStatsQuery(undefined, {
  pollingInterval: 5000, // refetch every 5 seconds
});

쿼리 인수와 건너뛰기

정의되지 않은 값을 전달하거나 `skip` 옵션을 사용해 조건에 따라 쿼리를 건너뜁니다. 필요한 ID를 아직 사용할 수 없을 때 유용합니다.
const { data } = useGetUserQuery(userId, { skip: !userId });

응답 변환

`transformResponse`를 사용해 API 응답을 캐시하기 전에 형태를 변경합니다. 이렇게 하면 컴포넌트가 원시 API 형식이 아니라 처리된 형태의 데이터를 받으므로 코드가 깔끔해집니다.
getUsers: builder.query({
  query: () => '/users',
  transformResponse: (raw) => raw.data.users,
})

빠른 확인

두 컴포넌트가 동시에 동일한 인수로 같은 RTK Query 훅을 호출하면 어떻게 되나요?

복습

createApi는 엔드포인트를 정의하고 타입이 지정된 훅을 생성합니다. 리듀서와 미들웨어를 스토어에 추가합니다. 쿼리 훅은 data, isLoading, isError를 반환합니다. 응답은 자동으로 캐시되고 중복이 제거됩니다.

다음 학습 내용

다음 수업: **낙관적 업데이트와 캐시 무효화** — 변이 시 UI를 즉시 업데이트하고 태그로 캐시된 데이터를 무효화합니다.

자주 묻는 질문

“RTK Query: 엔드포인트와 자동 캐싱” 강의는 무료인가요?

네 — “RTK Query: 엔드포인트와 자동 캐싱” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“RTK Query: 엔드포인트와 자동 캐싱”에서 뭘 배우나요?

createApi로 쿼리 및 변형 엔드포인트를 정의하고 RTK Query가 캐싱을 관리하도록 합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“RTK Query: 엔드포인트와 자동 캐싱” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Redux Toolkit 조각과 createSlice
  2. createAsyncThunk로 비동기 로직 다루기
  3. RTK Query: 엔드포인트와 자동 캐싱
  4. 낙관적 업데이트와 캐시 무효화
← React Academy(으)로 돌아가기