学习tornado:模板

原文链接:https://my.oschina.net/siddontang/blog/263245

第一次接触tornado的template,是在做oastub的时候,因为一位同学在handler里面硬编码了html代码,我决定引入template机制来降低逻辑与页面的耦合。

简介

tornado自带了一个简易的template引擎,使用它,我们可以很方便的构建自己的web页面。tornado的template使用起来很简单,如下:

from tornado.template import Template

t = Template("<html>{{ myvalue }}</html>")
t.generate(myvalue="Hello World")

#output: <html>Hello World</html>

可以看到,tornado的template很容易理解,我们加载一段模板代码,tornado会将该代码编译成python code。具体的过程如下:

  • 解析template,生成code string
  • 使用compile编译成code object
  • 使用exec执行该code object

expression

上面的例子,我们可以看到,在template里面myvalue的值是在generate的时候传入并生成的。tornado通过{{ }}将python的值插入模板里面。也就是说,我们可以在双括号里面写上任何python表达式,tornado在模板生成的时候会计算表达式的值,并插入输出代码里面。如下:

Template("{{ 1 + 1 }}").generate()
# output: 2
Template("{{ Hello World }}").generate()
# output: hello world
Template("{{ [ i for i in range(10) ] }}").generate()
# output: '[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]'

control flow

不光支持表达式,tornado的template还可以通过{{% %}}来支持流程控制。tornado template支持的control有if,for,while和try,如下:

Template("{{% if a is 1 %}} Hello World {{% end %}}").generate(a = 1)
# output: ' Hello World '
Template("{{% if a is 1 %}} Hello World {{% end %}}").generate(a = 2)
# output: ' '

Template("{{% for name in names %}} {{ name }} {{% end %}}").generate(names = ['a', 'b', 'c'])
# output: ' a  b  c '

export function

除了表达式和流程控制,tornado还给template提供了很多导出函数,可以在template里面直接使用,譬如最常使用的escape等,同时,我们还可以将函数传递给template,如下:

Template("{{ escape(url) }}").generate(url = 'a=1&b=2')
# output: 'a=1&amp;amp;b=2'

Template("{{ l(data) }}").generate(data = [1,2,3], l = lambda data: [ 2 * d for d in data ])
# output: '[2, 4, 6]'

inheritance

tornado的template支持继承,也就是说,我们可以通过继承一个基本的模板,然后再在子模板里面定制需要的东西。这个就跟c++里面多态一样。很是强大。

tornado的template通过extends和block来进行模板的继承。

#定义一个基本模板 main.html
<header>
{{% block header %}}{{% end %}}
</header>

#定义子模板 index.html
{{% extends main.html %}}}
{{% block header %}} <h1>Hello world!</h1>
{{% end %}}

可以看到,template的继承很简单,我们在base模板里面定义整体的模板框架,使用block字段来标明子模板可以重载。子模板通过extends载入base模板,然后使用block来定制自己的功能。

UIModule

从上面可以看到,tornado的template虽然简单,但是却很强大,不光如此,tornado还提供了UIModule,让我们更强大的去定制自己的html页面。在编写不同的web页面的时候,有时候我们需要重用一些html代码,这种情况不适用extends和block,如果以c++对比,extends和block就如同类的继承,是类的复用,而我们这里则需要实现的是函数级别的复用。

幸运的是,tornado的UIModule提供了这种功能,我们首先继承UIModule,然后将其注册给application,这样模板就能使用这个UIModule了,如下:

class HelloModule(tornado.web.UIModule): 
    def render(self):
        return '<h1>Hello, world!</h1>'

app = tornado.web.Application(
    ui_modules={'Hello', HelloModule}
)

#我们注册了一个Hello的UIModule,这样template就可以使用了,index.html
<html>
<body>
    {{% module Hello() %}} 
</body>
</html>

可以看出,uimodule的使用也很简单,更强大的是,我们可以在uimodule里面嵌入自己的css,javascript等。只需要重载继承的embedded_javascript,embedded_css等,这里就不展开了。

后面的话

tornado的template是一个很强大的模块,使用它,我们可以快速构建web应用,不过,我们仍然可以使用其他的模板引擎来与tornado集成,这里不得不说tornado的强大。

转载于:https://my.oschina.net/siddontang/blog/263245

上一篇:算法---------括号生成


下一篇:PostgreSQL使用总结(持续更新)