GUID

개요

이 가이드에서는 UUID(범용 고유 식별자)라고도 하는 (GUIDs),(전역 고유 식별자)를 직렬화하는 방법에 대해 설명합니다.

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