도움을 받을 수 있는 방법

이 튜토리얼을 수행하는 데 문제가 있는 경우 FAQ 섹션인 :doc:`Getting Help </faq/help>`으로 이동하십시오.

간단한 폼 쓰기¶

앞장의 투표 상세 템플릿(“polls/detail.html”)을 수정하여, 템플릿에 HTML<form> 요소를 포함시켜 봅시다.

<formaction="{%url'polls:vote'question.id%}"method="post">{%csrf_token%}<fieldset><legend><h1>{{question.question_text}}</h1></legend>{%iferror_message%}<p><strong>{{error_message}}</strong></p>{%endif%}{%forchoiceinquestion.choice_set.all%}<inputtype="radio"name="choice"id="choice{{forloop.counter}}"value="{{choice.id}}"><labelfor="choice{{forloop.counter}}">{{choice.choice_text}}</label><br>{%endfor%}</fieldset><inputtype="submit"value="Vote"></form>

간략하게 설명하면:

• 위의 템플릿은 각 질문 선택 항목에 대한 라디오 버튼을 표시합니다. 각 라디오 버튼의value는 연관된 질문 선택 항목의 ID입니다. 각 라디오 버튼의name은"choice"입니다. 즉, 누군가가 라디오 버튼 중 하나를 선택하여 폼을 제출하면, POST 데이터 인choice=#을 보낼 것입니다. 여기서 #은 선택한 항목의 ID입니다. 이것은 HTML 폼의 기본 개념입니다.
• 양식의action``을``{%url'polls:vote'question.id%}``로설정하고,``method="post"``로설정합니다.이양식을제출하는행위는데이터서버측을변화시키기때문에``method="post" (``method=”get”``과 반대로)를 사용하는 것은 매우 중요합니다. 데이터 서버측을 변경하는 양식을 만들 때마다``method=”post”``를 사용하십시오. 이 팁은 Django에만 국한된 것이 아니라 일반적인 좋은 웹 개발 관행입니다.
• forloop.counter 는for 태그가 반복을 한 횟수를 나타냅니다.
• POST 양식을 만들고 있기 때문에(데이터를 수정하는 효과가 있을 수 있음), 교차 사이트 요청 위조(Cross Site Request Forgeries)에 대해 걱정해야 합니다. 다행히도, 여러분은 너무 걱정하지 않아도 됩니다, 왜냐하면 Django는 그것으로부터 보호하는 유용한 시스템을 가지고 있기 때문입니다. 간단히 말하자면, 내부 URL을 대상으로 하는 모든 POST 양식은{%csrf_token%} 템플릿 태그를 사용해야 합니다.

이제 제출된 데이터를 처리하고 그 데이터로 무언가를 수행하는 Django 뷰를 작성하겠습니다.튜토리얼 3 에서 설문조사 어플리케이션을 위해 아래에 나와있는 코드를 포함하는 URLconf 를 만들었습니다:

path("<int:question_id>/vote/",views.vote,name="vote"),

또, 우리는vote() 함수를 가상으로 만들었습니다. 실제로 구현을 해봅시다.polls/views.py 에 다음을 추가합시다:

fromdjango.httpimportHttpResponse,HttpResponseRedirectfromdjango.shortcutsimportget_object_or_404,renderfromdjango.urlsimportreversefrom.modelsimportChoice,Question# ...defvote(request,question_id):question=get_object_or_404(Question,pk=question_id)try:selected_choice=question.choice_set.get(pk=request.POST["choice"])except(KeyError,Choice.DoesNotExist):# Redisplay the question voting form.returnrender(request,"polls/detail.html",{"question":question,"error_message":"You didn't select a choice.",},)else:selected_choice.votes+=1selected_choice.save()# Always return an HttpResponseRedirect after successfully dealing# with POST data. This prevents data from being posted twice if a# user hits the Back button.returnHttpResponseRedirect(reverse("polls:results",args=(question.id,)))

위 코드는 이 튜토리얼에서 아직 다루지 않은 몇 가지를 포함하고 있습니다:

• request.POST 는 키로 전송된 자료에 접근할 수 있도록 해주는 사전과 같은 객체입니다. 이 경우,request.POST['choice'] 는 선택된 설문의 ID를 문자열로 반환합니다.request.POST 의 값은 항상 문자열들입니다.

  Django는 같은 방법으로 GET 자료에 접근하기 위해request.GET 를 제공합니다 – 그러나 POST 요청을 통해서만 자료가 수정되게하기 위해서, 명시적으로 코드에request.POST 를 사용하고 있습니다.

• 만약 POST 자료에choice 가 없으면,request.POST['choice'] 는KeyError 가 일어납니다. 위의 코드는KeyError 를 체크하고, choice가 주어지지 않은 경우에는 에러 메시지와 함께 설문조사 폼을 다시보여줍니다.

• 설문지의 수가 증가한 이후에, 코드는 일반HttpResponse 가 아닌HttpResponseRedirect 를 반환하고,HttpResponseRedirect 는 하나의 인수를 받습니다: 그 인수는 사용자가 재전송될 URL 입니다. (이 경우에 우리가 URL을 어떻게 구성하는지 다음 항목을 보세요).

  위의 Python 주석에서 지적한 바와 같이 POST 데이터를 성공적으로 처리 한 후에는 항상HttpResponseRedirect 를 반환해야 합니다. 이 팁은 Django에만 국한된 것이 아니라 일반적으로 좋은 웹 개발 관행입니다.

• 우리는 이 예제에서HttpResponseRedirect 생성자 안에서reverse() 함수를 사용하고 있습니다. 이 함수는 뷰 함수에서 URL을 하드코딩하지 않도록 도와줍니다. 제어를 전달하기 원하는 뷰의 이름을, URL패턴의 변수부분을 조합해서 해당 뷰를 가리킵니다. 여기서 우리는튜토리얼 3장에서 설정했던 URLconf를 사용하였으며, 이reverse() 호출은 아래와 같은 문자열을 반환할 것입니다.

  "/polls/3/results/"

  여기서3 은question.id 값입니다. 이렇게 리디렉션된 URL은 최종 페이지를 표시하기 위해'results' 뷰를 호출합니다.

튜토리얼 3장에서 언급했듯이,request 는HttpRequest 개체입니다.HttpRequest 개체에 대해 더 알고 싶다면request와 response 문서를 참고하세요.

어떤 이가 설문조사에 설문을 하고난 뒤에는,vote() 뷰는 설문조사 결과 페이지로 리다이렉트합니다. 그 뷰를 작성해봅시다:

fromdjango.shortcutsimportget_object_or_404,renderdefresults(request,question_id):question=get_object_or_404(Question,pk=question_id)returnrender(request,"polls/results.html",{"question":question})

튜토리얼 3장의detail() 뷰와 거의 동일합니다. 템플릿 이름만 다릅니다. 나중에 이 중복을 수정할 겁니다.

이제,polls/results.html 템플릿을 만듭니다.

<h1>{{question.question_text}}</h1><ul>{%forchoiceinquestion.choice_set.all%}<li>{{choice.choice_text}} --{{choice.votes}} vote{{choice.votes|pluralize}}</li>{%endfor%}</ul><ahref="{%url'polls:detail'question.id%}">Vote again?</a>

이제, 웹 브라우저에서/polls/1/ 페이지로 가서, 투표를 해보세요. 당신이 투표를 할 때마다 값이 반영된 결과 페이지를 볼 수 있을 것입니다. 만약 당신이 설문지를 선택하지 않고 폼을 전송했다면, 오류 메시지를 보게 될 것입니다.

제너릭 뷰 사용하기: 적은 코드가 더 좋습니다.¶

detail() (fromTutorial 3)과results()``의view들은매우간단하며,위에서언급한바와같이중복됩니다.여론조사목록을보여주는``index() view도 비슷합니다.

이러한 보기는 URL에 전달된 매개 변수에 따라 데이터베이스에서 데이터를 가져오고, 템플릿을 로드하고, 렌더링된 템플릿을 반환하는 기본 웹 개발의 일반적인 경우를 나타냅니다. 이것이 매우 흔하기 때문에, Django는 “generic views” 시스템이라고 불리는 단축키를 제공합니다.

Generic views abstract common patterns to the point where you don’t even need towrite Python code to write an app. For example, theListView andDetailView generic viewsabstract the concepts of “display a list of objects” and“display a detail page for a particular type of object” respectively.

우리 설문조사 애플리케이션을 제너릭 뷰 시스템으로 변환해서 우리의 코드를 많이 삭제하도록 합시다. 이러한 전환을 하려면 다음과 같은 몇 가지 단계만 거치면 됩니다:

1. URLconf를 변환하십시오.
2. 불필요한 오래된보기 중 일부를 삭제하십시오.
3. Django의 제너릭 뷰를 기반으로 새로운 뷰를 도입하십시오.

자세한 내용은 계속 읽어 나가십시오.

fromdjango.urlsimportpathfrom.importviewsapp_name="polls"urlpatterns=[path("",views.IndexView.as_view(),name="index"),path("<int:pk>/",views.DetailView.as_view(),name="detail"),path("<int:pk>/results/",views.ResultsView.as_view(),name="results"),path("<int:question_id>/vote/",views.vote,name="vote"),]

fromdjango.httpimportHttpResponseRedirectfromdjango.shortcutsimportget_object_or_404,renderfromdjango.urlsimportreversefromdjango.viewsimportgenericfrom.modelsimportChoice,QuestionclassIndexView(generic.ListView):template_name="polls/index.html"context_object_name="latest_question_list"defget_queryset(self):"""Return the last five published questions."""returnQuestion.objects.order_by("-pub_date")[:5]classDetailView(generic.DetailView):model=Questiontemplate_name="polls/detail.html"classResultsView(generic.DetailView):model=Questiontemplate_name="polls/results.html"defvote(request,question_id):...# same as above, no changes needed.