Belajar Ruby on Rails: Seri Belajar Ruby on Rails Bagian 5

Setelah sebelumnya memulai pembahasan mengenai apa itu Ruby, cara
menginstall Ruby on Rails, pengenalan bahasa Ruby, dan pengenalan Rails
framework, sekarang saatnya untuk memulai menggunakan Rails framework dengan
membuat aplikasi sederhana.

Aplikasi Manajemen Tugas Sederhana

Kali ini kita akan mencoba membuat aplikasi manajemen tugas sederhana.
Aplikasi ini berfungsi untuk mencatat tugas-tugas harian, baik tugas
sekolah ataupun tugas kuliah. 

Sebelum itu, mari kita pikirkan data apa yang dibutuhkan untuk membuat
aplikasi ini. Karena aplikasi ini berkaitan dengan mencatat tugas harian,
maka data yang dibutuhkan, yaitu:

1. Nama Tugas
2. Deskripsi tugas
3. Kategori tugas
   Kategori ini dimaksudkan untuk menyimpan nama mata kuliah atau nama mata
   pelajaran di sekolah.
4. Deadline (Tanggal dikumpulkan)

Setelah mengetahui data apa saja yang dibutuhkan, dapat disimpulkan bahwa
setidaknya aplikasi ini terdiri dari satu model, satu controller, dan
beberapa view. Lalu kita buat projectnya, dengan menjalankan perintah
berikut pada terminal atau command prompt.

versi mysqlite

$ rails new homework_management

versi postgresql

$ rails new homework_management -d postgresql

cd homework_management

Setelah membuat Rails project baru, yang harus dilakukan adalah membuat
controller, model, dan view-view yang dibutuhkan. Untuk membuat beberapa hal
tersebut, Rails menyediakan fitur yang sangat berguna untuk membuatnya
secara otomatis dan simpel.

Scaffold, Fitur Ajaib di Rails

Scaffold ?. Apa itu scaffold ?. Scaffold merupakan quick-way yang
disediakan oleh Rails untuk membuat controller, model, beserta view-view
yang berkaitan. Dengan scaffold controller, model, dan view-view tersebut
dapat dibuat dengan satu kali operasi.

$ rails generate scaffold Homework homework_name:text category:string deadline:date description:text

Perintah di atas, berarti membuat resource homework dan pada tabelnya
memiliki kolom:

1. homework_name berupa text
2. category berupa string (menyimpan mata kuliah atau mata
   pelajaran)
   
3. deadline berupa date, dan
4. description berupa text

Apa yang dihasilkan dari perintah tersebut ?

1. File migration
   
2. Model
3. Route
   Scaffold akan otomatis mendaftarkan URL yang sudah dibuat menjadi route
   resources
4. Controller
5. Dan pada view, yaitu folder homeworks di app/views,
   index.html.erb, edit.html.erb, show.html.erb,
   new.html.erb, dan _form.html.erb di folder
   app/views/homeworks

Setelah itu coba jalankan server, dengan cara mengetikkan perintah
berikut pada terminal atau command prompt.

Tampilan tersebut merupakan tampilan error pada Rails framework. Apa yang
terjadi ?. Yang terjadi adalah kita lupa untuk menjalankan file migrasi
yang dibuat oleh scaffold.

Perlu diingat meskipun kita menggunakan scaffold, tetapi untuk melakukan
migrasi file database, harus dilakukan sendiri dengan cara menjalankan
perintah berikut.

atau

Jika tampilan di atas muncul, itu artinya aplikasi manajemen tugas
sederhana sudah dibuat.

Hanya dengan menggunakan scaffold bagian-bagian terpenting yang saling
berhubungan dapat dibuat. Tetapi bagaimana penjelasannya ?. Bagaimana jika
membuatnya secara manual ?. Berikut penjelasannya.

Model

Saat men-generate scaffold Homework, otomatis akan membuat model
pada app/models/homework.rb. Pada model ini nantinya dapat digunakan
untuk melakukan validasi data yang akan masuk, dsb.
Untuk membuat model secara manual dapat dilakukan dengan cara

$ rails generate model Homework

Perintah tersebut otomatis membuat model dengan nama homework.rb di
app/models beserta file migrasi tablenya.

Controller

Saat men-generate scaffold Homework, otomatis akan membuat
controller pada app/controllers/homeworks_controller.rb. Selain itu,
saat menjalankan scaffold maka pada cotroller otomatis akan membuat
method-method berikut:

1. index: menampilkan seluruh data pada tabel
2. show: menampilkan data sesuai dengan parameter
3. new: menampilkan halaman tambah data
4. edit:  menampilkan halaman edit data
5. create: proses menyimpan data
6. update: proses mengubah data
7. destroy: proses menghapus data

Untuk membuat controller secara manual dapat dilakukan dengan cara

$ rails generate controller Homework

Perintah tersebut otomatis membuat controller dengan nama
homework_controller.rb di app/controller. Jika ingin membuat
controller dan membuat view, dapat dilakukan dengan cara

$ rails generate controller Homework index

kata “index” pada perintah tersebut berarti membuat view pada
app/views/homework/index.html.erb

Migration

Dari awal pembahasan kita sudah sering menyebutkan file migrasi tabel. Apa
itu migrasi atau migration table di Ruby ?. Migration adalah fitur di Ruby
yang dibuat untuk membuat atau mengubah tabel di database secara mudah.
Migration ini merupakan salah satu yang akan dihasilkan ketika melakukan
scaffolding.

Untuk dapat membuat file migrasi, lakukan perintah berikut.

$ rails generate migration CreateHomeworks

File migrasi yang sudah dibuat akan disimpan pada folder db/migrate

Untuk dapat melakukan migrasi, lakukan perintah berikut.

atau

Route

Route pada Rails diibaratkan seperti jembatan yang berfungsi untuk menerima
request dari browser dan meneruskannya ke controller atau men-generate URL beserta action jika URL tersebut diakses.

Route di Rails application terdapat pada config/routes.rb. Ketika
menggunakan scaffold, maka scaffold akan otomatis mendaftarkan resource yang
dibuat di routes.rb. 

resource :homeworks artinya mengikat semua method yang ada pada
controller homework menjadi satu bagian, dan URL yang terbentuk dari
resource ini akan sesuai dengan nama methodnya. 

Contoh pada resources :homeworks terdapat method new, maka
URL yang dihasilkan menjadi /homeworks/new

Lalu dari hasil melakukan scaffolding URL apa yang dihasilkan ?. Untuk
mengetahui route apa saja yang terdaftar, dapat dilakukan dengan cara

Merubah Root Action

Untuk merubah root action ke sebuah method tertentu, misalnya root action
akan diubah ke method index pada controller
homework_controller.rb, dapat dilakukan dengan cara menambahkan
script berikut pada routes.rb

root "homeworks#index"

Happy Coding !!