직렬화

개요

이 가이드에서는 MongoDB .NET/C# 드라이버를 사용하여 직렬화를 수행하는 방법을 배울 수 있습니다. 직렬화는 MongoDB에 저장하기 위해 C# 객체를 BSON 문서에 매핑하는 프로세스입니다.

Serializer

직렬 변환기는 C# 객체와 BSON 문서 간의 변환을 처리하는 클래스입니다. 직렬 변환기는 IBsonSerializer 인터페이스를 구현합니다. .NET/C# 드라이버에는 기본 유형, collection 유형 및 사용자 지정 클래스를 처리하기 위해 만들어진 많은 내장 직렬 변환기가 있습니다.

사용 가능한 직렬 변환기의 전체 목록은 직렬 변환기 네임스페이스 API 문서를 참조하세요.

Serializer 레지스트리

직렬 변환기 레지스트리에는 애플리케이션 에서 사용할 수 있는 모든 등록된 직렬 변환기가 포함되어 있습니다. 대부분의 내장 직렬 변환기는 애플리케이션 스타트업 시 직렬 변환기 레지스트리에 자동으로 등록됩니다.

BsonSerializer.RegisterSerializer(new CustomTypeSerializer());

var intSerializer = BsonSerializer.SerializerRegistry.GetSerializer<int>();

class CustomRegularExpressionSerializer : IBsonSerializer
{
   public Type ValueType => typeof(Regex);
   public object Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
   {
      var type = context.Reader.CurrentBsonType;
      switch (type)
      {
         case BsonType.RegularExpression:
            return context.Reader.ReadRegularExpression().AsRegex;
         case BsonType.String:
            var pattern = context.Reader.ReadString()
            return new Regex(pattern);
         default:
            throw new NotSupportedException($"Cannot convert a {type} to a RegularExpression.");
      }
   }
   public void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
   {
      var regex = (Regex) value;
      context.Writer.WriteRegularExpression(regex);
   }
}

옵트인 인터페이스

.NET/C# 드라이버에는 직렬 변환기가 처리하는 데이터 유형에 따라 사용자 지정 직렬 변환기 클래스가 구현할 수 있는 몇 가지 선택적 인터페이스가 있습니다.

컨벤션

규칙 팩을 사용하면 운전자 직렬화 중에 사용하는 클래스와 해당 멤버에 규칙을 정의하고 적용 할 수 있습니다. 규칙은 각 클래스를 속성으로 장식하지 않고도 C# 객체와 MongoDB 문서 간에 데이터를 매핑하는 방법을 지정합니다.

.NET/ C# 드라이버 직렬화 프로세스 사용자 지정하는 데 사용할 수 있는 내장 규칙을 제공합니다. 다음 표에서는 몇 가지 내장 규칙에 대해 설명합니다.

사용 가능한 규칙의 전체 목록을 보려면 API 설명서에서 규칙 클래스 참조를 확인하세요.

다음 예시 와 같이 지정된 규칙을 사용하여 ConventionPack 를 인스턴스화한 다음 ConventionRegistry.Register() 메서드에 전달하여 규칙을 등록할 수 있습니다.

var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
ConventionRegistry.Register("CamelCaseConvention", camelCaseConvention, t => true);

배열 직렬화 성능 향상

<T> 표준 C# 배열이나 BsonArray 객체와 같은 유형을 사용하는 대신 프리미티브 Memory<T> ReadOnlyMemory<T>배열을Memory<T> 및 ReadOnlyMemory 구조체로 표시하여 애플리케이션의 성능을 향상시킬 수 있습니다. 운전자 및 에 대한 빠른 직렬화 및 역직렬화 경로를 구현하여 속도를 높이고 메모리 사용량을 줄입니다.

다음 기본 유형을 Memory<T> 또는 ReadOnlyMemory<T> 구조체에 저장하면 이러한 성능 향상 효과를 얻을 수 있습니다.

• bool

• sbyte

• byte

• char

• short

• ushort

• int

• uint

• long

• ulong

• float

• double

• decimal

다음 예시 Memory 및 ReadOnlyMemory 구조체로 모델링된 배열 필드를 포함하는 Line POCO를 정의합니다.

public class Line
{
  public ObjectId Id { get; set; }
  public Memory<int> X { get; set; }
  public ReadOnlyMemory<float> Y { get; set; }
}

다음 문서 샘플 Line 객체 MongoDB 에서 표현되는 방식을 나타냅니다.

{
  "_id": ...,
  "X": [ 1, 2, 3, 4, 5 ],
  "Y": [ 1, 1.409999966621399, 1.7300000190734863, 2, 2.240000009536743 ]
}

추가 정보

.NET/C# 드라이버를 사용하여 C# 객체를 직렬화하는 방법에 대해 자세히 알아보려면 다음 페이지를 참조하세요.

• 클래스 매핑

• POCO

• 다형성 객체

• GUID

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

• SerializerRegistry

• BsonSerializer

• IBsonSerializer

• ConventionPack

• ConventionRegistry

• Register()