Cara Membangun Backend untuk Blazor?
Dalam tutorial ini, Anda akan belajar bagaimana membangun backend lengkap untuk aplikasi Blazor menggunakan Back4app.
Kami akan membahas integrasi fitur-fitur penting Back4app - seperti manajemen database, Cloud Code Functions, REST dan GraphQL APIs, otentikasi pengguna, dan kueri waktu nyata (Live Queries) - untuk menciptakan backend yang aman, skalabel, dan kuat yang berkomunikasi dengan mulus dengan frontend Blazor Anda.
Memanfaatkan layanan backend yang kuat dari Back4app dengan Blazor, sebuah kerangka kerja ASP.NET Core untuk membangun UI web interaktif menggunakan C#, memungkinkan pengembang untuk mempercepat pengembangan backend.
Apakah Anda membangun aplikasi Blazor Server atau aplikasi Blazor WebAssembly, integrasi yang mulus dengan Back4app dapat secara drastis mengurangi waktu pengembangan sambil memastikan logika bisnis sisi server yang berkualitas tinggi.
Pada akhir tutorial ini, Anda akan memiliki struktur backend yang aman yang disesuaikan untuk aplikasi web full stack menggunakan Blazor.
Anda akan mendapatkan wawasan tentang cara menangani operasi data, menerapkan kontrol keamanan, dan mengimplementasikan fungsi cloud, menjadikan aplikasi web Blazor Anda kuat dan skalabel.
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:
- Akun Back4app dan proyek Back4app baru Memulai dengan Back4app. Jika Anda tidak memiliki akun, Anda dapat membuat satu secara gratis. Ikuti panduan di atas untuk menyiapkan proyek Anda.
- Lingkungan pengembangan Blazor dasar Anda dapat menyiapkannya dengan menginstal .NET SDK terbaru dari Microsoft dan membuat proyek Blazor baru menggunakan template seperti dotnet new blazorserver atau dotnet new blazorwasm.
- .NET SDK (versi 6 atau lebih tinggi) terinstal Pastikan Anda memiliki .NET SDK untuk membangun dan menjalankan aplikasi Blazor.
- Keterampilan dalam konsep C# dan Blazor Dokumentasi Resmi Blazor. Jika Anda baru mengenal Blazor, tinjau dokumen resmi atau tutorial pemula sebelum memulai.
Pastikan Anda memiliki prasyarat ini sebelum memulai untuk memastikan pengalaman tutorial yang lancar.
Langkah pertama dalam membangun backend Blazor Anda di Back4app adalah membuat proyek baru. Jika Anda belum membuat satu, ikuti langkah-langkah ini:
- Masuk ke akun Back4app Anda.
- Klik tombol “Aplikasi Baru” di dasbor Back4app Anda.
- Beri nama aplikasi Anda (misalnya, “Blazor-Backend-Tutorial”).
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/drXO0UqsgxhFvRDiVmsMb_image.png?format=webp)
Konfigurasi ini memastikan bahwa setiap kali Anda menggunakan Parse di aplikasi Blazor Anda, itu sudah dikonfigurasi sebelumnya untuk terhubung ke instance Back4app spesifik Anda.
Dengan menyelesaikan langkah ini, Anda telah membangun koneksi yang aman antara frontend Blazor Anda dan backend Back4app, membuka jalan untuk melakukan operasi basis data, manajemen pengguna, dan lainnya.
Dengan proyek Back4app Anda yang sudah disiapkan dan SDK Parse terintegrasi ke dalam aplikasi Blazor Anda, Anda sekarang dapat mulai menyimpan dan mengambil data. Cara termudah untuk membuat catatan adalah dengan menggunakan ParseObject kelas:
Sebagai alternatif, Anda dapat menggunakan endpoint API REST Back4app untuk operasi.
Secara default, Parse memungkinkan pembuatan skema secara langsung, tetapi Anda juga dapat mendefinisikan kelas dan tipe data Anda di dasbor Back4app untuk kontrol yang lebih.
- Navigasikan ke bagian “Database” di dasbor Back4app Anda.
- Buat kelas baru (misalnya, “Todo”) dan tambahkan kolom yang relevan, seperti judul (String) dan isCompleted (Boolean).
![Buat Kelas Baru Buat Kelas Baru](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/iaZ_P-7epc_LSMFIPlaZV_image.png?format=webp)
Saat melakukan query, sertakan data pointer:
Untuk pembaruan waktu nyata dalam aplikasi Blazor Server, pertimbangkan untuk menggunakan koneksi SignalR untuk Kueri Langsung. Meskipun SDK .NET Parse mendukung Kueri Langsung, mengintegrasikannya secara langsung dalam aplikasi Blazor mungkin memerlukan pengaturan tambahan dengan SignalR untuk komunikasi waktu nyata.
- Aktifkan Kueri Langsung di dasbor Back4app Anda di bawah Pengaturan Server. Pastikan “Kueri Langsung” diaktifkan.
- Konfigurasi Klien Kueri Langsung di .NET jika diperlukan. Namun, untuk aplikasi Blazor, memanfaatkan SignalR mungkin lebih idiomatik untuk koneksi sisi server.
Karena kompleksitas pengaturan Kueri Langsung dalam Blazor dan potensi keterbatasan SDK .NET Parse dalam Blazor WebAssembly, Anda mungkin perlu menerapkan layanan sisi server yang menghubungkan Kueri Langsung Parse dengan klien SignalR.
Back4app menganggap keamanan dengan serius dengan menyediakan Daftar Kontrol Akses (ACL) dan Izin Tingkat Kelas (CLP). Fitur-fitur ini memungkinkan Anda membatasi siapa yang dapat membaca atau menulis data berdasarkan objek atau kelas, memastikan hanya pengguna yang berwenang yang dapat memodifikasi data Anda.
Sebuah ACL diterapkan pada objek individu untuk menentukan pengguna, peran, atau publik mana yang dapat melakukan operasi baca/tulis. Misalnya:
Ketika Anda menyimpan objek, ia memiliki ACL yang mencegah siapa pun kecuali pengguna yang ditentukan untuk membaca atau memodifikasinya.
CLP mengatur izin default seluruh kelas, seperti apakah kelas tersebut dapat dibaca atau ditulis secara publik, atau jika hanya peran tertentu yang dapat mengaksesnya.
- Pergi ke Dasbor Back4app Anda, pilih aplikasi Anda, dan buka Database bagian.
- Pilih kelas (misalnya, “Todo”).
- Buka Izin Tingkat Kelas tab.
- Konfigurasikan default Anda, seperti “Memerlukan Autentikasi” untuk baca atau tulis, atau “Tidak Ada Akses” untuk publik.
Izin ini menetapkan dasar, sementara ACL menyempurnakan izin untuk objek individu. Model keamanan yang kuat biasanya menggabungkan baik CLP (pembatasan luas) dan ACL (pembatasan halus per objek). Untuk informasi lebih lanjut, kunjungi Pedoman Keamanan Aplikasi.
Cloud Code adalah fitur dari lingkungan Parse Server yang memungkinkan Anda menjalankan kode JavaScript kustom di sisi server - tanpa perlu mengelola server atau infrastruktur Anda.
Dengan menulis Cloud Code, Anda dapat memperluas backend Back4app Anda dengan logika bisnis tambahan, validasi, pemicu, dan integrasi yang berjalan dengan aman dan efisien di Parse Server.
Ketika Anda menulis Cloud Code, Anda biasanya menempatkan fungsi JavaScript, pemicu, dan modul NPM yang diperlukan di dalam main.js (atau app.js) file.
File ini kemudian diterapkan ke proyek Back4app Anda, yang dieksekusi dalam lingkungan Parse Server.
Karena fungsi dan pemicu ini berjalan di server, Anda dapat mempercayainya untuk menangani logika rahasia, memproses data sensitif, atau melakukan panggilan API yang hanya backend - proses yang mungkin tidak ingin Anda ekspos langsung ke klien.
Semua Cloud Code untuk aplikasi Back4app Anda berjalan di dalam Parse Server yang dikelola oleh Back4app, jadi Anda tidak perlu khawatir tentang pemeliharaan server, penskalaan, atau penyediaan.
Setiap kali Anda memperbarui dan menerapkan file main.js Anda, Parse Server yang sedang berjalan akan diperbarui dengan kode terbaru Anda.
Struktur File main.js Sebuah main.js yang khas mungkin berisi:
- Pernyataan require untuk modul yang diperlukan (paket NPM, modul Node bawaan, atau file kode cloud lainnya).
- Definisi fungsi Cloud menggunakan Parse.Cloud.define().
- Pemicu seperti Parse.Cloud.beforeSave(), Parse.Cloud.afterSave(), dll.
- Modul NPM yang Anda instal (jika diperlukan).
Dengan kemampuan untuk menginstal dan menggunakan modul NPM, Kode Cloud menjadi sangat fleksibel, memungkinkan Anda untuk mengintegrasikan dengan API eksternal, melakukan transformasi data, atau mengeksekusi logika sisi server yang kompleks.
- Logika Bisnis: Misalnya, mengagregasi data untuk analitik atau melakukan perhitungan sebelum menyimpan ke database.
- Validasi Data: Memastikan bahwa bidang tertentu ada atau bahwa pengguna memiliki izin yang benar sebelum menyimpan atau menghapus catatan.
- Pemicu: Melakukan tindakan ketika data berubah (misalnya, mengirim notifikasi ketika pengguna memperbarui profil mereka).
- Integrasi: Menghubungkan dengan API atau layanan pihak ketiga.
- Penegakan Keamanan: Memvalidasi dan membersihkan input untuk menegakkan keamanan sebelum melakukan operasi sensitif.
Berikut adalah fungsi Cloud Code sederhana yang menghitung panjang string teks yang dikirim dari klien:
Menyebarkan melalui Back4app CLI:
1 - Instal CLI:
- Untuk Linux/MacOS:
3 - Terapkan kode cloud Anda:
Menerapkan melalui Dasbor:
- Di dasbor aplikasi Anda, pergi ke Cloud Code > Functions.
- Salin/tempel fungsi ke dalam editor main.js.
- Klik Deploy.
Dari Blazor menggunakan Parse .NET SDK:
Anda juga dapat memanggilnya melalui REST atau GraphQL seperti yang ditunjukkan dalam tutorial ReactJS.
Back4app memanfaatkan kelas Parse User sebagai dasar untuk autentikasi. Secara default, Parse menangani hashing kata sandi, token sesi, dan penyimpanan yang aman. Ini berarti Anda tidak perlu mengatur alur keamanan yang kompleks secara manual.
Dalam aplikasi Blazor, Anda dapat membuat pengguna baru dengan:
Setelah login berhasil, Parse membuat sebuah token sesi yang disimpan dalam objek pengguna. Di aplikasi Blazor Anda, Anda dapat mengakses pengguna yang saat ini masuk:
Parse secara otomatis menangani sesi berbasis token di latar belakang, tetapi Anda juga dapat mengelola atau mencabutnya secara manual. Untuk keluar:
Back4app dan Parse dapat terintegrasi dengan penyedia OAuth populer, seperti Google atau Facebook.
Konfigurasi dapat bervariasi dan sering melibatkan pengaturan sisi server atau paket tambahan. Lihat di Dokumen Login Sosial untuk instruksi yang lebih rinci.
Karena aplikasi Blazor Server berjalan di ASP.NET Core, Anda mungkin mengintegrasikan login sosial menggunakan penyedia Identitas ASP.NET Core bersama dengan Parse untuk otentikasi yang mulus.
Untuk mengaktifkan verifikasi email dan reset kata sandi:
- Navigasikan ke Pengaturan Email di dasbor Back4app Anda.
- Aktifkan verifikasi email untuk memastikan pengguna baru memverifikasi kepemilikan alamat email mereka.
- Konfigurasikan alamat Dari, template email, dan domain kustom Anda jika diinginkan.
Fitur-fitur ini meningkatkan keamanan akun dan pengalaman pengguna dengan memvalidasi kepemilikan email pengguna dan menyediakan metode pemulihan kata sandi yang aman.
Parse mencakup kelas ParseFile untuk menangani unggahan file, yang disimpan dengan aman oleh Back4app:
Untuk melampirkan file ke objek:
Mengambil URL file:
Mengambil URL file:
Anda dapat menampilkan imageUrl ini di komponen Blazor Anda dengan mengaturnya sebagai sumber dari <img> tag.
Parse Server menyediakan konfigurasi yang fleksibel untuk mengelola keamanan unggahan file. Gunakan ACL pada ParseFiles atau atur konfigurasi tingkat server sesuai kebutuhan.
Pekerjaan Cloud di Back4app memungkinkan Anda untuk menjadwalkan dan menjalankan tugas rutin di backend Anda - seperti membersihkan data lama atau mengirim email ringkasan harian. Pekerjaan Cloud yang tipikal mungkin terlihat seperti ini:
- Terapkan kode Cloud Anda dengan pekerjaan baru (melalui CLI atau dasbor).
- Pergi ke Dasbor Back4app > Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang.
- Jadwalkan pekerjaan untuk dijalankan setiap hari atau pada interval yang sesuai dengan kebutuhan Anda.
Pekerjaan Cloud memungkinkan Anda untuk mengotomatiskan pemeliharaan latar belakang atau proses berkala lainnya tanpa memerlukan intervensi manual.
Webhook memungkinkan aplikasi Back4app Anda untuk mengirim permintaan HTTP ke layanan eksternal setiap kali peristiwa tertentu terjadi.
Ini sangat kuat untuk mengintegrasikan dengan sistem pihak ketiga seperti gateway pembayaran, alat pemasaran email, atau platform analitik.
- Navigasikan ke konfigurasi Webhook di dasbor Back4app Anda > Lainnya > WebHooks dan kemudian klik pada Tambah Webhook.
- Konfigurasi pemicu untuk menentukan peristiwa mana di kelas Back4app Anda atau fungsi Cloud Code yang akan memicu webhook.
Misalnya, jika Anda ingin memberi tahu saluran Slack setiap kali Todo baru dibuat:
- Buat Aplikasi Slack yang menerima webhook masuk.
- Salin URL webhook Slack.
- Di dasbor Back4app Anda, atur endpoint ke URL Slack tersebut untuk peristiwa “Rekaman baru di kelas Todo.”
- Anda juga dapat menambahkan header HTTP atau payload kustom jika diperlukan.
Anda juga dapat mendefinisikan Webhook di Cloud Code dengan membuat permintaan HTTP kustom dalam pemicu seperti beforeSave, afterSave.
Aplikasi Admin Back4app adalah antarmuka manajemen berbasis web yang dirancang untuk pengguna non-teknis untuk melakukan operasi CRUD dan menangani tugas data rutin tanpa menulis kode.
Ini menyediakan antarmuka berbasis model, ramah pengguna yang menyederhanakan administrasi database, manajemen data kustom, dan operasi tingkat perusahaan.
Aktifkan dengan pergi ke Dasbor Aplikasi > Lainnya > Aplikasi Admin dan klik tombol “Aktifkan Aplikasi Admin”.
Buat Pengguna Admin Pertama (username/kata sandi), yang secara otomatis menghasilkan peran baru (B4aAdminUser) dan kelas (B4aSetting, B4aMenuItem, dan B4aCustomField) dalam skema aplikasi Anda.
Pilih Subdomain untuk mengakses antarmuka admin dan selesaikan pengaturannya.
Masuk menggunakan kredensial admin yang Anda buat untuk mengakses dasbor Aplikasi Admin baru Anda.
Setelah diaktifkan, Aplikasi Admin Back4app memudahkan untuk melihat, mengedit, atau menghapus catatan dari database Anda tanpa memerlukan penggunaan langsung dari Dasbor Parse atau kode backend.
Dengan mengikuti tutorial komprehensif ini, Anda telah:
- Membuat backend yang aman untuk aplikasi Blazor di Back4app.
- Mengonfigurasi database dengan skema kelas, tipe data, dan hubungan.
- Mengintegrasikan kueri waktu nyata di mana diperlukan untuk pembaruan data segera.
- Menerapkan langkah-langkah keamanan menggunakan ACL dan CLP untuk melindungi dan mengelola akses data.
- Menerapkan fungsi Cloud Code untuk menjalankan logika bisnis kustom di sisi server.
- Mengatur otentikasi pengguna dengan dukungan untuk verifikasi email dan pengaturan ulang kata sandi.
- Mengelola unggahan file dan pengambilan, dengan kontrol keamanan file opsional.
- Menjadwalkan Pekerjaan Cloud untuk tugas latar belakang otomatis.
- Menggunakan Webhook untuk mengintegrasikan dengan layanan eksternal.
- Menjelajahi Panel Admin Back4app untuk manajemen data.
Dengan frontend Blazor yang solid dan backend Back4app yang kuat, Anda sekarang siap untuk mengembangkan aplikasi web yang kaya fitur, skalabel, dan aman.
Lanjutkan menjelajahi fungsionalitas yang lebih canggih, integrasikan logika bisnis Anda, dan manfaatkan kekuatan Back4app untuk menghemat waktu Anda dalam administrasi server dan database. Selamat coding!
- Bangun aplikasi Blazor yang siap produksi dengan memperluas backend ini untuk menangani model data yang lebih kompleks, strategi caching, dan optimisasi kinerja.
- Integrasikan fitur-fitur canggih seperti alur autentikasi khusus, kontrol akses berbasis peran, atau API eksternal.
- Periksa dokumentasi resmi Back4app untuk penjelasan lebih dalam tentang keamanan canggih, penyesuaian kinerja, dan analisis log.
- Jelajahi tutorial lainnya tentang aplikasi chat waktu nyata, dasbor IoT, atau layanan berbasis lokasi. Gabungkan teknik yang dipelajari di sini dengan API pihak ketiga untuk membuat aplikasi kompleks di dunia nyata.
![Doc contributor](https://s3.amazonaws.com/archbee-animals/cat.png)