할 일 앱 백엔드 템플릿
Android — 스키마, API 및 AI 가이드

주요 요점

개요

Todo 앱은 백엔드 개발 학습을 위한 가장 일반적인 시작점 중 하나입니다. 내부적으로 사용자 등록, 작업 CRUD, 소유 기반 접근 제어 및 선택적으로 실시간 동기화가 필요합니다.

아래 스키마는 _User (내장) 및 Todo라는 두 클래스를 정의하며, 이들은 포인터로 연결되어 있습니다. Back4app Android SDK를 사용하면 앱에서 이 백엔드와 상호작용할 수 있습니다 — 객체를 쿼리하고, 생성하고, 업데이트하고, 삭제하는 작업을 사용자 정의 API 레이어를 작성하지 않고도 수행할 수 있습니다.

왜 Back4app으로 Android 할 일 백엔드를 구축해야 할까요?

Back4app은 준비된 백엔드와 타입이 지정된 SDK를 제공하므로 REST 연결 코드를 작성하거나 인증을 직접 관리하지 않고도 할 일 앱을 구축할 수 있습니다.

• •SDK 및 타입 안전성: SDK는 Todo와 User를 타입 안전하게 유지하고 JSON을 처리하므로 보일러플레이트 코드를 덜 작성할 수 있습니다.
• •비동기 및 선택적 오프라인: async/await를 사용하세요; 지원되는 SDK는 로컬 핀닝을 제공하므로 목록이 오프라인에서도 작동하고 온라인으로 돌아올 때 동기화됩니다.
• •Live Queries: Todo 변경 사항을 구독하여 UI가 WebSockets를 통해 실시간으로 업데이트됩니다.

모든 스택에 대해 동일한 스키마와 API — 백엔드를 변경하지 않고 클라이언트를 나중에 전환할 수 있습니다.

핵심 이점

더 빠르게 배포할 수 있는 프로덕션 준비 완료 Todo 백엔드로 앱에 집중할 수 있습니다.

기술 스택

이 Todo 앱 템플릿을 지원하는 모든 것.

ER 다이어그램

Android 할 일 앱 데이터 모델에 대한 개체-관계 다이어그램입니다.

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 시퀀스: 당신의 Android 앱이 Back4app와 통신하는 방법 — 로그인 후, 할 일을 조회하고 생성합니다.

sequenceDiagram
  participant User
  participant App as Android App
  participant Back4app as Back4app Cloud

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

  User->>App: Load todos
  App->>Back4app: ParseQuery<ParseObject>.findInBackground()
  Back4app-->>App: List of Todo
  App-->>User: Show list

  User->>App: Create todo
  App->>Back4app: todo.saveInBackground()
  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 스키마를 사용합니다.

단계별 Android 통합

Android 앱에서 Back4app 백엔드에 연결하고 Back4app Android SDK를 사용하세요.

1. 1단계: Back4app Android SDK 설치

   스택에 맞는 Back4app SDK를 추가하세요 (예: npm, pubspec 또는 패키지 관리자).

   Kotlin

   복사

   1

   2

   3

   4

   // build.gradle.kts (app)
   dependencies {
       implementation("com.github.parse-community.Parse-SDK-Android:parse:4.1.0")
   }

2. 2단계: 앱에서 Back4app 초기화

   앱 시작 시 Back4app SDK를 App ID와 서버 URL로 초기화하세요.

   Kotlin

   복사

   1

   2

   3

   4

   5

   6

   7

   8

   // Application class or Activity
   Parse.initialize(
       Parse.Configuration.Builder(context)
           .applicationId("YOUR_APP_ID")
           .clientKey("YOUR_CLIENT_KEY")
           .server("https://parseapi.back4app.com/")
           .build()
   );

3. 3단계: 모든 할 일 쿼리

   SDK를 사용하여 우선순위별로 정렬된 모든 Todo 객체를 가져옵니다.

   Kotlin

   복사

   1

   2

   3

   4

   5

   suspend fun getTodos(): List<ParseObject> = withContext(Dispatchers.IO) {
       val query = ParseQuery.getQuery<ParseObject>("Todo")
       query.orderByAscending("priority")
       query.find()
   }

4. 4단계: 할 일 만들기

   제목, 완료 여부 및 우선순위를 가진 새로운 Todo를 생성한 후 저장하세요.

   Kotlin

   복사

   1

   2

   3

   4

   5

   6

   7

   suspend fun createTodo(title: String, priority: Int = 3) = withContext(Dispatchers.IO) {
       val todo = ParseObject("Todo")
       todo.put("title", title)
       todo.put("done", false)
       todo.put("priority", priority)
       todo.save()
   }

5. 5단계: 할 일 업데이트 및 삭제

   필드를 업데이트하고 저장하거나 객체를 삭제합니다.

   Kotlin

   복사

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   // Mark done
   suspend fun markDone(objectId: String) = withContext(Dispatchers.IO) {
       val query = ParseQuery.getQuery<ParseObject>("Todo")
       val todo = query.get(objectId)
       todo.put("done", true)
       todo.save()
   }
   
   // Delete
   suspend fun deleteTodo(objectId: String) = withContext(Dispatchers.IO) {
       val query = ParseQuery.getQuery<ParseObject>("Todo")
       query.get(objectId).delete()
   }

전체 데이터 모델

타입 안전 직렬화를 위한 전체 Todo 모델을 복사하세요(예: 클래스, 인터페이스 또는 타입 정의).

// Todo.kt — matches Back4app schema
data class Todo(
    val objectId: String?,
    val title: String,
    val done: Boolean,
    val dueDate: Date?,
    val priority: Int,
    val owner: ParseUser?,
    val createdAt: Date?,
    val updatedAt: Date?
) {
    companion object {
        fun from(obj: ParseObject): Todo = Todo(
            objectId = obj.objectId,
            title = obj.getString("title") ?: "",
            done = obj.getBoolean("done") ?: false,
            dueDate = obj.getDate("dueDate"),
            priority = obj.getInt("priority") ?: 3,
            owner = obj.getParseUser("owner"),
            createdAt = obj.createdAt,
            updatedAt = obj.updatedAt
        )
    }
}

자주 묻는 질문

Todo 앱 백엔드 템플릿에 대한 일반적인 질문입니다.