准备
Copy python -m django --version
案例使用: Python 3.4 / Django 1.11.2
创建项目
Copy django-admin startproject mysite
这个步骤将在当前目录下创建mysite
目录。注意不要采用python或django内建的组件的名字,例如django
或test
之类保留字。
在Django中,不需要像PHP那样把代码保存在web服务器的document根目录(例如/var/www
),对于Django这不是一个好习惯,存在被别人查看web上代码的风险。要将代码存放在存放在document根目录之外,例如/home/mycode
。
以下是startproject
命令创建的mysite
目录内容
Copy mysite
├── manage.py* 命令行交互工具
└── mysite/
├── __init__.py 空文件,告知python这个目录是一个Python包
├── settings.py 设置文件
├── urls.py url声明,也就是django网站的内容列表
└── wsgi.py WSGI兼容的web服务
创建项目
验证Django项目工作,进入mysite
目录,然后执行
Copy python manage.py runserver
此时看到输出
Copy Performing system checks...
System check identified no issues (0 silenced).
You have 13 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
June 23, 2017 - 02:42:58
Django version 1.11.2, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
注意
:默认开发环境django运行监听在127.0.0.1:8000
,所以外部不能直接访问。
可以通过django参数来指定端口以及监听的IP地址
例如,监听端口改成8080
Copy python manage.py runserver 8080
监听所有网络接口的8000端口
Copy python manage.py runserver 0:8000
注意:在CentOS 7上默认开启了firewall防火墙,要能够让外部访问,需要执行如下命令
Copy sudo firewall-cmd --zone=public --add-port=8000/tcp --permanent
sudo firewall-cmd --reload
此时在浏览器上访问 http://SERVER_IP:8000 可以看到Django页面,但是,如果是从外部访问,django有一个安全限制,会在页面提示所访问的http头部中包含的主机IP地址不在允许范围(默认只允许127.0.0.1回环地址访问):
Copy DisallowedHost at /
Invalid HTTP_HOST header: '192.168.1.156:8000'. You may need to add '192.168.1.156' to ALLOWED_HOSTS.
Request Method: GET
Request URL: http://192.168.1.156:8000/
Django Version: 1.11.2
Exception Type: DisallowedHost
Exception Value:
Invalid HTTP_HOST header: '192.168.1.156:8000'. You may need to add '192.168.1.156' to ALLOWED_HOSTS.
参考 Invalid http_host header ,修改 setting.py
配置文件,设置
Copy ALLOWED_HOSTS = [ '192.168.1.156' , 'localhost' , '127.0.0.1' ]
如果是放宽所有服务器可以设置ALLOWED_HOSTS = ['*']
创建polls应用
以上是创建了mysite
项目,接下来需要在项目中创建应用:每个应用就是按照一系列约定编写的python包。Django有一个工具可以自动生成app的基本目录结构,这样就可以聚焦在编写代码而不是创建目录。
projects vs. apps
app是一个web应用可以完成一定工作,例如weblog,数据库记录,投票系统等。project则是一组配置和apps用于构建website。一个project可以包含多个apps,而一个app可以属于多个projects。
Copy python manage.py startapp polls
此时在项目目录下创建按了polls
子目录
Copy polls/
├── admin.py
├── apps.py
├── __init__.py
├── migrations/
│ └── __init__.py
├── models.py
├── tests.py
└── views.py
Copy from django.http import HttpResponse
def index(request):
return HttpResponse("Hello, world. You're at the polls index.")
注意:必须from django.http import HttpResponse
之后才能使用return HttpResponse("...")
Copy from django . conf . urls import url
from . import views
urlpatterns = [
url ( r ' ^$ ' , views.index, name = 'index' ),
]
然后在根上指出root URL在polls.urls
模块,所以在mysite/urls.py
添加
注意:这里mysite/urls.py
是在项目目录下默认就建立的一个子目录,也就是默认就有一个app代表网站自身。其中已经有了一个urls.py
文件,默认就包含了url(r'^admin/', admin.site.urls),
Copy from django . conf . urls import include , url
from django . contrib import admin
urlpatterns = [
url ( r ' ^ polls/' , include ( 'polls.urls' )),
url ( r ' ^ admin/' , admin.site.urls),
]
必须先from django.conf.urls import include
才能使用include('polls.urls')
,这样就可以把部分url引用放到各自目录下。
url()
功能可以传递4个参数,有两个参数regex
和view
是必须的,另外两个kwargs
和name
是可选的。
regex
是"规则表达式"(regular expression)的缩写。注意,这些规则表达式不会搜索GET
和POST
参数,或者域名。例如,请求 https://www.example.com/myapp/ ,则URLconf
将看到myapp/
,并且请求 https://www.example.com/myapp/?page=3 ,此时URL依然只看到 myapp/
。
规则表达式应该在首次URLconf模块加载时编译以确保性能。
当Django找寻匹配的正则表达式,就会请求特定视图功能,使用一个HttpRequest
对象作为第一个参数,并且任何在正则表达式"捕捉到"的值就作为参数。如果regex使用简单捕捉,值就作为位置参数。如果使用命名的捕捉,值就作为一个关键值参数传递。
抽象关键词参数将作为一个字典传递给目标视图。
命名你所使用的URL就可以作为一个明确的引用在Django任何位置使用,特别是在模板中。这个强大的功能使得你可以创建全局变更到URL参数给项目,只需要访问一个单一文件。
数据库设置
编辑mysite/settings.py
,这是一个使用模块层变量表达Django设置的Python模块。默认使用SQLite,如果是生产环境,则可以使用更具扩展性的数据库,如PostgreSQL。
如果使用其他数据库,需要安装相应的database bindings 并修改配置文件
修改mysite/settings.py
,其中DATABASES配置中的ENGINE
设置成相应的数据库类型,如'django.db.backends.postgresql', 'django.db.backends.mysql'
Copy # Database
# https://docs.djangoproject.com/en/1.11/ref/settings/#databases
DATABASES = {
'default' : {
'ENGINE' : 'django.db.backends.sqlite3' ,
'NAME' : os . path . join (BASE_DIR, 'db.sqlite3' ),
}
}
如果不使用SQLite,需要配置增加USER
,PASSWORD
和HOST
参数。
settings.py
中其他设置
激活的Django apps - INSTALLED_APPS
这些应用默认包含了一个共用案例的便利转换。一些应用使用至少一个数据库表,所以需要在使用它们之前先创建数据库表。这个工作通过以下命令完成:
Copy python manage.py migrate
这个migrate
命令会检查INSTALLED_APPS
设置并根据misite/settings.py
创建任何需要的数据库表以及和应用程序一起发布的数据库迁移。可以通过数据库管理来查看上述命令创建的表格。
创建模式
现在需要定义模式 - 也就是使用附加的元数据来定义数据库结构。
这个简单的投票程序,创建2个models:Question
和Choice
: Question
是一个问题并且有一个发布时间;Choice
则有两个字段:选择文本和一个投票记录。每个Choice
和一个Question
关联。
这些概念是通过简单的Python classes。编辑pools/models.py
Copy from django . db import models
# Create your models here.
class Question ( models . Model ):
question_text = models . CharField (max_length = 200 )
pub_date = models . DateTimeField ( 'date published' )
class Choice ( models . Model ):
question = models . ForeignKey (Question, on_delete = models.CASCADE)
choice_text = models . CharField (max_length = 200 )
votes = models . IntegerField (default = 0 )
每个model都是通过django.db.models.Model 的子类来表述class。每个模块有一系列类变量,也就是在模式中表示数据库字段。
每个字段都通过一个Field 类的实例来表述 - 例如,CharField 是字符字段,而DateTimeField 是日期字段。这样就可以告知Django每个数据字段的类型。
每个字段 实例的名字(例如question_text
或pub_date
)是字段的名字,使用机器友好的格式。在Python代码中可以使用这些值,并且数据库将它们作为列名字。
一些字段有附加参数,例如CharField 需要设置max_length 。这个参数限制只作用于数据库schema。
注意,上述定义使用了ForeignKey 告知Django每个Choice是和一个Question关联的。Django支持所有常用数据库关系:many-to-one, many-to-many, one-to-one。
激活模式
模式的少量代码可以赋予Django大量的西溪,这样Django可以:
为应用程序创建一个数据库schema(CREATE TABLE
声明)
创建一个Python数据库访问API来访问Question
和Choice
对象
目前需要首先告诉项目,polls
应用已安装好。
Django apps 是热插拔
(pluggable),可以将一个app用于多个项目,然后可以分发apps,因为app在Django安装是并没有附加。
要将应用添加到项目,需要在INSTALLED_APPS
设置中加上一个引用配置类。这里的polls/apps.py
文件中有一个PollsConfig
类,所以其点路径是polls.apps.PollsConfig
。编辑mysite/settings.py
文件添加点路径到INSTALLED_APPS
设置中。
Copy # Application definition
INSTALLED_APPS = [
'polls.apps.PollsConfig' ,
'django.contrib.admin' ,
'django.contrib.auth' ,
'django.contrib.contenttypes' ,
'django.contrib.sessions' ,
'django.contrib.messages' ,
'django.contrib.staticfiles' ,
]
此时Django就知道包含polls
这个app,执行以下命令
Copy python manage.py makemigrations polls
就会看到如下输出信息:
Copy Migrations for 'polls':
polls/migrations/0001_initial.py
- Create model Choice
- Create model Question
- Add field question to choice
这里使用makemigrations
是告知Django作出了模式修改,并希望作为一个migration来将更改存储。
migration是Django存储修改到模式中(然后是数据库schema)- 也就是磁盘中的文件。要查看刚才创建polls
的新模型可以查看polls/migrations/0001_initial.py
。
运行migration来管理数据库schema的操作,通过sqlmigrate 来获取migration名字和返回SQL:
Copy python manage.py sqlmigrate polls 0001
此时可以看到以下输出
Copy BEGIN ;
--
-- Create model Choice
--
CREATE TABLE " polls_choice " ( "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "choice_text" varchar ( 200 ) NOT NULL , "votes" integer NOT NULL );
--
-- Create model Question
--
CREATE TABLE " polls_question " ( "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "question_text" varchar ( 200 ) NOT NULL , "pub_date" datetime NOT NULL );
--
-- Add field question to choice
--
ALTER TABLE "polls_choice" RENAME TO "polls_choice__old" ;
CREATE TABLE " polls_choice " ( "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "choice_text" varchar ( 200 ) NOT NULL , "votes" integer NOT NULL , "question_id" integer NOT NULL REFERENCES "polls_question" ( "id" ));
INSERT INTO "polls_choice" ( "votes" , "id" , "choice_text" , "question_id" ) SELECT "votes" , "id" , "choice_text" , NULL FROM "polls_choice__old" ;
DROP TABLE "polls_choice__old" ;
CREATE INDEX " polls_choice_question_id_c5b4b260 " ON "polls_choice" ( "question_id" );
COMMIT ;
这里sqlmigrate
命令并没有实际migrate数据库,而只是打印输出到屏幕,这样可以查看SQL Django会执行的操作,对于检查Django将要做的操作非常有用,特别是作为数据库管理员还可以修改SQL脚本。
如果感兴趣,还可以运行 python manage.py check
来检查项目的问题,而不会实际做修改。
现在可以运行migrate
来创建数据库的模式表格:
Copy python manage.py migrate
简单来说,实现模式修改需要3个步骤:
运行python manage.py makemigrations
来创建这些修改的migrations
运行python manage.py migrate
将这些修改作用到数据库
有关详细的manage.py
工具使用信息参考django-admin documentation
使用API
可以通过交互的Python shell来使用Django API:
Copy python manage.py shell
这里使用manage.py
而不是直接python
是因为可以设置DJANGO_SETTINGS_MODULE
环境变量,这是通过mysite/settings.py
文件中导入的路径
如果不是使用manage.py
则需要使用以下命令来设置:
Copy import django
djiango . setup ()
一旦进入shell,可以使用database API
Copy >>> from polls . models import Question , Choice # 这里导入模式中的类
>>> Question . objects . all () # 由于尚未添加数据库记录,所以Question中是空的
< QuerySet [] >
Copy # 创建一个新问题
# 在默认设置文件已经激活time zone,所以Django希望使用tzinfo的datetime来填写pub_date
# 使用 timezone.now() 来代替 datetime.datetime.now() 就能正确完成
>>> from django . utils import timezone
>>> q = Question (question_text = "What's new?" , pub_date = timezone. now ())
# 保存对象到数据库,使用 save()
>>> q . save ()
# 现在已经保存了一个Question数据记录,也就是有一个id,可以使用以下命令显示
# 注意:根据数据库不同,有可能显示"1L"而不是"1"
>>> q . id
1
# 通过Python属性来访问模式的
>>> q . question_text
"What's new?"
>>> q . pub_date
datetime . datetime ( 2017 , 8 , 6 , 7 , 43 , 20 , 396652 , tzinfo =< UTC > )
# 通过修改属性可以修改字段内容,然后再保存
>>> q . question_text = "What's up?"
>>> q . save ()
# objects.all()显示所有数据中的question
# 但是这里显示完全无用的对象<Question: Question object>是因为python 2的兼容问题
# 需要修改Question模型(polls/models.py)
>>> Question . objects . all ()
< QuerySet [ < Question : Question object > ] >
这里会发现<Question: Question object>
是完全无用对象,通过修改Question模型(polls/models.py
)来添加__str__()
方法:
Copy from django . db import models
from django . utils . encoding import python_2_unicode_compatible
@python_2_unicode_compatible # only if you need to support Python 2
class Question ( models . Model ):
# ...
def __str__ ( self ):
return self . question_text
@python_2_unicode_compatible # only if you need to support Python 2
class Choice ( models . Model ):
# ...
def __str__ ( self ):
return self . choice_text
这里重要的是添加__str__()
方法到模型中,不仅是处理交互,也是因为对象的代表在整个Django自动化生成的管理中使用。
注意,这个是常规的Python方法,现在加上自定义方法polls/models.py
:
Copy import datetime
from django . db import models
from django . utils import timezone
class Question ( models . Model ):
# ...
def was_published_recently ( self ):
return self . pub_date >= timezone . now () - datetime . timedelta (days = 1 )
这里import datetime
和from django.utils import timezone
是引用Python标准datetime模块和Django的time-zone相关工具django.utils.timezone
。
保存好上述修改,然后重新启动一个python manage.py shell
:
Copy >>> from polls . models import Question , Choice
# 确认__str__()添加生效,使用以下查询可以看到返回了对象集
>>> Question . objects . all ()
< QuerySet [ < Question : What 's up?>]>
# Django提供了一个数据库查看API
>>> Question . objects . filter (id = 1 )
< QuerySet [ < Question : What 's up?>]>
# 查询发布在今年的问题
>>> from django . utils import timezone
>>> current_year = timezone . now (). year
>>> Question . objects . get (pub_date__year = current_year)
< Question : What 's up?>
# 查询不存在的id
>>> Question . objects . get (id = 2 )
Traceback (most recent call last):
File "<console>" , line 1 , in < module >
File "/home/huatai/venv/lib/python3.4/site-packages/django/db/models/manager.py" , line 85 , in manager_method
return getattr (self. get_queryset (), name)( * args, ** kwargs)
File "/home/huatai/venv/lib/python3.4/site-packages/django/db/models/query.py" , line 380 , in get
self . model . _meta . object_name
polls . models . DoesNotExist : Question matching query does not exist .
# 大多数情况下会查询一个主键,所以Django提供了一个快捷的主键查询
# 以下是查询Question.objects.get(id=1)
>>> Question . objects . get (pk = 1 )
< Question : What 's up?>
# 确认定制方法可工作
>>> q = Question . objects . get (pk = 1 )
>>> q . was_published_recently ()
True
# 为问题提供一系列答案,以下船舰一个选择对象,插入状态和添加选择到可选集合
# 一个处理"other side"的外键可以通过API访问
>>> q = Question . objects . get (pk = 1 )
# 显示相关对象集的所有选择,当前是空的
>>> q . choice_set . all ()
< QuerySet [] >
# 创建3个选择
>>> q . choice_set . create (choice_text = 'No much' , votes = 0 )
< Choice : No much >
>>> q . choice_set . create (choice_text = 'The sky' , votes = 0 )
< Choice : The sky >
>>> c = q . choice_set . create (choice_text = 'Just hacking again' , votes = 0 )
# 通过API访问问题相关对象
>>> c . question
< Question : What 's up?>
# 反过来:问题对象来访问选择对象
>>> q . choice_set . all ()
< QuerySet [ < Choice : No much > , < Choice : The sky > , < Choice : Just hacking again > ] >
>>> q . choice_set . count ()
3
# API自动建立需要的关系
# 查询所有今年pub_date的所有问题的所有选择
>>> Choice . objects . filter (question__pub_date__year = current_year)
< QuerySet [ < Choice : No much > , < Choice : The sky > , < Choice : Just hacking again > ] >
# 现在尝试删除一个选择,使用 delete()
>>> c = q . choice_set . filter (choice_text__startswith = 'Just hacking' )
>>> c . delete ()
( 1 , { 'polls.Choice' : 1 } )
Django Admin
Copy python manage.py createsuperuser
完成后,即可通过 http://127.0.0.1:8000/admin/ 访问管理登录界面
现在需要告诉admin有关Question对象才能具有admin界面,所以编辑 polls/admin.py
文件:
Copy from django . contrib import admin
# Register your models here.
from . models import Question
admin . site . register (Question)
此时注册了Question,Django就知道如何显示在管理索引页面。
管理界面注册Question
点击"Question",就位于Question的"修改列表",该页面也就是数据库的显示所有question的页面,可以允许修改。
如果"Date published"显示的时间不是你实际创建时间,则表明前面设置TIME_ZONE
设置错误。
视图
在Django中,web页面和其他内容都是通过视图view来传递的,每个视图都是通过一个简单的Python功能(或方法,例如在基于类的视图中)来表述。Django将通过检查请求的URL来选择视图。
编写更多视图
在polls/views.py
中增加更多的视图:
Copy def detail ( request , question_id ):
return HttpResponse ( "You're looking at question %s ." % question_id)
def results ( request , question_id ):
response = "You're looking at the results of question %s ."
return HttpResponse (response % question_id)
def vote ( request , question_id ):
return HttpResponse ( "You're voting on question %s ." % question_id)
对应于新的视图,需要在url()
调用中添加polls.urls
,所以在polls/urls.py
Copy from django . conf . urls import url
from . import views
urlpatterns = [
# ex: /polls/
url ( r ' ^$ ' , views.index, name = 'index' ),
# ex: /polls/5/
url ( r ' ^( ?P<question_id>[0-9] + ) / $ ' , views.detail, name = 'detail' ),
# ex: /polls/5/results/
url ( r ' ^( ?P<question_id>[0-9] + ) /results/ $ ' , views.results, name = 'results' ),
# ex: /polls/5/vote/
url ( r ' ^( ?P<question_id>[0-9] + ) /vote/ $ ' , views.vote, name = 'vote' ),
]
从浏览器中查看诸如/polls/34/
,则将运行detail()
方法并吸纳是URL中指定的ID,而/polls/34/results/
和/polls/34/vote/
也是如此显示相应的results和vote页面。
当请求web网站/polls/34/
,Django将加载mysite.urls
方法,因为在mysite
子目录下的settings.py
中设置了ROOT_URLCONF = 'mysite.urls'
。Django找到模拟改为urlpatterns
变量(在urls.py
文件中),然后依次转换正则表达式。
当找到^polls/
匹配,它就会剥离出匹配的文本polls/
并发送剩下的文本34/
给polls.urls
的URLconf进行进一步处理,见 mysite/urls.py
中代码:
Copy urlpatterns = [
url(r'^polls/', include('polls.urls')),
...
]
然后就会匹配polls/urls.py
文件中的r'^(?P<question_id>[0-9]+)/$'
,这样就会调用detial()
视图,类似:
Copy detail (request =< HttpRequest object > , question_id = '34' )
这里的question_id='34'
是从(?P<question_id>[0-9]+)
得到的。使用围绕一个样式(pattern)的圆括号(parentheses)可以"捕获"(captures)通过样式匹配的文本,然后发送文本作为视图功能的参数。?P<question_id>
定义了用于标识匹配的样式来定义名字;而[0-9]+
则是匹配一系列数字的正则表达式。
由于URLyangshi是正则表达式,所以它没有任何限制。通常不需要加上诸如.html
的URL,除非你想要这样也行,如:
Copy url(r'^polls/latest\.html$', views.index),
不过,不要这样做,这很笨拙。
编写视图实际完成工作
每个视图负责做两件事情之一:返回一个HttpResponse 对象包含请求页面的内容,或者抛出一个异常,诸如Http404 。其余随你所愿。
视图可以从数据库中读取记录;视图可以使用一个模板系统,例如Django的模板,或者使用第三方Python模板系统。视图可以生成一个PDF文件,输出XML,动态创建一个ZIP文件,甚至任何使用Python库可以完成的事情。
所有Django期望的是HttpResponse 或一个异常。
由于使用方便,可以使用Django自己的数据库API。这里使用了一个新的index()
视图,显示最新的5个poll问题,通过逗号分隔,按照发布时间。polls/views.py
Copy from django . http import HttpResponse
from . models import Question
def index ( request ):
latest_question_list = Question . objects . order_by ( '-pub_date' ) [ : 5 ]
output = ', ' . join ([q.question_text for q in latest_question_list])
return HttpResponse (output)
# Leave the rest of the views (detail, results, vote) unchanged
这里主要的问题是:页面设计是硬编码到视图的。如果需要修改页面样式,需要修改Python代码。所以使用Django模板系统来分离Python中的设计来创建视图。
首先在polls
目录下创建目录templates
,因为Django会在这个目录下查找模板。
项目的TEMPLATES 设置描述了Django如何加载和渲染末按。默认设置文件配置了一个DjangoTemplates
后端,其APP_DIRS 选项设置为True
。按照惯例,DjangoTemplates
在每个INSTALLED_APPS 的templates
子目录查找。
在pools/
子目录下创建templates
目录,然后再在这个目录下创建polls
,并在其中存放一个index.html
。也就是,模板文件是polls/templates/polls/index.html
。因为app_directories
模板加载器将会按照上述路径工作,所以引用这个模板只需要使用polls/index.html
。
Copy {% if latest_question_list %}
<ul>
{% for question in latest_question_list %}
<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
{% endfor %}
</ul>
{% else %}
<p>No polls are available.</p>
{% endif %}
然后更新polls/views.py
中的index
视图引用上述模板:
Copy from django . http import HttpResponse
from django . template import loader
from . models import Question
def index ( request ):
latest_question_list = Question . objects . order_by ( '-pub_date' ) [ : 5 ]
template = loader . get_template ( 'polls/index.html' )
context = {
'latest_question_list' : latest_question_list ,
}
return HttpResponse (template. render (context, request))
上述代码加载称为polls/index.html
的模板,然后传递它一个上下文,这个上下文就是映射模板变量名到Pyton对象的目录映射。
现在浏览器加载访问/polls/
就会看到类表展示,并且有问题的详细页面信息的超链接。
render()快捷方式
一个非常常用的风格是从一个template模板加载,填写一个context上下文,然后返回一个HttpResponse 对象作为渲染模板的结果。Django提供一个快捷方式,一下是完整的 index() 视图:
polls/views.py
:
Copy from django . shortcuts import render
from . models import Question
def index ( request ):
latest_question_list = Question . objects . order_by ( '-pub_date' ) [ : 5 ]
context = { 'latest_question_list' : latest_question_list }
return render (request, 'polls/index.html' , context)
render() 功能捕获请求对象作为第一个参数,模板名称作为第2个参数,即一个目录作为可选的第3个参数。返回一个使用给定context上下文渲染的模板作为HttpResponse对象。
404错误页面
polls/view.py
Copy from django . http import Http404
from django . shortcuts import render
from . models import Question
# ...
def detail ( request , question_id ):
try :
question = Question . objects . get (pk = question_id)
except Question . DoesNotExist :
raise Http404 ( "Question does not exist" )
return render (request, 'polls/detail.html' , { 'question' : question})
这里提供了一个 Http404 异常,如果请求的ID不存在对应问题的话。
polls/templates/polls/detail.html
:
一个常用的方式是使用 get() 和在对象不存在时返回 Http404
以下是 detail()
视图的重写:
polls/views.py
Copy from django . shortcuts import get_object_or_404 , render
from . models import Question
# ...
def detail ( request , question_id ):
question = get_object_or_404 (Question, pk = question_id)
return render (request, 'polls/detail.html' , { 'question' : question})
这里get_object_or_404() 功能使用一个Django模块作为第一个参数并且一个关键词参数作为随意数字,传递给get() 模式管理的功能。如果对象不存在则返回Http404
这里去掉了前面的ObjectDoesNotExist
异常处理,代之以get_object_or_404()
实现了Django的一种维护丢失关系的处理快速模式的设计目标。(理解为约定俗成规则?)
这里的get_list_or_404()
功能只使用了get_object_or_404()
,异常使用filter()
代替了get()
,则在list是空的时候返回Http404
。
使用模板系统
返回到detail()
视图,给出上下文变量的question,这里有一个polls/detail.html
模板类似,
polls/templates/polls/detail.html
:
Copy <h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
<li>{{ choice.choice_text }}</li>
{% endfor %}
</ul>
这里模板系统使用dot-lookup语法来访问变量属性。在这个阿尼中 {{ question.question_text }}
,首先Django对对象question
使用一个字典查询。失败,就尝试一个属性查询,对这个案例就是成功的。如果属性查询失败,它将尝试列表索引(list-index)查询。
模式调用发生在 `
循环:
question.choice_set.all是作为
question.choice_set.all()的Python代码解释的,它将返回一个
Choice对象并符合
`标签的使用。
详细模板使用见 template guide
参考