兼容性

二进制数据

在所有版本的Python中， PyMongo将 bytes 类的实例编码为具有子类型 0 的二进制数据，这是二进制数据的默认子类型。在Python 3 中， PyMongo将这些值解码为 bytes 类的实例。在 Python 2 中，驾驶员将它们解码为具有子类型 0 的 Binary 类的实例。

以下代码示例展示了PyMongo如何解码 bytes 类的实例。选择Python 2或Python 3标签页以查看相应的代码。

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{u'_id': ObjectId('67afb78298f604a28f0247b4'), u'binary': Binary('this is a byte string', 0)}

from pymongo import MongoClient
client = MongoClient()
client.test.test.insert_one({'binary': b'this is a byte string'})
doc = client.test.test.find_one()
print(doc)

{'_id': ObjectId('67afb78298f604a28f0247b4'), 'binary': b'this is a byte string'}

在解码子类型为 0 的JSON二进制值时，驾驶员的行为方式相同。在Python 3 中，它将这些值解码为 bytes 类的实例。在Python 2 中，驾驶员将它们解码为具有子类型 0 的 Binary 类的实例。有关显示差异的代码示例，请参阅扩展JSON页面。

Pickled ObjectIds

如果您在Python 2 中对 ObjectId 进行了 pickle，并想在Python 3 中对其进行 unpickle，则必须将 encoding='latin-1' 作为参数传递给 pickle.loads() 方法。

以下示例展示了如何使用Python 3 对在Python 2 中进行 pickle 的 ObjectId 进行 unpickle：

import pickle
pickle.loads(b'<ObjectId byte stream>', encoding='latin-1')

如果Python 3应用程序使用兼容的序列化协议来 pickle ObjectId，您可以使用Python 2 来取消 pickle。要在Python 3 中指定兼容协议，请为 pickle.dumps() 方法的 protocol 参数传递 0、1 或 2 的值。

以下示例在Python 3 中序列化 ObjectId，然后打印 ObjectId 和生成的 bytes实例：

import pickle
from bson.objectid import ObjectId
oid = ObjectId()
oid_bytes = pickle.dumps(oid, protocol=2)
print("ObjectId: {}".format(oid))
print("ObjectId bytes: {}".format(oid_bytes))

ObjectId: 67af9b1fae9260c0e97eb9eb
ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00...

以下示例取消上一示例中 ObjectId 的封装，然后打印 bytes 和 ObjectId 实例：

import pickle
from bson.objectid import ObjectId
oid_bytes = b'\x80\x02cbson.objectid\nObjectId\nq\x00...'
oid = pickle.loads(oid_bytes)
print("ObjectId bytes: {}".format(oid_bytes))
print("ObjectId: {}".format(oid))

ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00)...
ObjectId: 67af9b1fae9260c0e97eb9eb