GUID

Overview

In this guide, you can learn how to serialize globally unique identifiers (GUIDs), also known as universally unique identifiers (UUIDs).

GUID は 16 バイトの整数で、MongoDB ドキュメントのユニークな ID として使用できます。MongoDB の GUID は元々、サブタイプ 3 の BsonBinaryData 値として表されていました。サブタイプ 3 では直列化の間にバイト順序が標準化されなかったため、MongoDB ドライバー間で直列化に一貫性がありませんでした。バイト順序を標準化し、ドライバー間で一貫した直列化を実現するため、BsonBinaryData サブタイプ 4 を開発しました。

GuidRepresentationMode

多くの MongoDB コレクションでは、すべての GUID フィールドが同じサブタイプ BsonBinaryData を使用しています。ただし、一部の古いコレクションには、サブタイプ 3 を使用する GUID フィールドとサブタイプ 4 を使用する GUID フィールドが含まれている場合があります。ドライバーですべての GUID を正しく直列化および逆直列化できるようにするには、 BsonDefaults.GuidRepresentationMode プロパティを次の GuidRepresentationMode 値のいずれかに設定する必要があります。

BsonDefaults.GuidRepresentationMode = GuidRepresentationMode.V3;

V3 における GUID の直列化

GuidRepresentationMode.V3 は、GUID の直列化を個々のプロパティのレベルで処理します。このモードは V2 よりも柔軟ですが、各 GUID フィールドが正しく直列化および逆直列化されていることを確認する必要があります。

.NET/C# ドライバーを使用して C# クラスをドキュメント スキーマに自動マップピングする場合は、GUID プロパティの BsonGuidRepresentation 属性を使用して表現を指定できます。

public class Widget
{
    public int Id { get; set; }
   [BsonGuidRepresentation(GuidRepresentation.Standard)]
   public Guid G { get; set; }
}

独自の直列化コードを作成する場合は、GuidSerializer クラスを使用して個々の GUID 値を BSON フィールドとの間で直列化および逆直列化できます。ドライバーで GUID を正しく処理できるようにするには、 GuidSerializer を構築するときに GuidRepresentation パラメーターを使用します。

次のコード サンプルでは、サブタイプ 4 の GUID 表現を直列化するための GuidSerializer のインスタンスを作成します。

var guidSerializer = new GuidSerializer(GuidRepresentation.Standard);

ほとんどの GUID が同じ表現を使用する場合は、 GuidSerializer をグローバルに登録できます。GuidSerializer を作成して登録するには、ブートストラップ フェーズなど、アプリケーションの早い段階で次のコードを実行します。

BsonSerializer.RegisterSerializer(new GuidSerializer(GuidRepresentation.Standard));

V3 におけるオブジェクトの直列化

ObjectSerializer を使用して、階層オブジェクトをサブドキュメントに直列化できます。V3 を使用するときにこれらのオブジェクト内の GUID を正しく直列化および逆直列化するには、 ObjectSerializer の構築時に正しい GUID 表現を選択する必要があります。

次のコード サンプルは、サブタイプ 4 の GUID 表現の ObjectSerializer を作成する方法を示しています。

var objectDiscriminatorConvention = BsonSerializer.LookupDiscriminatorConvention(typeof(object));
var objectSerializer = new ObjectSerializer(objectDiscriminatorConvention, GuidRepresentation.Standard);

アプリケーションで ObjectSerializer を使用して GUID を直列化する場合は、アプリケーションの早い段階（ブートストラップ段階など）でもシリアライザーを登録する必要があります。登録したシリアライザーは、オブジェクト シリアライザーが必要で、特に指定されていない場合は常にグローバルに使用されます。

ObjectSerializer を登録するには、BsonSerializer.RegisterSerializer() メソッドに渡します。

var objectDiscriminatorConvention = BsonSerializer.LookupDiscriminatorConvention(typeof(object));
var objectSerializer = new ObjectSerializer(objectDiscriminatorConvention, GuidRepresentation.Standard);
BsonSerializer.RegisterSerializer(objectSerializer);

詳細情報

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• BsonBinaryData

• GuidRepresentationMode

• BsonGuidRepresentation

• GuidSerializer

• ObjectSerializer