摘要：模板函數到底長什么樣下面我們就可以來看看模板函數到底長什么樣了。當然，首先得創(chuàng)建一個模板文件?？偨Y通過打印中間結果和分析代碼，我們已經大概知道了的模板是如何轉化成內容的。下一篇文章會闡述模板的各種語法所對應的動態(tài)函數內容。

web.py的模板實現利用了Python的可執(zhí)行對象的動態(tài)特性：根據模板內容和渲染函數的參數創(chuàng)建一個函數，該函數執(zhí)行的時候會返回一個TemplateResult類實例，該實例的字符串化就是模板對應的HTML內容。

為了說明web.py的模板是如何實現的，我們需要在web.py的模板實現代碼中加入一些打印語句來顯示中間結果。Python的virtualenv工具很好的實現了這個需求。另外，我還使用了iPython，不過Python標準命令行也是可以的。環(huán)境搭建的步驟簡述如下：

創(chuàng)建virtualenv環(huán)境：virtualenv env

激活virtualenv環(huán)境：cd env以及source bin/activate

安裝web.py：pip install web.py

這個web.py庫會被安裝在virtualenv環(huán)境的目錄下：

(env)? ~/programming/python/env/lib/python2.7/site-packages/web  $ pwd
/home/diabloneo/programming/python/env/lib/python2.7/site-packages/web

下面就可以修改這個web.py的代碼來看看模板到底是如何實現的。

我們要修改的代碼位于web/template.py文件內，找到Template類的compile_template函數（在template.py文件的第900行），加入一行打印語句：

def compile_template(self, template_string, filename):
    code = Template.generate_code(template_string, filename, parser=self.create_parser())

    def get_source_line(filename, lineno):
        try:
            lines = open(filename).read().splitlines()
            return lines[lineno]
        except:
            return None

    print code  # 這行就是我們增加的調試語句，可以打印出前面提到的動態(tài)生成的函數。
    try:
        # compile the code first to report the errors, if any, with the filename
        compiled_code = compile(code, filename, "exec")
    except SyntaxError, e:
    ...
    

下面我們就可以來看看模板函數到底長什么樣了。當然，首先得創(chuàng)建一個模板文件。在我們的實驗環(huán)境中進行如下操作：

(env)? ~/programming/python/env  $ ls
bin  include  lib  local
(env)? ~/programming/python/env  $ mkdir app
(env)? ~/programming/python/env  $ ls
app bin  include  lib  local
(env)? ~/programming/python/env  $ cd app
(env)? ~/programming/python/env/app  $ mkdir templates

現在，在templates目錄下創(chuàng)建一個最簡單的模板，文件名為hello.html，內容如下：

hello, world

下面來看看根據這個模板生成的函數到底長什么樣子，在實驗環(huán)境下啟動ipython或者python，進入到app目錄：

(env)? ~/programming/python/env/app  $ ipython
WARNING: Attempting to work in a virtualenv. If you encounter problems, please install IPython inside the virtualenv.
Python 2.7.8 (default, Oct 20 2014, 15:05:19)
Type "copyright", "credits" or "license" for more information.

IPython 1.0.0 -- An enhanced Interactive Python.
?         -> Introduction and overview of IPython"s features.
%quickref -> Quick reference.
help      -> Python"s own help system.
object?   -> Details about "object", use "object??" for extra details.

In [1]:

執(zhí)行如下代碼就可以看到模板函數的內容：

In [3]: hello = web.template.frender("templates/hello.html")
# coding: utf-8
def __template__():
    __lineoffset__ = -5
    loop = ForLoop()
    self = TemplateResult(); extend_ = self.extend
    extend_([u"hello, world
"])

    return self

In [4]:

上面的函數__template__()就是我們增加到web.py庫中的那行print code所打印出來的。從這個函數的定義，我們可以看出：

函數內使用了一些預定義的對象：ForLoop，TemplateResult等。

函數的結果是返回一個TemplateResult實例。

那么，現在問題來了：

這個函數是如何生成的？

使用的這些預定義名稱從哪里來的？

TemplateResult實例的字符串表示如何變成HTML文本的？

本文先來說明TemplateResult實例是如何產生HTML文本這個問題。

TemplateResult類的定義也在web/template.py文件中，繼承的類和實現的方法如下：

class TemplateResult(object, DictMixin):
   __delattr__ : function
   __delitem__ : function
   __getattr__ : function
   __getitem__ : function
   __init__ : function
   __repr__ : function
   __setattr__ : function
   __setitem__ : function
   __str__ : function
   __unicode__ : function
   _prepare_body : function
   keys : function

其中DictMixin是一個實現了大部分字典操作的類，繼承該類的子類（也就是這里的TemplateResult）需要實現：__getitem__(), __setitem__(), __delitem__()和keys()方法，以便對象可以模擬完整的字典操作。需要說明的是：DictMixin類已經過時了，現在應該使用collections.MutableMapping類（該類的實現利用了abc庫--抽象類）。

先來看__init__()函數，

def __init__(self, *a, **kw):
    self.__dict__["_d"] = dict(*a, **kw)
    self._d.setdefault("__body__", u"")

    self.__dict__["_parts"] = []
    self.__dict__["extend"] = self._parts.extend

從初始化函數可以看出，TemplateResult大部分屬性都存儲在_d這個字典中，該字典至少包含一個元素body。所以，外部代碼對TemplateResult的對象屬性進行增刪改查操作時，實際上都是在操作內部的_d這個字典。初始化函數中定義的另外兩個屬性是：_parts，一個序列；extend，指向_parts序列的extend()方法，也就是說調用TemplateResult實例的extend方法實際上是調用實例屬性_parts的extend方法。這個extend方法我們在前面的__template__()函數已經見到過了：

def __template__():
    __lineoffset__ = -5
    loop = ForLoop()
    self = TemplateResult(); extend_ = self.extend
    extend_([u"hello, world
"])

    return self
    

這個函數定義了extend_ = self.extend，extend_把模板的內容添加到了self._parts這個序列中。

下面來看一下TemplateResult如何生成HTML內容，這個就要看__str__()方法了：

def _prepare_body(self):
    """Prepare value of __body__ by joining parts.
    """
    if self._parts:
        value = u"".join(self._parts)
        self._parts[:] = []
        body = self._d.get("__body__")
        if body:
            self._d["__body__"] = body + value
        else:
            self._d["__body__"] = value

def __str__(self):
    self._prepare_body()
    return self["__body__"].encode("utf-8")

主要操作是在_prepare_body()函數里，主要操作是把_parts中的字符串拼接起來，然后再拼接到body的內容后面。

看過TemplateResult的實現后，我們可以知道，由模板生成的__template__()函數最終會把一堆字符串添加到TemplateResult實例中，然后再通過實例生成HTML字符串。

通過打印中間結果和分析代碼，我們已經大概知道了web.py的模板是如何轉化成HTML內容的。下一篇文章會闡述web.py模板的各種語法所對應的動態(tài)函數內容。