(9)Django框架学习-Templates进阶用法--上

也许，你想要自定义和扩展模板引擎，下面会介绍一些关于如何去扩展模板系统的方法，
了解一下模板系统的工作原理，同时也会介绍Django模板系统中的auto-escapint功能，
这是一种安全机制。

复习一下模板语言的用法

{# 模板tag的用法 #}
{% if done %}
<strong>Over</strong>

{% else %}
<strong>wait</strong>
{% endif %}
{# 模板变量的用法 #}
Now is {{ nowtime }}
在views.py中使用模板的时候：
1. 通过模板名，获得模板对象
2. 创建context对象，类似字典，用于像模板提供变量实际的值
3. 使用context对象进行模板的渲染，返回的是html网页的内容

使用RequestContext对上下文内容进行重用

当渲染一个模板的时候，我们通常使用的是django.template.Context的对象，
这里要介绍另外一个它的子类，django.template.RequestContext，
RequestContext提供了一种把不同的context内容中公共的部分提取出来的方法，
让context的内容重用。
下面来看例子：
1. Context版

from django.template import loader, Context
from django.http import HttpResponse

def view_1(request):
# ...
t = loader.get_template('template1.html')
c = Context({
'app': 'My app',
'user': request.user,
'ip_address': request.META['REMOTE_ADDR'],
'message': 'I am view 1.'
})
return HttpResponse(t.render(c))

def view_2(request):
# ...
t = loader.get_template('template2.html')
c = Context({
'app': 'My app',
'user': request.user,
'ip_address': request.META['REMOTE_ADDR'],
'message': 'I am the second view.'
})
return HttpResponse(t.render(c))

可以看到两个context的内容有些是重复的。比如app, user, ip_address

2. 下面改写成RequestContext版

from django.template import loader, RequestContext
from django.http import HttpResponse

# 使用context processro去提供一些context内容中公共的部分，也就是返回一个字典而已。
def custom_proc(request):
"A context processor that provides 'app', 'user' and 'ip_address'."
return {
'app': 'My app',
'user': request.user,
'ip_address': request.META['REMOTE_ADDR']
}

def view_1(request):
# ...
t = loader.get_template('template1.html')
# 创建方式不同，需要提供的参数有三个，request对象，字典类型，processors可选
c = RequestContext(request, {'message': 'I am view 1.'},
processors=[custom_proc])
return HttpResponse(t.render(c))

def view_2(request):
# ...
t = loader.get_template('template2.html')
c = RequestContext(request, {'message': 'I am the second view.'},
processors=[custom_proc])
return HttpResponse(t.render(c))

可以看到所谓的context processors其实就是一个函数，参数为request，
返回一个字典类型。这就是它所做的所有的事。在这里custom_proc返回的
是包含共同的那三个参数的字典

RequestContext构造函数中的第三个参数processors是可选的，可以是
多个custom_proc函数的列表或是元组，在这里我们只传递了一个，可以为多个。

结合RequestContext使用render_to_response函数直接返回HttpResponse对象

return render_to_response('template2.html',
{'message': 'I am the second view.'},
context_instance=RequestContext(request, processors=[custom_proc]))

以上代码就可以一步到位。

但是又引入了另一个问题，在每次使用render_to_response函数时，都要向
RequestContext指定所需要的context processors，因为这个原因，Django又给
我们提供了全局的processors，它默认是被传递给RequestContext对象的，这个设置
对应的是D:\Python27\Lib\site-packages\django\conf\global_setings.py文件
中TEMPLATE_CONTEXT_PROCESSORS属性,这样使用RequestContext的时候，就
不需要每次指定processors了。



我现在使用的是Django-1.4，所以路径是在这里，貌似以前的版本是直接在工程
文件夹下的settings.py文件， 上面都是一些processors函数的字符串表示，下面
介绍一些常用的默认被打开的processors提供的参数：

django.contrib.auth.context_processors.auth



user : 当前登入的用户名
perms ：用户所有的权限

django.core.context_processors.debug



debug：是否打开DEBUG模式
sql_queries：{'sql': ..., 'time': ...}形式的字典信息，显示执行的每一个SQL查询和
它执行所需的时间。从Django的源码可以看出要使用这个processors，需要首先打开调
试模式，其次需要是你的IP在INITERNAL_IPS元组中。

INITERNAL_IPS是什么东西？
它在之前的global_settings.py文件中，目前是一个空的元组，应该是用来安全认证的设置（猜测）。



django.core.context_processors.request

这就是request对象的processors，估计是直接返回request对象。



源代码和想像的一样。

一些关于自定义全局processors的建议：
1. 确保你的每个processor只对应一小部分的功能需要的数据，这样才能保证重用性更强，
组合方式更多，不会太重复。

2. 一旦定义了全局processor，那么它将对使用RequestContext的所有模板文件可见，
所以需要注意模板变量名字的选择，一种比较好的作法是全局processor中的变量全部使用大写。

3. 习惯把processors函数放在名为context_processors.py文件中，命名习惯而已。只要你在
TEMPLATE_CONTEXT_PROCESSORS元组中写对你的路径就可以。

通过 为知笔记 发布