Quickstarters
Bagaimana Membangun Backend untuk Play Framework?

36min
Pendahuluan
Dalam tutorial ini, Anda akan belajar bagaimana membangun backend lengkap untuk Play Framework menggunakan Back4App.
Kami akan membahas fitur-fitur penting untuk backend server, termasuk pengaturan konfigurasi, manajemen database, Cloud Code Functions, REST dan GraphQL APIs, otentikasi pengguna, penyimpanan file, dan kueri waktu nyata.
Anda akan melihat bagaimana Back4App menyederhanakan proses pengaturan, penskalaan, dan pemeliharaan backend aplikasi web sambil memungkinkan Anda untuk fokus pada kode Play Framework Anda.
Dengan belajar bagaimana membangun backend untuk Play Framework dengan Back4App, Anda akan mengurangi waktu pengembangan dan meminimalkan masalah dev ops.
Anda juga akan menambahkan fitur-fitur kuat seperti login sosial, penjadwalan tugas (Cloud Jobs), dan webhook. Setelah Anda menyelesaikan ini, Anda dapat memperluas sistem menjadi solusi kelas produksi, mengintegrasikan fitur-fitur yang lebih canggih sesuai kebutuhan.
Ketika Anda selesai, Anda akan memiliki cetak biru yang solid untuk membuat aplikasi web Play Framework Anda yang berikutnya yang dapat diskalakan dan aman.
Anda akan siap untuk menyelami lebih dalam ke dalam peningkatan kinerja, integrasi, atau optimasi mode pengembangan untuk menangani tuntutan dunia nyata.
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. Ikuti panduan di atas untuk menyiapkan proyek Anda.
Lingkungan Play Framework yang berfungsi
Pastikan Anda telah menginstal Java 8+.
Instal sbt atau gunakan sbt melalui IDE Anda.
Pengetahuan dasar tentang Play Framework
Rujuk ke Dokumentasi Play jika Anda perlu menyegarkan kembali dasar-dasar.
Keterampilan dengan REST atau GraphQL
Ini akan membantu Anda berinteraksi dengan Back4App, terutama jika Anda memutuskan untuk tidak menggunakan atau jika Anda tidak dapat menggunakan Parse SDK secara langsung.
Pastikan Anda memiliki prasyarat ini sebelum Anda mulai. Memiliki proyek Back4App Anda yang disiapkan dan lingkungan Play Framework Anda yang siap akan membantu Anda mengikuti dengan lancar.
Langkah 1 – Membuat Proyek Baru di Back4App dan Menghubungkan
Mengapa Anda Membutuhkan Proyek Back4App Baru
Proyek Back4App yang baru adalah tulang punggung untuk backend Anda karena mengelola data aplikasi Anda, otentikasi, dan logika cloud. Apakah Anda sedang membangun prototipe kecil atau aplikasi web berskala besar, mudah untuk menghubungkan aplikasi Play Framework Anda ke proyek Back4App yang baru.
Membuat Proyek Back4App
Masuk ke akun Back4App Anda.
Klik “Aplikasi Baru” di dasbor Back4App Anda.
Beri nama aplikasi Anda, misalnya, “Play-Framework-Backend”.
﻿
Setelah dibuat, proyek baru Anda akan muncul di dasbor.
Menghubungkan dengan Back4App
Back4App memanfaatkan Parse Server. Jika aplikasi Play Framework Anda berencana untuk berinteraksi dengan Back4App melalui Parse Java SDK, Anda dapat menambahkannya ke build.sbt jika diperlukan. Jika tidak, Anda dapat menggunakan endpoint REST atau GraphQL.
Ambil Kunci Parse Anda:
Di dasbor Back4App Anda, buka Pengaturan Aplikasi atau Keamanan & Kunci untuk menemukan ID Aplikasi, Kunci API REST, Kunci JavaScript (jika menggunakan panggilan front-end), atau Kunci Klien, ditambah URL Server (biasanya https://parseapi.back4app.com).
﻿
Menggunakan Java/Parse SDK (Opsional):
Jika Anda ingin integrasi sisi server langsung menggunakan Parse SDK, tambahkan ketergantungan di build.sbt:
Text
libraryDependencies += "com.parse" % "parse" % "1.0.40" // Example version
libraryDependencies += "com.parse" % "parse" % "1.0.40" // Example version
﻿
Kemudian, dalam kode Play Framework Anda, Anda dapat menginisialisasi Parse:
Text
object ParseConfig {
  def init(): Unit = {
    Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
      .server("https://parseapi.back4app.com")
      .clientKey("YOUR_CLIENT_KEY")
      .build()
    )
  }
}
object ParseConfig {
  def init(): Unit = {
    Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
      .server("https://parseapi.back4app.com")
      .clientKey("YOUR_CLIENT_KEY")
      .build()
    )
  }
}
﻿
Anda mungkin menempatkan ini di Global.scala Anda atau memanggilnya dari titik inisialisasi yang sesuai. Ini mempersiapkan Anda untuk interaksi langsung dengan proyek Back4App Anda.
Jika Anda mau, gunakan endpoint REST atau GraphQL untuk operasi data, terutama jika Anda ingin lebih banyak kontrol atas permintaan HTTP Anda atau jika Anda sedang membangun mikroservis.
Langkah 2 – Menyiapkan Database
Layanan penyimpanan data Back4App mendukung berbagai jenis data dan pembuatan skema dinamis. Ini memungkinkan Anda menyimpan data aplikasi Play Anda dengan sedikit kerepotan.
Membuat Model Data
Buka bagian “Database” di dasbor Back4App Anda.
Buat kelas baru (misalnya, “Todo”) dan tambahkan kolom (misalnya, title sebagai String, isCompleted sebagai Boolean).
Simpan untuk menyelesaikan skema database Anda.
Buat Kelas Baru
﻿
Membuat Model Data dengan Agen AI
Jika Anda ingin dengan cepat mendefinisikan struktur data Anda:
Buka Agen AI di Dasbor Aplikasi Anda.
Deskripsikan model data yang Anda inginkan dalam bahasa yang sederhana (misalnya, “Buat model ToDo yang sederhana.”).
Agen akan menghasilkan skema untuk Anda secara otomatis.
﻿
Membaca dan Menulis Data Menggunakan Parse SDK (Opsional)
Jika Anda memilih untuk menyertakan Parse Java SDK dalam aplikasi Play Framework Anda, Anda dapat menyimpan dan mengquery data:
Text
import com.parse.{ParseObject, ParseQuery}

object TodoService {
  def createTodo(title: String, isCompleted: Boolean): Either[Throwable, ParseObject] = {
    try {
      val todo = new ParseObject("Todo")
      todo.put("title", title)
      todo.put("isCompleted", isCompleted)
      Right(todo.save())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def fetchTodos(): Either[Throwable, java.util.List[ParseObject]] = {
    try {
      val query = ParseQuery.getQuery("Todo")
      val results = query.find()
      Right(results)
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
import com.parse.{ParseObject, ParseQuery}

object TodoService {
  def createTodo(title: String, isCompleted: Boolean): Either[Throwable, ParseObject] = {
    try {
      val todo = new ParseObject("Todo")
      todo.put("title", title)
      todo.put("isCompleted", isCompleted)
      Right(todo.save())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def fetchTodos(): Either[Throwable, java.util.List[ParseObject]] = {
    try {
      val query = ParseQuery.getQuery("Todo")
      val results = query.find()
      Right(results)
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
﻿
Membaca dan Menulis Data Menggunakan REST
Anda dapat mengirim permintaan HTTP dari pengontrol atau layanan Play Framework Anda:
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
Back4App juga menyediakan API GraphQL:
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
    }
  }
}
﻿
Ini sangat berguna jika Anda sedang membangun mikroservis atau ingin API yang fleksibel untuk klien front-end Anda.
Bekerja Dengan Kuery Langsung
Jika aplikasi web Anda membutuhkan data waktu nyata, aktifkan Kuery Langsung:
Aktifkan Kuery Langsung di dasbor Back4App di bawah Pengaturan Server.
Atur langganan Anda dalam kode. Jika menggunakan SDK Parse atau kode kustom, pastikan Anda mengonfigurasi liveQueryServerURL.
Berlangganan untuk perubahan pada kelas seperti “Todo.”
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Ikhtisar ACL dan CLP
Back4App menyediakan Daftar Kontrol Akses (ACL) untuk keamanan tingkat objek dan Izin Tingkat Kelas (CLP) untuk pembatasan yang lebih luas. Ini membantu menjaga backend server Anda tetap aman dan memastikan hanya operasi yang diizinkan yang terjadi.
﻿
Izin Tingkat Kelas
Di bagian Database dari dasbor Back4App Anda:
Pilih kelas (misalnya, “Todo”).
Buka CLP untuk membatasi baca/tulis kepada pengguna yang terautentikasi, peran, atau publik.
Konfigurasikan sesuai kebutuhan (misalnya, “Memerlukan Autentikasi” untuk setiap penulisan).
ACL
ACL melindungi objek individu. Misalnya, Anda dapat memastikan hanya pengguna tertentu yang dapat membaca atau menulis catatan tertentu. Jika Anda menggunakan Parse SDK dari kode Scala:
Text
import com.parse.{ParseACL, ParseUser, ParseObject}

def createPrivateTodo(title: String, owner: ParseUser): ParseObject = {
  val todo = new ParseObject("Todo")
  todo.put("title", title)

  val acl = new ParseACL(owner)
  acl.setPublicReadAccess(false)
  acl.setPublicWriteAccess(false)

  todo.setACL(acl)
  todo.save()
  todo
}
import com.parse.{ParseACL, ParseUser, ParseObject}

def createPrivateTodo(title: String, owner: ParseUser): ParseObject = {
  val todo = new ParseObject("Todo")
  todo.put("title", title)

  val acl = new ParseACL(owner)
  acl.setPublicReadAccess(false)
  acl.setPublicWriteAccess(false)

  todo.setACL(acl)
  todo.save()
  todo
}
﻿
Langkah 4 – Menulis Fungsi Cloud Code
Mengapa Cloud Code
Cloud Code memungkinkan Anda menjalankan logika kustom di server Back4App, menambahkan aturan bisnis atau validasi sebelum atau setelah transaksi data. Anda tidak perlu menangani penyediaan server Anda sendiri atau memulai ulang mode pengembangan untuk menerapkan fungsi tersebut.
Contoh Fungsi
JS
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
Anda dapat memanggil ini dari aplikasi Play Anda melalui REST, GraphQL, atau jika menggunakan Parse SDK, langsung.
Penerapan
Gunakan Back4App CLI atau dasbor:
Instal CLI (contoh Linux/MacOS):
Konfigurasi kunci akun:
Terapkan:
Atau terapkan melalui Dasbor dengan menempelkan fungsi Anda di Cloud Code > Functions dan menekan “Terapkan”.
Menggunakan Modul NPM
Cloud Code mendukung modul NPM. Misalnya, jika Anda memerlukan klien HTTP seperti axios:
JS
const axios = require('axios');
Parse.Cloud.define('fetchData', async (req) => {
  const response = await axios.get(req.params.url);
  return response.data;
});
const axios = require('axios');
Parse.Cloud.define('fetchData', async (req) => {
  const response = await axios.get(req.params.url);
  return response.data;
});
﻿
Langkah 5 – Mengonfigurasi Autentikasi
Mengaktifkan Autentikasi Pengguna
Back4App menggunakan kelas Parse.User untuk pendaftaran, login, dan manajemen sesi. Dalam pengaturan konfigurasi, pastikan “Aktifkan Verifikasi Email” dan “Aktifkan Reset Kata Sandi” jika diinginkan.
Kode Contoh (Parse SDK)
Text
import com.parse.{ParseUser}

object AuthService {
  def signUpUser(username: String, password: String, email: String): Either[Throwable, ParseUser] = {
    try {
      val user = new ParseUser()
      user.setUsername(username)
      user.setPassword(password)
      user.setEmail(email)

      Right(user.signUp())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def logInUser(username: String, password: String): Either[Throwable, ParseUser] = {
    try {
      Right(ParseUser.logIn(username, password))
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
import com.parse.{ParseUser}

object AuthService {
  def signUpUser(username: String, password: String, email: String): Either[Throwable, ParseUser] = {
    try {
      val user = new ParseUser()
      user.setUsername(username)
      user.setPassword(password)
      user.setEmail(email)

      Right(user.signUp())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def logInUser(username: String, password: String): Either[Throwable, ParseUser] = {
    try {
      Right(ParseUser.logIn(username, password))
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
﻿
Login Sosial
Jika Anda memerlukan login sosial (Google, Apple, atau Facebook), konfigurasikan mereka di dasbor Back4App Anda. Parse menyediakan metode utilitas atau Anda dapat mengandalkan alur OAuth standar, tergantung pada kebutuhan dan pendekatan Anda.
Langkah 6 – Menangani Penyimpanan File
Back4App menyimpan file melalui Parse.File. Dari Play Framework, Anda dapat mengunggah dengan REST atau Parse SDK.
Text
// Example with Parse SDK
import com.parse.{ParseFile, ParseObject}
import java.nio.file.{Files, Paths}

def uploadImage(filePath: String): Either[Throwable, String] = {
  try {
    val data = Files.readAllBytes(Paths.get(filePath))
    val parseFile = new ParseFile("myImage.jpg", data)
    parseFile.save()
    Right(parseFile.getUrl)
  } catch {
    case e: Throwable => Left(e)
  }
}
// Example with Parse SDK
import com.parse.{ParseFile, ParseObject}
import java.nio.file.{Files, Paths}

def uploadImage(filePath: String): Either[Throwable, String] = {
  try {
    val data = Files.readAllBytes(Paths.get(filePath))
    val parseFile = new ParseFile("myImage.jpg", data)
    parseFile.save()
    Right(parseFile.getUrl)
  } catch {
    case e: Throwable => Left(e)
  }
}
﻿
Pertimbangan Keamanan: Anda dapat mengonfigurasi izin unggah file (aktifkan untuk publik, anonim, atau terautentikasi) di pengaturan server Back4App.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Navigasikan ke Pengaturan Email di dasbor Back4App.
Aktifkan verifikasi email dan atur template email untuk reset kata sandi.
Di aplikasi Play Anda, Anda dapat memanggil:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}' \
  https://parseapi.back4app.com/requestPasswordReset
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
﻿
Ini akan memicu Back4App untuk mengirimkan instruksi reset kata sandi ke email pengguna.
Langkah 8 – Menjadwalkan Tugas dengan Cloud Jobs
Cloud Jobs
Jika Anda memerlukan tugas mulai untuk pekerjaan latar belakang (misalnya, membersihkan data atau menghasilkan laporan), Anda dapat menjadwalkan Cloud Jobs di Back4App.
JS
// main.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);
  }
});
// main.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);
  }
});
﻿
Penjadwalan:
Terapkan kode Cloud Anda.
Di Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang, jadwalkan pekerjaan untuk dijalankan setiap hari, mingguan, atau sesuai kebutuhan.
Menjadwalkan Cloud Job
﻿
Langkah 9 – Mengintegrasikan Webhooks
Jika Anda ingin memberi tahu layanan eksternal setiap kali data berubah, atur Webhooks di Back4App.
Pergi ke More > WebHooks di dasbor Back4App Anda.
Tambahkan Webhook dengan endpoint (misalnya, Slack atau Stripe).
Pilih pemicu, seperti “Rekaman baru di kelas Todo.”
Menambahkan Webhook
﻿
Anda juga dapat membuat Webhooks dalam pemicu Cloud Code, melakukan permintaan HTTP langsung ke layanan pihak ketiga.
WebHook Sebelum Disimpan
﻿
Langkah 10 – Menjelajahi Panel Admin Back4App
The Back4App Admin App adalah antarmuka yang ramah pengguna untuk manajemen data dan catatan. Pengguna non-teknis dapat menangani operasi CRUD tanpa harus menyelami kode.
Mengaktifkan Admin App
Pergi ke App Dashboard > More > Admin App.
Aktifkan dan buat pengguna admin.
Pilih subdomain untuk akses yang nyaman.
Aktifkan Admin App
﻿
Setelah masuk, Anda dapat mengelola entri data tanpa mengganggu dasbor tingkat rendah atau alat CLI.
﻿
Kesimpulan
Selamat! Anda telah belajar cara membangun backend untuk Play Framework menggunakan layanan Back4App. Sepanjang tutorial ini, Anda telah:
Membuat backend yang aman untuk aplikasi Play Framework di Back4App.
Mengatur database, termasuk desain skema, hubungan, dan kueri waktu nyata.
Menerapkan ACL dan CLP untuk akses data yang aman.
Menulis Cloud Code untuk logika kustom, pemicu, dan integrasi eksternal.
Mengonfigurasi otentikasi pengguna, login sosial, dan pengaturan ulang kata sandi.
Menangani unggahan file dan menambahkan keamanan file opsional.
Menjadwalkan tugas latar belakang dengan Cloud Jobs.
Mengintegrasikan dengan layanan pihak ketiga melalui Webhooks.
Menjelajahi Panel Admin Back4App untuk manajemen data yang lebih efisien.
Dengan alat-alat ini, Anda dapat mengoptimalkan mode pengembangan, menskalakan sesuai kebutuhan, dan membangun aplikasi web yang kuat di Play Framework. 
Rangkul integrasi lebih lanjut, penyetelan kinerja, dan langkah-langkah keamanan lanjutan untuk membawa backend server Anda ke tingkat berikutnya.
Langkah Selanjutnya
Tingkatkan pengaturan produksi Anda dengan alat caching, logging, atau monitoring.
Jelajahi keamanan tingkat lanjut dengan kontrol akses berbasis peran atau pengaturan zero-trust.
Integrasikan gateway pembayaran atau API pihak ketiga lainnya untuk perdagangan atau analitik.
Periksa dokumentasi resmi Back4App untuk wawasan lebih dalam tentang kinerja dan pemecahan masalah.
Tinjau lebih banyak tutorial tentang aplikasi obrolan waktu nyata, solusi IoT, atau layanan berbasis lokasi — banyak di antaranya membangun teknik dalam panduan ini.
﻿
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Bagaimana Membuat Backend untuk Elixir?
BERIKUTNYA
Cara Membangun Backend untuk Spring Boot?