摘要：处理和函数之间关系的程序称为路由。模板引擎是由实现的是内置的模板语言参照设计思想设计的，跟差不多渲染模板默认情况下，在程序文件夹中的子文件夹中寻找模板。如果需要可在文件夹中使用子文件夹存放文件。

所有Flask 程序都必须创建一个程序实例。Web 服务器使用一种名为Web 服务器网关接口（Web Server Gateway Interface，WSGI）的协议，把接收自客户端的所有请求都转交给这个对象处理。程序实例是Flask 类的对象。

from flask import Flask
app = Flask(__name__)

传入Flask构造方法的第一个参数是模块或者包的名称，我们应该使用特殊变量 __name __。
Python会根据所处的模块来赋予 __ name __变量相应的值，对于我们程序来说，这个值为app

客户端（例如Web 浏览器）把请求发送给Web 服务器，Web 服务器再把请求发送给Flask
程序实例。程序实例需要知道对每个URL 请求运行哪些代码，所以保存了一个URL 到Python 函数的映射关系。处理URL 和函数之间关系的程序称为路由。

@app.route("/")
def index():
return "
Hello World!
"

在这个程序中，app.route()装饰器把根地址/和index（）函数绑定起来，当用户访问这个URL时就会触发index（）函数。视图函数index（）返回 " Hello World! "

route()装饰器的第一个参数是URL规则，用字符串表示，必须以/开始。这里的URL是相对的URL（又称内部URL），即不包含域名的URL，以域名www.google.com为例，“/”对应的是根地址，即www.google.com，如果把URL规则改为“/maps”，则实际的绝对地址为www.google.com/maps

动态路由

如果你仔细观察日常所用服务的某些URL 格式，会发现很多地址中都包含可变部分。例如， 你的Facebook 资料页面的地址是http://www.facebook.com/， 用户名（your-name）是地址的一部分。Flask 支持这种形式的URL，只需在route 修饰器中使用特殊的句法即可。下例定义的路由中就有一部分是动态名字：

@app.route("/user/")
def user(name):
return "
Hello, %s!
" % name

程序实例用run 方法启动Flask 集成的开发Web 服务器：

if __name__ == "__main__":
app.run(debug=True)

name__==" main__"是Python 的惯常用法，在这里确保直接执行这个脚本时才启动开发Web 服务器。如果这个脚本由其他脚本引入，程序假定父级脚本会启动不同的服务器，因此不会执行app.run()。

示例1.4　hello.py：一个完整的Flask 程序

from flask import Flask
app = Flask(__name__)

@app.route("/")
def index():
    return "
Hello World!
"

@app.route("/user/")
def user(name):
    return "
Hello, %s!
" % name

if __name__ == "__main__":
    app.run(debug=True)

使用装饰器的形式去捕获指定的错误码和异常

@app.errorhandler(404)
def page_not_found(error):
    return    "404"

为了让每个视图函数避免编写重复功能的代码，Flask提供了通用设施的功能，即请求钩子。
请求钩子是通过装饰器的形式实现，Flask支持如下四种请求钩子：

before_first_request：注册一个函数，在处理第一个请求之前运行。
before_request：注册一个函数，在每次请求之前运行。
after_request：注册一个函数，如果没有未处理的异常抛出，在每次请求之后运行。
teardown_request：注册一个函数，即使有未处理的异常抛出，也在每次请求之后运行。

--

模板是一个包含响应文本的文件，其中包含用占位变量表示的动态部分，其具体值只在请求的上下文中才能知道。使用真实值替换变量，再返回最终得到的响应字符串，这一过程称为渲染。为了渲染模板，Flask 使用了一个名为Jinja2 的强大模板引擎。

Jinjia2是由python实现的
是Flask内置的模板语言
参照Django设计思想设计的，跟Django差不多

默认情况下，Flask 在程序文件夹中的templates 子文件夹中寻找模板。Flask提供的

示例 hello.py : 渲染模板

from flask import Flask, render_template
# ...
@app.route("/")
def index():
    return render_template("index.html")
@app.route("/user/")
def user(name):
    return render_template("user.html", name=name)

示例　templates/index.html：Jinja2 模板

Hello World!

示例

Hello, {{ name }}!

render_template 函数封装了该模板引擎
render_template 函数的第一个参数是模板的文件名，后面的参数都是键值对，表示模板中变量对应的真实值

在模板中使用的{{ name }} 结构表示一个变量，它是一种特殊的占位符，告诉模
板引擎这个位置的值从渲染模板时使用的数据中获取。

可以使用过滤器修改变量，过滤器名添加在变量名之后，中间使用竖线分隔。例如，下述模板以首字母大写形式显示变量name 的值：

Hello, {{ name|capitalize }}

Jinja2 提供的部分常用过滤器

表 Jinja2变量过滤器

Jinja2 提供了多种控制结构，可用来改变模板的渲染流程。

条件控制：

{% if user %}
    Hello, {{ user }}!
{% else %}
    Hello, Stranger!
{% endif %}

循环控制：

    {% for comment in comments %}
        
{{ comment }}
    {% endfor %}

宏

{ % macro render_comment(comment) % }
    
{{ comment }}
{ % endmacro % }


    { % for comment in comments % }
        
        {{ render_comment(comment) }}
    { % endfor % }

在模板中，可能会遇到以下问题

多个模板具有完全相同的顶部和底部内容

多个模板中具有相同的模板代码内容，但是内容中部分值不一样

多个模板中具有完全相同的 html 代码块内容

像遇到这种情况，可以使用 JinJa2 模板中的 宏、继承、包含来进行实现

模板继承

标签定义的内容

{% block   %} {% endblock %}

模板继承是为了重用模板中的公共内容。一般Web开发中，继承主要使用在网站的顶部菜单、底部。这些内容可以定义在父模板中，子模板直接继承，而不需要重复书写。

首先创建一个名为base.html 的基模板

    {% block head %}
    
    {% endblock %}


    {% block body %}
    {% endblock %}

block 标签定义的元素可在衍生模板中修改。在本例中，我们定义了名为head、title 和
body 的块。注意，title 包含在head 中。下面这个示例是基模板的衍生模板：

{% extends "base.html" %}
{% block title %}Index{% endblock %}
{% block head %}
    {{ super() }}
    
{% endblock %}
{% block body %}
Hello, World!
{% endblock %}

extends 指令声明这个模板衍生自base.html。在extends 指令之后，基模板中的3 个块被
重新定义，模板引擎会将其插入适当的位置。注意新定义的head 块，在基模板中其内容不
是空的，所以使用super() 获取原来的内容。

Bootstrap（http://getbootstrap.com/）是Twitter 开发的一个开源框架，它提供的用户界面组
件可用于创建整洁且具有吸引力的网页，而且这些网页还能兼容所有现代Web 浏览器。
Bootstrap 是客户端框架，因此不会直接涉及服务器。服务器需要做的只是提供引用了
Bootstrap 层叠样式表（CSS） 和JavaScript 文件的HTML 响应， 并在HTML、CSS 和
JavaScript 代码中实例化所需组件。这些操作最理想的执行场所就是模板。

初始化Flask-Bootstrap

from flask.ext.bootstrap import Bootstrap
# ...
bootstrap = Bootstrap(app)

初始化 Flask-Bootstrap 之后,就可以在程序中使用一个包含所有 Bootstrap 文件的基模板。这个模板利用Jinja2的模板继承机制,让程序扩展一个具有基本页面结构的基模板,其中就有用来引入 Bootstrap 的元素。官方教程

{% extends "bootstrap/base.html" %}

{% block title %}Flasky{% endblock %}

{% block navbar %}

{% endblock %}

{% block content %}

    

        
Hello, {{ name }}!
    

{% endblock %}

像常规路由一样，Flask 允许程序使用基于模板的自定义错误页面。最常见的错误代码有
两个：404，客户端请求未知页面或路由时显示；500，有未处理的异常时显示。

例 hello.py:自定义错误页面

@app.errorhandler(404)
def page_not_found(e):
    return render_template("404.html"), 404

@app.errorhandler(500)
def internal_server_error(e):
    return render_template("500.html"), 500

在模板中直接编写简单路由的 URL 链接不难,但对于包含可变部分的动态路由,在模板中构建正确的 URL 就很困难。而且,直接编写 URL 会对代码中定义的路由产生不必要的依赖关系。如果重新定义路由,模板中的链接可能会失效。Flask 提供了 url_for() 辅助函数,它可以使用程序 URL 映射中保存的信息生成 URL。

用静态文件,例如 HTML代码中引用的图片、JavaScript 源码文件和 CSS。默认设置下,Flask 在程序根目录中名为 static 的子目录中寻找静态文件。如果需要,可在static 文件夹中使用子文件夹存放文件。
如索引图标的位置{{ url_for("static", filename = "favicon.ico") }}