Django教程：第一个Django应用程序(3)

Django教程：第一个Django应用程序(3)

2013-10-08 磁针石

#承接软件自动化实施与培训等gtalk：ouyangchongwu#gmail.comqq 37391319

#博客:http://blog.csdn.net/oychw

#版权所有，转载刊登请来函联系

# 深圳测试自动化python项目接单群113938272深圳广州软件测试开发 6089740

#深圳湖南人业务户外群 66250781武冈洞口城步新宁乡情群49494279

#参考资料：https://docs.djangoproject.com/en/1.5/intro/tutorial01/

# http://django-chinese-docs.readthedocs.org/en/latest/intro/tutorial01.html

#本文的图片没有上传，完整的文档参见：python模块笔记：http://t.cn/z8ggk71

本节关注创建公共界面 –视图（views）。

哲学

在 Django 应用中，视图是一“类”具有特定功能和模板的网页。 例如，在博客应用中，你可能会有以下视图：

§  博客首页 – 显示最新发表的博客。

§  博客详细页面 – 单个博客的固定连接。

§  基于年份的归档页 – 显示指定年份所有月份的博客。

§  基于月份的归档页 – 显示指定月份所有日期的博客。

§  基于日期的归档页 –显示指定日期所有博客。

§  评论 – 为指定博客处理评论。

在我们的投票应用中，将有以下四个视图：

§  Poll“index” 页 – 显示最新投票。

§  Poll“detail” 页 – 显示投票，无投票结果，但是可以投票。

§  Poll“results” 页 – 显示指定的投票结果。

§  投票 – 处理投票。

在 Django 中，网页及其他内容是由视图展现。视图就是简单的 Python 函数（或方法）。Django 会通过检查URL（确切地说是域名之后的那部分 URL）来匹配一个视图。

URL 模式是URL的通用形式- 比如: /newsarchive/<year>/<month>/.

Django 通过‘URLconfs’把URL 模式 (正则表达式)映射到视图。本教程中介绍URLconfs 的基本指令，更多信息参见django.core.urlresolvers。

第一个视图

编辑polls/views.py：

from django.http importHttpResponse

defindex(request):

returnHttpResponse("Hello, world. You're at the poll index.")

然后配置URLconf 。在 polls 目录下创建一个名为 urls.py 的 URLconf 文档。

from django.conf.urls importpatterns,url

from polls importviews

urlpatterns=patterns('',

url(r'^$',views.index,name='index')

)

配置 mysite/urls.py 调用polls.urls：

fromdjango.conf.urls import patterns, include, url

fromdjango.contrib import admin

admin.autodiscover()

urlpatterns= patterns('',

url(r'^polls/', include('polls.urls')),

url(r'^admin/', include(admin.site.urls)),

)

启动开发服务器：python manage.py runserver 192.168.4.13:8000。访问：http://192.168.4.13:8000/polls/，将可以看到:Hello, world.You're at the poll index。

现在你在 URLconf 中配置了 index 视图。通过浏览器访问 http://localhost:8000/polls/ ，如同你在 index 视图中定义的一样，你将看到“Hello, world. You’re at the poll index.” 文字。

url() 两个必选参数： regex 和view， 两个可选参数：kwargs和name。

regex是regularexpression 的简写，这是字符串模式匹配的语法，在 Django 中就是url 模式。 Django 将请求的URL 从上至下依次匹配列表中的正则表达式，直到匹配为止。

注意这些正则表达式不会匹配 GET 和 POST 参数以及域名。 例如：针对请求http://www.example.com/myapp/，URLconf 将只查找 myapp/。而在http://www.example.com/myapp/?page=3 也是如此。

当 Django 匹配了正则表达式就会调用响应的view函数， HttpRequest作为第一个参数和正则表达式 “捕获” 值的作为其他参数。 如果是简单正则捕获，将按顺序位置传参数；如果是命名正则捕获，将按关键字传参数值。

kwargs任意关键字参数，可传一个字典至目标视图。

Name：给你的URL取名，让你在 其他地方尤其是模板中可以更方便地引用它，特别是在模板中。 这一强大的功能可允许你通过一个文件就可修改项目中的全局URL 模式。

更多视图

现在我们再增加一些有参数的视图:

defdetail(request, poll_id):

return HttpResponse("You're looking atpoll %s." % poll_id)

defresults(request, poll_id):

return HttpResponse("You're looking atthe results of poll %s." % poll_id)

defvote(request, poll_id):

return HttpResponse("You're voting onpoll %s." % poll_id)

添加对应的url映射:

fromdjango.conf.urls import patterns, url

frompolls import views

urlpatterns= patterns('',

# ex: /polls/

url(r'^$', views.index, name='index'),

# ex: /polls/5/

url(r'^(?P<poll_id>\d+)/$',views.detail, name='detail'),

# ex: /polls/5/results/

url(r'^(?P<poll_id>\d+)/results/$',views.results, name='results'),

# ex: /polls/5/vote/

url(r'^(?P<poll_id>\d+)/vote/$',views.vote, name='vote'),

)

在你的浏览器中访问 http://192.168.4.13:8000/polls/34/ 。将运行detail()方法并显示URL 中提供的ID 。/polls/34/results和/polls/34/vote/也有类似显示。

访问网站页面时，比如/polls/34/时，Django 会加载mysite.urls模块(settings中的ROOT_URLCONF = 'mysite.urls')，然后找到urlpatterns变量并依次匹配正则表达式。include()表示导入其他 URL配置。include()中的正则表达式没有$(字符串结尾的匹配符),尾部是一个反斜杠。当 Django 解析include()时，它截取匹配部分而把剩余的字符串交由子URLconf 作进一步处理。这样include()使 URLs 即插即用。

当用户访问 “/polls/34/”：

§  Django 匹配'^polls/'

§  Django 截取匹配文本polls/，发送34/ 到‘polls.urls’ URLconf ，后者匹配r'^(?P<poll_id>\d+)/$' 导致如下调用

detail(request=<HttpRequestobject>, poll_id='34')

添加些实际的功能

每个视图返回一个包含请求页面的内容HttpResponse对象或者抛出一个异常，例如 Http404。

视图可以选择是否读取数据库记录，是否使用Django或python第三方模板系统。视图可以生成PDF 文件，输出 XML ，创建 ZIP 文件等。可以使用任何 Python 库。

下面index视图显示系统中最新发布的 5 个调查问卷，以逗号分割并按发布日期排序：:

fromdjango.http import HttpResponse

from polls.modelsimport Poll

def index(request):

latest_poll_list = Poll.objects.order_by('-pub_date')[:5]

output = ','.join([p.question for p in latest_poll_list])

returnHttpResponse(output)

通过模板可以分离python和设计。

在polls目录下创建templates目录。Django 将会在那寻找模板。

Django 的TEMPLATE_LOADERS配置中查找模板的方法。 django.template.loaders.app_directories.Loader 就会在INSTALLED_APPS的templates子目录下查找模板。

在你刚创建的templates目录下，创建polls（防止不同应用有重名的模板）的目录，并在其中创建文件index.html。你的模板位于polls/templates/polls/index.html 。简写为polls/index.html就可。

{% iflatest_poll_list %}

<ul>

{% for poll in latest_poll_list %}

<li><a href="/polls/{{poll.id }}/">{{ poll.question }}</a></li>

{% endfor %}

</ul>

{% else%}

<p>No polls are available.</p>

{%endif %}

现在让我们在 index 视图中使用这个模板：

from django.http import HttpResponse

from django.template import Context, loader

from polls.models import Poll

def index(request):

    latest_poll_list = Poll.objects.order_by('-pub_date')[:5]

    template = loader.get_template('polls/index.html')

    context = Context({

        'latest_poll_list': latest_poll_list,

    })

    return HttpResponse(template.render(context))

代码将加载 polls/index.html 模板并传递 context。context是一个映射模板变量为Python 对象的字典。

在你的浏览器中加载 “/polls/” 页，你应该看到一个列表，包含了在教程 第1部分 中创建的 “What’sup” 调查。而链接指向 poll 的具体页面。

上述加载模板过程很常用，为此Django提供了快捷方式:render()，用于加载模板，填充上下文并返回一个含有模板渲染结果的HttpResponse对象。

from django.shortcuts import render

from polls.models import Poll

def index(request):

    latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]

    context = {'latest_poll_list': latest_poll_list}

    return render(request, 'polls/index.html', context)

render() 函数中第一个参数是 request 对象，第二个参数是一个模板名称，第三个是一个字典类型的可选参数。它将返回根据给定模板和上下文渲染的HttpResponse对象。

抛出 404 异常

显示具体投票的视图detail:

from django.http import Http404

# ...

def detail(request, poll_id):

    try:

        poll = Poll.objects.get(pk=poll_id)

    except Poll.DoesNotExist:

        raise Http404

    return render(request, 'polls/detail.html', {'poll': poll})

poll 的 ID 不存在，视图将抛出Http404异常。我们稍后讨论如何设置polls/detail.html模板，若是你想快速运行上面的例子，在模板文件中添加如下代码：

{{ poll }}

同样这也有个快捷方式。

from django.shortcuts import render, get_object_or_404

# ...

def detail(request, poll_id):

    poll = get_object_or_404(Poll, pk=poll_id)

    return render(request, 'polls/detail.html', {'poll': poll})

get_object_or_404()使用Django 模型作为第一个参数，还有一些任意数量的传递到模型管理器的get（）的关键字参数，若对象不存在时就抛出Http404异常。

为什么不在更高层自动捕获 ObjectDoesNotExist异常， 或者由模型 API 抛出 Http404异常？

因为那样会使模型层与视图层耦合在一起。保持松耦合Django 最重要的设计目标之一。一些耦合控制在 django.shortcuts 模块中介绍。

get_list_or_404()与get_object_or_404()类似– 不过执行的是 filter() 而不是 get() 。若返回的是空列表将抛出 Http404 异常。

编写404 ( 页面未找到 ) 视图

Django 载入特定的视图来处理 404 错误，根据你的 root URLconf (仅root URLconf)中设置的handler404变量来查找视图。

一般不需要编写 404 视图。若没有设置handler404，默认使用内置的django.views.defaults.page_not_found()视图。或者在你的模板目录根目录

编写一个 500 ( 服务器错误 ) 视图

类似的，你可以在 root URLconf 中定义 handler500 变量，在服务器发生错误时调用对应的视图。视图代码产生的运行时错误会发生服务器错误。

同样，在模板根目录下创建一个500.html模板并且添加些像“出错了”之类的内容。

使用模板系统

修改polls/detail.html :

<h1>{{ poll.question }}</h1>

<ul>

{% for choice in poll.choice_set.all %}

    <li>{{ choice.choice_text }}</li>

{% endfor %}

</ul>

模板系统使用了“变量.属性”的语法访问变量的属性值。 例如 {{ poll.question }} ， 首先 Django 对 poll 对象做字典查询。 失败之后尝试属性查询 – 在本例中属性查询成功了。 如果属性查询失败将尝试列表索引查询。

在{% for %}循环中有方法调用: poll.choice_set.all即Python 代码poll.choice_set.all(),它将返回一组可迭代的Choice对象。

更多模板的信息参见 templateguide 。

移除模板中硬编码的 URLS

polls/index.html中，polls/{{ poll.id }}等是硬编码：

<li><a href="/polls/{{ poll.id }}/">{{ poll.question }}</a></li>

可以在 url 配置中使用 {% url %} 模板标记来移除特定的 URL 路径依赖:

<li><a href="{% url 'detail' poll.id %}">{{ poll.question }}</a></li>

其原理就是在 polls.urls 模块中寻找指定的URL 定义。 你知道命名为 ‘detail’ 的 URL 就如下所示那样定义的一样：:

...

# 'name' 的值由 {% url %} 模板标记来引用

url(r'^(?P<poll_id>\d+)/$', views.detail, name='detail'),

...

如果你想将 polls 的 detail 视图的 URL 改成polls/specifics/12，那不需要在模板（或者模板集）中修改而只要在 polls/urls.py 修改:

...

# 新增 'specifics'

url(r'^specifics/(?P<poll_id>\d+)/$', views.detail, name='detail'),

...

URL命名空间：

如果多个应用都有名字为 detail的 视图，需要在 root URLconf 配置中添加命名空间。修改mysite/urls.py文件：

from django.conf.urls import patterns, include, url

from django.contrib import admin

admin.autodiscover()

urlpatterns = patterns('',

    url(r'^polls/', include('polls.urls', namespace="polls")),

    url(r'^admin/', include(admin.site.urls)),

)

修改polls/index.htm从:

<li><a href="{% url 'detail' poll.id %}">{{ poll.question }}</a></li>

为包含命名空间的 detail 视图:

<li><a href="{% url 'polls:detail' poll.id %}">{{ poll.question }}</a></li>