實作

• 建立 GraphQL API 和資料庫

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

  amplify add api
  
  ? Please select from one of the below mentioned services: GraphQL
  ? Provide API name: notesapp
  ? Choose the default authorization type for the API: API Key
  ? Enter a description for the API key: demo
  ? After how many days from now the API key should expire: 7 (or your preferred expiration)
  ? Do you want to configure advanced settings for the GraphQL API: No, I am done.
  ? Do you have an annotated GraphQL schema?  No
  ? Do you want a guided schema creation?  Yes
  ? What best describes your project: Single object with fields
  ? Do you want to edit the schema now? Yes

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

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

  type Note @model {
    id: ID!
    name: String!
    description: String
  }
  

  c.儲存檔案。然後返回命令列並按 Enter 鍵以完成 API 設定步驟。

• 部署 API

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

  amplify push --y

  這將完成 3 項操作：

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

  要查看您帳戶中的 GraphQL API，請執行以下命令：

  amplify console api
  
  > Choose GraphQL
  

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

  amplify console

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

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

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

  import React, { useState, useEffect } from 'react';
  import './App.css';
  import { API } from 'aws-amplify';
  import { withAuthenticator, AmplifySignOut } from '@aws-amplify/ui-react';
  import { listNotes } from './graphql/queries';
  import { createNote as createNoteMutation, deleteNote as deleteNoteMutation } from './graphql/mutations';
  
  const initialFormState = { name: '', description: '' }
  
  function App() {
    const [notes, setNotes] = useState([]);
    const [formData, setFormData] = useState(initialFormState);
  
    useEffect(() => {
      fetchNotes();
    }, []);
  
    async function fetchNotes() {
      const apiData = await API.graphql({ query: listNotes });
      setNotes(apiData.data.listNotes.items);
    }
  
    async function createNote() {
      if (!formData.name || !formData.description) return;
      await API.graphql({ query: createNoteMutation, variables: { input: formData } });
      setNotes([ ...notes, formData ]);
      setFormData(initialFormState);
    }
  
    async function deleteNote({ id }) {
      const newNotesArray = notes.filter(note => note.id !== id);
      setNotes(newNotesArray);
      await API.graphql({ query: deleteNoteMutation, variables: { input: { id } }});
    }
  
    return (
      <div className="App">
        <h1>My Notes App</h1>
        <input
          onChange={e => setFormData({ ...formData, 'name': e.target.value})}
          placeholder="Note name"
          value={formData.name}
        />
        <input
          onChange={e => setFormData({ ...formData, 'description': e.target.value})}
          placeholder="Note description"
          value={formData.description}
        />
        <button onClick={createNote}>Create Note</button>
        <div style={{marginBottom: 30}}>
          {
            notes.map(note => (
              <div key={note.id || note.name}>
                <h2>{note.name}</h2>
                <p>{note.description}</p>
                <button onClick={() => deleteNote(note)}>Delete note</button>
              </div>
            ))
          }
        </div>
        <AmplifySignOut />
      </div>
    );
  }
  
  export default withAuthenticator(App);
  

  我們的應用程式有 3 個主要函數：

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

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

  npm start