Créer une application React complète

Mise en œuvre

• Créer une API GraphQL et une base de données

  a. Ajoutez une API GraphQL à votre application en exécutant la commande suivante depuis la racine du répertoire de votre application :
  

  amplify add api
  
  ? Select from one of the below mentioned services: GraphQL
  ? Here is the GraphQL API that we will create. Select a setting to edit or continue: Continue
  ? Choose a schema template: Single object with fields (e.g., "Todo" with ID, name, description)
  ? Do you want to edit the schema now? (Y/n) yes

  Code snippet copied

  Copier

  b. Ouvrez le schéma GraphQL dans l'éditeur de texte : /amplify/backend/api/<api_name>/schema.graphql.

  Mettez le fichier à jour avec le schéma suivant :
  

  type Note @model @auth(rules: [ { allow: public } ] ){
    id: ID!
    name: String!
    description: String
  }

  Code snippet copied

  Copier

  c. Enregistrez le fichier.
  

• Déployer l'API

  À présent que l'API est configurée localement, il est nécessaire de la déployer. Pour ce faire, exécutez la commande push Amplify :
  

  amplify push --y

  Code snippet copied

  Copier

  Cela aura trois effets :

  1. Créer l'API AWS AppSync
  2. Créer une table DynamoDB
  3. Créer les opérations GraphQL locales dans un dossier situé sous src/graphql que vous pouvez utiliser pour interroger l'API

  Pour afficher l'API GraphQL dans votre compte à tout moment, exécutez la commande suivante, puis sélectionnez GraphQL API dans le volet de navigation de gauche :

  amplify console api
  
  > Choose GraphQL
  

  Code snippet copied

  Copier

  Pour afficher l'API Amplify dans votre compte à tout moment, exécutez la commande suivante :
  

  amplify console
  ? Which site do you want to open? AWS console

  Code snippet copied

  Copier
• Écrire du code frontend pour interagir avec l'API

  Maintenant que le backend est déployé, écrivons du code pour permettre aux utilisateurs de créer, répertorier et supprimer des notes.

  Mettez à jour src/App.js avec le code suivant :

  import React, { useState, useEffect } from "react";
  import "./App.css";
  import "@aws-amplify/ui-react/styles.css";
  import { API } from "aws-amplify";
  import {
    Button,
    Flex,
    Heading,
    Text,
    TextField,
    View,
    withAuthenticator,
  } from "@aws-amplify/ui-react";
  import { listNotes } from "./graphql/queries";
  import {
    createNote as createNoteMutation,
    deleteNote as deleteNoteMutation,
  } from "./graphql/mutations";
  
  const App = ({ signOut }) => {
    const [notes, setNotes] = useState([]);
  
    useEffect(() => {
      fetchNotes();
    }, []);
  
    async function fetchNotes() {
      const apiData = await API.graphql({ query: listNotes });
      const notesFromAPI = apiData.data.listNotes.items;
      setNotes(notesFromAPI);
    }
  
    async function createNote(event) {
      event.preventDefault();
      const form = new FormData(event.target);
      const data = {
        name: form.get("name"),
        description: form.get("description"),
      };
      await API.graphql({
        query: createNoteMutation,
        variables: { input: data },
      });
      fetchNotes();
      event.target.reset();
    }
  
    async function deleteNote({ id }) {
      const newNotes = notes.filter((note) => note.id !== id);
      setNotes(newNotes);
      await API.graphql({
        query: deleteNoteMutation,
        variables: { input: { id } },
      });
    }
  
    return (
      <View className="App">
        <Heading level={1}>My Notes App</Heading>
        <View as="form" margin="3rem 0" onSubmit={createNote}>
          <Flex direction="row" justifyContent="center">
            <TextField
              name="name"
              placeholder="Note Name"
              label="Note Name"
              labelHidden
              variation="quiet"
              required
            />
            <TextField
              name="description"
              placeholder="Note Description"
              label="Note Description"
              labelHidden
              variation="quiet"
              required
            />
            <Button type="submit" variation="primary">
              Create Note
            </Button>
          </Flex>
        </View>
        <Heading level={2}>Current Notes</Heading>
        <View margin="3rem 0">
          {notes.map((note) => (
            <Flex
              key={note.id || note.name}
              direction="row"
              justifyContent="center"
              alignItems="center"
            >
              <Text as="strong" fontWeight={700}>
                {note.name}
              </Text>
              <Text as="span">{note.description}</Text>
              <Button variation="link" onClick={() => deleteNote(note)}>
                Delete note
              </Button>
            </Flex>
          ))}
        </View>
        <Button onClick={signOut}>Sign Out</Button>
      </View>
    );
  };
  
  export default withAuthenticator(App);

  Code snippet copied

  Copier

  Notre application possède trois fonctions principales :

  1. fetchNotes : cette fonction utilise la classe d'API pour envoyer une requête à l'API GraphQL et récupérer une liste de notes.
  2. createNote : cette fonction utilise également la classe d'API pour envoyer une mutation à l'API GraphQL. La principale différence est que dans cette fonction, nous transmettons les variables nécessaires à une mutation GraphQL afin de créer une nouvelle note avec les données du formulaire.
  3. deleteNote : à l'instar de createNote, cette fonction envoie une mutation GraphQL ainsi que des variables, mais au lieu de créer une note, nous en supprimons une.
• Exécuter l'application

  Pour tester l'application, exécutez la commande Start :
  

  npm start

  Code snippet copied

  Copier