Controller & AutoRoute

Ini dia fitur yang membuat GoIgniter terasa seperti CodeIgniter. Kalau kamu rindu magic routing CI3 yang tinggal buat file controller langsung jalan - GoIgniter punya itu.

Basic Controller

Perbandingan controller di CI3 dan GoIgniter:

application/controllers/Welcome.php

<?php
class Welcome extends CI_Controller {
    public function index() {
        $data['title'] = 'Welcome';
        $this->load->view('welcome', $data);
    }

    public function about() {
        $this->load->view('about');
    }
}

// GoIgniter: main.go atau controller file
package main

import "goigniter/system/core"

type Welcome struct {
    core.Controller
}

func (w *Welcome) Index() {
    w.Ctx.View("welcome", core.Map{
        "Title": "Welcome",
    })
}

func (w *Welcome) About() {
    w.Ctx.View("about", core.Map{})
}

Pola yang sama:

• Controller adalah struct yang embed core.Controller
• Method Index() adalah method default
• Akses view via w.Ctx.View()

Register & AutoRoute

Untuk mengaktifkan auto-routing, cukup register controller lalu panggil AutoRoute():

func main() {
    app := core.New()

    // Register controllers
    core.Register(&Welcome{})
    core.Register(&Product{})
    core.Register(&Dashboard{}, "admin") // dengan prefix

    // Aktifkan auto-routing
    app.AutoRoute()

    app.Run(":8080")
}

Itu saja! Routes akan otomatis dibuat berdasarkan nama controller dan method.

CRUD Mapping Otomatis

Berikut method names yang di-mapping secara otomatis ke HTTP routes:

Method	HTTP Methods	URL
Index()	GET, POST	/welcome
Show()	GET, POST	/welcome/:id
Create()	GET, POST	/welcome/create
Store()	POST	/welcome
Edit()	GET, POST	/welcome/:id/edit
Update()	PUT, POST	/welcome/:id
Delete()	DELETE, POST	/welcome/:id

Ini mengikuti konvensi RESTful dengan tambahan POST untuk form compatibility (seperti CI3).

Custom Method

Method selain yang di atas akan otomatis di-map sebagai GET dan POST (seperti CI3):

func (w *Welcome) About() {
    // Otomatis: GET & POST /welcome/about
    w.Ctx.View("about", core.Map{})
}

func (w *Welcome) Contact() {
    // Otomatis: GET & POST /welcome/contact
    w.Ctx.View("contact", core.Map{})
}

AllowedMethods - Kontrol HTTP Methods

Secara default, semua method controller menerima GET dan POST (seperti CI3). Tapi kamu bisa membatasi HTTP methods yang diizinkan dengan AllowedMethods():

type Auth struct {
    core.Controller
}

// Override untuk membatasi HTTP methods
func (a *Auth) AllowedMethods() map[string][]string {
    return map[string][]string{
        "Login":    {"GET"},           // Hanya GET
        "Dologin":  {"POST"},          // Hanya POST
        "Logout":   {"GET", "POST"},   // Keduanya (explicit)
        "Api":      {"GET", "POST", "PUT"}, // Multiple methods
    }
}

func (a *Auth) Login() {
    // GET /auth/login - tampilkan form
    a.Ctx.View("auth/login", core.Map{"Title": "Login"})
}

func (a *Auth) Dologin() {
    // POST /auth/dologin - proses login
    email := a.Ctx.FormValue("email")
    password := a.Ctx.FormValue("password")
    // ... proses login
}

func (a *Auth) Profile() {
    // GET & POST /auth/profile (default, tidak perlu didefinisikan)
    a.Ctx.View("auth/profile", core.Map{})
}

Default HTTP Methods

Method Name	Default HTTP Methods
Index()	GET, POST
Show()	GET, POST
Create()	GET, POST
Store()	POST only
Edit()	GET, POST
Update()	PUT, POST
Delete()	DELETE, POST
Method lainnya	GET, POST

Perbandingan dengan CI3

Di CI3, semua route menerima GET dan POST secara default. GoIgniter mengikuti behavior yang sama, tapi dengan tambahan kontrol via AllowedMethods():

// CI3: Tidak ada cara built-in untuk restrict HTTP methods
// Biasanya dicek manual di controller:
public function dologin() {
    if ($this->input->method() !== 'post') {
        show_404();
    }
    // ... proses login
}

// GoIgniter: Lebih clean dengan AllowedMethods()
func (a *Auth) AllowedMethods() map[string][]string {
    return map[string][]string{
        "Dologin": {"POST"},
    }
}

func (a *Auth) Dologin() {
    // Otomatis hanya menerima POST
    // GET akan return 404
}

Nested Controller (Admin Panel)

Untuk controller dengan prefix (misalnya admin), tambahkan parameter kedua saat register:

main.go

func main() {
    app := core.New()

    // Controller biasa
    core.Register(&Product{})

    // Controller dengan prefix "admin"
    core.Register(&Dashboard{}, "admin")
    core.Register(&User{}, "admin")

    app.AutoRoute()
    app.Run(":8080")
}

// Dashboard
type Dashboard struct {
    core.Controller
}

func (d *Dashboard) Index() {
    // Route: GET /admin/dashboard
    d.Ctx.View("admin/dashboard", core.Map{})
}

Hasil routing:

Product     → /product
Dashboard   → /admin/dashboard
User        → /admin/user

Akses Request Data

Di dalam method controller, akses data request via p.Ctx:

func (p *Product) Store() {
    // Form data
    name := p.Ctx.FormValue("name")
    price := p.Ctx.FormValue("price")

    // Query parameter
    page := p.Ctx.Query("page")

    // Route parameter (untuk :id)
    id := p.Ctx.Param("id")

    // JSON body
    var data map[string]any
    p.Ctx.Bind(&data)

    // ... proses dan simpan
}

Response Types

Berbagai cara mengirim response:

// JSON response
p.Ctx.JSON(200, core.Map{"status": "success"})

// HTML template
p.Ctx.View("products/index", core.Map{"products": products})

// Plain text
p.Ctx.String(200, "Hello World")

// Redirect
p.Ctx.Redirect(302, "/login")

// File download
p.Ctx.File("/path/to/file.pdf")

// No content (untuk DELETE sukses)
p.Ctx.NoContent(204)

Contoh Lengkap: Product CRUD

package main

import "goigniter/system/core"

func main() {
    app := core.New()

    core.Register(&Product{})

    app.AutoRoute()
    app.Run(":8080")
}

type Product struct {
    core.Controller
}

// GET /product
func (p *Product) Index() {
    products := getProductsFromDB()
    p.Ctx.View("products/index", core.Map{
        "Products": products,
    })
}

// GET /product/:id
func (p *Product) Show() {
    id := p.Ctx.Param("id")
    product := getProductByID(id)
    p.Ctx.View("products/show", core.Map{
        "Product": product,
    })
}

// GET /product/create
func (p *Product) Create() {
    p.Ctx.View("products/create", core.Map{})
}

// POST /product
func (p *Product) Store() {
    name := p.Ctx.FormValue("name")
    price := p.Ctx.FormValue("price")

    saveProduct(name, price)

    p.Ctx.Redirect(302, "/product")
}

// GET /product/:id/edit
func (p *Product) Edit() {
    id := p.Ctx.Param("id")
    product := getProductByID(id)
    p.Ctx.View("products/edit", core.Map{
        "Product": product,
    })
}

// PUT /product/:id
func (p *Product) Update() {
    id := p.Ctx.Param("id")
    name := p.Ctx.FormValue("name")
    price := p.Ctx.FormValue("price")

    updateProduct(id, name, price)

    p.Ctx.Redirect(302, "/product")
}

// DELETE /product/:id
func (p *Product) Delete() {
    id := p.Ctx.Param("id")
    deleteProduct(id)
    p.Ctx.NoContent(204)
}

---

Controller sudah jadi, tapi bagaimana dengan autentikasi dan logging? Lanjut ke Middleware.