你需要一段context來(lái)解析模板。 一般情況下，這是一個(gè) django.template.Context 的實(shí)例，不過(guò)在Django中還可以用一個(gè)特殊的子類(lèi)， django.template.RequestContext ，這個(gè)用起來(lái)稍微有些不同。 RequestContext 默認(rèn)地在模板context中加入了一些變量，如 HttpRequest 對(duì)象或當(dāng)前登錄用戶(hù)的相關(guān)信息。

當(dāng)你不想在一系例模板中都明確指定一些相同的變量時(shí)，你應(yīng)該使用 RequestContext 。 例如，考慮這兩個(gè)視圖：

from django.template import loader, Context

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 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 t.render(c)

（注意，在這些例子中，我們故意 不 使用 render_to_response() 這個(gè)快捷方法，而選擇手動(dòng)載入模板，手動(dòng)構(gòu)造context對(duì)象然后渲染模板。 是為了能夠清晰的說(shuō)明所有步驟。）

每個(gè)視圖都給模板傳入了三個(gè)相同的變量：app、user和ip_address。 如果我們把這些冗余去掉會(huì)不會(huì)更好？

創(chuàng)建 RequestContext 和 context處理器 就是為了解決這個(gè)問(wèn)題。 Context處理器允許你設(shè)置一些變量，它們會(huì)在每個(gè)context中自動(dòng)被設(shè)置好，而不必每次調(diào)用 render_to_response() 時(shí)都指定。 要點(diǎn)就是，當(dāng)你渲染模板時(shí)，你要用 RequestContext 而不是 Context 。

最直接的做法是用context處理器來(lái)創(chuàng)建一些處理器并傳遞給 RequestContext 。上面的例子可以用context processors改寫(xiě)如下：

from django.template import loader, RequestContext

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')
  c = RequestContext(request, {'message': 'I am view 1.'},
      processors=[custom_proc])
  return 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 t.render(c)

我們來(lái)通讀一下代碼：

    首先，我們定義一個(gè)函數(shù) custom_proc 。這是一個(gè)context處理器，它接收一個(gè) HttpRequest 對(duì)象，然后返回一個(gè)字典，這個(gè)字典中包含了可以在模板context中使用的變量。 它就做了這么多。

    我們?cè)谶@兩個(gè)視圖函數(shù)中用 RequestContext 代替了 Context 。在context對(duì)象的構(gòu)建上有兩個(gè)不同點(diǎn)。 一， RequestContext 的第一個(gè)參數(shù)需要傳遞一個(gè) HttpRequest 對(duì)象，就是傳遞給視圖函數(shù)的第一個(gè)參數(shù)（ request ）。二， RequestContext 有一個(gè)可選的參數(shù) processors ，這是一個(gè)包含context處理器函數(shù)的列表或者元組。 在這里，我們傳遞了我們之前定義的處理器函數(shù) curstom_proc 。

    每個(gè)視圖的context結(jié)構(gòu)里不再包含 app 、 user 、 ip_address 等變量，因?yàn)檫@些由 custom_proc 函數(shù)提供了。

    每個(gè)視圖 仍然 具有很大的靈活性，可以引入我們需要的任何模板變量。 在這個(gè)例子中， message 模板變量在每個(gè)視圖中都不一樣。

 為了講解context處理器底層是如何工作的，在上面的例子中我們沒(méi)有使用 render_to_response() 。但是建議選擇 render_to_response() 作為context的處理器。這就需要用到context_instance參數(shù)：

from django.shortcuts import render_to_response
from django.template import RequestContext

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):
  # ...
  return render_to_response('template1.html',
    {'message': 'I am view 1.'},
    context_instance=RequestContext(request, processors=[custom_proc]))

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

在這，我們將每個(gè)視圖的模板渲染代碼寫(xiě)成了一個(gè)單行。

雖然這是一種改進(jìn)，但是，請(qǐng)考慮一下這段代碼的簡(jiǎn)潔性，我們現(xiàn)在不得不承認(rèn)的是在 另外 一方面有些過(guò)分了。 我們以代碼冗余（在 processors 調(diào)用中）的代價(jià)消除了數(shù)據(jù)上的冗余（我們的模板變量）。 由于你不得不一直鍵入 processors ，所以使用context處理器并沒(méi)有減少太多的輸入量。

Django因此提供對(duì) 全局 context處理器的支持。 TEMPLATE_CONTEXT_PROCESSORS 指定了哪些context processors總是默認(rèn)被使用。這樣就省去了每次使用 RequestContext 都指定 processors 的麻煩。

默認(rèn)情況下， TEMPLATE_CONTEXT_PROCESSORS 設(shè)置如下：

TEMPLATE_CONTEXT_PROCESSORS = (
  'django.core.context_processors.auth',
  'django.core.context_processors.debug',
  'django.core.context_processors.i18n',
  'django.core.context_processors.media',
)

這個(gè)設(shè)置項(xiàng)是一個(gè)可調(diào)用函數(shù)的元組，其中的每個(gè)函數(shù)使用了和上文中我們的 custom_proc 相同的接口，它們以request對(duì)象作為參數(shù)，返回一個(gè)會(huì)被合并傳給context的字典： 接收一個(gè)request對(duì)象作為參數(shù)，返回一個(gè)包含了將被合并到context中的項(xiàng)的字典。

每個(gè)處理器將會(huì)按照順序應(yīng)用。 也就是說(shuō)如果你在第一個(gè)處理器里面向context添加了一個(gè)變量，而第二個(gè)處理器添加了同樣名字的變量，那么第二個(gè)將會(huì)覆蓋第一個(gè)。

Django提供了幾個(gè)簡(jiǎn)單的context處理器，有些在默認(rèn)情況下被啟用的。

django.core.context_processors.auth

•     user ：一個(gè) django.contrib.auth.models.User 實(shí)例，描述了當(dāng)前登錄用戶(hù)（或者一個(gè) AnonymousUser 實(shí)例，如果客戶(hù)端沒(méi)有登錄）。
•     messages ：一個(gè)當(dāng)前登錄用戶(hù)的消息列表（字符串）。 在后臺(tái)，對(duì)每一個(gè)請(qǐng)求，這個(gè)變量都調(diào)用 request.user.get_and_delete_messages() 方法。 這個(gè)方法收集用戶(hù)的消息然后把它們從數(shù)據(jù)庫(kù)中刪除。
•     perms ： django.core.context_processors.PermWrapper 的一個(gè)實(shí)例，包含了當(dāng)前登錄用戶(hù)有哪些權(quán)限。

關(guān)于users、permissions和messages的更多內(nèi)容請(qǐng)參考第14章。
django.core.context_processors.debug

這個(gè)處理器把調(diào)試信息發(fā)送到模板層。 如果TEMPLATE_CONTEXT_PROCESSORS包含這個(gè)處理器，每一個(gè)RequestContext將包含這些變量：

•     debug ：你設(shè)置的 DEBUG 的值（ True 或 False ）。你可以在模板里面用這個(gè)變量測(cè)試是否處在debug模式下。
•     sql_queries ：包含類(lèi)似于 ``{‘sql': …, ‘time': `` 的字典的一個(gè)列表， 記錄了這個(gè)請(qǐng)求期間的每個(gè)SQL查詢(xún)以及查詢(xún)所耗費(fèi)的時(shí)間。 這個(gè)列表是按照請(qǐng)求順序進(jìn)行排列的。
•     System Message: WARNING/2 (<string>, line 315); backlink
•     Inline literal start-string without end-string.
• 由于調(diào)試信息比較敏感，所以這個(gè)context處理器只有當(dāng)同時(shí)滿(mǎn)足下面兩個(gè)條件的時(shí)候才有效：
•     DEBUG 參數(shù)設(shè)置為 True 。
•     請(qǐng)求的ip應(yīng)該包含在 INTERNAL_IPS 的設(shè)置里面。

細(xì)心的讀者可能會(huì)注意到debug模板變量的值永遠(yuǎn)不可能為False，因?yàn)槿绻鸇EBUG是False，那么debug模板變量一開(kāi)始就不會(huì)被RequestContext所包含。
django.core.context_processors.i18n

如果這個(gè)處理器啟用，每個(gè) RequestContext 將包含下面的變量：

•     LANGUAGES ： LANGUAGES 選項(xiàng)的值。
•     LANGUAGE_CODE ：如果 request.LANGUAGE_CODE 存在，就等于它；否則，等同于 LANGUAGE_CODE 設(shè)置。

django.core.context_processors.request

如果啟用這個(gè)處理器，每個(gè) RequestContext 將包含變量 request ， 也就是當(dāng)前的 HttpRequest 對(duì)象。 注意這個(gè)處理器默認(rèn)是不啟用的，你需要激活它。

如果你發(fā)現(xiàn)你的模板需要訪問(wèn)當(dāng)前的HttpRequest你就需要使用它:

{{ request.REMOTE_ADDR }}

最新評(píng)論