zope.app.session 4.1.0

注意

此包提供的所有接口和实现 已迁移到zope.session。这个包裹现在 仅提供ZMI菜单配置。

概述

会话允许我们通过无状态协议（http）伪造状态。 我们通过在多个 http请求，不管是cookie还是某个id被破坏到url中。

IClientIdManager实用程序提供了这个唯一的id。 负责传播此ID，以便将来从 客户端获得相同的id（例如通过设置http cookie）。（注意 这个和所有接口都是从这个包中导入的 仅用于演示目的。他们被转移到 zope.session.interfaces）当我们调整 请求唯一的客户端ID:

>>> from zope.app.session.interfaces import IClientId
>>> IClientId
<InterfaceClass zope.session.interfaces.IClientId>
>>> client_id = IClientId(request)

ISession适配器为我们提供了一个可用于存储 并检索会话数据。使用唯一密钥（包id） 要避免名称空间冲突：

>>> from zope.app.session.interfaces import ISession
>>> pkg_id = 'products.foo'
>>> session = ISession(request)[pkg_id]
>>> session['color'] = 'red'

>>> session2 = ISession(request)['products.bar']
>>> session2['color'] = 'blue'

>>> session['color']
'red'
>>> session2['color']
'blue'

数据存储

实际数据存储在ISessionDataContainer实用程序中。 ISession选择应该由哪个ISessionDataContainer使用 使用包ID作为命名实用程序查找。 站点管理员配置会话数据的实际位置 通过添加所需^{tt5}的注册来存储$ 用正确的名字。

>>> from zope.app.session.interfaces import ISessionDataContainer
>>> from zope.component import getUtility
>>> sdc = getUtility(ISessionDataContainer, pkg_id)
>>> sdc[client_id][pkg_id] is session
True
>>> sdc[client_id][pkg_id]['color']
'red'

如果没有ISessionDataContainer实用程序，则可以使用 包id，则未命名的ISessionDataContainer实用程序用作 后退。自动创建未命名的ISessionDataContainer。 对于您，如果需要，可以用不同的实现替换。

>>> ISession(request)['unknown'] \
...     is getUtility(ISessionDataContainer)[client_id]['unknown']
True

ISessionDataContainer包含ISessionData对象，以及 ISessionData对象依次包含ISessionPkgData对象。你 除非你在写行政管理文件 会议机制的视图。

>>> from zope.app.session.interfaces import ISessionData, ISessionPkgData
>>> ISessionData.providedBy(sdc[client_id])
True
>>> ISessionPkgData.providedBy(sdc[client_id][pkg_id])
True

ISessionDataContainer负责使会话数据过期。 可以通过设置其timeout属性来配置到期时间。

>>> sdc.timeout = 1200 # 1200 seconds or 20 minutes

限制

存储在会话中的数据必须是持久的或可拾取的。

>>> class NoPickle(object):
...     def __getstate__(self):
...         raise TypeError("Cannot serialize")
>>> session['oops'] = NoPickle()
>>> import transaction
>>> transaction.commit()
Traceback (most recent call last):
...
TypeError: Cannot serialize

页面模板

Session data may be accessed in page template documents using TALES:

<span tal:content="request/session:products.foo/color | default">
    green
</span>

or:

<div tal:define="session request/session:products.foo">
    <script type="text/server-python">
        try:
            session['count'] += 1
        except KeyError:
            session['count'] = 1
    </script>

    <span tal:content="session/count" />
</div>

4.1.0（2018-10-22）

• 添加对Python3.7的支持。

4.0.0（2017-05-29）

• 添加对python 3.4、3.5、3.6和pypy的支持。
• 删除对ZODB3和其他未使用的包的依赖关系 通过这个包，只留下zope.session。包装 在测试期间使用的现在是测试依赖项。

3.6.2（2010-09-01）

• 删除对zope.deferredimport的未声明依赖项。

3.6.1（2010-02-06）

• 包含zope.securitypolicy中的meta.zcml

3.6.0（2009-02-01）

• 在测试中使用zope.site，而不是zope.app.folder。

3.5.2（2009-01-27）

• 修正了测试中的拆卸错误。

3.5.1（2007-10-31）

• 解决ZopeSecurityPolicy弃用警告。

3.5.0（2007-09-27）

• 覆盖未标记的未读内容的释放Oned开发人员发布 download.zope.org/distribution。

3.4.3（2007-09-27）

• 修复包元数据。

3.4.2（2007-09-24）

• 更换有问题的鸡蛋
• 已将缺少的依赖项添加到zope.session

3.4.1（2007-09-24）

• 将丢失的文件添加到egg分发中

3.4.0（2007-09-24）

• 初始文件发布