BsonWriterSettings.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.
*/

using System;
using MongoDB.Bson.Serialization;

namespace MongoDB.Bson.IO
{
    /// <summary>
    /// Represents settings for a BsonWriter.
    /// </summary>
    public abstract class BsonWriterSettings
    {
        // private fields
        private bool _isFrozen;
        private int _maxSerializationDepth = BsonDefaults.MaxSerializationDepth;
        private IBsonSerializationDomain _serializationDomain;

        // constructors
        /// <summary>
        /// Initializes a new instance of the BsonWriterSettings class.
        /// </summary>
        protected BsonWriterSettings()
        {
        }

        // public properties
        /// <summary>
        /// Gets whether the settings are frozen.
        /// </summary>
        public bool IsFrozen
        {
            get { return _isFrozen; }
        }

        /// <summary>
        /// Gets or sets the max serialization depth allowed (used to detect circular references).
        /// </summary>
        public int MaxSerializationDepth
        {
            get { return _maxSerializationDepth; }
            set
            {
                if (_isFrozen) { ThrowFrozenException(); }
                _maxSerializationDepth = value;
            }
        }

        // public methods
        /// <summary>
        /// Creates a clone of the settings.
        /// </summary>
        /// <returns>A clone of the settings.</returns>
        public BsonWriterSettings Clone()
        {
            return CloneImplementation();
        }

        /// <summary>
        /// Freezes the settings.
        /// </summary>
        /// <returns>The frozen settings.</returns>
        public BsonWriterSettings Freeze()
        {
            _isFrozen = true;
            return this;
        }

        /// <summary>
        /// Returns a frozen copy of the settings.
        /// </summary>
        /// <returns>A frozen copy of the settings.</returns>
        public BsonWriterSettings FrozenCopy()
        {
            if (_isFrozen)
            {
                return this;
            }
            else
            {
                return Clone().Freeze();
            }
        }

        /// <summary>
        /// //TODO
        /// </summary>
        public IBsonSerializationDomain SerializationDomain
        {
            get => _serializationDomain;
            set
            {
                if (_isFrozen) { ThrowFrozenException(); }
                _serializationDomain = value;
            }
        }

        // protected methods
        /// <summary>
        /// Creates a clone of the settings.
        /// </summary>
        /// <returns>A clone of the settings.</returns>
        protected abstract BsonWriterSettings CloneImplementation();

        /// <summary>
        /// Throws an InvalidOperationException when an attempt is made to change a setting after the settings are frozen.
        /// </summary>
        protected void ThrowFrozenException()
        {
            var message = string.Format("{0} is frozen.", this.GetType().Name);
            throw new InvalidOperationException(message);
        }
    }
}