Tutorial 2: Form dan Data Delivery
Pemrograman Berbasis Platform (CSGE602022) - diselenggarakan oleh Fakultas Ilmu Komputer Universitas Indonesia, Semester Genap 2022/2023
Tujuan Pembelajaran​
Setelah menyelesaikan tutorial ini, mahasiswa diharapkan untuk dapat:
- Mengetahui XML dan JSON sebagai salah satu metode data delivery
- Memahami cara kerja submisi data yang diberikan oleh pengguna menggunakan elemen
form
- Memahami cara mengirimkan data menggunakan format XML dan JSON
- Memahami cara mengambil data spesifik berdasarkan ID
Pengenalan Data Delivery
Dalam mengembangkan suatu platform, ada kalanya kita perlu mengirimkan data dari satu stack ke stack lainnya. Data yang dikirimkan bisa bermacam-macam bentuknya. Beberapa contoh format data yang umum digunakan antara lain HTML, XML, dan JSON. Implementasi data delivery dalam bentuk HTML sudah kamu pelajari pada tutorial sebelumnya. Tutorial ini akan mengajarkan data delivery melalui XML dan JSON.
XML (Extensible Markup Language)
XML adalah singkatan dari eXtensible Markup Language. XML didesain menjadi self-descriptive, sehingga dengan membaca XML tersebut kita bisa mengerti informasi apa yang ingin disampaikan dari data yang tertulis. XML digunakan pada banyak aplikasi web maupun mobile, yaitu untuk menyimpan dan mengirimkan data. XML hanyalah informasi yang dibungkus di dalam tag. Kita perlu menulis program untuk mengirim, menerima, menyimpan, atau menampilkan informasi tersebut.
Contoh data dalam format XML adalah sebagai berikut.
<?xml version="1.0" encoding="UTF-8"?>
<subject>
<name>Bahasa Italia Dasar A</name>
<lecturer>Prof. Antonietta Sireci</lecturer>
<credit>3</credit>
<organizer>Sastra Perancis</organizer>
</subject>
XML di atas sangatlah self-descriptive:
- Ada informasi nama mata kuliah (
name
) - Ada informasi nama dosen pengampu (
lecturer
) - Ada informasi SKS (
credit
) - Ada informasi penyelenggara (
organizer
)
Dokumen XML membentuk struktur seperti tree yang dimulai dari root, lalu branch, hingga berakhir pada leaves. Dokumen XML harus mengandung sebuah root element yang merupakan parent dari elemen lainnya. Pada contoh di atas, <phone>
adalah root element.
Untuk baris <?xml version="1.0" encoding="UTF-8"?>
biasa disebut sebagai XML Prolog. XML Prolog bersifat opsional, akan tetapi jika ada maka posisinya harus berada di awal dokumen XML. Pada dokumen XML semua elemen wajib memiliki closing tag. Tag pada XML sifatnya case sensitive, sehingga tag <subject>
berbeda dengan tag <Subject>
.
JSON (JavaScript Object Notation)
JSON adalah singkatan dari JavaScript Object Notation. JSON didesain menjadi self-describing, sehingga JSON sangat mudah untuk dimengerti. JSON digunakan pada banyak aplikasi web maupun mobile, yaitu untuk menyimpan dan mengirimkan data. Sintaks JSON merupakan turunan dari Object JavaScript. Akan tetapi format JSON berbentuk text, sehingga kode untuk membaca dan membuat JSON banyak terdapat dibanyak bahasa pemrograman.
Contoh data dalam format JSON adalah sebagai berikut.
{
"name": "Bahasa Italia Dasar B",
"lecturer": "Prof. Antonietta Sireci",
"credit": "3",
"organizer": "Sastra Perancis",
}
Data pada JSON disimpan dalam bentuk key dan value. Pada contoh di atas yang menjadi key adalah name
, lecturer
, credit
, dan organizer
. Value dapat berupa tipe data primitif (string, number, boolean) ataupun berupa objek.
Tutorial: Membuat Form Registrasi
Sampai saat ini, belum ada data yang ditambahkan ke dalam aplikasi. Sekarang, kita akan membuat sebuah form sederhana untuk menginput data transaksi pada aplikasi sehingga nantinya kamu dapat menambahkan data baru untuk ditampilkan pada halaman utama.
Catatan: Pada tutorial ini, kamu akan menggunakan proyek yang sudah kamu buat pada tutorial sebelumnya.
-
Jalankan virtual environment terlebih dahulu.
-
Buka
models.py
yang ada pada foldermoney_tracker
yang sudah dibuat sebelumnya. Ubahlah kode model menjadi seperti berikut agar tipe transaksi dibatasi pada pemasukan dan pengeluaran saja.from django.db import models TYPE_CHOICES = [ ('Pengeluaran', 'Pengeluaran'), ('Pemasukan', 'Pemasukan') ] class TransactionRecord(models.Model): name = models.CharField(max_length=50) type = models.CharField(max_length=20, choices=TYPE_CHOICES) amount = models.IntegerField() date = models.DateTimeField(auto_now_add=True) description = models.TextField()
-
Lakukanlah migrasi dengan perintah
python manage.py makemigrations
danpython manage.py migrate
pada Terminal atau Command Prompt untuk mengaplikasikan perubahan model yang telah dilakukan pada langkah sebelumnya. -
Buatlah file baru pada folder
money_tracker
dengan namaforms.py
untuk membuat struktur form yang dapat menerima data transaksi baru. Tambahkan kode berikut ke dalam fileforms.py
. -
Kemudian, bukalah file
views.py
yang ada pada foldermoney_tracker
dan tambahkan importHttpResponseRedirect
,TransactionRecordForm
, danreverse
pada bagian paling atas. -
Buatlah fungsi baru dengan nama
create_transaction
pada file tersebut yang menerima parameterrequest
, dan tambahkan potongan kode di bawah ini untuk menghasilkan formulir yang dapat menambahkan data transaksi secara otomatis ketika data di-submit dari form. -
Buatlah berkas HTML baru dengan nama
create_transaction.html
pada foldermoney_tracker/templates
. Isi daricreate_transaction.html
dapat kamu isi dengan template berikut. -
Buka
urls.py
yang ada pada foldermoney_tracker
danimport
fungsi yang sudah kamu buat tadi. -
Tambahkan path url ke dalam
urlpatterns
untuk mengakses fungsi yang sudah di-import pada poin sebelumnya. -
Buka
tracker.html
dan tambahkan kode berikut setelah block<table></table>
untuk menambahkan button tambah transaksi baru.
Kita sudah menambahkan form transaksi baru. Coba jalankan server dan tambahkan beberapa data transaksi baru. Seharusnya kamu dapat melihat data yang ditambahkan pada halaman utama aplikasi.
Tutorial: Mengembalikan Data dalam Bentuk XML
Catatan: Pada tutorial ini, kamu akan menggunakan proyek yang sudah kamu buat pada tutorial sebelumnya.
-
Buka
views.py
yang ada pada foldermoney_tracker
dan buatlah sebuah fungsi yang menerima parameter request (misal bernamashow_xml
). -
Tambahkan import
HttpResponse
danSerializer
pada bagian paling atas. -
Buatlah sebuah variabel di dalam fungsi tersebut yang menyimpan hasil query dari seluruh data yang ada pada
TransactionRecord
. -
Tambahkan return function berupa
HttpResponse
yang berisi parameter data hasil query yang sudah diserialisasi menjadi XML dan parametercontent_type="application/xml"
. -
Buka
urls.py
yang ada pada foldermoney_tracker
dan import fungsi yang sudah kamu buat tadi. -
Tambahkan path url ke dalam
urlpatterns
untuk mengakses fungsi yang sudah diimpor tadi. -
Jalankan proyek Django-mu dengan perintah
python manage.py runserver
dan bukalah http://localhost:8000/tracker/xml/ (sesuaikan dengan path url yang dibuat) di browser favoritmu untuk melihat hasilnya.
Tutorial: Mengembalikan Data dalam Bentuk JSON
-
Buka
views.py
yang ada pada foldermoney_tracker
dan buatlah sebuah fungsi baru yang menerima parameter request (misal bernamashow_json
). -
Buatlah sebuah variabel di dalam fungsi tersebut yang menyimpan hasil query dari seluruh data yang ada pada
TransactionRecord
. -
Tambahkan return function berupa
HttpResponse
yang berisi parameter data hasil query yang sudah diserialisasi menjadi JSON dan parametercontent_type="application/json"
. -
Buka
urls.py
yang ada pada foldermoney_tracker
dan import fungsi yang sudah kamu buat tadi. -
Tambahkan path url ke dalam
urlpatterns
untuk mengakses fungsi yang sudah diimpor tadi. -
Jalankan proyek Django-mu dengan perintah
python manage.py runserver
dan bukalah http://localhost:8000/tracker/json/ (sesuaikan dengan path url yang dibuat) di browser favoritmu untuk melihat hasilnya.
Tutorial: Mengembalikan Data Berdasarkan ID dalam Bentuk XML atau JSON
-
Buka
views.py
yang ada pada foldermoney_tracker
dan buatlah sebuah fungsi baru yang menerima parameter request dan ID (misal bernamashow_xml_by_id
danshow_json_by_id
). -
Buatlah sebuah variabel di dalam fungsi tersebut yang menyimpan hasil query dari data dengan ID tertentu yang ada pada
TransactionRecord
. -
Tambahkan return function berupa
HttpResponse
yang berisi parameter data hasil query yang sudah diserialisasi menjadi JSON atau XML dan parametercontent_type
dengan value"application/xml"
(untuk format XML) atau"application/json"
(untuk format JSON).-
XML
-
JSON
-
-
Buka
urls.py
yang ada pada foldermoney_tracker
dan impor fungsi yang sudah kamu buat tadi. -
Tambahkan path url ke dalam
urlpatterns
untuk mengakses fungsi yang sudah diimpor tadi. -
Jalankan proyek Django-mu dengan perintah
python manage.py runserver
dan bukalah http://localhost:8000/tracker/xml/[id] atau http://localhost:8000/tracker/json/[id] (sesuaikan dengan path url yang dibuat dan id yang diinginkan) di browser favoritmu untuk melihat hasilnya.
Credits
Tutorial ini dikembangkan berdasarkan PBP Ganjil 2023 yang ditulis oleh Tim Pengajar Pemrograman Berbasis Platform 2023. Segala tutorial serta instruksi yang dicantumkan pada repositori ini dirancang sedemikian rupa sehingga mahasiswa yang sedang mengambil mata kuliah Pemrograman Berbasis Platform dapat menyelesaikan tutorial saat sesi lab berlangsung.
Dibuat: 22 Februari 2023 12:45:36