处理Web表单的扩展 Flask－WTF

Flask-wtf 对WTForms包进行了包装，方便集成入Flask框架

跨站请求保护

CSRF(Cross-Site Request Forgery)是指恶意网站把请求发送到被攻击者已登录的其他网站就会引发CSRF攻击
为了实现CSRF保护，需要程序设置密钥，生成加密令牌，再用来验证表单数据真伪。非常简单：

app = Flask(__name__)
app.config['SECRET_KEY'] = 'hard to guess string'

不过在生产环境，不会直接写入程序，而会从文件或环境中导入配置值，Flask-wtf提供了方法来实现

表单类

使用Flask-wtf时，每一个表单都由一个继承自Form类表示，这个类定义表单的字段，每个字段由对象表示，
字段对象可以附属一个或多个验证函数，验证函数负责验证用户提交输入值是否符合要求
示范：

from flask.ext.wtf import Form
from wtforms import StringField,SubmitField
from wtforms.validators import DataRequired,Email

class NameForm(Form):
    name = StringField('what is your name ?',validators=[DataRequired()])
    email = StringField('what is your email ?',validators=[Email()])
    submit = SubmitField('Submit')

上面代码定义了3个字段：name,email,submit三个字段，name和email表示"text" 的input元素，
submit表示type = 'submit'的“input”元素。DataRequired接受用户输入之后，确保提交字段不为空，
Email确保输入为符合邮件的函数

WTForms支持的HTML标准字段 举例，更多可以查官方文档

WTForms内建验证函数

表单渲染成HTML

Flask-Bootstrap提供了一个辅助函数，使用Bootstrap预先定义好的表单样式渲染Flask－Wtf表单对象，使用Bootstrap默认样式渲染传入的表单。
还可以使视图函数渲染表单，接收表单数据

py:

@app.route('/',methods=['GET','POST'])
def index():
    name = None
    email = None
    form = NameForm()
    if form.validate_on_submit():
        name = form.name.data
        email = form.email.data
        form.name.data = ''
        form.email.data = ''
    return render_template('index.html',form=form,name=name)

html：

<div class="page-header">
    <h1>Hello, {% if name %}{{ name }}{% else %}Stranger{% endif %}!</h1>
</div>

{{ wtf.quick_form(form) }}

重定向和用户会话

如果使用上面的视图函数，重复点击链接会再次提交表单，让你确认。
不过可以重定向POST请求，重新向重定向的URL发起GET请求，显示页面内容 － POST/重定向/GET，模式
不过，处理POST请求时，如果不保存数据，下次请求来时，数据就已经丢失。
不过，可以通过用户会话（session）保存数据，并且像python字典一样操作

默认情况下，用户会话保存在cookie中，而且cookie使用SECRET_KEY加密

示范代码：

@app.route('/',methods=['GET','POST'])
def index():
    form = NameForm()
    if form.validate_on_submit():
        session['name'] = form.name.data
        session['email'] = form.email.data
        return redirect(url_for('index')) # url_for重定向必须是相应视图函数的名字
    return render_template('index.html',form=form,name=session.get('name'),email=session.get('email'))

Flash消息

如果状态发生变化，可以通过flash()通知用户 －确认消息，警告或者错误提醒 FLask的核心特性
不过仅仅调用flash()不能把消息显示，还需要模板渲染消息，最好在基模板渲染，这样所有页面都能使用。

py:

@app.route('/',methods=['GET','POST'])
def index():
    form = NameForm()
    if form.validate_on_submit():
        oldname = session['name']
        if oldname is not None and oldname!=form.name.data:
            flash('Looks like you have changed your name!')
        old_email = session['email']
        if  old_email is not None and old_email !=form.email.data:
            flash('Email changed!')
        session['name'] = form.name.data
        session['email'] = form.email.data
        return redirect(url_for('index')) # url_for重定向必须是相应视图函数的名字
    return render_template('index.html',form=form,name=session.get('name'),email=session.get('email'))

html:

{% for msg in get_flashed_messages() %}
        <div class="alert alert-warning">
            <button type="button" class="close" data-dismiss="alert">×</button>
            {{ msg }}
        </div>
{% endfor %}