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
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
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
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操作
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,简单错误
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'
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
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/