Apa itu middleware di Django?

Question

Accepted Answer

**Middleware** adalah sebuah framework dari hooks yang memproses **setiap request dan response** secara global, berada di antara web server dan views Anda. Setiap middleware dapat menginspeksi/memodifikasi requests saat masuk dan responses saat keluar — ideal untuk cross-cutting concerns seperti authentication, security headers, sessions, dan logging.

## Alur request/response melalui middleware

```text
Request  → MW1 → MW2 → MW3 → VIEW
Response ← MW1 ← MW2 ← MW3 ← VIEW

Middleware wraps the view like layers of an onion:
  - on the way IN (request): top-to-bottom
  - on the way OUT (response): bottom-to-top (reverse order)
```

## Middleware bawaan Django (di settings.py)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # security headers (HSTS, etc.)
    "django.contrib.sessions.middleware.SessionMiddleware",   # enables request.session
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # CSRF protection
    "django.contrib.auth.middleware.AuthenticationMiddleware",# enables request.user
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # clickjacking protection
]
# ORDER MATTERS — e.g. SessionMiddleware must come before AuthenticationMiddleware
```

Banyak fungsi inti Django adalah middleware: sessions (`request.session`), authentication (`request.user`), CSRF protection, dan security headers semuanya berasal dari middleware bawaan. **Urutan penting** — beberapa middleware bergantung pada middleware lain yang berjalan terlebih dahulu.

## Menulis custom middleware

```python
class TimingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response          # the next middleware/view

def __call__(self, request):
        # --- code here runs on the way IN (before the view) ---
        import time; start = time.time()

response = self.get_response(request)     # call the next layer (eventually the view)

# --- code here runs on the way OUT (after the view) ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

Middleware adalah sebuah callable: kode sebelum `self.get_response(request)` berjalan pada request, kode sesudahnya berjalan pada response. Ini memungkinkan Anda bertindak baik sebelum maupun sesudah eksekusi view.

## Penggunaan middleware yang umum

```text
✓ Authentication / setting request.user
✓ Security headers (CSP, HSTS, X-Frame-Options)
✓ Request/response logging, timing, metrics
✓ Sessions, locale/i18n detection, CORS
✓ Rate limiting, maintenance mode, custom request preprocessing
```

## Middleware vs views/decorators

```text
Middleware → GLOBAL, cross-cutting concerns affecting EVERY (or most) request
Decorators/view logic → per-view concerns specific to certain endpoints
→ Use middleware for app-wide behavior; decorators for selective behavior.
```

## Mengapa ini penting

Middleware adalah fundamental terhadap bagaimana Django memproses requests — memahaminya menjelaskan bagaimana sebagian besar fungsi inti framework bekerja dan menyediakan mekanisme yang tepat untuk **global, cross-cutting concerns**.

Mengenali bahwa sessions, authentication (`request.user`), CSRF protection, dan security headers semuanya berasal dari middleware bawaan demystifies penanganan request Django dan menunjukkan mengapa fitur-fitur ini "hanya bekerja". Memahami **alur onion-layer request/response** (middleware membungkus view, memproses requests dari atas-ke-bawah dan responses dari bawah-ke-atas) dan bahwa **urutan penting** (beberapa middleware bergantung pada middleware lain, seperti authentication yang memerlukan sessions terlebih dahulu) penting untuk mengonfigurasi Django dengan benar dan men-debug masalah.

Kemampuan untuk **menulis custom middleware** berharga untuk mengimplementasikan perilaku app-wide dengan bersih — logging, timing, custom headers, rate limiting, maintenance mode — di satu tempat daripada mengulanginya di seluruh views.

Mengetahui kapan menggunakan middleware (global concerns yang mempengaruhi sebagian besar requests) versus decorators atau view logic (per-endpoint concerns) adalah keputusan arsitektur yang kunci.

Middleware adalah tempat Django menangani request/response processing yang berlaku di seluruh aplikasi, menjadikannya pengetahuan yang penting dan relevan secara praktis baik untuk memahami internal framework maupun untuk membangun aplikasi yang terstruktur dengan baik dengan pemisahan cross-cutting concerns yang tepat.