[파이썬] Django의 미들웨어 개발과 활용

01 Sep 2023

python

Django는 웹 애플리케이션을 개발하기 위한 파이썬 웹 프레임워크로, 많은 기능과 장점을 제공합니다. 그 중에서도 미들웨어는 Django 애플리케이션에 유연성과 확장성을 더해주는 핵심 요소입니다.

미들웨어란?

미들웨어는 Django 애플리케이션에 들어오는 요청과 응답 사이에 위치하여, 그 사이에서 발생하는 작업을 처리하는 컴포넌트입니다. Django의 미들웨어는 HTTP 요청 및 응답에 대한 기능을 추가하거나 수정할 수 있도록 해줍니다.

미들웨어 개발

Django에서 미들웨어를 개발하기 위해서는 MiddlewareMixin 클래스를 상속받아야 합니다. 또한, 미들웨어에 적용하고자 하는 로직을 process_request, process_response 등의 메소드로 구현해야 합니다.

from django.utils.deprecation import MiddlewareMixin

class MyMiddleware(MiddlewareMixin):
    def process_request(self, request):
        """
        HTTP 요청 처리 전 호출됩니다.
        """
        # request 로직을 처리하는 코드 작성

    def process_response(self, request, response):
        """
        HTTP 응답 처리 후 호출됩니다.
        """
        # response 로직을 처리하는 코드 작성
        return response

미들웨어 활용

미들웨어를 활용하면 Django 애플리케이션에서 다양한 작업을 수행할 수 있습니다. 미들웨어를 사용하여 세션 관리, 인증, 로깅, 캐싱 등을 구현할 수 있습니다.

예를 들어, 다음은 사용자가 인증되지 않았을 때 로그인 페이지로 리다이렉트하는 미들웨어의 예시입니다.

from django.shortcuts import redirect

class AuthMiddleware(MiddlewareMixin):
    def process_request(self, request):
        if not request.user.is_authenticated:
            return redirect('login')

또 다른 예로는 로깅 미들웨어를 만들어보겠습니다. 이 미들웨어는 각각의 요청에 대해 로깅을 수행합니다.

import logging

class LogMiddleware(MiddlewareMixin):
    def process_request(self, request):
        logger.info("Received request for: " + request.path)

    def process_response(self, request, response):
        logger.info("Returning response with status code: " + str(response.status_code))
        return response

미들웨어 등록

미들웨어를 사용하기 위해서는 Django 애플리케이션 설정 파일인 settings.py에서 MIDDLEWARE 리스트에 미들웨어 클래스 이름을 등록해야 합니다. 미들웨어는 등록된 순서대로 실행됩니다.

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'myapp.middleware.MyMiddleware',
]

위의 예시에서 myapp.middleware.MyMiddleware는 원하는 미들웨어의 위치에 맞게 등록해야 합니다.

마무리

Django의 미들웨어를 활용하면 애플리케이션에 원하는 기능을 쉽게 추가할 수 있습니다. 특히 인증, 세션 관리, 로깅 등의 작업을 미들웨어로 처리하면 코드의 중복을 피하고, 모듈화된 구조를 갖출 수 있습니다. 개발환경에 맞춰 유연하고 확장 가능한 Django 애플리케이션을 만들기 위해, 미들웨어를 적절하게 활용하시기 바랍니다.