Flask Web开发 第一部分 virtualenv & 第2章 Flask程序的基本结构

1. virtualenv

pip install virtualenv

创建windows系统下的 Python 虚拟环境
这个命令只有一个必需的参数，即虚拟环境的名字。创建虚拟环境后，当前文件夹中会出现一个子文件夹，名字就是上述命令中指定的参数，与虚拟环境相关的文件都保存在这个子文件夹中。
按照惯例，一般虚拟环境会被命名为 venv

$ virtualenv venv
 New python executable in venv/bin/python2.7
Also creating executable in venv/bin/python
Installing setuptools............done.
Installing pip...............done.

linux和macos,激活命令
$ source venv/bin/activate
使用微软 Windows 系统，激活命令是：

$ venv\Scripts\activate

取消激活用deactivate

如果虚拟环境和大环境python版本不一致，想在virtualenv中 指定 python 解释器的版本要用参数P，先下载安装包装好对应版本的python，比如创建D盘里面的python2.7.6版本解释器的虚拟环境

virtualenv -p D:\Python27\python.exe venv27

则在当前文件夹下创建名为venv27的python2.7虚拟环境了

2. 基本结构

2.1　初始化

from flask import Flask
app = Flask(__name__)

所有 Flask 程序都必须创建一个程序实例，程序实例是 Flask 类的对象，Web 服务器使用一种名为 Web 服务器网关接口（Web Server Gateway Interface，WSGI）的协议，把接收自客户端的所有请求都转交给这个对象处理。Flask 类的构造函数只有一个必须指定的参数，即程序主模块或包的名字。在大多数程序中，Python 的系统变量 name 变量就是所需的值。（name有2个取值：当模块是被调用执行的，取值为模块的名字。当模块是直接执行的，则该变量取值为：main ，关于变量name的详细介绍参考：http://blog.csdn.net/qq_32166627/article/details/59109080）

2.2　路由和视图函数

这章还好，就是修饰器，pass

2.3　启动服务器

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

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

服务器启动后，会进入轮询，等待并处理请求。轮询会一直运行，直到程序停止，比如按Ctrl-C 键。

有一些选项参数可被 app.run() 函数接受用于设置 Web 服务器的操作模式。在开发过程中启用调试模式会带来一些便利，比如说激活调试器和重载程序。要想启用调试模式，我们可以把 debug 参数设为 True 。

2.3　启动服务器
pass
2.4　一个完整的程序
pass
2.5　请求-响应循环
pass

2.5.1　程序和请求上下文

Flask 从客户端收到请求时，要让视图函数能访问一些对象，这样才能处理请求。请求对象就是一个很好的例子，它封装了客户端发送的 HTTP 请求。要想让视图函数能够访问请求对象，一个显而易见的方式是将其作为参数传入视图函数，不过这会导致程序中的每个视图函数都增加一个参数。除了访问请求对象，如果视图函数在处理请求时还要访问其他对象，情况会变得更糟。为了避免大量可有可无的参数把视图函数弄得一团糟，Flask 使用上下文临时把某些对象变为全局可访问。有了上下文，就可以写出下面的视图函数：

from Flask import request

@app.route('/')
def index():
        user_agent = request.headers.get('User-Agent')
        return '<p>Your Browser is %s</p>' % user_agent

注意在这个视图函数中我们如何把 request 当作全局变量使用。事实上， request 不可能是全局变量。试想，在多线程服务器中，多个线程同时处理不同客户端发送的不同请求时，每个线程看到的 request 对象必然不同。Falsk 使用上下文让特定的变量在一个线程中全局可访问，与此同时却不会干扰其他线程。在 Flask 中有两种上下文：程序上下文和请求上下文。表 2-1 列出了这两种上下文提供的变量。

Flask 在分发请求之前激活（或推送）程序和请求上下文，请求处理完成后再将其删除。程序上下文被推送后，就可以在线程中使用 current_app 和 g 变量。类似地，请求上下文被推送后，就可以使用 request 和 session 变量。如果使用这些变量时我们没有激活程序上
下文或请求上下文，就会导致错误。

下面这个 Python shell 会话演示了程序上下文的使用方法：

>>> from hello import app
>>> from flask import current_app
>>> current_app.name
Traceback (most recent call last):
...
RuntimeError: working outside of application context
>>> app_ctx = app.app_context()
>>> app_ctx.push()
>>> current_app.name
'hello'
>>> app_ctx.pop()

在这个例子中，没激活程序上下文之前就调用 current_app.name 会导致错误，但推送完上
下文之后就可以调用了。注意，在程序实例上调用 app.app_context() 可获得一个程序上
下文。

2.5.2　请求调度

Flask 使用 app.route 修饰器或者非修饰器形式的 app.add_url_rule() 生成映射。

2.5.3　请求钩子

有时在处理请求之前或之后执行代码会很有用，Flask 提供了注册通用函数的功能，注册的函数可在请求被分发到视图函数之前或之后调用。请求钩子使用修饰器实现。Flask 支持以下 4 种钩子。

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

在请求钩子函数和视图函数之间共享数据一般使用上下文全局变量 g 。例如， before_request 处理程序可以从数据库中加载已登录用户，并将其保存到 g.user 中。随后调用视图函数时，视图函数再使用 g.user 获取用户。

2.5.4　响应

如果视图函数返回的响应需要使用不同的状态码，那么可以把数字代码作为第二个返回值，添加到响应文本之后。例如，下述视图函数返回一个 400 状态码，表示请求无效：

@app.route('/')
    def index():
    return '<h1>Bad Request</h1>', 400

如果不想返回由 1 个、2 个或 3 个值组成的元组，Flask 视图函数还可以返回 Response 对象。 make_response() 函数可接受 1 个、2 个或 3 个参数（和视图函数的返回值一样），并返回一个 Response 对象。有时我们需要在视图函数中进行这种转换，然后在响应对象上调用各种方法，进一步设置响应。下例创建了一个响应对象，然后设置了 cookie：

from flask import make_response

@app.route('/')
        def index():
        response = make_response('<h1>This document carries a cookie!</h1>')
        response.set_cookie('answer', '42')
        return response

重定向

from flask import redirect
@app.route('/')
def index():
        return redirect('http://www.example.com')

还有一种特殊的响应由 abort 函数生成，用于处理错误。在下面这个例子中，如果 URL 中动态参数 id 对应的用户不存在，就返回状态码 404：
abort 不会把控制权交还给调用它的函数，而是抛出异常把控制权交给 Web 服
务器。

from flask import abort
@app.route('/user/<id>')
def get_user(id):
    user = load_user(id)
    if not user:
        abort(404)
    return '<h1>Hello, %s</h1>' % user.name

2.6　Flask扩展
如何把扩展整合到程序中?good question!
Flask 的开发 Web 服务器支持很多启动设置选项，但只能在脚本中作为参数传给 app.run()函数。这种方式并不十分方便，传递设置选项的理想方式是使用命令行参数。Flask-Script 是一个 Flask 扩展，为 Flask 程序添加了一个命令行解析器。Flask-Script 自带了一组常用选项，而且还支持自定义命令。
Flask-Script 扩展使用 pip 安装：

(venv) $ pip install flask-script

把命令行解析功能添加到 hello.py 程序中时需要修改的地方

from flask_script import Manager
manager = Manager(app)
# ...
if __name__ == '__main__':
manager.run()

这个扩展的初始化方法也适用于其他很多扩展：把程序实例作为参数传给构造函数，初始化主类的实例。创建的对象可以在各个扩展中使用。在这里，服务器由 manager.run() 启动，启动后就能解析命令行了