这部分文档涵盖了 Flask 的所有接口。对于那些 Flask 依赖外部库的部分,我们 这里提供了最重要的部分的文档,并且提供其官方文档的链接。 应用对象蓝图对象进入的请求对象- class
flask. request 你可以使用全局 request 对象访问进入的请求数据。 Flask 处理进入的请求 数据并允许你用这个全局对象访问它。如果你工作在多线程环境,Flask 内部保证 你总会在当前线程上获取正确的数据, 这是一个代理。详情见 留意代理 。 请求对象是一个 Request 子类的实例,提供所有 Werkzeug 定义的属性。这里只对最重要的展示了简要概述。
响应对象会话如果你设置了 Flask.secret_key ,你可以在 Flask 应用中使用会话。会话 主要使得在请求见保留信息成为可能。 Flask 的实现方法是使用一个签名的 cookie 。 这样,用户可以查看会话的内容,但是不能修改它,除非用户知道密钥。所以确保密钥 被设置为一个复杂且无法被容易猜测的值。 你可以使用 session 对象来访问当前的会话: - class
flask. session 会话对象很像通常的字典,区别是会话对象会追踪修改。 这是一个代理。更多信息见 留意代理 。 下列属性是需要关注的: new 如果会话是新的,该值为 True ,否则为 False 。
modified 当果会话对象检测到修改,这个值为 True 。注意可变结构的修改不会 被自动捕获,这种情况下你需要自行显式地设置这个属性为 True 。这 里有 一个例子: # this change is not picked up because a mutable object (here
# a list) is changed.
session['objects'].append(42)
# so mark it as modified yourself
session.modified = True
permanent 如果设为 True ,会话存活 permanent_session_lifetime 秒。默认为 31 天。 如果是 False (默认选项),会话会在用户关闭浏览器时删除。
会话接口会话接口提供了简单的途径来替换 Flask 正在使用的会话实现。 Notice PERMANENT_SESSION_LIFETIME 配置键从 Flask 0.8 开始可以是一个整数。 你可以自己计算值,或用应用上的 permanent_session_lifetime 属性来自动转换结果为 一个整数。
|