Django: MTV 패턴을 활용한 CRUD 기능 구현하기

Django는 MTV(Model-Template-View) 구조를 따르는 웹 프레임워크로, 이 구조를 활용해 프로젝트를 작성해보겠습니다. 이번 글에서는 CRUD(Create, Read, Update, Delete) 기능을 구현하며 Django의 핵심 요소를 익히는 과정을 다룹니다.

프로젝트 설정 및 준비

1. 기본 URL 설정

articles 앱의 urls.py 파일에 아래와 같은 URL 패턴을 추가합니다:

from django.urls import path
from . import views

urlpatterns = [
    path("", views.articles, name="articles"),
    path("new/", views.new, name="new"),
    path("create/", views.create, name="create"),
]

2. 템플릿 기본 설정

articles 앱에서 사용할 템플릿을 생성합니다. articles/templates 디렉토리에 HTML 파일을 작성합니다.

• articles.html:

{% extends 'base.html' %}

{% block content %}
    <h1>Articles</h1>
    <ul>
        {% for article in articles %}
            <li>
                <div>글 번호: {{ article.id }}</div>
                <div>글 제목: {{ article.title }}</div>
                <div>글 내용: {{ article.content }}</div>
                <br>
            </li>
        {% endfor %}
    </ul>
{% endblock content %}

• new.html:

{% extends 'base.html' %}

{% block content %}
<h1>New Article</h1>
<form action="{% url 'create' %}" method="POST">
    {% csrf_token %}
    <label for="title">제목</label>
    <input type="text" name="title" id="title"><br><br>

    <label for="content">내용</label>
    <textarea name="content" id="content" cols="30" rows="10"></textarea><br><br>

    <button type="submit">저장</button>
</form>
{% endblock content %}

• create.html:

{% extends 'base.html' %}

{% block content %}
    <h1>'{{ article.title }}' 작성 완료</h1>
    <a href="{% url 'articles' %}">목록으로</a>
{% endblock content %}

기능 구현

1. Read: 모든 아티클 조회

articles 앱의 views.py 파일에 아래 코드를 작성하여 데이터베이스의 모든 아티클을 조회하고 템플릿으로 전달합니다:

from django.shortcuts import render
from .models import Article


def articles(request):
    articles = Article.objects.all()
    context = {
        "articles": articles,
    }
    return render(request, "articles.html", context)

2. Create: 새로운 아티클 작성

a. 입력 폼 페이지 사용자가 데이터를 입력할 수 있도록 new 뷰를 작성합니다:

def new(request):
    return render(request, "new.html")

b. 데이터 저장 로직 사용자가 입력한 데이터를 받아 데이터베이스에 저장합니다:

from django.shortcuts import render, redirect
from .models import Article


def create(request):
    if request.method == "POST":
        title = request.POST.get("title")
        content = request.POST.get("content")

        # 모델을 이용해 데이터 저장
        article = Article(title=title, content=content)
        article.save()

        # 저장 완료 후 생성된 데이터를 보여주는 페이지로 이동
        return render(request, "create.html", {"article": article})
    return redirect("new")

HTTP Method와 보안

GET vs POST

• GET:
  • 주로 리소스를 조회할 때 사용합니다.
  • 데이터는 URL에 포함되어 전송됩니다.
  • 데이터베이스의 변화를 초래하지 않습니다.
• POST:
  • 데이터를 생성하거나 수정할 때 사용합니다.
  • 데이터는 HTTP 요청의 BODY에 포함되어 전송됩니다.
  • 데이터베이스에 변화를 초래합니다.

CSRF Token

Django는 POST 요청을 보호하기 위해 CSRF(Cross-Site Request Forgery) 토큰을 제공합니다. new.html 템플릿에 {% csrf_token %}을 추가하면 CSRF 공격을 방지할 수 있습니다.

<form action="{% url 'create' %}" method="POST">
    {% csrf_token %}
    ...
</form>

최신 아티클 정렬하기

최신 데이터를 먼저 보여주기 위해 views.py에서 아래와 같이 데이터를 정렬합니다:

articles = Article.objects.all().order_by("-id")

상세 페이지 조회(Read)

URL 설정

articles/urls.py에 상세 페이지를 위한 URL 패턴을 추가합니다:

from django.urls import path
from . import views

urlpatterns = [
    path("", views.articles, name="articles"),
    path("<int:pk>/", views.article_detail, name="article_detail"),
    ...
]

뷰(View) 구현

특정 게시글의 상세 정보를 표시하는 뷰를 작성합니다:

from django.shortcuts import render, get_object_or_404
from .models import Article


def article_detail(request, pk):
    article = get_object_or_404(Article, pk=pk)
    context = {
        "article": article,
    }
    return render(request, "article_detail.html", context)

템플릿(Template) 작성

상세 페이지를 위한 HTML 파일을 작성합니다:

{% extends "base.html" %}

{% block content %}
    <h2>글 상세 페이지</h2>
    <p>제목: {{ article.title }}</p>
    <p>내용: {{ article.content }}</p>
    <p>작성일시: {{ article.created_at }}</p>
    <p>수정일시: {{ article.updated_at }}</p>

    <a href="{% url 'articles' %}">목록 보기</a>
{% endblock content %}

글 삭제(Delete)

URL 설정

삭제 기능을 위한 URL을 추가합니다:

path("<int:pk>/delete/", views.delete, name="delete"),

뷰(View) 구현

삭제 요청을 처리하는 뷰를 작성합니다. 삭제 요청은 반드시 POST 방식으로 처리해야 안전합니다:

from django.shortcuts import redirect

def delete(request, pk):
    article = get_object_or_404(Article, pk=pk)
    if request.method == "POST":
        article.delete()
        return redirect("articles")
    return redirect("article_detail", pk=article.pk)

템플릿(Template) 작성

삭제 버튼을 상세 페이지에 추가합니다:

<form action="{% url 'delete' article.pk %}" method="POST">
    {% csrf_token %}
    <button type="submit">글 삭제</button>
</form>

글 수정(Update)

URL 설정

수정을 위한 URL 패턴을 추가합니다:

path("<int:pk>/edit/", views.edit, name="edit"),
path("<int:pk>/update/", views.update, name="update"),

뷰(View) 구현

수정 폼 페이지 제공 기존 데이터를 폼에 미리 채워 보여주는 뷰를 작성합니다:

def edit(request, pk):
    article = get_object_or_404(Article, pk=pk)
    context = {
        "article": article,
    }
    return render(request, "edit.html", context)

수정 데이터 처리 수정된 데이터를 저장하는 뷰를 작성합니다:

def update(request, pk):
    article = get_object_or_404(Article, pk=pk)
    if request.method == "POST":
        article.title = request.POST.get("title")
        article.content = request.POST.get("content")
        article.save()
        return redirect("article_detail", pk=article.pk)
    return redirect("edit", pk=pk)

템플릿(Template) 작성

수정 폼 페이지를 위한 HTML 파일을 작성합니다:

{% extends "base.html" %}

{% block content %}
    <h1>글 수정</h1>
    <form action="{% url 'update' article.pk %}" method="POST">
        {% csrf_token %}
        <label for="title">제목</label>
        <input type="text" name="title" id="title" value="{{ article.title }}"><br><br>

        <label for="content">내용</label>
        <textarea name="content" id="content" cols="30" rows="10">{{ article.content }}</textarea><br><br>

        <button type="submit">저장</button>
    </form>
{% endblock content %}

상세 페이지에 수정 버튼을 추가합니다:

<a href="{% url 'edit' article.pk %}"><button>글 수정</button></a>

리다이렉션 사용하기

Django의 redirect 함수는 POST-Redirect-GET(PRG) 패턴을 구현하는 데 사용됩니다. 이 패턴은 POST 요청 후 데이터를 중복 전송하는 문제를 방지합니다. 예를 들어, 글 작성 후 상세 페이지로 리다이렉트하려면 다음과 같이 작성합니다:

def create(request):
    title = request.POST.get("title")
    content = request.POST.get("content")
    article = Article(title=title, content=content)
    article.save()
    return redirect("article_detail", pk=article.pk)