Todo 應用程式後端模板
iOS - 模式、API 與 AI 指南

主要心得

概述

Todo 應用程式是學習後端開發最常見的起點之一。它需要使用者註冊、任務 CRUD、基於所有權的存取控制，以及可選擇的即時同步。

下面的模式定義了兩個類別 - _User（內建）和 Todo，它們由一個 Pointer 連接。使用 Back4app iOS SDK，您可以從應用程式與此後端互動 - 查詢、建立、更新及刪除物件 - 而無需撰寫自訂 API 層。

为什么使用 Back4app 构建您的 iOS Todo 后端？

Back4app為您提供了一個就緒的後端和類型化的 SDK，因此您可以建立您的 Todo 應用程式，而無需自行撰寫 REST 程式或管理 auth。

• •SDK 與類型安全: SDK 保持 Todo 和 User 的類型安全，並處理 JSON，因此您可以少寫一些模板。
• •非同步與可選的離線: 使用 async/await；支援的 SDK 提供本機釘選功能，因此您的清單可以離線運作，並在重新連線時進行同步。
• •__品牌0__: 訂閱 Todo 變更，讓使用者介面透過 WebSockets 即時更新。

每個堆疊都有相同的模式和 API - 稍後可切換用戶端，而無需變更後端。

核心優勢

生產就緒的 Todo 後端，讓您可以更快速地出貨並專注於您的應用程式。

技術堆疊

此 Todo 應用程式範本的所有功能一目了然。

ER 圖

iOS Todo 應用程式資料模型的實體關係圖。

erDiagram
    _User {
        String objectId PK
        String username
        String email
        String password
        Date createdAt
        Date updatedAt
    }

    Todo {
        String objectId PK
        String title
        Boolean done
        Date dueDate
        Number priority
        Pointer owner FK
        Date createdAt
        Date updatedAt
    }

    _User ||--o{ Todo : "owns"

整合流程

Auth-to-CRUD 序列：您的 iOS 應用程式如何與 Back4app 對話 - 登入，然後查詢和建立待辦事項。

sequenceDiagram
  participant User
  participant App as iOS App
  participant Back4app as Back4app Cloud

  User->>App: Login
  App->>Back4app: ParseUser.logIn(username:password:)
  Back4app-->>App: Session token
  App-->>User: Logged in

  User->>App: Load todos
  App->>Back4app: ParseQuery.find()
  Back4app-->>App: [PFObject]
  App-->>User: Show list

  User->>App: Create todo
  App->>Back4app: todo.save()
  Back4app-->>App: Todo (objectId)
  App-->>User: Updated list

資料詞典

模式中每個類別的完整欄位參考。

安全性與權限

擁有權、ACL 及類別層級權限如何保護此模式中的資料。

模式 (JSON)

原始 JSON 方案定義 - 複製並在您的 Back4app 應用程式中使用，或透過 API 匯入。

{
  "classes": [
    {
      "className": "Todo",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "title": {
          "type": "String",
          "required": true
        },
        "done": {
          "type": "Boolean",
          "required": false,
          "defaultValue": false
        },
        "dueDate": {
          "type": "Date",
          "required": false
        },
        "priority": {
          "type": "Number",
          "required": false,
          "defaultValue": 3
        },
        "owner": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "_User",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "username": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "password": {
          "type": "String",
          "required": true
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    }
  ]
}

API 遊樂場

請嘗試 Todo 方案的 REST 和 GraphQL 端點。來自上述範例資料的回應 - 不需要 Back4app 帳戶。

使用與此模板相同的 Todo 模式。

分步式 iOS 整合

使用 Back4app iOS SDK 從 iOS 應用程式連接至您的 Back4app 後端。

1. 步驟 1: 安裝 Back4app iOS SDK

   為您的堆疊加入 Back4app SDK (例如 npm、pubspec 或套件管理員)。

   Swift

   複製

   1

   2

   3

   // Package.swift or CocoaPods
   // SPM: .package(url: "https://github.com/parse-community/Parse-Swift", from: "4.0.0")
   // Podfile: pod 'Parse'

2. 步驟 2：在應用程式中初始化 Back4app

   在應用程式啟動時，使用您的應用程式 ID 和伺服器 URL 來初始化 Back4app SDK。

   Swift

   複製

   1

   2

   3

   4

   5

   6

   7

   Parse.initialize(
       configuration: ParseClientConfiguration {
           $0.applicationId = "YOUR_APP_ID"
           $0.clientKey = "YOUR_CLIENT_KEY"
           $0.server = "https://parseapi.back4app.com/"
       }
   )

3. 步驟 3：查詢所有待辦事項

   使用 SDK 取得所有 Todo 物件，並依優先順序排序。

   Swift

   複製

   1

   2

   3

   4

   5

   func getTodos() async throws -> [PFObject] {
       let query = PFQuery(className: "Todo")
       query.order(byAscending: "priority")
       return try await query.findObjects()
   }

4. 步驟 4：建立待辦事項

   建立有標題、已完成和優先順序的新 Todo，然後儲存。

   Swift

   複製

   1

   2

   3

   4

   5

   6

   7

   func createTodo(title: String, priority: Int = 3) async throws {
       let todo = PFObject(className: "Todo")
       todo["title"] = title
       todo["done"] = false
       todo["priority"] = priority
       try await todo.save()
   }

5. 步驟 5：更新和刪除待辦事項

   更新欄位並儲存，或刪除物件。

   Swift

   複製

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   // Mark done
   func markDone(objectId: String) async throws {
       let query = PFQuery(className: "Todo")
       let todo = try await query.getObjectWithId(objectId)
       todo["done"] = true
       try await todo.save()
   }
   
   // Delete
   func deleteTodo(objectId: String) async throws {
       let query = PFQuery(className: "Todo")
       let todo = try await query.getObjectWithId(objectId)
       try await todo.delete()
   }

完整資料模型

複製完整的 Todo 模型進行類型安全序列化 (例如類別、介面或類型定義)。

// Todo.swift — matches Back4app schema
struct Todo: Codable {
    var objectId: String?
    var title: String
    var done: Bool
    var dueDate: Date?
    var priority: Int
    var owner: Pointer<_User>?
    var createdAt: Date?
    var updatedAt: Date?
}

func toTodo(_ obj: PFObject) -> Todo {
    Todo(
        objectId: obj.objectId,
        title: obj["title"] as? String ?? "",
        done: obj["done"] as? Bool ?? false,
        dueDate: obj["dueDate"] as? Date,
        priority: obj["priority"] as? Int ?? 3,
        owner: obj["owner"] as? Pointer<_User>,
        createdAt: obj.createdAt,
        updatedAt: obj.updatedAt
    )
}

常見問題

有關 Todo 應用程式後端模板的常見問題。