Post

react-query

react-query

React Query는 React 애플리케이션에서 서버 상태 관리를 쉽게 해주는 인기 있는 라이브러리입니다. 데이터 페칭, 캐싱, 동기화, 서버 상태 업데이트 등을 단순화하여 강력하고 유연한 도구를 제공합니다.

React Query의 주요 기능과 장점은 다음과 같습니다.

데이터 페칭

선언적 API를 사용하여 데이터 페칭을 단순화합니다.
백그라운드 데이터 페칭과 동기화를 자동으로 관리합니다.

캐싱

서버 응답을 캐싱하여 효율적으로 재사용하고 오프라인 지원을 제공합니다.
캐시 무효화와 가비지 컬렉션을 설정할 수 있습니다.

자동 리페칭

데이터가 변경되었을 때 자동으로 재요청하여 최신 상태를 유지합니다.
의존성이나 특정 조건에 따라 데이터를 자동으로 갱신합니다.

병렬 및 의존성 데이터 요청

병렬로 여러 데이터를 요청할 수 있으며, 의존성을 가진 데이터 요청도 쉽게 처리할 수 있습니다.

훅(Hooks) 기반 API

React의 훅을 활용한 간단하고 직관적인 API를 제공합니다.
useQuery, useMutation 등과 같은 훅을 사용하여 쉽게 데이터를 관리할 수 있습니다.

데이터 업데이트

서버에 데이터를 업데이트하는 변이를 관리할 수 있습니다.
낙관적 업데이트(Optimistic Updates)를 지원하여 사용자 경험을 향상시킵니다.

React Query를 사용한 간단한 예시

필요한 패키지를 설치

1
npm install react-query axios

설정

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// src/index.js
import React from 'react';
import ReactDOM from 'react-dom';
import { QueryClient, QueryClientProvider } from 'react-query';
import App from './App';

const queryClient = new QueryClient();

ReactDOM.render(
  <QueryClientProvider client={queryClient}>
    <App />
  </QueryClientProvider>,
  document.getElementById('root')
);

데이터 페칭

다음은 사용자 데이터를 가져와서 화면에 표시하는 컴포넌트입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// src/App.js
import React from 'react';
import { useQuery } from 'react-query';
import axios from 'axios';

const fetchUserData = async () => {
  const { data } = await axios.get('https://jsonplaceholder.typicode.com/users');
  return data;
};

const App = () => {
  const { data, error, isLoading, isError } = useQuery('users', fetchUserData);

  if (isLoading) {
    return <div>로딩 중...</div>;
  }

  if (isError) {
    return <div>에러 발생: {error.message}</div>;
  }

  return (
    <div>
      <h1>사용자 목록</h1>
      <ul>
        {data.map(user => (
          <li key={user.id}>{user.name}</li>
        ))}
      </ul>
    </div>
  );
};

export default App;

주요 부분 설명

QueryClientProvider: React Query의 클라이언트를 제공하는 컨텍스트입니다. 이를 사용하여 애플리케이션 전역에서 React Query 기능을 사용할 수 있습니다.
useQuery: 데이터 페칭을 간단하게 처리하는 React Query 훅입니다. 첫 번째 인자로 쿼리 키를, 두 번째 인자로 데이터를 가져오는 함수를 받습니다.
fetchUserData: Axios를 사용하여 데이터를 가져오는 비동기 함수입니다.
isLoading, isError: 데이터 페칭 상태를 나타내는 값들입니다. 로딩 중이거나 에러가 발생했을 때 이를 처리할 수 있습니다.

This post is licensed under CC BY 4.0 by the author.