Flask——xinge中文文档

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、hello,world!

from flask import Flask

app = Flask(__name__)　　# 静态文件和模板文件的配置


@app.route('/')     # 路由映射
def hello_world():
    return 'Hello World!'   # 返回字符串


if __name__ == '__main__':
    app.run()　　# IP和端口的配置

2、返回模板

from flask import render_template # 引入

return render_template('index.html') # 返回模板

3、路由系统

@app.route('/user/<username>')     # 字符串类型，赋值给username
@app.route('/post/<int:post_id>')   # 传整型，赋值给post_id
@app.route('/post/<float:post_id>')    # 浮点型，赋值给post_id
@app.route('/post/<path:path>')     # 路径
@app.route('/login', methods=['GET', 'POST'])　　# 设置get/post请求方式

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

DEFAULT_CONVERTERS = {      # 内置方法，是用正则表达式帮我们整的
    'default':          UnicodeConverter,
    'string':           UnicodeConverter,
    'any':              AnyConverter,　　# <any:(about,help,class,...):page_name>
    'path':             PathConverter,
    'int':              IntegerConverter,
    'float':            FloatConverter,
    'uuid':             UUIDConverter,
}

注：对于Flask默认不支持直接写正则表达式的路由，不过可以通过自定义来实现

4、获取用户请求数据

from flask import request

request.method
request.args		# 获取get请求的数据
request.form		# 获取form表单
request.values
request.files
request.cookies		# 获取cookie
request.headers		# 获取请求头
request.path		# 请求url
request.full_path	# 请求完整的url
request.script_root
request.url
request.base_url
request.url_root
request.host_url
request.host

5、设置cookie

from flask import make_response

@app.route('/setcookie')
def index():
    resp = make_response(render_template(...))
    resp.set_cookie('username', 'the username')
    return resp
	
@app.route('/getcookie')
def get_cookie():
	request.cookies.get('username')

6、重定向

from flask import redirect # 引入

return redirect('/index') # 重定向

7、动态生成url（类似Django的reverse功能）

from flask import url_for

url = url_for('函数名')   # 动态生成url：类似Django的reverse功能，name默认是函数名
return redirect(url)    # 重定向redirect

8、设置清除session

flask的session实际上就是加密的cookie，返回到浏览器

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

from flask import session

session['username']="asdf"　　　　# 设置session
session.pop('username', None)　　# 删除session

if __name__ == "__main__":
    ...
    app.secret_key = 'A0Zr98j/3yX R~XHH!jmN]LWX/,?RT'

 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

9、自定制中间件

Python框架的中间件大多数都是使用__call__方法触发的。

我们要做的重新为app.wsgi_app赋值，app内部会执行__call__方法，经过中间件。

class Foo(object):
    def __init__(self,w):
        self.w = w
    def __call__(self, environ, start_response):　　# 生成实例后再加括号执行Foo()()
	# app执行之前通过
        obj = self.w(environ, start_response)
        # app执行之后通过
		return obj


if __name__ == "__main__":
    app.wsgi_app = Foo(app.wsgi_app)　　# 执行Foo中的__init__后，内部执行__call__方法
	
    app.run()

10、message

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

实现原理：将访问的数据放到session中，当请求过一次后删除session

@app.route('/')
def index1():
    # 获取消息
    v = get_flashed_messages()
    print(v)
    return render_template('s4.html')


@app.route('/set')
def index2():
    v = request.args.get('p')
    # 设置消息
    flash('kkkk')
    return 'ok'

11、模板语言（jinja2）

中文文档：猛击这里

views.py

def abc():
    return "<a>123</a>"

@app.route('/xxx')
def xxx():
	...
	return render_template('index.html', k1='root', k2=[1, 2, 3], k3={'name': 'alex', 'age': 73}, k4=abc)

html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>Index</h1>
    {{k1}}
    {{k2}}
    <ul>
        {% for item in k2%}
            <li>{{item}}</li>
        {%endfor%}
    </ul>
    {{k3}}
    <ul>
        {% for k,v in k3.items() %}
            <li>{{k}}-{{v}}</li>
        {%endfor%}
    </ul>

    {{k4()|safe}}　　<!--使用|safe-->

</body>
</html>