Apollo Client pour la gestion de l'état GraphQL dans React

Apollo Client est une bibliothèque JavaScript populaire qui simplifie la gestion des données pour les API GraphQL. Il vous permet de gérer efficacement les données locales et distantes dans votre application React et fournit des fonctionnalités puissantes telles que la mise en cache, les mises à jour en temps réel, la pagination et le traitement par lots de requêtes. Avec Apollo Client, les développeurs peuvent interagir avec les serveurs GraphQL en utilisant des requêtes et des mutations de manière transparente et déclarative.

Apollo Client s'intègre bien à React et est couramment utilisé pour gérer l'état et effectuer des opérations telles que la récupération, la mise en cache et la mise à jour des données à partir d'un serveur GraphQL. Il réduit le besoin de bibliothèques de gestion d'état complexes comme Redux et offre une approche plus simple de la gestion des données liées aux composants de votre interface utilisateur.

1. Concepts de base du client Apollo

1. Fournisseur Apollo

Pour utiliser Apollo Client dans une application React, vous devez d'abord envelopper votre application avec le composant ApolloProvider. Ce composant rend l'instance Apollo Client disponible dans toute votre arborescence de composants via l'API Context de React.

Exemple?:

import React from 'react';
import ReactDOM from 'react-dom';
import { ApolloProvider, InMemoryCache } from '@apollo/client';
import App from './App';

// Initialize Apollo Client with a cache
const client = new ApolloClient({
  uri: 'https://your-graphql-endpoint.com/graphql',
  cache: new InMemoryCache(),
});

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

• ApolloProvider permet d'accéder à l'instance du client Apollo dans votre application.
• InMemoryCache est l'implémentation de cache par défaut utilisée par Apollo Client pour stocker les résultats des requêtes et optimiser les récupérations ultérieures.

2. Requêtes

Dans Apollo Client, les requêtes sont utilisées pour récupérer des données à partir d'un serveur GraphQL. Vous pouvez utiliser le hook useQuery pour récupérer des données dans vos composants React. Ce hook gère automatiquement le chargement, les états d'erreur et la mise en cache pour vous.

Exemple?:

import React from 'react';
import { useQuery, gql } from '@apollo/client';

// Define a query to fetch data from the GraphQL server
const GET_ITEMS = gql`
  query GetItems {
    items {
      id
      name
      description
    }
  }
`;

const ItemsList = () => {
  const { loading, error, data } = useQuery(GET_ITEMS);

  if (loading) return <p>Loading...</p>;
  if (error) return <p>Error: {error.message}</p>;

  return (
    <ul>
      {data.items.map(item => (
        <li key={item.id}>
          <h3>{item.name}</h3>
          <p>{item.description}</p>
        </li>
      ))}
    </ul>
  );
};

export default ItemsList;

• useQuery exécute la requête GET_ITEMS lorsque le composant est monté et fournit les états de chargement, d'erreur et de données.
• Apollo Client met automatiquement en cache la réponse et la réutilise lorsque la même requête est à nouveau exécutée.

3. Mutations

Les mutations sont utilisées pour modifier les données sur le serveur (par exemple, créer, mettre à jour ou supprimer des enregistrements). Vous pouvez utiliser le hook useMutation pour effectuer des mutations au sein de vos composants React.

Exemple?:

import React from 'react';
import ReactDOM from 'react-dom';
import { ApolloProvider, InMemoryCache } from '@apollo/client';
import App from './App';

// Initialize Apollo Client with a cache
const client = new ApolloClient({
  uri: 'https://your-graphql-endpoint.com/graphql',
  cache: new InMemoryCache(),
});

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

• useMutation est utilisé pour appeler la mutation ADD_ITEM.
• L'option variables transmet les données d'entrée à la mutation.
• Vous pouvez utiliser onCompleted pour gérer les données de réponse une fois la mutation réussie.

4. Mise en cache

Apollo Client utilise la mise en cache par défaut. Cette fonctionnalité permet d'éviter les requêtes réseau inutiles et d'améliorer les performances en stockant les résultats des requêtes précédentes dans un cache en mémoire.

Exemple?:

Lorsque vous effectuez une requête, Apollo Client vérifie automatiquement le cache pour voir si les données ont déjà été récupérées. Si les données existent, il les renvoie immédiatement. Sinon, il envoie une requête réseau.

import React from 'react';
import { useQuery, gql } from '@apollo/client';

// Define a query to fetch data from the GraphQL server
const GET_ITEMS = gql`
  query GetItems {
    items {
      id
      name
      description
    }
  }
`;

const ItemsList = () => {
  const { loading, error, data } = useQuery(GET_ITEMS);

  if (loading) return <p>Loading...</p>;
  if (error) return <p>Error: {error.message}</p>;

  return (
    <ul>
      {data.items.map(item => (
        <li key={item.id}>
          <h3>{item.name}</h3>
          <p>{item.description}</p>
        </li>
      ))}
    </ul>
  );
};

export default ItemsList;

• La première fois que vous appelez useQuery, Apollo Client récupère les données du réseau.
• La prochaine fois que la même requête est exécutée, Apollo Client sert les données du cache, améliorant ainsi les performances.

5. Pagination et récupération supplémentaire

Lorsqu'il s'agit de grands ensembles de données, la pagination est souvent nécessaire. Apollo Client fournit une fonction fetchMore pour charger des données supplémentaires en réponse aux actions de l'utilisateur comme faire défiler ou cliquer sur ? Charger plus ?.

Exemple?:

import React, { useState } from 'react';
import { useMutation, gql } from '@apollo/client';

// Define a mutation to add a new item
const ADD_ITEM = gql`
  mutation AddItem($name: String!, $description: "String!) {"
    addItem(name: $name, description: "$description) {"
      id
      name
      description
    }
  }
`;

const AddItemForm = () => {
  const [name, setName] = useState('');
  const [description, setDescription] = useState('');
  const [addItem, { loading, error }] = useMutation(ADD_ITEM);

  const handleSubmit = (e) => {
    e.preventDefault();
    addItem({
      variables: { name, description },
      onCompleted: (data) => {
        // Handle the data after the mutation is successful
        console.log('Item added:', data.addItem);
      },
    });
  };

  if (loading) return <p>Adding item...</p>;
  if (error) return <p>Error: {error.message}</p>;

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="text"
        placeholder="Name"
        value={name}
        onChange={(e) => setName(e.target.value)}
      />
      <input
        type="text"
        placeholder="Description"
        value={description}
        onChange={(e) => setDescription(e.target.value)}
      />
      <button type="submit">Add Item</button>
    </form>
  );
};

export default AddItemForm;

• fetchMore vous permet de charger plus de données lorsque cela est nécessaire, par exemple lorsque l'utilisateur atteint le bas d'une liste.

2. Avantages de l'utilisation du client Apollo pour la gestion de l'état GraphQL

1. Récupération efficace des données

Apollo Client simplifie la récupération de données avec GraphQL, garantissant que votre application récupère uniquement les données dont elle a besoin.

2. Mise en cache automatique

Grace à sa mise en cache intégrée, Apollo Client réduit le nombre de requêtes adressées au serveur et rend votre application plus réactive en diffusant les données du cache.

3. Données en temps réel

Apollo Client prend en charge les abonnements, qui vous permettent d'écouter les mises à jour des données en temps réel. Ceci est utile pour créer des applications en temps réel telles que des applications de chat ou des tableaux de bord en direct.

4. Récupération déclarative de données

Apollo Client vous permet de récupérer des données de manière déclarative à l'aide de requêtes GraphQL, ce qui rend vos composants React plus simples et plus faciles à raisonner.

5. Interface utilisateur optimiste

Apollo Client prend en charge les mises à jour optimistes de l'interface utilisateur, vous permettant de mettre à jour l'interface utilisateur avant que le serveur ne confirme le changement. Cela se traduit par une expérience utilisateur plus fluide.

3. Exemple d'application client Apollo complète

import React from 'react';
import ReactDOM from 'react-dom';
import { ApolloProvider, InMemoryCache } from '@apollo/client';
import App from './App';

// Initialize Apollo Client with a cache
const client = new ApolloClient({
  uri: 'https://your-graphql-endpoint.com/graphql',
  cache: new InMemoryCache(),
});

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

import React from 'react';
import { useQuery, gql } from '@apollo/client';

// Define a query to fetch data from the GraphQL server
const GET_ITEMS = gql`
  query GetItems {
    items {
      id
      name
      description
    }
  }
`;

const ItemsList = () => {
  const { loading, error, data } = useQuery(GET_ITEMS);

  if (loading) return <p>Loading...</p>;
  if (error) return <p>Error: {error.message}</p>;

  return (
    <ul>
      {data.items.map(item => (
        <li key={item.id}>
          <h3>{item.name}</h3>
          <p>{item.description}</p>
        </li>
      ))}
    </ul>
  );
};

export default ItemsList;

4. Conclusion

Apollo Client est un outil puissant pour gérer les données GraphQL dans les applications React. Il fournit une prise en charge intégrée pour l'interrogation et la mutation des données, la mise en cache, la pagination et les mises à jour des données en temps réel. En utilisant Apollo Client, vous pouvez rationaliser vos processus de gestion de données, améliorer les performances et vous concentrer sur la création de votre application plut?t que sur la gestion de systèmes de gestion d'état complexes.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!