建置完整堆疊的 React 應用程式

實作

• 建立 GraphQL API 和資料庫

  a.透過從應用程式的根目錄執行以下命令，將 GraphQL API 新增到您的應用程式：
  

  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

  複製

  b.在文字編輯器中開啟 GraphQL 結構描述：/amplify/backend/api/<api_name>/schema.graphql。

  使用以下結構描述更新檔案：
  

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

  Code snippet copied

  複製

  c.儲存檔案。
  

• 部署 API

  現在已經在本機對 API 進行了設定，是時候部署它了。為此，請執行 Amplify push 命令：
  

  amplify push --y

  Code snippet copied

  複製

  這會做三件事：

  1. 建立 AWS AppSync API
  2. 建立 DynamoDB 資料表
  3. 在 src/graphql 資料夾中建立可用於查詢 API 的本機 GraphQL 操作

  若要隨時檢視帳戶中的 GraphQL API，請執行下列命令，然後在左側導覽窗格中選取 GraphQL API：

  amplify console api
  
  > Choose GraphQL
  

  Code snippet copied

  複製

  若要查看您帳戶中的 Amplify 應用程式，請執行以下命令：
  

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

  Code snippet copied

  複製
• 編寫與 API 互動的前端程式碼

  現在後端已經部署完畢，讓我們編寫一些程式碼，以允許使用者建立、列出和刪除筆記。

  使用以下程式碼更新 src/App.js：

  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

  複製

  我們的應用程式具有三項主要功能：

  1. fetchNotes – 此函數使用 API ​​類將查詢傳送到 GraphQL API 並擷取筆記清單。
  2. createNote – 此函數還使用 API 類別，將變動傳送至 GraphQL API。主要區別在於，在此函數中，我們傳遞了 GraphQL 變動所需的變數，以便使用表單資料建立新的筆記。
  3. deleteNote - 與 createNote 一樣，此函數傳送 GraphQL 變動以及一些變數，但不是建立筆記，而是刪除筆記。
• 執行應用程式

  要測試該應用程式，執行 start 命令：
  

  npm start

  Code snippet copied

  複製