Flask简介

Flask是一个相对于Django而言轻量级的Web框架。

和Django大包大揽不同，Flask建立于一系列的开源软件包之上，这其中 最主要的是WSGI应用开发库Werkzeug和模板引擎Jinja：

策略 ：werkzeug和Jinja这两个库和Flask一样，都是pocoo团队开发的。这 或许体现了pocoo与Django竞争时关于生态的一种策略，这种策略的自然延伸是Flask框架中没有包含数据库方面的构件，无论ORM还是其他。

关注点 ：Flask是一个WSGI应用框架，这意味着我们进行Flask开发时，不需要 关注网络方面的操作，Flask应用的入口是封装过的网络请求包，出口是 网络响应，我们仅需要关注这个阶段内的处理逻辑。

WSGI服务器 ：Flask虽然内置了简单的WSGI服务器，但其性能仅仅适用于开发期的调试。 Flask官网推荐了多种WSGI服务器，实现方式从多进程到多线程到协程， 这方面的选择我们在本课程中将不涉及。

REST适应性 ：虽然Flask和Django一样，最初的出发点都是服务端的动态网页应用。但 Flask的设计使之也相当适用于面向资源的REST架构，在越来越移动化 并且单页应用越来越重要的WEB开发领域，这是Flask相对于Django相当 大的优势。

这里推荐大家一个学习flask的教程，本文的内容也是转自该教程。

Hello Flask

编写一个基于Flask的hello world相当容易：

1、导入Flask类

from flask import Flask

Flask类是Flask框架的核心类，它实现了WSGI应用规范。

2、创建Flask实例

app = Flask(__name__)

Flask构造函数的第一个参数指定一个引入名/importname。Flask框架 使用这个名字进行静态资源、模板、错误信息的定位。除非你清楚的理解它的 作用，通常情况下，我们总应该使用特殊变量_name。

Flask实例是可调用的（具有call方法），这个实例可以直接对接 WSGI服务器。

3、注册路由

@route('/')def index():    return 'Hello,Flask!'

注册路由就是建立URL规则和处理函数之间的关联。Flask框架依赖于路由 完成HTTP请求的分发。

路由中的函数被称为视图函数，其返回值将作为HTTP响应的正文内容。

4、对接并启动WSGI服务器

Flask封装了一个简单的开发用WSGI服务器，我们可以通过调用run() 启动服务器运行：

app.run(host='0.0.0.0',port=80)

概述

路由是MVC架构的Web框架中相当重要的一个概念，也是本节课程的重点。

顾名思意，路由就是在迷茫中找出一条路的意思。在Flask框架中的路由就表示为用户请求的URL找出其对应的处理函数之意。

可见路由表在Flask应用中处于相当核心的位置。路由表的内容是由应用开发者填充。

route装饰器 ：可以使用Flask应用实例的route装饰器将一个URL规则绑定到 一个视图函数上。

例如，下面的示例将URL规则/test绑定到视图函数test()上：

@app.route('/test')def test():    return 'this is response'

如果这个应用部署在主机ezhost.com的根目录下，那么当用户访问：

http://ezhost.com/teset

Flask框架就会调用我们的test()函数，其返回结果就传递给WSGI服务器发送给访问者。

add_url_rule() ：另一种等价的写法是使用Flask应用实例的add_url_route()方法。 下面的示例注册了一个与前例相同的路由：

def test():    return 'this is response'app.add_url_route('/test',view_func=test)

其实，route装饰器内部也是通过调用add_url_route()方法实现的路由注册。 但是显然，使用装饰器使代码看起来更优雅一些。

为路由指定HTTP方法

默认情况下，Flask路由仅支持HTTP的GET请求。可以使用methods关键字参数，在注册 路由时显式地声明视图方法支持的HTTP方法。

例如，下面的示例将URL规则/auth绑定到视图函数v_auth()，这个路由仅支持POST方法：

@app.route('/auth',methods=['POST'])def v_auth():pass

指定多种HTTP方法支持

关键字参数methods的类型为list，因此可以同时指定多种HTTP方法。

下面的示例中，使URL规则/user同时支持POST方法和GET方法：

@app.route('/user',methods=['POST','GET'])def v_users():    if request.method == 'GET':        return ... # 返回用户列表    if request.method == 'POST'        return ... #创建新用户

这个特性使Flask非常易于开发REST架构的后台服务，而不仅仅局限于传统的动态网页。

匹配动态URL

有时我们需要将同一类URL映射到同一个视图函数处理，比如，使用同一个视图函数 来显示不同用户的个人档案。我们希望以下的URL都可以分发到同一个视图函数：

默认访问点 ：当我们使用route装饰器注册路由时，默认使用被装饰函数的 函数名（name）作为访问点，因此，你看到上面的表中，路由中的访问点为home。

自定义访问点 ：可以在使用route装饰器或调用add_url_rule()方法注册路由时，使用 endpoint关键字参数改变这一默认行为：

@app.route('/home',endpoint='whocare')def home():pass

此时的两张路由表将变成这样：

静态目录路由

当创建应用实例时，Flask将自动添加一条静态目录路由，其访问点 始终被设置为static，URL规则默认被设置为/static，本地路径默认被 设置为应用文件夹下的static子文件夹：

+————————————————————+ | url rule | endpoint | view_function | | /static | static | Flask.send_static_file | +————————————————————+ 如果你的应用目录如下：

/app    /web.py    /static        /main.css        /jquery.min.js   

那么启动应用后就可以通过URL/static/main.css访问static文件夹下的main.css了。

除了访问点被固定为static，静态目录的URL规则和本地目录都是可以根据应用情况进行调整。

改变默认的本地路径 ：可以在创建应用对象时使用关键字参数static_folder改变 默认的静态文件夹。例如，你的静态文件都存放在应用下的assets目录下， 那么可以按如下的方式创建应用对象：

app = Flask(name,static_folder=’assets’) 也可以使用一个绝对路径：

app = Flask(name,static_folder=’/var/www/static’) 改变默认的本地路径并不会对路由表产生影响。

改变默认的URL规则 ： 如果不喜欢静态目录URL/static，也可以在创建应用 对象时使用关键字参数static_url_path换一个别的名字。

下面的示例中，将应用下的assets文件夹注册为静态目录/assets：

app = Flask(name,static_folder=’assets’,static_url_path=’/assets’) 当应用运行后，通过URL/assets/main.css就可以访问assets文件夹下的 main.css文件了。

这时的路由表变化为：

+————————————————————+ | url | endpoint | view_function | | /assets | static | Flask.send_static_file | +————————————————————+

构造URL

在一个实用的视图中，不可避免地存在指向其他视图的链接。在之前的课程示例中，我们 都是在视图函数中这样硬编码这些链接URL的：

@app.route('/')def v_index():    return '<a href="/tech">tech</a>'@app.route('/tech') def v_tech():pass

大部分情况下这种硬编码URL是可以工作的。但如果这个应用被挂在WSGI服务器的一个 子路径下，比如：/app1，那么用户访问URL/tech是不会成功的，这时应当访问/app1/tech 才可以正确地路由到视图函数v_tech()。

我们应当使用访问点让Flask框架帮我们计算链接URL。简单地给url_for()函数传入 一个访问点，它返回将是一个可靠的URL地址：

@app.route('/')def v_index():    print url_for('v_contacts')  # /contact    return 'see console output!'@app.route('/contact')def v_contacts():pass

添加查询参数 ： 使用关键字参数，可以在构造的URL中生成查询串。下面的调用将生成 /contact?format=json

@app.route('/')def v_index():    print url_for('v_contacts',format='json')    return  ''@app.route('/contact') def v_contacts():pass

添加URL变量 ： 如果指定访问点对应的视图函数接收参数，那么关键字参数将生成对应的参数URL。下面的 示例将生成/contact/Julia?format=html：

@app.route('/')def v_index():    print url_for('v_contact',name='Julia',format='html')    return ''@app.route('/contact/<name>')def v_contact(name):pass</name>

添加锚点 ：使用_anchor关键字可以为生成的URL添加锚点。下面的示例将生成URL /contact#part2

@app.route('/')def v_index():    print url_for('v_contacts',_anchor='part2')@app.route('/contact')def v_contacts():pass

外部URL ： 默认情况下，url_for()生成站内URL，可以设置关键字参数_external 为True，生成包含站点地址的外部URL。下面的示例将生成URLhttp://<x.y.z>/contacts:

@app.route('/')def v_index():    print url_for('v_contacts',_external=True)@app.route('/contact')def v_contacts():pass