Flask 从入门到实践
路由的介绍
程序实例保存了一个URL到Python程序的映射关系,处理URL和函数之间关系的程序成为路由。
使用程序实例的app.route装饰器即可把要修饰的函数(可称为视图函数,下例中为index(),user())注册为路由。
from flask import Flask
from flask import request
app = Flask(__name__)
@app.route('/')
def index():
return '<h1>Hello World!</h1>'
@app.route('/user/<name>')
def user(name):
return '<h1>Hello, %s !</h1>' %name
@app.route('/users/<int:id>')
def users(id):
return '<h1>Your ID is : %d !</h1>' %id
@app.route('/info/')
def info():
user_agent = request.headers.get('User-Agent')
return '<p>Your browser is %s</p>' % user_agent
if __name__ == '__main__':
app.run(debug=True)
Flask上下文全局变量
| 变量名 |
上下文 |
说明 |
| current_app |
程序上下文 |
当前激活程序的程序实例 |
| g |
程序上下文 |
处理请求时用作临时存储的对象,每次请求会重设该变量 |
| request |
请求上下文 |
请求对象,封装了客户端发出的HTTP请求中的内容 |
| session |
请求上下文 |
用户会话,用于存储请求之间需要“记住”的值的词典 |
Flask中有两种上下文:程序上下文和请求上下文,在调用之前需要先激活。
视图函数用来处理客户端发来的请求,Flask用app.route装饰器或者非装饰器的app.add_url_rule() 来生成URL映射。
在处理请求之前或之后执行处理的代码称为请求钩子函数,Flask支持以下4种装饰器来实现:
- before_first_request:处理第一个请求前运行
- before_request:每次请求前运行
- after_request:如没有未处理的异常抛出,在每次请求之后运行
- teardown_request:即是有未处理的异常也在每次请求后运行
在请求析构函数和视图函数之间共享数据一般使用上下文全局变量 g.
Flask中可用make_response来自定义响应对象,例如携带cookie等:
from flask import make_response
@app.route('/cookie/')
def cookie_test():
response = make_response('<h1>This document carries a cookie!</h1>')
response.set_cookie('year', '2017')
return response
302重定向:
from flask import redirect
@app.route('/r/')
def redirect():
return redirect('http://www.hython.com')
处理错误的响应用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
Jinja2模板的使用
Jinja2变量过滤器
| 过滤器名 |
说明 |
| safe |
渲染值时不转义 |
| capitalize |
把值的首字母转换成大写,其余的小写 |
| lower |
把值转换成小写形式 |
| upper |
把值转换成大写形式 |
| title |
值中的每个单词的首字母转换成大写 |
| trim |
把值的首尾空格去掉 |
| striptags |
渲染之前把值中所有的HTML标签都删掉 |
控制结构
- 条件控制语句:if
- for循环
- 宏函数(macros)
Flask-Bootstrap插件
flask bootstrap基模板中定义的块
| 块名 |
说明 |
| doc |
整个HTML文档 |
| html_attribs |
标签的属性 |
| html |
标签中的内容 |
| head |
标签中的内容 |
| title |
标签中的内容</td>
</tr>
<tr>
<td>metas</td>
<td>一组<meta>标签</td>
</tr>
<tr>
<td>styles</td>
<td>css样式表定义</td>
</tr>
<tr>
<td>body_attribs</td>
<td><body>标签的属性</td>
</tr>
<tr>
<td>body</td>
<td><body>标签中的内容</td>
</tr>
<tr>
<td>navbar</td>
<td>用户定义的导航条</td>
</tr>
<tr>
<td>content</td>
<td>用户定义的页面内容</td>
</tr>
<tr>
<td>scripts</td>
<td>文档底部的JavaScript声明</td>
</tr>
</tbody>
</table>
<p>如果需要重新定义块,比如自定义css和js的styles和scripts,需使用jinja2中的<code>super()</code>函数:</p>
<pre><code class="language-python">{% block scripts %}
{{ super() }}
<script type="text/javascript" scr="my-script.js"></script>
{% endblock %}
</code></pre>
<p><code>url_for()</code>函数:</p>
<pre><code class="language-python"># _external=True返回绝对地址:http://127.0.0.1:5000/static/css/styles.css
url_for('static', filename='css/styles.css', _external=True)
</code></pre>
<h3 id="flask-moment插件本地化日期和时间">Flask-moment插件本地化日期和时间</h3>
<p>引入并实例:</p>
<pre><code class="language-python">from flask.ext.moment import Moment
moment = Moment(app)
</code></pre>
<p><code>base.html</code>中需要引入:</p>
<pre><code class="language-python">{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{{ moment.lang('ja') }}
{% endblock %}
</code></pre>
<p><code>index.html</code>中即可使用:</p>
<pre><code class="language-html"><p>The Local date and time is {{ moment(current_time).format('LLL') }}.</p>
<p>That was {{ moment(current_time).fromNow(refresh=True) }}</p>
</code></pre>
<p>除此之外Flask-Moment实现了moment.js中format(),fromNow(),fromTime(),calendar(),valueOf(),和unix()等方法。具体可参阅<a href="http://momentjs.com/docs/#/displaying/" target="_blank">官方文档</a>。</p>
<h2 id="web表单">Web表单</h2>
<h3 id="设置flask-wtf插件">设置Flask-WTF插件</h3>
<p>为免受跨站伪造请求CSRF的攻击,需要在<code>app.config</code>设置通用密钥如下:</p>
<pre><code class="language-python">app = Flask(__name__)
app.config['SECRET_KEY'] = 'do not guess this string'
</code></pre>
<blockquote>
<p>其实配置密钥的变量保存在系统变量中比写在代码里更为安全。</p>
</blockquote>
<table>
<thead>
<tr>
<th>字段类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>StringField</td>
<td>文本字段</td>
</tr>
<tr>
<td>TextAreaField</td>
<td>多行文本字段</td>
</tr>
<tr>
<td>PasswordField</td>
<td>密码文本字段</td>
</tr>
<tr>
<td>HiddenField</td>
<td>隐藏文本字段</td>
</tr>
<tr>
<td>DateField</td>
<td>文本字段,值为datetime.date格式</td>
</tr>
<tr>
<td>DateTimeField</td>
<td>文本字段,值为datetime.datetime格式</td>
</tr>
<tr>
<td>IntegerField</td>
<td>文本字段,值为整数</td>
</tr>
<tr>
<td>DecimalField</td>
<td>文本字段,值为decimal.Decimal</td>
</tr>
<tr>
<td>FloatField</td>
<td>文本字段,值为浮点数</td>
</tr>
<tr>
<td>BooleanField</td>
<td>复选框</td>
</tr>
<tr>
<td>RadioField</td>
<td>一组单选框</td>
</tr>
<tr>
<td>SelectField</td>
<td>下拉列表</td>
</tr>
<tr>
<td>SelectMultipleField</td>
<td>下拉列表,可选择多个值</td>
</tr>
<tr>
<td>FileField</td>
<td>文本上传字段</td>
</tr>
<tr>
<td>SubmitField</td>
<td>表单提交</td>
</tr>
<tr>
<td>FormField</td>
<td>把表单作为字段嵌入另一个表单</td>
</tr>
<tr>
<td>FormField</td>
<td>一组指定类型的字段</td>
</tr>
</tbody>
</table>
<h3 id="wtforms验证函数">WTForms验证函数</h3>
<table>
<thead>
<tr>
<th>验证函数</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>Email</td>
<td>电子邮件地址</td>
</tr>
<tr>
<td>EqualTo</td>
<td>比较两字段值,常用于要求输入两次密码确认</td>
</tr>
<tr>
<td>IPAddress</td>
<td>验证IPv4网络地址</td>
</tr>
<tr>
<td>Length</td>
<td>验证输入字符串长度</td>
</tr>
<tr>
<td>NumberRange</td>
<td>验证输入的值在数字范围内</td>
</tr>
<tr>
<td>Optional</td>
<td>无输入值时跳过其他验证函数</td>
</tr>
<tr>
<td>Required</td>
<td>确保字段中有数据</td>
</tr>
<tr>
<td>Regexp</td>
<td>使用正则表达式验证输入值</td>
</tr>
<tr>
<td>URL</td>
<td>验证URL</td>
</tr>
<tr>
<td>AnyOf</td>
<td>确保输入值在可选值列表中</td>
</tr>
<tr>
<td>NoneOf</td>
<td>确保输入值不在可选值列表中</td>
</tr>
</tbody>
</table>
|