0Pricing
React Academy · Урок

RTK Query: конечные точки и автоматическое кэширование

Определяйте конечные точки запросов и мутаций с помощью createApi и поручайте RTK Query управление кэшем.

«RTK Query: конечные точки и автоматическое кэширование» — бесплатный урок React Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения React Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс React Academy содержит 4 уроков всего.

Добро пожаловать

В этом уроке Вы научитесь определять конечные точки запросов и мутаций с помощью createApi из RTK Query и позволите ему автоматически управлять кэшированием, состояниями загрузки и получением данных.

Что такое RTK Query

RTK Query — это встроенный в Redux Toolkit слой для получения и кэширования данных. Он избавляет от необходимости вручную управлять состояниями загрузки и ошибок, устраняет дублирование запросов и кэширует ответы по конечной точке и аргументу.

Создание API с помощью createApi

Вызовите createApi(), передав ему reducerPath, baseQuery и endpoints. В результате будут созданы хуки 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 и refetch. Данные кэшируются по аргументу: тот же хук с тем же аргументом мгновенно возвращает кэшированные данные.
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

Управляйте тем, как долго кэшированные данные хранятся в хранилище после размонтирования всех подписчиков. Значение по умолчанию — 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
});

Аргументы запроса и пропуск

Передайте undefined или используйте параметр `skip`, чтобы условно пропустить запрос. Это полезно, когда необходимые идентификаторы ещё недоступны.
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. Ответы автоматически кэшируются, а дублирование запросов устраняется.

Далее

Следующий урок: **Оптимистичные обновления и инвалидация кэша** — Вы научитесь мгновенно обновлять интерфейс при выполнении мутации и инвалидировать кэшированные данные с помощью тегов.

Часто задаваемые вопросы

Урок «RTK Query: конечные точки и автоматическое кэширование» бесплатный?

Да — полный текст урока «RTK Query: конечные точки и автоматическое кэширование» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс React Academy, подпишись на CoddyKit PRO. Курс React Academy содержит 4 уроков всего.

Чему я научусь в уроке «RTK Query: конечные точки и автоматическое кэширование»?

Определяйте конечные точки запросов и мутаций с помощью createApi и поручайте RTK Query управление кэшем. Ты практикуешь React Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать React Academy?

Предыдущий опыт не требуется. React Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «RTK Query: конечные точки и автоматическое кэширование»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке React Academy?

Да. Каждый урок React Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Части Redux Toolkit и createSlice
  2. Асинхронная логика с createAsyncThunk
  3. RTK Query: конечные точки и автоматическое кэширование
  4. Оптимистичные обновления и аннулирование кэша
← Назад к React Academy