Шаблон бэкенда приложения Todo
iOS — Схема, API и руководство по AI

Ключевые выводы

Обзор

Todo приложение — это одна из самых распространенных отправных точек для изучения разработки бэкенда. Внутри оно требует регистрации пользователей, CRUD задач, контроля доступа на основе владения и, опционально, синхронизации в реальном времени.

Схема ниже определяет два класса — _User (встроенный) и Todo — соединенные указателем. С помощью Back4app iOS SDK вы можете взаимодействовать с этим бэкендом из вашего приложения — запрашивать, создавать, обновлять и удалять объекты — без написания пользовательского API слоя.

Почему стоит создать ваш iOS Todo бэкенд с Back4app?

Back4app предоставляет готовый бэкенд и типизированный SDK, чтобы вы могли создать ваше Todo приложение без написания REST glue или управления аутентификацией самостоятельно.

• •SDK и безопасность типов: SDK обеспечивает безопасность типов для Todo и User и обрабатывает JSON, так что вам нужно писать меньше шаблонного кода.
• •Асинхронный и необязательный оффлайн: Используйте async/await; поддерживаемые SDK предлагают локальную привязку, чтобы ваш список мог работать в оффлайне и синхронизироваться при возвращении в онлайн.
• •Live Queries: Подписывайтесь на изменения 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 Playground

Попробуйте REST и GraphQL конечные точки для схемы Todo. Ответы из приведенных выше примерных данных — учетная запись Back4app не требуется.

Использует ту же схему Todo, что и этот шаблон.

Пошаговая интеграция iOS

Подключитесь к вашему Back4app бэкенду из iOS приложения, используя Back4app iOS SDK.

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 в вашем приложении

   Инициализируйте Back4app SDK при запуске приложения с вашим App ID и URL сервера.

   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.