Djangoミドルウェアの概要

Djangoのミドルウェアは、リクエストとレスポンスの処理プロセスに介入する軽量なプラグインシステムです。フレームワークの入力と出力を変更するための低レベルな仕組みを提供します。

ミドルウェアの設計は非侵入的な開発アプローチを可能にし、Djangoフレームワークの堅牢性を強化します。他のMVCフレームワークでも同様の機能がIOC（Inversion of Control）として実装されています。

ミドルウェアメソッドの種類

1. 初期化メソッド

パラメータを必要とせず、サーバーが最初のリクエストに応答する際に一度だけ呼び出されます。現在のミドルウェアを有効にするかどうかを決定します。

def __init__(self):
    # 初期化処理
    pass

2. リクエスト前処理

各リクエストに対して呼び出され、NoneまたはHttpResponseオブジェクトを返します。

def preprocess_request(self, req):
    # リクエスト前処理
    return None

3. ビュー前処理

各リクエストに対して呼び出され、NoneまたはHttpResponseオブジェクトを返します。

def preprocess_view(self, req, view_function, view_parameters, view_keyword_params):
    # ビュー実行前処理
    return None

4. テンプレートレスポンス処理

各リクエストに対して呼び出され、renderメソッドを実装したレスポンスオブジェクトを返します。

def process_template_response(self, req, resp):
    # テンプレートレスポンス処理
    return resp

5. レスポンス後処理

すべてのレスポンスがブラウザに返される前に呼び出され、HttpResponseオブジェクトを返します。

def postprocess_response(self, req, resp):
    # レスポンス後処理
    return resp

6. 例外処理

ビューが例外をスローしたときに呼び出され、HttpResponseオブジェクトを返します。

def handle_exception(self, req, exc):
    # 例外処理
    return None

実装例

ミドルウェアは独立したPythonクラスとして実装され、上記のメソッドのいずれかまたはすべてを定義できます。

class CustomMiddleware:
    def __init__(self):
        print('ミドルウェア初期化')
    
    def preprocess_request(self, req):
        print('リクエスト前処理')
        return None
    
    def preprocess_view(self, req, view_func, view_args, view_kwargs):
        print('ビュー前処理')
        return None
    
    def process_template_response(self, req, resp):
        print('テンプレートレスポンス処理')
        return resp
    
    def postprocess_response(self, req, resp):
        print('レスポンス後処理')
        return resp

settings.pyファイルのMIDDLEWARE設定に登録します。

例外処理ミドルウェアの実装

class ExceptionHandler1:
    def handle_exception(self, req, exc):
        print('例外ハンドラー1の処理')
        return None

class ExceptionHandler2:
    def handle_exception(self, req, exc):
        print('例外ハンドラー2の処理')
        return None

Djangoミドルウェアはフレームワークの低レベルな処理に介入でき、コードの重複を避けるための効果的な手段となります。Django自体も多くの組み込みミドルウェアを提供しており、例えばCSRF保護機能などがこれに該当します。