Flask框架基础（二）

2019年10月2日 169次阅读 来源: 周闖

1 程序的基本结构

1.1初始化

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

from flask import Flask
app = Flask(__name__)

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

1.2注册路由

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

@app.route('/')
def index():
return '<h1>Hello World!</h1>'

在这个程序中，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/&lt;your-name>， 用户名（your-name）是地址的一部分。Flask 支持这种形式的URL，只需在route 修饰器中使用特殊的句法即可。下例定义的路由中就有一部分是动态名字：

@app.route('/user/<name>')
def user(name):
return '<h1>Hello, %s!</h1>' % name

1.3启动服务器

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

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

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

1.4完整的程序

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

from flask import Flask
app = Flask(__name__)

@app.route('/')
def index():
    return '<h1>Hello World!</h1>'

@app.route('/user/<name>')
def user(name):
    return '<h1>Hello, %s!</h1>' % name

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

1.4 异常捕获

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

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

1.5请求钩子

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

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

—

2 模板

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

2.1 Jinja2模板引擎

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

2.1.1渲染模板

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

示例 hello.py : 渲染模板

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

示例　templates/index.html：Jinja2 模板

<h1>Hello World!</h1>

示例

<h1>Hello, {{ name }}!</h1>

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

2.1.2 变量

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

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

Hello, {{ name|capitalize }}

Jinja2 提供的部分常用过滤器

表 Jinja2变量过滤器

过滤器名说明
safe渲染值时不转义
capitalize把值的首字母转换成大写，其他字母转换成小写
lower把值转换成小写形式
upper把值转换成大写形式
title把值中每个单词的首字母都转换成大写
trim把值的首尾空格去掉
striptags渲染之前把值中所有的HTML 标签都删掉

2.1.3 控制结构

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

  • 条件控制：
{% if user %}
    Hello, {{ user }}!
{% else %}
    Hello, Stranger!
{% endif %}
  • 循环控制：
<ul>
    {% for comment in comments %}
        <li>{{ comment }}</li>
    {% endfor %}
</ul>
  • 宏
<!--宏的定义-->
{ % macro render_comment(comment) % }
    <li>{{ comment }}</li>
{ % endmacro % }
<!--宏的使用-->
<ul>
    { % for comment in comments % }
        <!--宏调用-->
        {{ render_comment(comment) }}
    { % endfor % }
</ul>

模板代码复用

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

  1. 多个模板具有完全相同的顶部和底部内容
  2. 多个模板中具有相同的模板代码内容，但是内容中部分值不一样
  3. 多个模板中具有完全相同的 html 代码块内容

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

模板继承

标签定义的内容

{% block %} {% endblock %}

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

首先创建一个名为base.html 的基模板
<html>
<head>
    {% block head %}
    <title>{% block title %}{% endblock %} - My Application</title>
    {% endblock %}
</head>
<body>
    {% block body %}
    {% endblock %}
</body>
</html>

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

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

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

2.2 Flask-Bootstrap

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" %}<!--extends 指 令 从 Flask-Bootstrap中导入bootstrap/base.html,实现模板继承。 -->

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

{% block navbar %}
<div class="navbar navbar-inverse" role="navigation">
    <div class="container">
        <div class="navbar-header">
            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
            </button>
            <a class="navbar-brand" href="/">Flasky</a>
        </div>
        <div class="navbar-collapse collapse">
            <ul class="nav navbar-nav">
                <li><a href="/">Home</a></li>
            </ul>
        </div>
    </div>
</div>
{% endblock %}

{% block content %}
<div class="container">
    <div class="page-header">
        <h1>Hello, {{ name }}!</h1>
    </div>
</div>
{% endblock %}

2.3 自定义错误页面

像常规路由一样，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

2.4 链接

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

2.5 静态文件

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

    原文作者：周闖
    原文地址: https://segmentfault.com/a/1190000016900621
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞