장고:글쓰기
장고! 웹 프레임워크! 틀:장고
개요
글쓰기 기능을 구현하기 위해 정리한 문서.
기본적으로 포스팅 기능이지만, 모델명을 Post로 하기엔 전송방식인 post와 혼동이 오곤 해서 question으로 구현한다.
url 작성
urls.py 안에 필요한 기능을 다 담아주어야 한다.
예컨대, 글을 쓴다면 만들기, 편집, 삭제기능을 만들어주어야 하기에 다음과 같이 기입한다.
(뷰의 설정이나, import방식에 따라 뷰를 불러오는 방식이 달라질 수 있다.)
| 일반적으로 코드를 짜는 경우 | 제네릭 뷰를 사용하는 경우 |
|---|---|
from django.urls import path
from . views #해당 앱의 뷰를 불러온다.
app_name = 'pool'
urlpatterns = [
path('question/', views.list, name='list'),#글의 리스트롤 보여주는 화면.
path('question/detail/<int:question_id>/', views.detail, name='detail'),#글의 내용을 보여주는 화면.
path('question/create/', views.create, name='create'),#글의 작성화면
path('question/modify/<int:question_id>/', views.modify, name='modify'),#글의 수정화면
path('question/delete/<int:question_id>/', views.delete, name='delete'),#글의 삭제화면
]
|
함수명을 바꾸어주어야 한다.
views.클래스뷰명.as_view()), 형태로. 클래스형 뷰임을 지정해주기 위해. |
#아직 함수를 짜주진 않았지만, 앞으로 만들 함수에 대해 연결해두자.
모델 작성
글에서 포함해야 할 것들이 있다. 작성자, 작성일자, 내용 등의 요소를 포함하여 모델을 작성한다.
/앱/models.py 안에 작성한다.
from django.contrib.auth.models import User
from django.db import models
class Question(models.Model):#세부내용은 필요에 따라..
author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='author_question')
subject = models.CharField(max_length=200)
content = models.TextField()
create_date = models.DateTimeField()
modify_date = models.DateTimeField(null=True, blank=True)
def __str__(self):#관리자페이지에 나타낼 객체 이름.
return self.subject#이 객체의 subject를 이름으로 쓰겠다는 의미.
관리자 기능에서 확인
모델이 제대로 작성되고, 글이 제대로 생성될 수 있는지 관리자기능에 등록한 후 작성해보자.
관리자 등록은 장고:관리자페이지 참조.
이상이 없으면 뷰 작성으로 넘어가자.
뷰, 탬플릿 작성
탬플릿과 연관이 깊으니, 같이 짜주자. 한 단계, 한 단계 차근차근 작동을 확인하며 넘어가자.
리스트 보기
| 일반적으로 코드를 짤 경우 | 제네릭뷰(클래스형 뷰)를 쓰는 경우 | |
|---|---|---|
| view 작성 | 전체 글을 본다.from django.shortcuts import render
from .models import * #모델을 불러온다.
def list(request):
question_list=Question.objects.order_by('-create_date') #만들어진 순서의 역순으로 정렬
context={'question_list':question_list, } #템플릿으로 보내줄 내용을 담는다.
return render(request, 'list.html', context) #list.html로 보낸다.
|
전체 글을 본다.from django.views import generic
from .models import Question
class ListView(generic.ListView):
def get_queryset(self):
return Question.objects.order_by('-create_date')
#템플릿 명이 명시적으로 지정되지 않은 경우에는 자동으로 모델명_list.html을 템플릿명으로 사용.
|
| template작성 | 경로에 맞게 해주면 되는데, 위 뷰의 경우엔 /앱이름/template/list.html 에 만들어준다.
만들어진 html파일의 body에 다음과 같이 넣어준다. 상황에 맞게 표를 만들든, 목차를 만들든 html을 짜면 될 터.{% if question_list %}
<ul>
{% for question in question_list %}
<li><a href="{% url 'pool:detail' question.id %}">{{question.subject}}</a></li>
{% endfor %}
</ul>
{% else %}
{% endif %}
|
템플릿 명이 명시적으로 지정되지 않은 경우에는 자동으로 모델명_list.html을 템플릿명으로 사용.
/앱이름/template/question_list.html 을 좌측과 같이 짜주면 된다.#따로 탬플릿 명을 명시하려면 다음의 변수를 get_queryset함수 안에 넣는다.
template='앱이름/list.html'
#탬플릿에 전달될 리스트 이름을 바꾸려면 get_queryset함수 안에 이 변수를 넣는다.
context_object_name='바꿀리스트명'
|
글 보기
리스트에서 글을 클릭하면 글의 상세내용을 볼 수 있어야 한다.
| 일반적으로 코드를 짤 경우 | 제네릭뷰(클래스형 뷰)를 쓰는 경우 | |
|---|---|---|
| view 작성 | 글 하나의 내용을 본다.
get_object_or_404를 쓴다. id에 해당하는 객체가 없으면 서버에서 에러를 일으키는데, 이는 서버에러로 잡힌다. 에러의 방향성을 명확히 지정해주기 위해. 404에러를 부르게끔!from django.shortcuts import render, get_object_or_404
from .models import * #모델을 불러온다.
def detail(request,question_id):#url에서 매핑된 question_id가 전달된다.
question=get_object_or_404(Question, pk=question_id)
context={'question':question}
return render(request, 'detail.html', context)
|
from django.views import generic
class DetailView(generic.DetailView):
model = Question
#템플릿 명이 명시적으로 지정되지 않은 경우에는 자동으로 모델명_detail.html을 템플릿명으로 사용
제네릭뷰에 경우, 변수명이 지정되어 있다. urls.py에서 <int:pk> 형태로 기입받는다. |
| template작성 | 경로에 맞게 해주면 되는데, 위 뷰의 경우엔 /앱이름/template/detail.html 에 만들어준다.
만들어진 html파일의 body에 다음과 같이 넣어준다. 상황에 맞게 표를 만들든, 목차를 만들든 html을 짜면 될 터. {{변수.속성}} 형태로 필요한 데이터를 가져온다.<h1>{{ question.subject }}</h1>
<div>
{{ question.content }}
</div>
|
제네릭 뷰를 쓸 땐 탬플릿에 모델이 object라는 이름으로 전달된다.
|
글 작성
장고에서 제공하는 form이 내부에서 어떻게 작동하는지 잘 보이지 않아 쓰지 않으려 했지만.. 자동으로 에러검사도 해주고 편리해 사용하지 않을 이유가 없어 form을 적극적으로 활용한다.
| 일반적으로 코드를 짤 경우 | 제네릭뷰(클래스형 뷰)를 쓰는 경우 | |
|---|---|---|
| template작성 | 위에서 만든 list.html을 수정한다. 글 작성을 위한 링크를 추가.<a href="{% url '앱이름:create' %}" class="btn btn-primary">등록</a>
| |
| form 작성 | 장고에선 form이라는 형태로 입력을 받을 수 있게 고안해두었다.
앱 디렉터리 안에 form.py 파일을 새로 작성한다. 모델과 연결된 모델폼을 사용한다.from django import forms
from .models import Question
class QuestionForm(forms.ModelForm):#모델폼 상속
class Meta:
model = Question#연결할 모델 지정
fields = ['subject', 'content']#모델의 어떤 부분을 입력할지 지정
|
|
| view 작성 | 글을 작성하기 위한 공간 만들기.
일반적으로 페이지를 불러오는 것과 데이터를 저장하는 데 같은 링크를 사용한다. 페이지 요청방식에 따라 달리 작동하게 하면 되는데, POST요청이면 데이터를 저장. (링크를 타고 오는 경우, GET 요청으로 들어온다.) 폼을 사용하는 경우.from .forms import QuestionForm#위에서 작성한 폼 불러오기
from ..models import Question #모델을 불러온다.
def create(request):
if request.method == 'POST':#포스트로 요청이 들어온다면... 글을 저장.
form = QuestionForm(request.POST) #폼을 불러와 내용입력을 받는다.
if form.is_valid():#내용이 모델에 맞지 않는 경우, 에러 반환.
question = form.save(commit=False)
#commit=False 옵션은 저장하지 않고 불러오기만 한다는 의미.
#question모델에서 create_date옵션이 null=False이기 때문에 그냥 저장하면 에러가 난다.
question.author = request.user # 추가한 속성 author 적용
question.create_date = timezone.now()#현재시간으로 자동 적용
question.save()
return redirect('pool:index') #작성이 끝나면 목록화면으로 보낸다.
else:#포스트 요청이 아니라면 내용작성 화면으로.
form = QuestionForm()
context = {'form': form}
#폼이 valid하지 않으면 이 안에 에러메시지가 담겨 create.html로 보내진다.
#어떤 부분이 모델에서의 제약과 맞지 않는지 친절하게 안내한다.
return render(request, 'create.html', context)
|
from django.views import generic
from django.urls import reverse_lazy
class create(generic.CreateView):
model = Question
feilds = ['필드명', '필드명',...]#작성할 필드명 지정
success_url=reverse_lazy('앱이름:detail')#작성에 성공한 경우 보낼 탬플릿.
template_name_suffix='_create'
#사용하는 탬플릿 명을 '모델명_create.html'로 바꾼다는 의미. 접미사만 바꾼다.
#기본 탬플릿은 '모델명_form.html'로 나타난다.
|
| template작성 | view에서 보내는 탬플릿을 작성한다.
폼을 사용하는 경우.{% extends '연장할탬플릿.html' %}
{% block content %}
<form method="post">
{% csrf_token %}
{{ form.as_p }}
<input type="submit" value='나타낼 텍스트'>
</form>
{% endblock %}
{{form.as_p}}는 폼으로부터 전달된 객체. 입력을 위한 코드를 자동으로 작성한다. 자동으로 <p>태그로 감싸준다. 자동으로 생성되기 때문에 CSS를 적용할 수 없는데... forms.py를 수정하면 가능하다. | |
글 수정
| 일반적으로 코드를 짤 경우 | 제네릭뷰(클래스형 뷰)를 쓰는 경우 | |
|---|---|---|
| template작성 | 위에서 만든 detail.html을 수정한다. 글 수정을 위한 링크를 추가.<a href="{% url '앱이름:modify' question.id%}" class="btn btn-primary">수정</a>
pk=question.id 형태로 넣어주어야 한다.
| |
| view 작성 | [여기 아직 수정 안함.]from .forms import QuestionForm#위에서 작성한 폼 불러오기
from ..models import Question #모델을 불러온다.
def create(request):
if request.method == 'POST':#포스트로 요청이 들어온다면... 글을 저장.
form = QuestionForm(request.POST) #폼을 불러와 내용입력을 받는다.
if form.is_valid():#내용이 모델에 맞지 않는 경우, 에러 반환.
question = form.save(commit=False)
#commit=False 옵션은 저장하지 않고 불러오기만 한다는 의미.
#question모델에서 create_date옵션이 null=False이기 때문에 그냥 저장하면 에러가 난다.
question.author = request.user # 추가한 속성 author 적용
question.create_date = timezone.now()#현재시간으로 자동 적용
question.save()
return redirect('pool:index') #작성이 끝나면 목록화면으로 보낸다.
else:#포스트 요청이 아니라면 내용작성 화면으로.
form = QuestionForm()
context = {'form': form}
#폼이 valid하지 않으면 이 안에 에러메시지가 담겨 create.html로 보내진다.
#어떤 부분이 모델에서의 제약과 맞지 않는지 친절하게 안내한다.
return render(request, 'create.html', context)
|
from django.views import generic
from django.urls import reverse_lazy
class create(generic.UpdateView):
model = Question
feilds = ['필드명', '필드명',...]#수정할 수 있는 필드명 지정
success_url=reverse_lazy('앱이름:modify')#작성에 성공한 경우 보낼 탬플릿.
template_name_suffix='_update'
#사용하는 탬플릿 명을 '모델명_update.html'로 바꾼다는 의미. 접미사만 바꾼다.
#기본 탬플릿은 '모델명_form.html'로 나타난다.
|
| template작성 | 글 작성에서 사용한 탬플릿에서 버튼 이름만 바꾼다.{% extends '연장할탬플릿.html' %}
{% block content %}
<form method="post">
{% csrf_token %}
{{ form.as_p }}
<input type="submit" value='나타낼 텍스트'>
</form>
{% endblock %}
| |
tip
뷰가 많아지면 /앱/views/posting_view.py 따위의 이름으로 뷰를 나누어 작성하는 것도 전략이다.