Quickstarters
Cara Membangun Backend untuk Ruby?

34min
Pendahuluan
Dalam tutorial ini, Anda akan menemukan cara membangun backend untuk Ruby menggunakan Back4App. 
Kami akan menjelajahi fitur-fitur penting Back4App seperti manajemen database, Fungsi Cloud Code, API REST dan GraphQL, otentikasi pengguna, dan kueri waktu nyata (Kueri Langsung). 
Dengan memanfaatkan bahasa pemrograman Ruby dan Back4App, Anda mendapatkan backend yang aman, dapat diskalakan, dan kuat yang mudah terintegrasi dengan ekosistem pengembangan perangkat lunak Anda.
Pendekatan ini menghemat waktu dan usaha dengan menggunakan platform web sumber terbuka yang dibangun di atas Parse. Anda akan melihat bagaimana mempercepat proyek pengembangan dengan prinsip pengembangan cepat. 
Sepanjang jalan, Anda akan belajar menggunakan fitur keamanan canggih, menjadwalkan tugas dengan Pekerjaan Cloud, dan mengatur webhook untuk integrasi eksternal. 
Pada akhirnya, Anda akan siap untuk merancang struktur kerangka aplikasi web dan mengembangkannya untuk aplikasi produksi.
Anda akan dapat:
Mengintegrasikan Ruby dengan Back4App untuk model data, logika berorientasi objek, dan data waktu nyata.
Memanfaatkan praktik terbaik proses pengembangan untuk pengembangan aplikasi dalam gaya model tampilan pengontrol (MVC) atau arsitektur lain yang Anda pilih.
Meningkatkan peran Anda sebagai pengembang backend dengan menangani otentikasi pengguna yang aman, pemicu Cloud Code, dan lainnya.
Lebih menyempurnakan aplikasi web Anda untuk memenuhi kebutuhan dunia nyata menggunakan fitur fleksibel dari Back4App.
Prasyarat
Akun Back4app dan proyek Back4app baru
Memulai dengan Back4app.
Daftar secara gratis jika Anda belum memiliki akun.
Lingkungan Ruby lokal
Anda harus memiliki Ruby terinstal. Biasanya, Ruby 2.6 atau yang lebih baru disarankan.
Keterampilan dengan bahasa pemrograman Ruby
Pengetahuan dasar tentang sintaks Ruby, konsep berorientasi objek dan penggunaan umum bahasa pemrograman
Bundler (opsional tetapi disarankan)
Bundler membantu mengelola gem untuk kerangka aplikasi web Anda atau proyek pengembangan. Dokumen Resmi Bundler.﻿
Pastikan Anda memiliki semua prasyarat ini sebelum memulai. Memiliki proyek Back4App Anda yang dibuat dan lingkungan Ruby Anda siap akan memberikan pengalaman tutorial yang lancar.
Langkah 1 – Membuat Proyek Baru di Back4App dan Menghubungkan
Mengapa Langkah Ini Penting
Proyek Back4App baru adalah fondasi untuk pengembangan aplikasi. Ini menyimpan database Anda, mengelola otentikasi pengguna, dan menyediakan lingkungan untuk menjalankan Cloud Code.
Buat Proyek Baru
Masuk ke Back4App.
Klik Aplikasi Baru di dasbor Back4App Anda.
Beri nama aplikasi Anda (misalnya, “Ruby-Backend-Tutorial”).
Instal Parse SDK dan Hubungkan ke Back4App
Parse SDK untuk Ruby membantu Anda berinteraksi dengan backend Back4App. Anda dapat menginstalnya melalui gem:
Langkah 2 – Menyiapkan Database
1. Membuat Model Data
Di Back4App, sebuah kelas seperti tabel database. Misalnya, Anda dapat membuat kelas “Todo” untuk menyimpan tugas. Anda dapat membuat kelas secara langsung dari Ruby atau mendefinisikannya di dasbor untuk kontrol yang lebih rinci.
2. Membuat Model Data Menggunakan AI Agent
Buka AI Agent di Dasbor Aplikasi Anda.
Deskripsikan model data Anda dalam bahasa yang sederhana (misalnya, “Aplikasi Todo dengan judul, bidang isCompleted”).
Biarkan AI Agent membuat skema Anda secara otomatis.
﻿
3. Membaca dan Menulis Data Menggunakan Ruby (Parse SDK)
Di bawah ini adalah contoh sederhana untuk membuat catatan baru dalam kelas “Todo” menggunakan Ruby SDK:
Ruby
require_relative 'parse_config'

# Create a Todo object
todo = Parse::Object.new("Todo")
todo["title"] = "Buy groceries"
todo["isCompleted"] = false
saved_todo = todo.save
puts "Todo saved with objectId: #{saved_todo['objectId']}"

# Query Todos
query = Parse::Query.new("Todo")
results = query.get
puts "Fetched #{results.size} todos."
results.each do |t|
  puts "Title: #{t['title']}, Completed: #{t['isCompleted']}"
end
require_relative 'parse_config'

# Create a Todo object
todo = Parse::Object.new("Todo")
todo["title"] = "Buy groceries"
todo["isCompleted"] = false
saved_todo = todo.save
puts "Todo saved with objectId: #{saved_todo['objectId']}"

# Query Todos
query = Parse::Query.new("Todo")
results = query.get
puts "Fetched #{results.size} todos."
results.each do |t|
  puts "Title: #{t['title']}, Completed: #{t['isCompleted']}"
end
﻿
4. Membaca dan Menulis Data Menggunakan REST API
Anda juga dapat membuat dan mengambil catatan menggunakan antarmuka REST:
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
﻿
5. Membaca dan Menulis Data Menggunakan API GraphQL
Back4App menawarkan endpoint GraphQL untuk aplikasi web:
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
    }
  }
}
﻿
6. Bekerja dengan Live Queries (Opsional)
Aktifkan Live Queries di dasbor Back4App (Pengaturan Server) dan berlangganan dari skrip Ruby Anda jika lingkungan Anda mendukung koneksi WebSocket. Anda juga dapat menggunakannya untuk pembaruan waktu nyata dalam kerangka aplikasi web yang mendukung konkurensi.
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
1. Ikhtisar
ACL (Daftar Kontrol Akses) dan CLP (Izin Tingkat Kelas) melindungi data Anda dengan cara berorientasi objek. ACL memungkinkan Anda memutuskan siapa yang dapat membaca atau menulis setiap catatan. CLP memungkinkan Anda mengelola izin untuk seluruh kelas.
﻿
2. Mengatur Izin Tingkat Kelas (CLP) dan ACL
Pergi ke Database bagian aplikasi Anda dan pilih kelas Anda, seperti “Todo.” Konfigurasikan CLP kelas Anda di bawah “Keamanan” atau “Izin Tingkat Kelas.” Untuk mengatur ACL pada catatan:
Ruby
owner = Parse::User.current
todo = Parse::Object.new("Todo")
acl = Parse::ACL.new(owner)
acl.public_read = false
acl.public_write = false
todo.acl = acl
todo["title"] = "Private Task"
todo.save
owner = Parse::User.current
todo = Parse::Object.new("Todo")
acl = Parse::ACL.new(owner)
acl.public_read = false
acl.public_write = false
todo.acl = acl
todo["title"] = "Private Task"
todo.save
﻿
Ini memastikan hanya pemilik yang dapat membaca/menulis Todo tertentu tersebut.
Langkah 4 – Menulis Fungsi Cloud Code
1. Mengapa Cloud Code
Cloud Code membantu menyematkan logika bisnis dan validasi langsung ke dalam server. Ini ideal untuk memastikan integritas data dan melakukan tugas yang tidak diekspos kepada klien.
2. Contoh Fungsi
Di main.js proyek Anda (atau yang serupa) di Back4App, Anda dapat mendefinisikan Fungsi Cloud:
JS
Parse.Cloud.define('calculateTextLength', (request) => {
  const { text } = request.params;
  if (!text) {
    throw 'No text provided';
  }
  return { length: text.length };
});
Parse.Cloud.define('calculateTextLength', (request) => {
  const { text } = request.params;
  if (!text) {
    throw 'No text provided';
  }
  return { length: text.length };
});
﻿
Catatan: Meskipun aplikasi utama kami menggunakan Ruby, Cloud Code di Parse berbasis JavaScript. Inilah cara Anda menyematkan logika sisi server di Back4App.
3. Penyebaran
Back4App CLI:
Dasbor Back4App: Salin/tempel fungsi Anda ke Cloud Code > Fungsi dan klik Terapkan.
4. Modul NPM
Anda dapat menginstal modul npm (misalnya, axios) untuk lingkungan Cloud Code Anda. Misalnya:
Bash
npm install axios
npm install axios
﻿
Di main.js, minta dan lakukan panggilan API eksternal sesuai kebutuhan.
Langkah 5 – Mengonfigurasi Autentikasi
1. Pengaturan Dasbor
Aktifkan autentikasi pengguna di Pengaturan Aplikasi aplikasi Anda. Back4App menggunakan Parse.User untuk manajemen pengguna.
2. Daftar / Masuk dengan Ruby
Ruby
require_relative 'parse_config'

# Signing Up a User
user = Parse::User.new({
  username: "alice",
  password: "secret123",
  email: "[email protected]"
})
begin
  user.sign_up
  puts "User signed up successfully"
rescue => e
  puts "Error: #{e.message}"
end

# Logging In a User
logged_in_user = Parse::User.login("alice", "secret123")
puts "Logged in as: #{logged_in_user.username}"
require_relative 'parse_config'

# Signing Up a User
user = Parse::User.new({
  username: "alice",
  password: "secret123",
  email: "alice@example.com"
})
begin
  user.sign_up
  puts "User signed up successfully"
rescue => e
  puts "Error: #{e.message}"
end

# Logging In a User
logged_in_user = Parse::User.login("alice", "secret123")
puts "Logged in as: #{logged_in_user.username}"
﻿
3. Masuk Sosial
Untuk mengintegrasikan masuk sosial (Facebook, Google, Apple), konsultasikan dengan Dokumen Masuk Sosial. Rincian implementasi bervariasi untuk setiap penyedia.
Langkah 6 – Menangani Penyimpanan File
1. Mengatur Penyimpanan File
Back4App mengelola unggahan file melalui objek Parse::File. Dalam Ruby:
Ruby
file = Parse::File.new("image.png", File.read("/path/to/image.png"))
saved_file = file.save
puts "File saved at: #{saved_file.url}"

# Attach file to an object
photo = Parse::Object.new("Photo")
photo["imageFile"] = saved_file
photo.save
puts "Photo object created with file reference."
file = Parse::File.new("image.png", File.read("/path/to/image.png"))
saved_file = file.save
puts "File saved at: #{saved_file.url}"

# Attach file to an object
photo = Parse::Object.new("Photo")
photo["imageFile"] = saved_file
photo.save
puts "Photo object created with file reference."
﻿
2. Contoh
Pengguna dapat mengunggah gambar, dokumen, atau file lainnya. Ambil URL untuk menampilkannya di frontend Anda atau layanan lainnya.
3. Pertimbangan Keamanan
Konfigurasikan aplikasi Anda untuk membatasi unggahan file hanya untuk pengguna yang terautentikasi jika perlu.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
1. Mengapa Ini Penting
Verifikasi email memastikan alamat email yang valid untuk akun baru. Reset kata sandi memungkinkan pengguna Anda untuk memulihkan akun mereka dengan aman.
2. Konfigurasi Dasbor Back4App
Aktifkan Verifikasi Email.
Siapkan template kustom untuk verifikasi dan reset kata sandi.
3. Contoh Kode
Dari Ruby, Anda dapat meminta reset kata sandi:
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": "alice@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
﻿
Ini mengirimkan tautan reset kata sandi ke email pengguna.
Langkah 8 – Penjadwalan Tugas dengan Pekerjaan Cloud
1. Apa yang Dilakukan Pekerjaan Cloud
Pekerjaan Cloud menjalankan tugas berkala seperti membersihkan data lama atau mengirim email ringkasan.
2. Contoh Pekerjaan
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);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
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);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
﻿
Jadwalkan di bawah Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang di dasbor Back4App Anda.
Langkah 9 – Mengintegrasikan Webhook
1. Definisi
Webhook memungkinkan Anda mengirim permintaan HTTP ke layanan eksternal setiap kali peristiwa tertentu terjadi di Back4App. Ini sangat baik untuk menghubungkan ke layanan pihak ketiga atau memicu tugas dalam bahasa pemrograman lainnya.
2. Konfigurasi
Pergi ke dasbor Back4App aplikasi Anda > Lainnya > Webhook, dan tambahkan Webhook baru dengan URL layanan eksternal Anda.
3. Contoh
Kirim data ke Stripe atau Slack setiap kali “Todo” baru dibuat. Sebagai alternatif, Anda dapat mendefinisikan pemicu dalam Cloud Code dan membuat permintaan HTTP dalam pemicu tersebut.
Langkah 10 – Menjelajahi Panel Admin Back4App
1. Di Mana Menemukannya
Di dasbor aplikasi Anda, klik Lainnya > Aplikasi Admin, lalu aktifkan.
2. Fitur
Antarmuka grafis untuk manajemen data tanpa kode.
Alat untuk menganalisis log, menjadwalkan pekerjaan latar belakang, dan lainnya.
Kontrol akses berbasis peran, memungkinkan Anda memberikan cara yang aman bagi pengguna non-teknis untuk mengelola konten.
Aktifkan Aplikasi Admin
﻿
Kesimpulan
Anda telah membangun backend yang aman dan dapat diskalakan untuk aplikasi Ruby Anda di Back4App, menggunakan bahasa pemrograman ruby untuk terhubung dengan Parse API. Proses pengembangan Anda sekarang mencakup:
Sebuah database dengan fitur keamanan canggih (ACL, CLP).
Pembaruan data real-time melalui Live Queries.
Cloud Code triggers untuk logika bisnis kustom.
Autentikasi pengguna dan penanganan file.
Tugas terjadwal dengan Cloud Jobs dan Webhooks untuk layanan eksternal.
Panel Admin yang ramah pengguna untuk manajemen data.
Dengan fondasi ini, Anda dapat memperluas aplikasi web Anda atau proyek bahasa pemrograman lainnya untuk memenuhi kebutuhan dunia nyata.
Apakah Anda seorang pengembang backend berpengalaman atau baru memulai dengan Ruby, Back4App menyediakan platform berorientasi objek yang mudah digunakan untuk pengembangan cepat.
Jangan ragu untuk mengintegrasikan API atau fitur tambahan, dan jelajahi lebih lanjut kustomisasi untuk menyelaraskan dengan pola model view controller (MVC) atau gaya arsitektur lainnya.
Langkah Selanjutnya
Perbaiki lingkungan produksi Anda dengan menambahkan caching lanjutan, akses berbasis peran, atau optimasi kinerja.
Tambahkan hubungan yang lebih kompleks di antara kelas data untuk mendukung kasus penggunaan dunia nyata.
Jelajahi Dokumentasi Resmi Back4App untuk keamanan, wawasan kinerja, dan analitik.
Eksperimen dengan kerangka web sumber terbuka lainnya untuk memperluas fitur aplikasi Anda.
Nikmati membangun aplikasi web yang lebih kuat dan kaya fitur dengan Ruby dan Back4App!
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Bagaimana Cara Membangun Backend untuk Ruby On Rails?
BERIKUTNYA
Bagaimana Membuat Backend untuk Elixir?