web框架---Flask

Flask

Flask是一个基于Python开发并且依赖jinja2模板和Werkzeug WSGI服务的一个微型框架，对于Werkzeug本质是Socket服务端，其用于接收http请求并对请求进行预处理，然后触发Flask框架，开发人员基于Flask框架提供的功能对请求进行相应的处理，并返回给用户，如果要返回给用户复杂的内容时，需要借助jinja2模板来实现对模板的处理，即：将模板和数据进行渲染，将渲染后的字符串返回给用户浏览器。

“微”(micro) 并不表示你需要把整个 Web 应用塞进单个 Python 文件（虽然确实可以），也不意味着 Flask 在功能上有所欠缺。微框架中的“微”意味着 Flask 旨在保持核心简单而易于扩展。Flask 不会替你做出太多决策——比如使用何种数据库。而那些 Flask 所选择的——比如使用何种模板引擎——则很容易替换。除此之外的一切都由可由你掌握。如此，Flask 可以与您珠联璧合。

默认情况下，Flask 不包含数据库抽象层、表单验证，或是其它任何已有多种库可以胜任的功能。然而，Flask 支持用扩展来给应用添加这些功能，如同是 Flask 本身实现的一样。众多的扩展提供了数据库集成、表单验证、上传处理、各种各样的开放认证技术等功能。Flask 也许是“微小”的，但它已准备好在需求繁杂的生产环境中投入使用。

安装

1 pip install Flask

一、第一次

1 from flask import Flask
2 app = Flask(__name__)
3  
4 @app.route("/")
5 def hello():
6     return "Hello World!"
7  
8 if __name__ == "__main__":
9     app.run()

二、路由系统

@app.route('/user/<username>')
@app.route('/post/<int:post_id>')
@app.route('/post/<float:post_id>')
@app.route('/post/<path:path>')
@app.route('/login', methods=['GET', 'POST'])

常用路由系统有以上五种，所有的路由系统都是基于一下对应关系来处理：

1 DEFAULT_CONVERTERS = {
2     'default':          UnicodeConverter,
3     'string':           UnicodeConverter,
4     'any':              AnyConverter,
5     'path':             PathConverter,
6     'int':              IntegerConverter,
7     'float':            FloatConverter,
8     'uuid':             UUIDConverter,
9 }

注：对于Flask默认不支持直接写正则表达式的路由，不过可以通过自定义来实现，见：https://segmentfault.com/q/1010000000125259

三、模板

1、模板的使用

Flask使用的是Jinja2模板，所以其语法和Django无差别

2、自定义模板方法

Flask中自定义模板方法的方式和Bottle相似，创建一个函数并通过参数的形式传入render_template，如：

 1 <!DOCTYPE html>
 2 <html>
 3 <head lang="en">
 4     <meta charset="UTF-8">
 5     <title></title>
 6 </head>
 7 <body>
 8     <h1>自定义函数</h1>
 9     {{ww()|safe}}
10 
11 </body>
12 </html>
13 
14 index.html

index.html

 1 #!/usr/bin/env python
 2 # -*- coding:utf-8 -*-
 3 from flask import Flask,render_template
 4 app = Flask(__name__)
 5  
 6  
 7 def wupeiqi():
 8     return '<h1>Wupeiqi</h1>'
 9  
10 @app.route('/login', methods=['GET', 'POST'])
11 def login():
12     return render_template('login.html', ww=wupeiqi)
13  
14 app.run()

四、公共组件

1、请求

对于Http请求，Flask会讲请求信息封装在request中(werkzeug.wrappers.BaseRequest)，提供的如下常用方法和字段以供使用：

 1 request.method
 2 request.args
 3 request.form
 4 request.values
 5 request.files
 6 request.cookies
 7 request.headers
 8 request.path
 9 request.full_path
10 request.script_root
11 request.url
12 request.base_url
13 request.url_root
14 request.host_url
15 request.host

 1 @app.route('/login', methods=['POST', 'GET'])
 2 def login():
 3     error = None
 4     if request.method == 'POST':
 5         if valid_login(request.form['username'],
 6                        request.form['password']):
 7             return log_the_user_in(request.form['username'])
 8         else:
 9             error = 'Invalid username/password'
10     # the code below is executed if the request method
11     # was GET or the credentials were invalid
12     return render_template('login.html', error=error)
13 
14 表单处理Demo

表单处理Demo

 1 from flask import request
 2 from werkzeug import secure_filename
 3 
 4 @app.route('/upload', methods=['GET', 'POST'])
 5 def upload_file():
 6     if request.method == 'POST':
 7         f = request.files['the_file']
 8         f.save('/var/www/uploads/' + secure_filename(f.filename))
 9     ...
10 
11 上传文件Demo

上传文件Demo

 1 from flask import request
 2 
 3 @app.route('/setcookie/')
 4 def index():
 5     username = request.cookies.get('username')
 6     # use cookies.get(key) instead of cookies[key] to not get a
 7     # KeyError if the cookie is missing.
 8 
 9 
10 
11 
12 from flask import make_response
13 
14 @app.route('/getcookie')
15 def index():
16     resp = make_response(render_template(...))
17     resp.set_cookie('username', 'the username')
18     return resp
19 
20 Cookie操作

Cookie操作

2、响应

当用户请求被开发人员的逻辑处理完成之后，会将结果发送给用户浏览器，那么就需要对请求做出相应的响应。

a.字符串

1 @app.route('/index/', methods=['GET', 'POST'])
2 def index():
3     return "index"

b.模板引擎

1 from flask import Flask,render_template,request
2 app = Flask(__name__)
3  
4 @app.route('/index/', methods=['GET', 'POST'])
5 def index():
6     return render_template("index.html")
7  
8 app.run()

c.重定向

 1 #!/usr/bin/env python
 2 # -*- coding:utf-8 -*-
 3 from flask import Flask, redirect, url_for
 4 app = Flask(__name__)
 5  
 6 @app.route('/index/', methods=['GET', 'POST'])
 7 def index():
 8     # return redirect('/login/')
 9     return redirect(url_for('login'))
10  
11 @app.route('/login/', methods=['GET', 'POST'])
12 def login():
13     return "LOGIN"
14  
15 app.run()

d.错误页面

1 from flask import Flask, abort, render_template
2 app = Flask(__name__)
3 
4 @app.route('/e1/', methods=['GET', 'POST'])
5 def index():
6     abort(404, 'Nothing')
7 app.run()
8 
9 指定URL，简单错误

指定URL，简单错误

 1 from flask import Flask, abort, render_template
 2 app = Flask(__name__)
 3  
 4 @app.route('/index/', methods=['GET', 'POST'])
 5 def index():
 6     return "OK"
 7  
 8 @app.errorhandler(404)
 9 def page_not_found(error):
10     return render_template('page_not_found.html'), 404
11  
12 app.run()

e.设置相应信息

使用make_response可以对相应的内容进行操作

 1 from flask import Flask, abort, render_template,make_response
 2 app = Flask(__name__)
 3  
 4 @app.route('/index/', methods=['GET', 'POST'])
 5 def index():
 6     response = make_response(render_template('index.html'))
 7     # response是flask.wrappers.Response类型
 8     # response.delete_cookie
 9     # response.set_cookie
10     # response.headers['X-Something'] = 'A value'
11     return response
12  
13 app.run()

3、Session

除请求对象之外，还有一个 session 对象。它允许你在不同请求间存储特定用户的信息。它是在 Cookies 的基础上实现的，并且对 Cookies 进行密钥签名要使用会话，你需要设置一个密钥。

设置：session['username'] ＝ 'xxx'
删除：session.pop('username', None)

 1 from flask import Flask, session, redirect, url_for, escape, request
 2  
 3 app = Flask(__name__)
 4  
 5 @app.route('/')
 6 def index():
 7     if 'username' in session:
 8         return 'Logged in as %s' % escape(session['username'])
 9     return 'You are not logged in'
10  
11 @app.route('/login', methods=['GET', 'POST'])
12 def login():
13     if request.method == 'POST':
14         session['username'] = request.form['username']
15         return redirect(url_for('index'))
16     return '''
17         <form action="" method="post">
18             <p><input type=text name=username>
19             <p><input type=submit value=Login>
20         </form>
21     '''
22  
23 @app.route('/logout')
24 def logout():
25     # remove the username from the session if it's there
26     session.pop('username', None)
27     return redirect(url_for('index'))
28  
29 # set the secret key.  keep this really secret:
30 app.secret_key = 'A0Zr98j/3yX R~XHH!jmN]LWX/,?RT'

View Code

4.message

message是一个基于Session实现的用于保存数据的集合，其特点是：使用一次就删除

 1 <!DOCTYPE html>
 2 <html>
 3 <head lang="en">
 4     <meta charset="UTF-8">
 5     <title></title>
 6 </head>
 7 <body>
 8     {% with messages = get_flashed_messages() %}
 9         {% if messages %}
10         <ul class=flashes>
11             {% for message in messages %}
12             <li>{{ message }}</li>
13             {% endfor %}
14         </ul>
15         {% endif %}
16     {% endwith %}
17 </body>
18 </html>
19 
20 index.html

index.html

 1 from flask import Flask, flash, redirect, render_template, request
 2  
 3 app = Flask(__name__)
 4 app.secret_key = 'some_secret'
 5  
 6 @app.route('/')
 7 def index1():
 8     return render_template('index.html')
 9  
10 @app.route('/set')
11 def index2():
12     v = request.args.get('p')
13     flash(v)
14     return 'ok'
15  
16 if __name__ == "__main__":
17     app.run()

5.中间件

 1 from flask import Flask, flash, redirect, render_template, request
 2  
 3 app = Flask(__name__)
 4 app.secret_key = 'some_secret'
 5  
 6 @app.route('/')
 7 def index1():
 8     return render_template('index.html')
 9  
10 @app.route('/set')
11 def index2():
12     v = request.args.get('p')
13     flash(v)
14     return 'ok'
15  
16 class MiddleWare:
17     def __init__(self,wsgi_app):
18         self.wsgi_app = wsgi_app
19  
20     def __call__(self, *args, **kwargs):
21  
22         return self.wsgi_app(*args, **kwargs)
23  
24 if __name__ == "__main__":
25     app.wsgi_app = MiddleWare(app.wsgi_app)
26     app.run(port=9999)

Flask还有众多其他功能，更多参见：
http://docs.jinkan.org/docs/flask/
http://flask.pocoo.org/