Tornado模板

--------------------静态文件--------------------
1、static_path：通过向web.Application类的构造函数传递一个名为static_path的参数来告诉Tornado从文件系统的一个特定位置提供静态文件
    app = tornado.web.Application(
        [(r'/', IndexHandler)],
        static_path=os.path.join(os.path.dirname(__file__), "statics"),
    )

2、对于静态文件目录的命名，为了便于部署，建议使用static
    可以通过http://127.0.0.1/static/html/index.html来访问。而且在index.html中引用的静态资源文件，我们给定的路径也符合/static/...的格式，故页面可以正常浏览。

3、StaticFileHandler：可以通过tornado.web.StaticFileHandler来自由映射静态文件与其访问路径url。
    1、tornado.web.StaticFileHandler是tornado预置的用来提供静态资源文件的handler。

    2、
    import os

    current_path = os.path.dirname(__file__)
    app = tornado.web.Application(
        [
            (r'^/()$', StaticFileHandler, {"path":os.path.join(current_path, "statics/html"), "default_filename":"index.html"}),
            (r'^/view/(.*)$', StaticFileHandler, {"path":os.path.join(current_path, "statics/html")}),
        ],
        static_path=os.path.join(current_path, "statics"),
    )

    3、path 用来指明提供静态文件的根路径，并在此目录中寻找在路由中用正则表达式提取的文件名。

    4、default_filename 用来指定访问路由中未指明文件名时，默认提供的文件。


--------------------使用模板--------------------
1、路径与渲染
    1、使用模板，需要仿照静态文件路径设置一样，向web.Application类的构造函数传递一个名为template_path的参数来告诉Tornado从文件系统的一个特定位置提供模板文件

    2、
    app = tornado.web.Application(
        [(r'/', IndexHandler)],
        static_path=os.path.join(os.path.dirname(__file__), "statics"),
        template_path=os.path.join(os.path.dirname(__file__), "templates"),
    )

    3、在handler中使用render()方法来渲染模板并返回给客户端。
        self.render("index.html") # 渲染主页模板，并返回给客户端。

2、模板语法
    1、变量与表达式
        1、在tornado的模板中使用{{}}作为变量或表达式的占位符，使用render渲染后占位符{{}}会被替换为相应的结果值。
            self.render("index.html",**kwargs)

        2、{{}}不仅可以包含变量，还可以是表达式
            self.render("index.html",{"p1":100,"p2":200})

            {{p1 + p2}}

    2、控制语句
        1、在Tornado模板中使用Python条件和循环语句。控制语句以{\%和\%}包围，并以类似下面的形式被使用：
            {% if page is None %} 或 {% if len(entries) == 3 %}

        2、部分控制语句
            1、{% if ... %} ... {% elif ... %} ... {% else ... %} ... {% end %}

            2、{% for ... in ... %} ... {% end %}

            3、{% while ... %} ... {% end %}

    3、函数
        1、static_url()：Tornado模板模块提供了一个叫作static_url的函数来生成静态文件目录下文件的URL。
            1、使用方法
            <link rel="stylesheet" href="{{ static_url("style.css") }}">

            2、static_url函数创建了一个基于文件内容的hash值，并将其添加到URL末尾（查询字符串的参数v）。这个hash值确保浏览器总是加载一个文件的最新版而不是之前的缓存版本。无论是在你应用的开发阶段，还是在部署到生产环境使用时，都非常有用，因为你的用户不必再为了看到你的静态内容而清除浏览器缓存了。

            3、另一个好处是你可以改变你应用URL的结构，而不需要改变模板中的代码。例如，可以通过设置static_url_prefix来更改Tornado的默认静态路径前缀/static。如果使用static_url而不是硬编码的话，代码不需要改变。

        2、转义
            1、模板中可以通过raw语句来输出不被转义的原始格式

            2、注意：在Firefox浏览器中会直接弹出alert窗口，而在Chrome浏览器中，需要set_header("X-XSS-Protection", 0)

            3、关闭自动转义：
                1、Application中设置autoescape=None

                2、模板中添加 {% autoescape None %} 语句

            4、关闭自动转义后，可以使用escape()函数来对特定变量进行转义：{{ escape(text) }}

        3、自定义函数：在模板中还可以使用一个自己编写的函数，只需要将函数名作为模板的参数传递即可，就像其他变量一样。
            1、定义函数
            def house_title_join(titles):
                return "+".join(titles)

            2、将函数赋值到指定变量传递到模板
            self.render("index.html", houses=house_list, title_join = house_title_join)

            3、前端调用指定的函数，并传入对应的参数
            {{title_join(house["titles"])}}

    4、块
        1、进行模板页的嵌套
            1、指定继承的模板页
                {% extends "base.html" %}
            2、定义对应的模块，子模板继承父级模板进行对应的替换操作
                {% block block_name %} {% end %}

作者：黑马程序员人工智能+python培训学院
首发：http://python.itheima.com/