B.1. Golang Web App: Hello World

Pada serial chapter B ini, fokus pembelajaran masih tetap tentang topik-topik fundamental atau dasar, tapi lebih spesifik ke area yang berhubungan dengan web development atau pengembangan web.

Pembahasan diawali dengan pembuatan aplikasi web "Hello World" sederhana menggunakan Go.

B.1.1. Pembuatan Aplikasi

Mari belajar sambil praktik. Pertama buat folder project baru dengan isi main.go, tentukan package-nya sebagai main, lalu import package fmt dan net/http.

package main

import "fmt"
import "net/http"

Setelah itu, siapkan dua buah fungsi, masing-masing memiliki skema parameter yang sama:

• Parameter ke-1 bertipe http.ResponseWrite
• Parameter ke-2 bertipe *http.Request

Fungsi dengan struktur di atas diperlukan oleh http.HandleFunc sebagai handler untuk keperluan penanganan request ke rute yang ditentukan. Berikut adalah dua fungsi yang dimaksud:

func handlerIndex(w http.ResponseWriter, r *http.Request) {
    var message = "Welcome"
    w.Write([]byte(message))
}

func handlerHello(w http.ResponseWriter, r *http.Request) {
    var message = "Hello world!"
    w.Write([]byte(message))
}

Method Write() milik parameter pertama (yang bertipe http.ResponseWrite), digunakan untuk meng-output-kan data ke HTTP response. Argumen method adalah data yang ingin dijadikan output, dituliskan dalam bentuk []byte.

Pada contoh ini, data yang akan kita tampilkan bertipe string, maka perlu dilakukan casting dari string ke []byte. Praktiknya bisa dilihat seperta pada kode di atas, di bagian w.Write([]byte(message)).

Selanjutnya, siapkan fungsi main() dengan isi di dalamnya adalah beberapa rute (atau route), dengan aksi adalah kedua fungsi yang sudah disiapkan di atas. Tak lupa siapkan juga kode untuk start web server.

func main() {
    http.HandleFunc("/", handlerIndex)
    http.HandleFunc("/index", handlerIndex)
    http.HandleFunc("/hello", handlerHello)

    var address = "localhost:9000"
    fmt.Printf("server started at %s\n", address)
    err := http.ListenAndServe(address, nil)
    if err != nil {
        fmt.Println(err.Error())
    }
}

Fungsi http.HandleFunc() digunakan untuk keperluan routing. Parameter pertama adalah rute dan parameter ke-2 adalah handler-nya.

Fungsi http.ListenAndServe() digunakan membuat sekaligus start server baru, dengan parameter pertama adalah alamat web server yang diiginkan (bisa diisi host, host & port, atau port saja). Parameter kedua merupakan object mux atau multiplexer.

Dalam chapter ini kita menggunakan default mux yang sudah disediakan oleh Go, jadi untuk parameter ke-2 cukup isi dengan nil.

Ok, sekarang program sudah siap, jalankan menggunakan go run.

Cek pada browser rute yang sudah dibuat, output akan muncul.

Berikut merupakan penjelasan detail per-bagian program yang telah kita buat dari contoh di atas.

◉ Penggunaan http.HandleFunc()

Fungsi ini digunakan untuk routing, menentukan aksi dari pengaksesan URL/rute tertentu. Rute dituliskan dalam tipe data string sebagai parameter pertama, dan aksi-nya sendiri dibungkus dalam fungsi (bisa berupa closure) pada parameter kedua (biasanya disebut sebagai handler).

Pada kode di atas, tiga buah rute didaftarkan:

• Rute / dengan aksi adalah fungsi handlerIndex()
• Rute /index dengan aksi adalah sama dengan /, yaitu fungsi handlerIndex()
• Rute /hello dengan aksi fungsi handlerHello()

Ketika rute-rute di atas diakses lewat browser, outpunya adalah isi-handler rute yang bersangkutan. Kebetulan pada chapter ini, ketiga rute tersebut outputnya adalah sama, yaitu berupa string.

Pada contoh di atas, ketika rute yang tidak terdaftar diakses, maka secara otomatis handler rute / yang dipanggil.

◉ Penjelasan Mengenai Handler

Route handler atau handler atau parameter kedua fungsi http.HandleFunc(), adalah sebuah fungsi dengan ber-skema func (ResponseWriter, *Request).

• Parameter ke-1 merupakan objek untuk keperluan http response.
• Sedang parameter ke-2 yang bertipe *request ini, berisikan informasi-informasi yang berhubungan dengan http request untuk rute yang bersangkutan.

Contoh penulisan handler bisa dilihat pada fungsi handlerIndex() berikut.

func handlerIndex(w http.ResponseWriter, r *http.Request) {
    var message = "Welcome"
    w.Write([]byte(message))
}

Output dari rute dituliskan di dalam handler menggunakan method Write() milik objek ResponseWriter (parameter pertama). Output bisa berupa apapun, untuk output text tinggal lakukan casting dari tipe string ke []byte, aturan ini juga berlaku untuk banyak jenis output lainnya seperti HTML, XML, JSON, dan lainnya (dengan catatan response header Content-Type-nya juga perlu disesuaikan).

Pada contoh program yang telah kita buat, handler Index() memunculkan text "Welcome", dan handler Hello() memunculkan text "Hello world!".

Sebuah handler bisa dipergunakan pada banyak rute, bisa dilihat pada di atas handler Index() digunakan pada rute / dan /index.

◉ Penggunaan http.ListenAndServe()

Fungsi ini digunakan untuk membuat web server baru. Pada contoh yang telah dibuat, web server di-start pada port 9000 (bisa dituliskan dalam bentuk localhost:9000, 0.0.0.0:9000, atau cukup :9000 saja).

var address = ":9000"
fmt.Printf("server started at %s\n", address)
err := http.ListenAndServe(address, nil)

Fungsi http.ListenAndServe() bersifat blocking, menjadikan semua statement setelahnya tidak akan dieksekusi, sebelum di-stop.

Fungsi ini mengembalikan nilai balik ber-tipe error. Jika proses pembuatan web server baru gagal, maka kita bisa mengetahui root-cause nya apa.

B.1.2. Web Server Menggunakan http.Server

Selain menggunakan http.ListenAndServe(), ada cara lain yang bisa diterapkan untuk start web server, yaitu dengan memanfaatkan struct http.Server.

Kode di bagian start server yang sudah kita buat, jika diubah ke cara ini, kurang lebih menjadi seperti berikut.

var address = ":9000"
fmt.Printf("server started at %s\n", address)

server := new(http.Server)
server.Addr = address
err := server.ListenAndServe()
if err != nil {
    fmt.Println(err.Error())
}

Informasi host/port perlu dimasukan dalam property .Addr milik objek server. Lalu dari objek tersebut panggil method .ListenAndServe() untuk start web server.

Kelebihan menggunakan http.Server salah satunya adalah kemampuan untuk mengubah beberapa konfigurasi default web server Go. Contohnya bisa dilihat pada kode berikut, timeout untuk read request dan write request di ubah menjadi 10 detik.

server.ReadTimeout = time.Second * 10
server.WriteTimeout = time.Second * 10

Struct http.Server memiliki cukup banyak property lainnya, yang pastinya akan dibahas pada pembahasan-pembahasan selanjutnya.