| ページ一覧 | ブログ | twitter |  書式 | 書式(表) |

MyMemoWiki

Django 最初のアプリケーション 3

提供: MyMemoWiki
2020年2月16日 (日) 04:24時点におけるPiroto (トーク | 投稿記録)による版
(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
ナビゲーションに移動 検索に移動

Django 最初のアプリケーション 3 (Viewの作成)

[Django][Python][[Django 最初のアプリケーション 4]|[前|Django 最初のアプリケーション 2]]][[[次]]

Pythonの概要も分かり易い.

を参考にサンプルアプリケーションを作成してみる

方針

<blockquote>Djangoアプリケーションにて、ビューは、Webページの『型』であり、特定の機能や、テンプレートを提供する。</blockquote>

たとえば、ブログアプリケーションでは以下のようなビュー。
  • ホームページ - 最新の2、3のエントリを表示
  • エントリの詳細ページ - あるエントリへのパーマリンク
  • 年別アーカイブページ - ある年のエントリを月別表示
  • 月別アーカイブページ - ある月のエントリを日別表示
  • 日別アーカイブページ - ある日のエントリを表示
  • コメントページ - エントリへのコメント
サンプルとして作成している Poll アプリケーションでは、以下の4つのビューを持たせる
  • アーカイブページ - 最新の2、3の調査を表示
  • 詳細ページ - 調査の質問を表示。結果は表示せず、投票フォームを表示
  • 結果ページ - 調査結果のページ特定の調査についての結果
  • 投票ページ - 特定の調査に対する投票を選択する

<blockquote>Djangoではビューをシンプルな Pythonの関数で表現する</blockquote>

URLの設計

URLの構造を設計

  • 最初に、URLの構造を設計する
  • これには、URLconfから呼び出される、Pythonのモジュールを作成する
  • URLconfは、DjangoがURLとPythonコードを結びつける
  • Djangoで作成されたページにアクセスすると、システムは ROOT_URLCONF設定を探す
  • ROOT_URLCONFはPythonのドット区切り文法で記述された文字列
  • Djangoはこのモジュールをロードし、呼び出されたURLパターンで、モジュールレベル変数を探す
  • URLパターンは、以下の書式のタプル
(正規表現, Python コールバック関数 [, オプションのディクショナリ])
  • Djangoは、最初に正規表現が一致するまでリストを下っていく
  • 一致するものが見つかったら、Djangoは、HttpRequestオブジェクトを最初の引数として、キーワード引数として、正規表現から捕捉された値、オプションで任意のディクショナリ(タプルの3つ目の項目)を伴って、Pythonコールバック関数を呼び出す

オブジェクト詳細

urls.pyの編集

  • 最初のアプリケーション 1で、django-admin.py startproject mysite を実行したとき、mysite/urls.py にデフォルトの URLconfを作成している。
  • 自動的に、settings.pyファイルのROOT_URLCONF 設定 にて、そのファイルを指定している
ROOT_URLCONF = 'mysite.urls'
  • mysite/urls.pyを以下のように編集
from django.conf.urls.defaults import *

# Uncomment the next two lines to enable the admin:
from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns(,
    # Example:
    # (r'^mysite/', include('mysite.foo.urls')),
    (r'^polls/$', 'mysite.polls.views.index'),
    (r'^polls/(?P<poll_id>\d+)/$', 'mysite.polls.views.detail'),
    (r'^polls/(?P<poll_id>\d+)/results/$', 'mysite.polls.views.results'),
    (r'^polls/(?P<poll_id>\d+)/vote/$', 'mysite.polls.views.vote'),    
    
    # Uncomment the admin/doc line below and add 'django.contrib.admindocs'
    # to INSTALLED_APPS to enable admin documentation:
    # (r'^admin/doc/', include('dhttp://typea.info/tips/wiki.cgi?action=EDIT&page=Django+%BA%C7%BD%E9%A4%CE%A5%A2%A5%D7%A5%EA%A5%B1%A1%BC%A5%B7%A5%E7%A5%F3+3&artno=2jango.contrib.admindocs.urls')),

    # Uncomment the next line to enable the admin:
    (r'^admin/(.*)', admin.site.root),
)

リクエストパラメータの解析

上記の例では、"/polls/23/"というリクエストがあった場合、DjangoはPythonモジュールをロードする。これは、r'^polls/(?P<poll_id>\d+)/$' にマッチするためであり、 mysite/polls/views.py.からdetail()関数が以下のように呼び出される。

detail(request=<HttpRequest object>, poll_id='23')
  • poll_id='23' の部分は、(?P<poll_id>\d+)から来ている
  • 丸括弧でパターンをを囲うことにより、テキストの一致を『捕捉』しビュー関数に引数として送信する。
  • ?P<poll_id> がパターンにマッチした場合の名称を定義している。
  • \d+ は正規表現で数字の連続

最初のビュー

ViewDoesNotExistエラー

  • まだ、ビューを作成していないので、http://192.168.24.14:8080/polls/ にアクセスしても、以下のようにViewDoesNotExistエラーが表示される

0372 django firstapp24.jpg

  • これは、index() 関数を mysite/polls/views.py. に実装していないため。

シンプルビューの実装

  • mysite/polls/views.py に以下を記述してみる
from django.http import HttpResponse

def index(request):
        return HttpResponse("Hello, world. You're at the poll index.")
                                                                       

0373 django firstapp25.jpg テキストを出力するシンプルなビューが作成された

引数を取るビューの実装

def detail(request, poll_id):
       return HttpResponse("You're looking at poll %s." % poll_id)

0374 django firstapp26.jpg URLに入力したパラメータを取得できている

実際になにかするビュー

簡単なビューの作成

  • ビューは次の2つのうちどちらかを行う責任がある。
    • リクエストされたページのコンテンツを含んだHttpResponseオブジェクトを返す
    • Http404のようなエラーを返す
  • 先ほどの例で、HttpResponseにメッセージを直接与えたように、Pollの最新の5件を出力するようにハードコーディングしてしまうと、ページの見た目を変えるためにPythonのコードに手を加えなければいけなくなってしまう。Pythonからデザインを分離するために、テンプレートを使用する。
  • 以下のコードはpolls/index.htmlテンプレートをロードし、Contextというテンプレート変数名とPythonオブジェクトのディクショナリを引き渡す
from django.template import Context, loader
from mysite.polls.models import Poll
from django.http import HttpResponse

def index(request):
        latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]
        t = loader.get_template('polls/index.html')
        c = Context({
             'latest_poll_list': latest_poll_list        
        })        
        return HttpResponse(t.render(c))
  • ページをリロードするとテンプレートがまだないため、以下のようなエラーとなる
TemplateDoesNotExist at /polls/
polls/index.html
  • 最初のアプリケーション 2でsetting.pyに指定したTEMPLATE_DIRS のディレクトリ以下に、pollsディレクトリを作成し、index.htmlファイルを作成する
  • loader.get_template('polls/index.html') は、"[テンプレートディレクトリ]/polls/index.html"をファイルシステム上では指すようになる

index.html

{% if latest_poll_list %}
        <ul>
        {% for poll in latest_poll_list %}
                <li>テンプレート:Poll.question</li>
        {% endfor %}
        </ul>
{% else %}
        <p>No polls are available.</p>
{% endif %}

0375 django firstapp27.jpg

ショートカット : render_to_response()
  • テンプレートをロードするのによく使われる方法は、コンテキストとHttpResponseオブジェクトをテンプレートとともに詰めて返す。

書き直してみる

from django.shortcuts import render_to_response
from mysite.polls.models import Poll
 
def index(request):
        latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]          
        return render_to_response('polls/index.html',{'latest_poll_list': latest_poll_list})

上と同じ結果が得られる

404エラー

Poll詳細ビューを作成してみる

from django.http import Http404from mysite.polls.models import Poll
      :
def detail(request, poll_id):
        try:
                p = Poll.objects.get(pk=poll_id)
        except Poll.DoesNotExist:
                raise Http404
        return render_to_response('polls/detail.html', { 'poll': p })
  • Poll のIDが見つからない場合、HTTP 404エラーを返す
  • detail.htmlにとりあえず、以下の内容を記述
テンプレート:Poll
  • 存在するIDを指定

0376 django firstapp28.jpg

  • 存在しないIDを指定

0377 django firstapp29.jpg

ショートカット : get_object_or_404()
  • Djangoはこのような場合にもショートカットを提供
from django.shortcuts import render_to_response, get_object_or_404
from mysite.polls.models import Poll

def detail(request, poll_id):
        p = get_object_or_404(Poll, pk=poll_id)
        return render_to_response('polls/detail.html', { 'poll': p })
  • get_list_or_404()関数も、同様に動作する。get()の代わりに、filter()を利用することを除いて。リストが空の場合、404エラーを返す。

テンプレートシステムを利用する

  • detail()ビューは、次のような感じ
<h1>テンプレート:Poll.question</h1>
<ul>
{% for choice in poll.choice_set.all %}
        <li>テンプレート:Choice.choice</li>
{% endfor %}
</ul>

0378 django firstapp30.jpg

URLconfs

簡単にする

  • 各コールバック関数共通の、「mysite.polls.vews」をプレフィックスとして外だしできる
urlpatterns = patterns('mysite.polls.vews',
    (r'^polls/$', 'index'),
    (r'^polls/(?P<poll_id>\d+)/$', 'detail'),
    (r'^polls/(?P<poll_id>\d+)/results/$', 'results'),
    (r'^polls/(?P<poll_id>\d+)/vote/$', 'vote'),
)

分割する

  • Pollアプリケーションの可搬性を高める
  • 今までの、mysite/urls.py を mysite/polls/urls.py にコピー
mysite/urls.py
  • mysite/polls/urls.pyを取り込む
urlpatterns = patterns(,
    (r'^polls/', include('mysite.polls.urls')),
)
mysite/polls/urls.py
  • 正規表現から、polls/ を取り除く。
  • こうすることにより、/polls/から、ほかのURLへの移動も簡単になる
urlpatterns = patterns('mysite.polls.views',
    (r'^$', 'index'),
    (r'^(?P<poll_id>\d+)/$', 'detail'),
    (r'^(?P<poll_id>\d+)/results/$', 'results'),
    (r'^(?P<poll_id>\d+)/vote/$', 'vote'),
)

[[Django 最初のアプリケーション 4]|[前|Django 最初のアプリケーション 2]]][[[次]]