Quickstarters
Cara Membangun Backend untuk Dart?

25min
Pendahuluan
Dalam tutorial ini, Anda akan belajar cara membangun backend untuk Dart menggunakan Back4app. 
Kita akan fokus pada integrasi fitur-fitur penting Back4app—seperti manajemen database, Fungsi Cloud Code, API REST dan GraphQL, otentikasi pengguna, dan kueri waktu nyata (Live Queries)—ke dalam proyek berbasis Dart. 
Karena Dart adalah bahasa pemrograman yang serbaguna, Anda dapat menggunakannya untuk berbagai proyek backend, dari server web sederhana hingga aplikasi skala penuh.
Dengan memanfaatkan lingkungan intuitif Back4app, Anda akan dengan cepat menyiapkan kerangka backend yang kuat dan aman tanpa pemeliharaan server yang berat. 
Anda akan melihat bagaimana fitur-fitur seperti ACL, CLP, penjadwalan tugas latar belakang, dan membuat logika kustom dengan Cloud Code memperlancar operasi sisi server Anda. 
Setelah menyelesaikan tutorial ini, Anda akan siap untuk meningkatkan backend Dart Anda atau menambahkan integrasi yang lebih canggih.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:
Akun Back4app dan proyek Back4app baru
 Memulai dengan Back4app.
Jika Anda tidak memiliki akun, Anda dapat membuatnya secara gratis.
Lingkungan pengembangan Dart dasar
Anda dapat mengatur ini dengan menginstal Dart SDK dan editor pilihan Anda. Untuk informasi lebih lanjut, lihat Dapatkan Dart SDK.﻿
Dart 2.0 atau lebih tinggi
Pastikan lingkungan Anda diperbarui, sehingga Anda dapat memanfaatkan fitur-fitur Dart terbaru dan paket shelf atau pustaka sisi server lainnya.
Keterampilan dalam Dart dan konsep backend
Jika Anda baru mengenal Dart, tinjau Dokumentasi Resmi Dart. untuk membangun kefasihan dasar.
Pastikan Anda memiliki semua prasyarat ini sebelum Anda mulai. Memiliki proyek Back4app Anda siap dan lingkungan Dart lokal Anda dikonfigurasi dengan benar akan membantu Anda mengikuti dengan lebih mudah.
Langkah 1 – Membuat Proyek Baru di Back4App dan menghubungkan
Mengapa membuat proyek Back4app baru?
Proyek Back4app baru membentuk dasar backend Anda, mengelola database, keamanan, API, penyimpanan file, dan lainnya. Ini memberi Anda struktur yang terorganisir untuk membangun logika sisi server berbasis Dart Anda.
Membuat Proyek Back4app
Masuk ke akun Back4app Anda.
Klik “Aplikasi Baru” di dasbor Back4app.
Beri nama aplikasi Anda dengan deskriptif (misalnya, “Dart-Backend-Tutorial”).
﻿
Setelah dibuat, proyek Anda akan muncul di dasbor Back4app. Proyek ini adalah tempat Anda akan mengonfigurasi semua pengaturan backend untuk aplikasi Dart Anda.
Instal Parse SDK dan Hubungkan
Meskipun Dart tidak memiliki Parse SDK resmi, ada pustaka yang dikelola oleh komunitas seperti parse_server_sdk yang memungkinkan integrasi Back4app. Anda dapat menambahkannya dengan menyertakan ketergantungan berikut dalam pubspec.yaml:
YAML
dependencies:
  parse_server_sdk: ^4.0.0  # Example version
dependencies:
  parse_server_sdk: ^4.0.0  # Example version
﻿
Kemudian jalankan:
Bash
dart pub get
dart pub get
﻿
Inisialisasi Parse dalam kode Dart Anda (misalnya, di sebuah main.dart file):
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> main() async {
  const keyApplicationId = 'YOUR_APPLICATION_ID';
  const keyClientKey = 'YOUR_JAVASCRIPT_KEY';
  const keyParseServerUrl = 'https://parseapi.back4app.com';

  await Parse().initialize(
    keyApplicationId,
    keyParseServerUrl,
    clientKey: keyClientKey,
    autoSendSessionId: true,
  );

  // Your Dart server logic goes here
  print('Parse initialized with Back4app!');
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> main() async {
  const keyApplicationId = 'YOUR_APPLICATION_ID';
  const keyClientKey = 'YOUR_JAVASCRIPT_KEY';
  const keyParseServerUrl = 'https://parseapi.back4app.com';

  await Parse().initialize(
    keyApplicationId,
    keyParseServerUrl,
    clientKey: keyClientKey,
    autoSendSessionId: true,
  );

  // Your Dart server logic goes here
  print('Parse initialized with Back4app!');
}
﻿
Ambil Application ID, JavaScript Key, dan Parse Server URL dari dasbor Back4app (di bawah “Pengaturan Aplikasi” > “Keamanan & Kunci”). Dengan langkah ini, aplikasi Dart Anda dapat berinteraksi dengan aman dengan kerangka backend Back4app Anda.
Langkah 2 – Menyiapkan Database
Membuat Model Data
Di dasbor Back4app, navigasikan ke bagian “Database” dan buat kelas baru (misalnya, “Todo”). Tambahkan kolom untuk bidang Anda, seperti title (String) dan isCompleted (Boolean).
Membuat Model Data Menggunakan AI Agent
Buka AI Agent di Dasbor Aplikasi Anda.
Deskripsikan skema yang Anda inginkan (misalnya, “Tolong buat kelas ToDo dengan bidang title dan isCompleted.”).
Biarkan AI Agent menyelesaikan skema untuk Anda.
AI Agent untuk Pembuatan Skema
﻿
Membaca dan Menulis Data Menggunakan SDK
Dengan pustaka parse_server_sdk, Anda dapat menyimpan dan mengquery data dari kode Dart Anda. Misalnya:
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<ParseObject?> createTodoItem(String title, bool isCompleted) async {
  final todo = ParseObject('Todo')
    ..set('title', title)
    ..set('isCompleted', isCompleted);

  final response = await todo.save();

  if (response.success && response.result != null) {
    print('Todo created: ${response.result}');
    return response.result as ParseObject;
  } else {
    print('Error creating Todo: ${response.error?.message}');
    return null;
  }
}

Future<List<ParseObject>?> fetchTodos() async {
  final query = QueryBuilder<ParseObject>(ParseObject('Todo'));
  final response = await query.query();

  if (response.success && response.results != null) {
    return response.results as List<ParseObject>;
  } else {
    print('Error fetching Todos: ${response.error?.message}');
    return null;
  }
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<ParseObject?> createTodoItem(String title, bool isCompleted) async {
  final todo = ParseObject('Todo')
    ..set('title', title)
    ..set('isCompleted', isCompleted);

  final response = await todo.save();

  if (response.success && response.result != null) {
    print('Todo created: ${response.result}');
    return response.result as ParseObject;
  } else {
    print('Error creating Todo: ${response.error?.message}');
    return null;
  }
}

Future<List<ParseObject>?> fetchTodos() async {
  final query = QueryBuilder<ParseObject>(ParseObject('Todo'));
  final response = await query.query();

  if (response.success && response.results != null) {
    return response.results as List<ParseObject>;
  } else {
    print('Error fetching Todos: ${response.error?.message}');
    return null;
  }
}
﻿
Membaca dan Menulis Data Menggunakan REST API
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Membaca dan Menulis Data Menggunakan GraphQL API
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
Bekerja dengan Live Queries (opsional)
Untuk mengaktifkan pembaruan waktu nyata, aktifkan Live Queries di dasbor Back4app Anda (Pengaturan Server). Anda kemudian dapat berlangganan dari Dart, meskipun Anda mungkin memerlukan pustaka khusus. Pustaka parse_server_sdk mungkin memiliki dukungan query langsung sebagian; periksa dokumentasinya untuk detail.
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Ikhtisar
ACLs (Daftar Kontrol Akses): Batasi baca/tulis pada tingkat objek.
CLPs (Izin Tingkat Kelas): Batasi baca/tulis pada tingkat kelas.
Langkah-demi-langkah
Izin Tingkat Kelas: Di dasbor Back4app, buka bagian Database, pilih kelas, dan konfigurasikan CLPs di bawah “Keamanan.”
ACLs dalam Kode (menggunakan parse_server_sdk):
Dart
Future<ParseObject?> createPrivateTodo(String title, ParseUser ownerUser) async {
  final todo = ParseObject('Todo')..set('title', title);
  
  final acl = <String, dynamic>{};
  // Grant read/write to the owner
  acl[ownerUser.objectId!] = {"read": true, "write": true};
  
  // Disable public read/write
  acl['*'] = {"read": false, "write": false};

  todo.setACL(acl);

  final response = await todo.save();
  if (response.success && response.result != null) {
    return response.result as ParseObject;
  } else {
    print('Error setting ACL: ${response.error?.message}');
    return null;
  }
}
Future<ParseObject?> createPrivateTodo(String title, ParseUser ownerUser) async {
  final todo = ParseObject('Todo')..set('title', title);
  
  final acl = <String, dynamic>{};
  // Grant read/write to the owner
  acl[ownerUser.objectId!] = {"read": true, "write": true};
  
  // Disable public read/write
  acl['*'] = {"read": false, "write": false};

  todo.setACL(acl);

  final response = await todo.save();
  if (response.success && response.result != null) {
    return response.result as ParseObject;
  } else {
    print('Error setting ACL: ${response.error?.message}');
    return null;
  }
}
﻿
Langkah 4 – Menulis Fungsi Cloud Code
Mengapa Cloud Code
Cloud Code sangat penting untuk membuat logika bisnis kustom di sisi server. Ini menghindarkan Anda dari mengelola infrastruktur Anda sendiri dan menjaga kode Anda tetap aman dan dapat diskalakan.
Contoh Fungsi dan Pemicu
Di main.js (untuk Cloud Code):
JS
// main.js
Parse.Cloud.define('helloDart', (request) => {
  return `Hello from Dart and Back4app, ${request.params.name || 'Guest'}!`;
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Each Todo needs a title!';
  }
});
// main.js
Parse.Cloud.define('helloDart', (request) => {
  return `Hello from Dart and Back4app, ${request.params.name || 'Guest'}!`;
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Each Todo needs a title!';
  }
});
﻿
Penerapan
Menggunakan Back4app CLI:
Menggunakan Dashboard:
Pergi ke Cloud Code > Fungsi.
Tempelkan kode Anda ke main.js.
Klik Terapkan.
NPM dan Cloud Code
Jika Anda memerlukan modul NPM tambahan untuk Cloud Code Anda, tentukan mereka dalam package.json. Ini memungkinkan Anda untuk mengintegrasikan API eksternal atau operasi lanjutan langsung dari kode sisi server Anda.
Langkah 5 – Mengonfigurasi Autentikasi
Aktifkan Autentikasi Pengguna
Di dashboard Back4app, Anda dapat mengaktifkan verifikasi email atau mengatur login sosial. Secara default, kelas Pengguna Parse menyimpan kata sandi dengan aman.
Contoh Kode (menggunakan parse_server_sdk di Dart):
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> signUpUser(String username, String password, String email) async {
  final user = ParseUser(username, password, email);
  final response = await user.signUp();
  
  if (response.success) {
    print('User signed up: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}

Future<void> loginUser(String username, String password) async {
  final user = ParseUser(username, password, null);
  final response = await user.login();

  if (response.success) {
    print('User logged in: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> signUpUser(String username, String password, String email) async {
  final user = ParseUser(username, password, email);
  final response = await user.signUp();
  
  if (response.success) {
    print('User signed up: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}

Future<void> loginUser(String username, String password) async {
  final user = ParseUser(username, password, null);
  final response = await user.login();

  if (response.success) {
    print('User logged in: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}
﻿
Login Sosial
Konfigurasikan penyedia seperti Google, Apple, atau Facebook di dalam dasbor Back4app.
Terapkan plugin parse_server_sdk yang sesuai atau alur OAuth kustom jika tersedia.
Langkah 6 – Menangani Penyimpanan File
Menyiapkan Penyimpanan File
Back4app secara otomatis meng-host file yang Anda unggah melalui API Parse. Anda dapat menyimpan gambar, dokumen, atau jenis file apa pun.
Contoh (Dart)
Pertimbangan Keamanan
Anda dapat mengontrol siapa yang dapat mengunggah atau mengambil file dengan menyesuaikan CLP atau peran pengguna Anda di dasbor Back4app.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Ikhtisar
Verifikasi email mengonfirmasi bahwa pengguna memiliki email yang mereka daftarkan, sementara tautan reset kata sandi menyediakan cara yang aman untuk mengelola kredensial yang hilang.
Konfigurasi Dasbor Back4App
Pergi ke Pengaturan Aplikasi > Email.
Aktifkan Verifikasi Email Pengguna dan Reset Kata Sandi.
Sesuaikan template email Anda sesuai kebutuhan.
Implementasi
Ketika pengguna mendaftar menggunakan email yang valid, mereka menerima tautan verifikasi email. Untuk reset kata sandi, panggil metode requestPasswordReset milik ParseUser (jika tersedia di parse_server_sdk) atau endpoint REST.
Langkah 8 – Penjadwalan Tugas dengan Pekerjaan Cloud
Apa yang Dilakukan Pekerjaan Cloud
Pekerjaan Cloud memungkinkan Anda menjadwalkan tugas pada interval yang ditentukan, seperti membersihkan catatan lama atau mengirim laporan berkala. Mereka beroperasi di latar belakang, terpisah dari tindakan yang dipicu pengguna.
Contoh
Di main.js, tambahkan:
JS
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
Jadwal
Pergi ke Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang.
Jadwalkan cleanupOldTodos untuk dijalankan setiap hari atau pada interval yang Anda pilih.
Langkah 9 – Mengintegrasikan Webhook
Definisi
Webhook memungkinkan aplikasi Back4app Anda melakukan permintaan HTTP ke layanan eksternal pada peristiwa tertentu. Ini berguna untuk mengintegrasikan dengan layanan pihak ketiga seperti Slack atau Stripe.
Konfigurasi
Pergi ke Lainnya > WebHooks di dasbor Back4app Anda.
Klik Tambahkan Webhook dan berikan endpoint (misalnya, https://your-external-service.com/webhook-endpoint).
Tentukan peristiwa pemicu (misalnya, setelah Todo dibuat).
Menambahkan Webhook
﻿
Contoh
Jika Anda memiliki URL Webhook Slack, Anda dapat mengonfigurasinya untuk menerima notifikasi setiap kali Todo baru dimasukkan. Koneksi yang mulus antara backend Dart Anda dan alat eksternal meningkatkan otomatisasi.
Langkah 10 – Menjelajahi Panel Admin Back4App
Di Mana Menemukannya
Di konsol Back4app Anda, buka More > Admin App dan aktifkan panel.
Fitur
Kelola catatan database dengan mudah.
Tinjau log, pekerjaan latar belakang, dan analitik.
Kontrol akses dan peran pengguna.
Aktifkan Aplikasi Admin
﻿
Kesimpulan
Dengan mengikuti langkah-langkah ini, Anda telah:
Membangun backend yang aman untuk Dart di Back4app.
Mengelola database Anda melalui kelas dan field Parse.
Membuat Cloud Code kustom untuk menangani logika sisi server.
Mengamankan data menggunakan ACL, CLP, dan otentikasi pengguna.
Menjadwalkan tugas latar belakang dengan Cloud Jobs.
Mengintegrasikan layanan eksternal menggunakan Webhooks.
Menjelajahi Panel Admin untuk manajemen data yang mudah.
Fondasi yang solid ini mempersiapkan Anda untuk menerapkan proyek Dart dengan efisien, apakah Anda sedang membangun server web skala penuh, mikroservis, atau aplikasi khusus. Dari sini, Anda dapat meningkatkan kerangka backend Anda, menambahkan logika yang lebih kompleks, atau mengintegrasikan fitur canggih seperti notifikasi push atau analitik lanjutan.
Langkah Selanjutnya
Jelajahi kesiapan produksi: Gunakan strategi caching, tangani konkurensi, dan optimalkan kinerja untuk lalu lintas tinggi.
Integrasikan fitur canggih: Seperti kontrol akses berbasis peran, lebih banyak login sosial, atau alat kolaborasi waktu nyata.
Periksa dokumen resmi Back4app untuk wawasan lebih dalam tentang log, keamanan, dan penyetelan kinerja.
Eksperimen dengan paket tambahan seperti paket shelf untuk membuat server web kustom di samping lapisan data berbasis Parse Anda, memanfaatkan kemampuan Dart sebagai bahasa pemrograman yang fleksibel.
Dengan pengetahuan ini tentang cara membangun backend untuk Dart, Anda memiliki cara yang kuat untuk menangani data, mengamankan proses sisi server Anda, dan mengotomatiskan alur kerja aplikasi Anda—semua tanpa perlu infrastruktur yang signifikan.
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Bagaimana Membangun Backend untuk Ionic?
BERIKUTNYA
Bagaimana Membangun Backend untuk PHP?