API

应用对象

蓝图对象

进入的请求对象

classflask.request

你可以使用全局 request 对象访问进入的请求数据。 Flask 处理进入的请求 数据并允许你用这个全局对象访问它。如果你工作在多线程环境，Flask 内部保证 你总会在当前线程上获取正确的数据，

这是一个代理。详情见 留意代理 。

请求对象是一个 Request 子类的实例，提供所有 Werkzeug 定义的属性。这里只对最重要的展示了简要概述。

响应对象

会话

如果你设置了 Flask.secret_key ，你可以在 Flask 应用中使用会话。会话 主要使得在请求见保留信息成为可能。 Flask 的实现方法是使用一个签名的 cookie 。 这样，用户可以查看会话的内容，但是不能修改它，除非用户知道密钥。所以确保密钥 被设置为一个复杂且无法被容易猜测的值。

你可以使用 session 对象来访问当前的会话:

classflask.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 正在使用的会话实现。