C# Bson序列化特性 MongoDB.Bson.Serialization.Attributes

▲相关特性MongoDB.Bson.Serialization.Attributes

MongoDB序列化特性官方文档
[BsonIgnore]
[BsonElement]
[BsonIgnoreExtraElements]
[BsonExtraElements]
[BsonRepresentation(BsonType.String)]

[BsonId]

2.可以忽略某些字段
[BsonIgnore]该标签用来禁止字段序列化,不保存数据库也不查询,即忽略。
3.支持默认值以及取别名
[BsonElement] 字段加上该标签,即使是private字段也会序列化(默认只序列化public字段),该标签还可以带一个string参数,给字段序列化指定别名。

[BsonIgnore]//忽略保存进数据库,禁止字段序列化。
public Entity Entity
[BsonIgnore]//组件类中
public NavGraph[] graphs;

//默认private不会序列化,加上BsonElement就会序列化
[BsonElement("C")]
[BsonIgnoreIfNull]
private HashSet<Component> components = new HashSet<Component>();

 元素顺序

如果要精确控制BSON文档中元素的顺序,可以对BsonElement属性使用Order named参数:

public class MyClass 
{
    [BsonElement("sp", Order = 1)]
    public string SomeProperty { get; set; }
}

 

4.升级版本支持

[BsonIgnoreExtraElements] 该标签用在class上面,反序列化时用来忽略多余的字段,一般版本兼容需要考虑,低版本的协议需要能够反 序列化高版本的内容,否则新版本删除字段,旧版本结构反序列化会出错
5.支持额外的元素
[BsonExtraElements]
您可以将您的类设计为能够处理反序列化期间在BSON文档中可能发现的任何其他元素。为此,您必须具有BsonDocument(或IDictionary<string, object>)类型的属性,并且必须将该属性标识为应该包含找到的任何其他元素的属性。按照惯例,可以命名该成员ExtraElements。例如:

public MyClass 
{
// fields and properties
[BsonExtraElements]
public BsonDocument CatchAll { get; set; }
}

 

6.表示,枚举:
[BsonRepresentation(BsonType.String)]
对于某些.NET基本类型,您可以控制要用来表示值的BSON类型。例如,您可以指定将char值表示为BSON Int32还是一字符BSON字符串:
默认情况下,枚举表示为其基础值。换句话说,纯枚举将表示为整数值。但是,可以指示驱动程序将枚举表示为字符串。

//告诉mongodb这个字段在数据库中的类型是String
[BsonRepresentation(BsonType.String)]
public AppType AppType { get; set; }
//告诉mongodb这个字段在数据库中的类型是ObjectId
[BsonRepresentation(BsonType.ObjectId)]

public class MyClass 
{
[BsonRepresentation(BsonType.Int32)]
public char RepresentAsInt32 { get; set; }

[BsonRepresentation(BsonType.String)]
public char RepresentAsString { get; set; }
}

 

//默认是国际时间
[BsonDateTimeOptions(Kind = DateTimeKind.Local)]//单独指定时区
[BsonDictionaryOptions(DictionaryRepresentation.ArrayOfArrays)]
DictionaryRepresentation有三个值可选:
[BsonRepresentation(BsonType.String)]
ET框架中,保存数据库组件需要继承 ISerializeToEntity接口。

[BsonDictionaryOptions(DictionaryRepresentation.ArrayOfArrays)]
public Dictionary<int, int> MyAreaDict = new Dictionary<int, int>();

 

//class上面,反序列化时用来忽略多余的字段,否则新版本加了字段,旧版本结构反序列化会出错
[BsonIgnoreExtraElements]
public class CheckPointConfig : IConfig

 

7.指定默认值:[BsonDefaultValue(0L)]

您可以使用来为成员指定默认值BsonDefaultValueAttribute

8.忽略默认值:

 [BsonIgnoreIfDefault]

[BsonId]

id编号产生器:[BsonId(IdGenerator = typeof(CombGuidGenerator))]

当您插入文档时,驱动程序将检查是否已为该Id成员分配了值,如果没有,则为该成员生成一个新的唯一值。由于Id成员可以是任何类型,因此驱动程序需要借助IIdGenerator来检查成员是否Id具有为其分配的值,并在必要时生成新值。该驱动程序具有以下内置的ID生成器:

其中一些ID生成器会自动用于常用Id类型:

要通过属性指定ID生成器,请执行以下操作:

public class MyClass 
{
    [BsonId(IdGenerator = typeof(CombGuidGenerator))]
    public Guid Id { get; set; }
}

或通过代码:

BsonClassMap.RegisterClassMap<MyClass>(cm => 
{
    cm.AutoMap();
    cm.MapIdMember(c => c.Id).SetIdGenerator(CombGuidGenerator.Instance);
});

 

[BsonElement] 字段加上该标签,即使是private字段也会序列化(默认只序列化public字段,readonly),该标签还可以带一个string参数,给字段序列化指定别名。

[BsonIgnoreExtraElements]
public abstract class ComponentWithId : Component
{
[BsonIgnoreIfDefault]
[BsonDefaultValue(0L)]//指定默认值
[BsonElement]
[BsonId]//定义为主键,字段映射,告诉mongodb这个字段在数据库中对应_id,这个字段一般不需要在Json中体现出来,在序列化时被忽略
public long Id { get; set; }

//默认是国际时间
[BsonDateTimeOptions(Kind = DateTimeKind.Local)]//单独指定时区

 

 

 

MongoDB.Driver中的Bson特性

namespace MongoDB.Driver
{
[BsonElement("max")]
public TValue Max => _max;

[BsonElement("count")]
public long Count { get; private set; }

 

Bson库的指定序列化器:
有时需要使用特定的序列化程序,而不是让BSON库选择。可以使用BsonSerializerAttribute
//这里是Bson库的序列化器
namespace MongoDB.Driver.GeoJsonObjectModel
{

[BsonSerializer(typeof(GeoJson2DGeographicCoordinatesSerializer))]
public class GeoJson2DGeographicCoordinates : GeoJsonCoordinates

 



posted @ 2020-05-14 21:26  好Wu赖  阅读(720)  评论(0编辑  收藏