概览

React Query 通常被描述为 React 缺少的数据获取(data-fetching)库，但是从更广泛的角度来看，它使 React 程序中的获取，缓存，同步和更新服务器状态变得轻而易举。

动机

大多数的 Web 框架(如 React)都没有内置的从组件中获取或更新数据的方式，因此开发人员最终会构建自己的获取数据的方式。 这通常意味着开发者总是倾向于使用 React Hooks 将基于组件的 state 和 effects 整合在一起，或者使用更通用的状态管理库来存储和提供整个程序中的异步数据。

尽管大多数传统状态管理库非常适合用于处理客户端状态，但是它们并不适合处理异步或服务器状态。 这是因为服务器状态完全不同：

• 远程保留在你无法控制或拥有的位置
• 需要异步 API 进行获取和更新
• 意味着共享所有权，可以在你不知情的情况下被其他人改变
• 如果不小心，数据可能会在应用中变得"过时"

一旦你掌握了应用中服务器状态的本质，你会遇到更多的挑战，例如:

• 缓存...（这可能是编程中最难的事情）
• 将对同一数据的多个请求的重复数据集合到单个请求中
• 在后台更新"过时"的数据
• 知道数据何时"过时"
• 尽可能快地反映数据更新
• 分页和延迟加载数据等性能优化
• 管理服务器状态的内存和 GC
• 结构化存储并共享查询结果

如果您没有被这个列表压垮，那么这一定意味着你可能已经解决了所有的服务器状态问题，值得获奖。 然而，如果你和大多数人一样，要么还没有解决所有这些挑战，要么还没有解决大部分挑战，那么我们只是触及了表面!

React Query 无疑是管理服务器状态的最佳库之一。它非常好用，开箱即用，无需配置，并且可以随着应用的增长而根据自己的喜好进行定制。

React Query 使你可以击败并征服那些棘手的服务器状态挑战和障碍，并在混杂的数据开始打乱你的应用之前对其进行控制。

从更专业的角度来说，React Query 可能会:

• 帮助您从应用中删除许多复杂和容易引起误解的代码行，用少量的 React Query 逻辑代替
• 使你的应用更易维护，更易构建新功能，而不必担心如何连接新的服务器状态数据源
• 通过维持应用的流畅 GUI 及更快的数据响应，直接影响最终用户
• 潜在地帮助你节省带宽和提高内存性能

直接上代码!

在下面的例子中，你可以看到 React Query 以其最基本和简单的形式被用来获取 GitHub 项目本身的 React Query 的统计信息:

Open in CodeSandbox

1import {2  QueryClient,3  QueryClientProvider,4  useQuery,5} from "@tanstack/react-query";6 7const queryClient = new QueryClient();8 9export default function App() {10  return (11    <QueryClientProvider client={queryClient}>12      <Example />13    </QueryClientProvider>14  );15}16 17function Example() {18  const { isLoading, error, data } = useQuery(["repoData"], () =>19    fetch("https://api.github.com/repos/tannerlinsley/react-query").then(20      (res) => res.json(),21    ),22  );23 24  if (isLoading) return "Loading...";25 26  if (error) return "An error has occurred: " + error.message;27 28  return (29    <div>30      <h1>{data.name}</h1>31      <p>{data.description}</p>32      <strong>👀 {data.subscribers_count}</strong>{" "}33      <strong>✨ {data.stargazers_count}</strong>{" "}34      <strong>🍴 {data.forks_count}</strong>35    </div>36  );37}

你说服了我，那现在怎么办？

• 考虑参加React Query Course课程（或为整个团队购买！）（英文）
• 立即开始阅读文档!