django 1.8 官方文档翻译: 3-1-3 Django 的快捷函数
Django 的快捷函数
django.shortcuts
收集了“跨越” 多层MVC 的辅助函数和类。 换句话讲,这些函数/类为了方便,引入了可控的耦合。
render
render(request, template_name[, context][, context_instance][, content_type][, status][, current_app][, dirs][, using])[source]
结合一个给定的模板和一个给定的上下文字典,并返回一个渲染后的 HttpResponse
对象。
render()
与以一个强制使用RequestContext
的context_instance
参数调用render_to_response()
相同。
Django 不提供返回TemplateResponse
的快捷函数,因为TemplateResponse
的构造与render()
提供的便利是一个层次的。
必选的参数
request
用于生成响应的请求对象。
template_name
要使用的模板的完整名称或者模板名称的一个序列。
可选的参数
context
添加到模板上下文的一个字典。默认是一个空字典。如果字典中的某个值是可调用的,视图将在渲染模板之前调用它。
Django 1.8 的改变:context 参数之前叫做dictionary。这个名字在Django 1.8 中废弃并将在Django 2.0 中删除。
context_instance
渲染模板的上下文实例。默认情况下,模板将使用RequestContext
实例( 值来自request
和context
)渲染。
版本 1.8 以后废弃:废弃context_instance 参数。仅仅使用context。
content_type
生成的文档要使用的MIME 类型。默认为DEFAULT_CONTENT_TYPE
设置的值。
status
响应的状态码。默认为200。
current_app
指示哪个应用包含当前的视图。更多信息,参见带命名空间的URL 的解析。
版本1.8 以后废弃:废弃current_app 参数。你应该设置request.current_app。
using
用于加载模板使用的模板引擎的名称。
Changed in Django 1.8:增加using 参数。
Changed in Django 1.7:增加dirs 参数。
Deprecated since version 1.8:废弃dirs 参数。
示例
下面的示例渲染模板myapp/index.html
,MIME 类型为application/xhtml+xml
:
from django.shortcuts import renderdef my_view(request):# View code here...return render(request, 'myapp/index.html', {"foo": "bar"},content_type="application/xhtml+xml")
这个示例等同于:
from django.http import HttpResponse
from django.template import RequestContext, loaderdef my_view(request):# View code here...t = loader.get_template('myapp/index.html')c = RequestContext(request, {'foo': 'bar'})return HttpResponse(t.render(c),content_type="application/xhtml+xml")
render_to_response
render_to_response(template_name[, context][, context_instance][, content_type][, status][, dirs][, using])[source]
根据一个给定的上下文字典渲染一个给定的目标,并返回渲染后的HttpResponse。
必选的参数
template_name
使用的模板的完整名称或者模板名称的序列。如果给出的是一个序列,将使用存在的第一个模板。关于如何查找模板的更多信息请参见 模板加载的文档 。
可选的参数
context
添加到模板上下文中的字典。默认是个空字典。如果字典中的某个值是可调用的,视图将在渲染模板之前调用它。
Changed in Django 1.8:context 参数之前叫做dictionary。 这个名字在Django 1.8 中废弃并将在Django 2.0 中删除。
context_instance
渲染模板使用的上下文实例。默认情况下,模板将Context
实例(值来自context
)渲染。如果你需要使用上下文处理器,请使用RequestContext
实例渲染模板。你的代码看上去像是这样:
return render_to_response('my_template.html',my_context,context_instance=RequestContext(request))
版本1.8 以后废弃:废弃context_instance 参数。 仅仅使用context。
content_type
生成的文档使用的MIME 类型。默认为DEFAULT_CONTENT_TYPE
设置的值。
status
相应的状态码。默认为200。
using
加载模板使用的模板引擎的名称。
Changed in Django 1.8:添加status 和using 参数。
Changed in Django 1.7:增加dirs 参数。
Deprecated since version 1.8:废弃dirs 参数。
示例
下面的示例渲染模板myapp/index.html
,MIIME 类型为application/xhtml+xml
:
from django.shortcuts import render_to_responsedef my_view(request):# View code here...return render_to_response('myapp/index.html', {"foo": "bar"},content_type="application/xhtml+xml")
这个示例等同于:
from django.http import HttpResponse
from django.template import Context, loaderdef my_view(request):# View code here...t = loader.get_template('myapp/index.html')c = Context({'foo': 'bar'})return HttpResponse(t.render(c),content_type="application/xhtml+xml")
redirect
redirect(to, [permanent=False, ]*args, **kwargs)[source]
为传递进来的参数返回HttpResponseRedirect 给正确的URL 。
参数可以是:
- 一个模型:将调用模型的
get_absolute_url()
函数 - 一个视图,可以带有参数:将使用
urlresolvers.reverse
来反向解析名称 - 一个绝对的或相对的URL,将原样作为重定向的位置。
默认返回一个临时的重定向;传递permanent=True
可以返回一个永久的重定向。
Django 1.7 中的改变:增加使用相对URL 的功能。
示例
你可以用多种方式使用redirect()
函数。
通过传递一个对象;将调用get_absolute_url()
方法来获取重定向的URL:
from django.shortcuts import redirectdef my_view(request):...object = MyModel.objects.get(...)return redirect(object)
通过传递一个视图的名称,可以带有位置参数和关键字参数;将使用reverse()
方法反向解析URL:
def my_view(request):...return redirect('some-view-name', foo='bar')
传递要重定向的一个硬编码的URL:
def my_view(request):...return redirect('/some/url/')
完整的URL 也可以:
def my_view(request):...return redirect('http://example.com/')
默认情况下,redirect()
返回一个临时重定向。以上所有的形式都接收一个permanent
参数;如果设置为True
,将返回一个永久的重定向:
def my_view(request):...object = MyModel.objects.get(...)return redirect(object, permanent=True)
get_object_or_404
get_object_or_404(klass, *args, **kwargs)[source]
在一个给定的模型管理器上调用get()
,但是引发Http404
而不是模型的DoesNotExist
异常。
必选的参数
klass
获取该对象的一个Model
类,Manager
或QuerySet
实例。
**kwargs
查询的参数,格式应该可以被get()
和filter()
接受。
示例
下面的示例从MyModel
中使用主键1 来获取对象:
from django.shortcuts import get_object_or_404def my_view(request):my_object = get_object_or_404(MyModel, pk=1)
这个示例等同于:
from django.http import Http404def my_view(request):try:my_object = MyModel.objects.get(pk=1)except MyModel.DoesNotExist:raise Http404("No MyModel matches the given query.")
最常见的用法是传递一个 Model
,如上所示。然而,你还可以传递一个QuerySet
实例:
queryset = Book.objects.filter(title__startswith='M')
get_object_or_404(queryset, pk=1)
上面的示例有点做作,因为它等同于:
get_object_or_404(Book, title__startswith='M', pk=1)
但是如果你的queryset 来自其它地方,它就会很有用了。
最后你还可以使用一个管理器。如果你有一个自定义的管理器,它将很有用:
get_object_or_404(Book.dahl_objects, title='Matilda')
你还可以使用关联的 管理器:
author = Author.objects.get(name='Roald Dahl')
get_object_or_404(author.book_set, title='Matilda')
注:与get()一样,如果找到多个对象将引发一个MultipleObjectsReturned
异常。
get_list_or_404
get_list_or_404(klass, *args, **kwargs)[source]
返回一个给定模型管理器上filter() 的结果,并将结果映射为一个列表,如果结果为空则返回Http404。
必选的参数
klass
获取该列表的一个Model
、Manager
或QuerySet
实例。
**kwargs
查寻的参数,格式应该可以被get()
和filter()
接受。
示例
下面的示例从MyModel
中获取所有发布出来的对象:
from django.shortcuts import get_list_or_404def my_view(request):my_objects = get_list_or_404(MyModel, published=True)
这个示例等同于:
from django.http import Http404def my_view(request):my_objects = list(MyModel.objects.filter(published=True))if not my_objects:raise Http404("No MyModel matches the given query.")
译者:Django 文档协作翻译小组,原文:Shortcuts。
本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。
django 1.8 官方文档翻译: 3-1-3 Django 的快捷函数相关推荐
- django 1.8 官方文档翻译:13-1-2 使用Django认证系统
使用Django认证系统 这篇文档解释默认配置下Django认证系统的使用.这些配置已经逐步可以满足大部分常见项目对的需要,可以处理范围非常广泛的任务,且具有一套细致的密码和权限实现.对于需要与默认配 ...
- django 1.8 官方文档翻译: 3-5-2 使用Django输出PDF
使用Django输出PDF 这篇文档阐述了如何通过使用Django视图动态输出PDF.这可以通过一个出色的.开源的Python PDF库ReportLab来实现. 动态生成PDF文件的优点是,你可以为 ...
- django 1.8 官方文档翻译: 3-5-1 使用Django输出CSV
使用Django输出CSV 这篇文档阐述了如何通过使用Django视图动态输出CSV (Comma Separated Values). 你可以使用Python CSV 库或者Django的模板系统来 ...
- django 1.8 官方文档翻译: 6-6-1 部署 Django
部署 Django 虽然Django 满满的便捷性让Web 开发人员活得轻松一些,但是如果不能轻松地部署你的网站,这些工具还是没有什么用处.Django 起初,易于部署就是一个主要的目标.有许多优秀的 ...
- django 1.8 官方文档翻译: 2-5-7 自定义查找
自定义查找 New in Django 1.7. Django为过滤提供了大量的内建的查找(例如,exact和icontains).这篇文档阐述了如何编写自定义查找,以及如何修改现存查找的功能.关于查 ...
- django 1.8 官方文档翻译: 2-5-6 多数据库
多数据库 这篇主题描述Django 对多个数据库的支持.大部分Django 文档假设你只和一个数据库打交道.如果你想与多个数据库打交道,你将需要一些额外的步骤. 定义你的数据库 在Django中使用多 ...
- django 1.8 官方文档翻译: 1-1-2 快速安装指南
快速安装指南 在你开始使用 Django 之前,你需要先安装它.我们有一个 完整安装指南 它涵盖了所有的安装步骤和可能遇到的问题:本指南将会给你一个最简单.简洁的安装指引. 安装 Python 作为一 ...
- django 1.8 官方文档翻译:6-3 Django异常
Django异常 DJango会抛出一些它自己的异常,以及Python的标准异常. Django核心异常 Django核心异常类定义在django.core.exceptions中. ObjectDo ...
- django 1.8 官方文档翻译:13-1-3 密码管理
Django中的密码管理 密码管理在非必要情况下一般不会重新发明,Django致力于提供一套安全.灵活的工具集来管理用户密码.本文档描述Django存储密码和hash存储方法配置的方式,以及使用has ...
- django 1.8 官方文档翻译:5-2-2 表单素材 ( Media 类)
表单素材 ( Media 类) 渲染有吸引力的.易于使用的web表单不仅仅需要HTML – 同时也需要CSS样式表,并且,如果你打算使用奇妙的web2.0组件,你也需要在每个页面包含一些JavaScr ...
最新文章
- android phonegap插件开发方法 plugin
- 互联网中网站建设如何体现出企业品牌的企业网络推广能力?
- python图片分析中央气象台降水量预报_php采集自中央气象台范围覆盖全国的天气预报代码实例...
- 网站“拍照”备案月底恐难实施
- CSS3 Transform变形理解与应用
- Julia 创始人访谈:简单机器学习任务可与 Python 媲美,复杂任务胜过 Python
- 计算机大学英语融合的课题有什么,【计算机信息论文】计算机信息管理学科交叉融合研究(共3910字)...
- 一起谈.NET技术,40条ASP.NET开发Tip
- Moods of Norway扩大RFID系统使用范围,保证库存准确率
- SQL Server 2008 R2下载地址
- 啦啦外卖独立版41.4+全插件+可运营版本+开源(亲测100%可用)
- python中的对数_python中计算log对数的方法
- Linux下安装小企鹅输入法
- 企业微信 php sdk,thinkphp5.0集成企业微信SDK
- JavaGUI:多功能计算器(四)--Swing实现双语悬停提示(源码升级说明)
- 影响个人征信的不良习惯有哪些?
- JAVA毕业设计高校人事管理系统计算机源码+lw文档+系统+调试部署+数据库
- oracle荣誉acd_Oracle函数
- 候选码主属性非主属性
- Base64加密算法原理、具体例子及Java代码
热门文章
- FPGA状态机一段式
- neo4j python_Python 操作 Neo4j 数据库!
- 6001. mavlink 编译与移植
- RT-Thread的线程(任务)处理【RT-Thread学习笔记 2】
- SQUID优化重要参数
- [C++] - 创建对象时 () 和 {} 的区别
- 上海高考女生计算机专业,@2020高考:女生最多的15个专业,一辈子的好友就在这里...
- Oracle01877,Cognos错误:RQP-DEF-0177 执行操作“sqlOpenResult”(状态为“-28”)时出错...
- 使用d3.v5实现折线图与面积图
- Java 继承——2