ビューを記述する¶
ビュー関数、つまり view は、単にWeb リクエストを受け取って Web レスポンスを返すPython 関数です。 このレスポンスは、WebページのHTMLコンテンツ、リダイレクトや404エラー、またはXMLドキュメントやイメージ、その他何にでもなり得ます (本当にそうなんです)。ビュー自体には、このレスポンスを返すために必要な、任意の論理が含まれます。 このコードは、Python パス上にあればどこでも好きな場所に置くことができます。それ以外の要件はありません – つまり “魔法” はないのです。 コードを どこかに 置くために、慣習ではプロジェクトやアプリケーションのディレクトリに置かれた views.py
というファイルにビューを記述します。
シンプルなビュー¶
以下は、HTML ドキュメントとして、現在の日付と時刻を返すビューです:
from django.http import HttpResponse
import datetime
def current_datetime(request):
now = datetime.datetime.now()
html = "<html><body>It is now %s.</body></html>" % now
return HttpResponse(html)
1 行ずつコードを見ていきましょう:
最初に、Python の
datetime
ライブラリ とともに、クラスHttpResponse
をdjango.http
モジュールからインポートします。次に、
current_datetime
という関数を定義します。これがビュー関数です。それぞれのビュー関数は、HttpRequest
のオブジェクトを第 1 引数として受け取り、一般的にはrequest
と名付けられます。ビュー関数の名前は重要ではありません; Django が識別するために特別な方法で名前を付ける必要はありません。ここでは、
current_datetime
という名前はその機能を的確に表しているので、ビュー関数をcurrent_datetime
と呼ぶことにします。このビューは、生成されたレスポンスを含む
HttpResponse
のオブジェクトを返します。それぞれのビュー関数には、HttpResponse
オブジェクトを返す義務があります。(例外もありますので、後で説明します。)
Django のタイムゾーン
Django は TIME_ZONE
設定を含んでおり、デフォルトは America/Chicago
です。これはあなたの住む場所ではないかもしれませんので、あなたの設定ファイルを変更する必要があるかもしれません。
URL をビューにマッピングする¶
要約すると、このビュー関数は現在の日付と時刻を含む HTML ページを返します。このビューを特定の URL で表示するには、URLconf を作成する必要があります。その方法は、URL dispatcher を参照してください。
エラーを返す¶
Django で HTTP エラーコードを返すのは簡単です。(“OK” を意味する) 200 以外の数ある一般的なHTTPステータスコード(* “OK” *を意味します)に対して、HttpResponse
サブクラスがあります。 使用可能なサブクラスの完全なリストは、request/response <ref-httpresponse-subclasses>`ドキュメントにあります。 エラーを知らせるためには、通常の :class:`~django.http.HttpResponse の代わりに、これらのサブクラスのインスタンスを単に返してください。例えば:
from django.http import HttpResponse, HttpResponseNotFound
def my_view(request):
# ...
if foo:
return HttpResponseNotFound('<h1>Page not found</h1>')
else:
return HttpResponse('<h1>Page was found</h1>')
レスポンスコードの多くは使用頻度が低いため、発生しうる HTTP レスポンスコードすべてにそれぞれ特化したサブクラスが用意されているわけではありません。 しかし、HttpResponse
のドキュメントに書かれているように、HTTP ステータスコードをコンストラクタに渡して、HttpResponse
が任意のステータスコードを返すクラスを作成することもできます。例えば:
from django.http import HttpResponse
def my_view(request):
# ...
# Return a "created" (201) response code.
return HttpResponse(status=201)
404 エラーは最も一般的な HTTP エラーなので、簡単に扱える方法があります。
Http404
例外¶
-
class
django.http.
Http404
¶
エラーを返すときは (例えば HttpResponseNotFound
)、エラーページを結果とする HTML を定義する責任があります:
return HttpResponseNotFound('<h1>Page not found</h1>')
利便性に加えて、サイト全体を通じて一貫性のある 404 ページを表示できるようにするため、Django は Http404
例外を提供しています。ビュー関数のあらゆる時点で Http404
が投げられたとき、Django はこれを捉えてアプリケーションに対して、HTTP エラーコード 404 とともに標準的なエラーページを返します。
使い方の例:
from django.http import Http404
from django.shortcuts import render
from polls.models import Poll
def detail(request, poll_id):
try:
p = Poll.objects.get(pk=poll_id)
except Poll.DoesNotExist:
raise Http404("Poll does not exist")
return render(request, 'polls/detail.html', {'poll': p})
Django が 404 を返したときに独自の HTML を表示したいときは、404.html` という名前の HTML テンプレートを作成し、テンプレートツリーのトップレベルの場所に置いてください。DEBUG
が False
にセットされているとき、このテンプレートが使われます。
DEBUG
が True
の場合、Http404
にメッセージを提供し、標準的な 404 デバッグテンプレートに表示させることができます。このメッセージ機能はデバッグ用に使用してください; 通常、プロダクトの404 テンプレートとしては不向きです。
エラービューをカスタマイズする¶
Django のデフォルトのエラービューは、ほとんどの Web アプリケーションで十分ですが、独自の動作が必要な場合は簡単にオーバーライドできます。 URLconf で以下のようにハンドラを指定するだけです (他の場所で設定しても効果はありません)。
page_not_found()
ビューは handler404
でオーバーライドされます:
handler404 = 'mysite.views.my_custom_page_not_found_view'
server_error()
ビューは handler500
でオーバーライドされます:
handler500 = 'mysite.views.my_custom_error_view'
permission_denied()
ビューは handler403
でオーバーライドされます:
handler403 = 'mysite.views.my_custom_permission_denied_view'
bad_request()
ビューは handler400
でオーバーライドされます:
handler400 = 'mysite.views.my_custom_bad_request_view'
参考
CSRF エラービューをオーバーライドするには、CSRF_FAILURE_VIEW
設定を使用してください。