zodbpickle 4.1.1

注意

zodbpickle 依赖于 Python 的 pickle 模块。该模块并非设计为对错误构造或恶意构造的数据具有安全性。请勿从不受信任或未经验证的来源反序列化数据，因为可能会执行任意代码。

另请参阅 https://docs.pythonlang.cn/3.6/library/pickle.html

通用用法

为了实现 Python 2 和 3 序列化的兼容性，替换

import pickle

为

from zodbpickle import pickle

这提供了兼容性，但效果是您在 Python 3 中获得快速实现，而 Python 2 使用慢速版本。

为了获得更确定的选择实现，请使用以下之一

from zodbpickle import fastpickle # always C
from zodbpickle import slowpickle # always Python

这两个模块可以共存，这有助于比较。

但还有更多要考虑的，请继续阅读！

加载/存储 Python 2 字符串

在所有他们的智慧中，Python 开发者决定 Python 2 的 str 实例应被加载为 Python 3 的 str 对象（即 Unicode 字符串）。在 Python issue 6784 中提出了补丁，但从未被应用。此代码库包含这些补丁。

示例 1：在 Python 3 上加载 Python 2 pickles

$ python2
>>> import pickle
>>> pickle.dumps('\xff', protocol=0)
"S'\\xff'\np0\n."
>>> pickle.dumps('\xff', protocol=1)
'U\x01\xffq\x00.'
>>> pickle.dumps('\xff', protocol=2)
'\x80\x02U\x01\xffq\x00.'

$ python3
>>> from zodbpickle import pickle
>>> pickle.loads(b"S'\\xff'\np0\n.", encoding='bytes')
b'\xff'
>>> pickle.loads(b'U\x01\xffq\x00.', encoding='bytes')
b'\xff'
>>> pickle.loads(b'\x80\x02U\x01\xffq\x00.', encoding='bytes')
b'\xff'

示例 2：在 Python 2 上加载 Python 3 pickles

$ python3
>>> from zodbpickle import pickle
>>> pickle.dumps(b"\xff", protocol=0)
b'c_codecs\nencode\np0\n(V\xff\np1\nVlatin1\np2\ntp3\nRp4\n.'
>>> pickle.dumps(b"\xff", protocol=1)
b'c_codecs\nencode\nq\x00(X\x02\x00\x00\x00\xc3\xbfq\x01X\x06\x00\x00\x00latin1q\x02tq\x03Rq\x04.'
>>> pickle.dumps(b"\xff", protocol=2)
b'\x80\x02c_codecs\nencode\nq\x00X\x02\x00\x00\x00\xc3\xbfq\x01X\x06\x00\x00\x00latin1q\x02\x86q\x03Rq\x04.'

$ python2
>>> import pickle
>>> pickle.loads('c_codecs\nencode\np0\n(V\xff\np1\nVlatin1\np2\ntp3\nRp4\n.')
'\xff'
>>> pickle.loads('c_codecs\nencode\nq\x00(X\x02\x00\x00\x00\xc3\xbfq\x01X\x06\x00\x00\x00latin1q\x02tq\x03Rq\x04.')
'\xff'
>>> pickle.loads('\x80\x02c_codecs\nencode\nq\x00X\x02\x00\x00\x00\xc3\xbfq\x01X\x06\x00\x00\x00latin1q\x02\x86q\x03Rq\x04.')
'\xff'

示例 3：一切都崩溃了

$ python2
>>> class Foo(object):
...     def __init__(self):
...         self.x = 'hello'
...
>>> import pickle
>>> pickle.dumps(Foo(), protocol=0)
"ccopy_reg\n_reconstructor\np0\n(c__main__\nFoo\np1\nc__builtin__\nobject\np2\nNtp3\nRp4\n(dp5\nS'x'\np6\nS'hello'\np7\nsb."
>>> pickle.dumps(Foo(), protocol=1)
'ccopy_reg\n_reconstructor\nq\x00(c__main__\nFoo\nq\x01c__builtin__\nobject\nq\x02Ntq\x03Rq\x04}q\x05U\x01xq\x06U\x05helloq\x07sb.'
>>> pickle.dumps(Foo(), protocol=2)
'\x80\x02c__main__\nFoo\nq\x00)\x81q\x01}q\x02U\x01xq\x03U\x05helloq\x04sb.'

$ python3
>>> from zodbpickle import pickle
>>> class Foo(object): pass
...
>>> foo = pickle.loads("ccopy_reg\n_reconstructor\np0\n(c__main__\nFoo\np1\nc__builtin__\nobject\np2\nNtp3\nRp4\n(dp5\nS'x'\np6\nS'hello'\np7\nsb.", encoding='bytes')
>>> foo.x
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'Foo' object has no attribute 'x'

等等？

>>> foo.__dict__
{b'x': b'hello'}

哦哦。所以我们使用 encoding='ASCII'（默认）和 errors='bytes' 并希望它工作

>>> foo = pickle.loads("ccopy_reg\n_reconstructor\np0\n(c__main__\nFoo\np1\nc__builtin__\nobject\np2\nNtp3\nRp4\n(dp5\nS'x'\np6\nS'hello'\np7\nsb.", errors='bytes')
>>> foo.x
'hello'

如有必要回退到字节

>>> pickle.loads(b'\x80\x02U\x01\xffq\x00.', errors='bytes')
b'\xff'

对 noload() 的支持

ZODB 使用 cPickle 的 noload() 方法从 pickle 中检索所有持久引用，而不加载任何对象。这个功能已被从 Python 3 的 pickle 中移除。不幸的是，这会不必要地填充 pickle 缓存。

此模块再次提供了 noload() 方法。