BsonSerializationContext.cs

/* Copyright 2010-present MongoDB Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

usingSystem;
usingMongoDB.Bson.IO;

namespaceMongoDB.Bson.Serialization
{
/// <summary>
/// Represents all the contextual information needed by a serializer to serialize a value.
/// </summary>
publicclassBsonSerializationContext
{
// private fields
privatereadonlyFunc<Type,bool>_isDynamicType;
privatereadonlyIBsonWriter_writer;

// constructors
privateBsonSerializationContext(
IBsonWriterwriter,
Func<Type,bool>isDynamicType)
{
_writer=writer;
_isDynamicType=isDynamicType;
}

// public properties
/// <summary>
/// Gets a function that, when executed, will indicate whether the type 
/// is a dynamic type.
/// </summary>
publicFunc<Type,bool>IsDynamicType
{
get{return_isDynamicType;}
}

/// <summary>
/// Gets the writer.
/// </summary>
/// <value>
/// The writer.
/// </value>
publicIBsonWriterWriter
{
get{return_writer;}
}

// public static methods
/// <summary>
/// Creates a root context.
/// </summary>
/// <param name="writer">The writer.</param>
/// <param name="configurator">The serialization context configurator.</param>
/// <returns>
/// A root context.
/// </returns>
publicstaticBsonSerializationContextCreateRoot(
IBsonWriterwriter,
Action<Builder>configurator=null)
{
varbuilder=newBuilder(null,writer);
if(configurator!=null)
{
configurator(builder);
}
returnbuilder.Build();
}

/// <summary>
/// Creates a new context with some values changed.
/// </summary>
/// <param name="configurator">The serialization context configurator.</param>
/// <returns>
/// A new context.
/// </returns>
publicBsonSerializationContextWith(
Action<Builder>configurator=null)
{
varbuilder=newBuilder(this,_writer);
if(configurator!=null)
{
configurator(builder);
}
returnbuilder.Build();
}

// nested classes
/// <summary>
/// Represents a builder for a BsonSerializationContext.
/// </summary>
publicclassBuilder
{
// private fields
privateFunc<Type,bool>_isDynamicType;
privateIBsonWriter_writer;

// constructors
internalBuilder(BsonSerializationContextother,IBsonWriterwriter)
{
if(writer==null)
{
thrownewArgumentNullException("writer");
}

_writer=writer;
if(other!=null)
{
_isDynamicType=other._isDynamicType;
}
else
{
_isDynamicType= t =>
(BsonDefaults.DynamicArraySerializer!=null&&t==BsonDefaults.DynamicArraySerializer.ValueType)||
(BsonDefaults.DynamicDocumentSerializer!=null&&t==BsonDefaults.DynamicDocumentSerializer.ValueType);
}
}

// properties
/// <summary>
/// Gets or sets the function used to determine if a type is a dynamic type.
/// </summary>
publicFunc<Type,bool>IsDynamicType
{
get{return_isDynamicType;}
set{_isDynamicType=value;}
}

/// <summary>
/// Gets the writer.
/// </summary>
/// <value>
/// The writer.
/// </value>
publicIBsonWriterWriter
{
get{return_writer;}
}

// public methods
/// <summary>
/// Builds the BsonSerializationContext instance.
/// </summary>
/// <returns>A BsonSerializationContext.</returns>
internalBsonSerializationContextBuild()
{
returnnewBsonSerializationContext(_writer,_isDynamicType);
}
}
}
}