Django: URL 처리와 앱 구조화

01. Django URLs

URL dispatcher와 Variable Routing 등을 활용하여 Django의 강력한 URL 매핑 기능을 살펴보겠습니다.

URL Dispatcher

Django에서 URL dispatcher는 들어온 HTTP 요청을 특정 view로 전달하는 역할을 합니다. Django 공식 문서에서 URL dispatcher에 대한 자세한 내용을 확인할 수 있습니다: URL dispatcher

💡 Dispatcher란 무엇일까요?

• 요청을 어디로 보내 처리할지 정하는 역할을 합니다.
• Django에서 URL dispatcher는 요청을 특정 view 함수와 연결합니다.

Trailing Slash (/)

URL 뒤에 붙는 /는 Trailing Slash라고 불립니다. 이 슬래시는 디렉토리와 파일을 구분하는 데 사용됩니다:

• https://www.example.com/: 디렉토리로 인식
• https://www.example.com: 파일로 인식

Django는 기본적으로 Trailing Slash를 사용하는 방식(디렉토리 접근)을 채택하며, 이 옵션은 설정에서 변경할 수 있습니다.

예를 들어:

• users/로 들어오면 users로도 처리하도록 설정 가능
• 기본 설정으로 진행하는 것이 권장됩니다.

Variable Routing

Variable Routing은 URL 일부를 변수로 지정하여 동적으로 view에 값을 전달하는 기능입니다. 이를 통해 유저 이름에 따라 동적인 페이지를 쉽게 생성할 수 있습니다.

예시 코드

[urls.py]

from django.urls import path
from . import views

urlpatterns = [
    path("users/<str:username>/", views.profile),
]

[views.py]

def profile(request, username):
    context = {
        "username": username,
    }
    return render(request, "profile.html", context)

[profile.html]

{% extends "base.html" %}

{% block content %}
    <h1>{{ username }}’s Profile Page</h1>
    <div>
        <h2>Username: {{ username }}</h2>
    </div>
    <a href="/index/">Go to Home</a>
{% endblock content %}

Variable Routing의 작동 방식

• users/<str:username>/에서 <str:username>은 동적 변수로 사용됩니다.
• view 함수에서 username이라는 이름으로 값을 받아 이를 템플릿에 전달합니다.

URL 패턴과 변수 타입

Django의 URL 패턴에서 다양한 변수 타입을 사용할 수 있습니다:

• str: 기본값, 문자열 처리
• int: 정수 처리
• slug: URL-friendly 문자열 처리
• uuid: UUID 값 처리
• path: /를 포함한 경로 처리

실습: Variable Routing 구현하기

문제

• 유저 이름에 따라 동적인 프로필 페이지를 만들어보세요.
• URL: /users/<username>/
• 템플릿: profile.html 활용

정답 코드

[urls.py]

path("users/<str:username>/", views.profile),

[views.py]

def profile(request, username):
    context = {
        "username": username,
    }
    return render(request, "profile.html", context)

[profile.html]

{% extends "base.html" %}

{% block content %}
    <h1>{{ username }}’s Profile Page</h1>
    <div>
        <h2>Username: {{ username }}</h2>
    </div>
    <a href="/index/">Go to Home</a>
{% endblock content %}

정리

• URL dispatcher는 요청을 적절한 view로 라우팅합니다.
• Variable Routing을 활용하면 동적인 URL 처리가 가능해집니다.

02. Django Multiple Apps

하나의 Django 프로젝트에 여러 종류의 경로와 기능을 포함시키다 보면, 앱(App) 단위로 분리하여 관리하는 것이 더욱 효율적입니다. 여기서는 여러 앱으로 구성된 Django 프로젝트를 설정하고 관리하는 방법을 다룹니다.

App 생성하기

Django는 여러 개의 앱으로 나뉘어질 수 있습니다. 예를 들어, 사용자 관리 기능을 위한 users 앱을 만들어 보겠습니다.

명령어

python manage.py startapp users

이 명령어를 실행하면 users라는 새로운 앱 폴더가 생성됩니다.

URLs 분리하기

Django 프로젝트의 기본 설정에서는 모든 URL을 하나의 urls.py 파일에서 관리합니다. 하지만 앱 단위로 기능을 나누면 각 앱의 urls.py 파일로 URL 관리를 분리할 수 있습니다.

앱 폴더 내 URLs 파일 생성

users 폴더 안에 urls.py 파일을 새로 생성합니다.

# users/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path("", views.users),
    path("profile/<str:username>/", views.profile),
]

기본 URLs에 포함시키기

프로젝트의 urls.py 파일에서 include를 사용해 앱의 URLs 파일을 포함합니다.

# 프로젝트의 urls.py
from django.urls import path, include

urlpatterns = [
    path("users/", include("users.urls")),
]

💡 include를 통해 users/ 경로로 들어오는 요청은 모두 users/urls.py로 위임됩니다.

URL 흐름

다음은 URL 요청 처리의 흐름입니다:

1. users/profile/<username>/로 들어오는 요청은 프로젝트의 urls.py에서 users/ 패턴과 일치합니다.
2. 요청이 users/urls.py로 전달됩니다.
3. users/urls.py에서 profile/<username>/ 패턴과 일치하는 URL 패턴을 찾습니다.
4. views.profile 함수로 요청을 전달하여 처리합니다.

URL 패턴 정리하기

URL 구조 개선

만약 users/users/aiden처럼 중복된 URL 경로가 생성된다면, 이를 간결하게 수정할 수 있습니다.

# users/urls.py
path("", views.users),
path("profile/<str:username>/", views.profile),

뷰(Views) 옮기기

users 앱에 맞게 views를 정리합니다.

# users/views.py
def users(request):
    return render(request, "users/index.html")

def profile(request, username):
    context = {"username": username}
    return render(request, "users/profile.html", context)

템플릿 이동

users 앱 폴더 내에 templates 폴더를 생성하고, 템플릿 파일을 이동합니다.

users/
  templates/
    users/
      index.html
      profile.html

URL에 이름 붙이기

URL 하드코딩을 피하기 위해 각 URL에 이름을 부여할 수 있습니다. path 함수의 name 매개변수를 사용합니다.

# users/urls.py
urlpatterns = [
    path("", views.users, name="users_home"),
    path("profile/<str:username>/", views.profile, name="profile"),
]

템플릿에서 URL 이름을 참조하여 경로를 생성합니다:

<!-- index.html -->
<ul>
    <li><a href="{% url 'users_home' %}">Home</a></li>
    <li><a href="{% url 'profile' username='aiden' %}">Aiden's Profile</a></li>
</ul>

정리

Django 프로젝트에서 여러 앱으로 기능을 나누고, 각 앱의 URL과 뷰를 독립적으로 관리하는 방법을 살펴보았습니다.

• App 생성: 각 기능별로 새로운 앱을 생성
• URLs 분리: 앱 단위로 URLs 파일을 만들어 프로젝트의 urls.py에 포함
• 뷰와 템플릿 이동: 앱별 폴더 구조로 정리
• URL 이름 지정: 하드코딩을 방지하고 유지보수성을 높임