CSHARP-4191: Support use of BsonValue.AsString in filters (and all other AsXyz properties also).

Author: rstam

src/MongoDB.Bson/Serialization/Serializers/BooleanSerializer.cs

@@ -14,10 +14,7 @@
 */
 
 using System;
-using System.IO;
 using MongoDB.Bson.IO;
-using MongoDB.Bson.Serialization.Attributes;
-using MongoDB.Bson.Serialization.Options;
 
 namespace MongoDB.Bson.Serialization.Serializers
 {
@@ -26,6 +23,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class BooleanSerializer : StructSerializerBase<bool>, IRepresentationConfigurable<BooleanSerializer>
     {
+        #region static
+        private static readonly BooleanSerializer __instance = new BooleanSerializer();
+
+        /// <summary>
+        /// Gets a cached instance of a BooleanSerializer.
+        /// </summary>
+        public static BooleanSerializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
 

src/MongoDB.Bson/Serialization/Serializers/ByteArraySerializer.cs

@@ -15,7 +15,6 @@
 
 using System;
 using System.Globalization;
-using System.Text;
 
 namespace MongoDB.Bson.Serialization.Serializers
 {
@@ -24,6 +23,16 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class ByteArraySerializer : SealedClassSerializerBase<byte[]>, IRepresentationConfigurable<ByteArraySerializer>
     {
+        #region static
+        private static readonly ByteArraySerializer __instance = new ByteArraySerializer();
+
+        // public static properties
+        /// <summary>
+        /// Gets a cached instance of a ByteArraySerializer.
+        /// </summary>
+        public static ByteArraySerializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
 

src/MongoDB.Bson/Serialization/Serializers/Decimal128Serializer.cs

@@ -24,6 +24,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class Decimal128Serializer : StructSerializerBase<Decimal128>, IRepresentationConfigurable<Decimal128Serializer>, IRepresentationConverterConfigurable<Decimal128Serializer>
     {
+        #region static
+        private static readonly Decimal128Serializer __decimal128Instance = new Decimal128Serializer(BsonType.Decimal128);
+
+        /// <summary>
+        /// Gets a cached instance of a Decimal128Serializer with Decimal128 representation.
+        /// </summary>
+        public static Decimal128Serializer Decimal128Instance => __decimal128Instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
         private readonly RepresentationConverter _converter;

src/MongoDB.Bson/Serialization/Serializers/DecimalSerializer.cs

@@ -24,6 +24,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class DecimalSerializer : StructSerializerBase<decimal>, IRepresentationConfigurable<DecimalSerializer>, IRepresentationConverterConfigurable<DecimalSerializer>
     {
+        #region static
+        private static readonly DecimalSerializer __decimal128Instance = new DecimalSerializer(BsonType.Decimal128);
+
+        /// <summary>
+        /// Gets a cached instance of a DecimalSerializer with Decimal128 representation.
+        /// </summary>
+        public static DecimalSerializer Decimal128Instance => __decimal128Instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
         private readonly RepresentationConverter _converter;

src/MongoDB.Bson/Serialization/Serializers/DoubleSerializer.cs

@@ -14,10 +14,7 @@
 */
 
 using System;
-using System.Globalization;
-using System.IO;
 using MongoDB.Bson.IO;
-using MongoDB.Bson.Serialization.Attributes;
 using MongoDB.Bson.Serialization.Options;
 
 namespace MongoDB.Bson.Serialization.Serializers
@@ -27,6 +24,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class DoubleSerializer : StructSerializerBase<double>, IRepresentationConfigurable<DoubleSerializer>, IRepresentationConverterConfigurable<DoubleSerializer>
     {
+        #region static
+        private static readonly DoubleSerializer __instance = new DoubleSerializer();
+
+        /// <summary>
+        /// Gets a cached instance of DoubleSerializer;
+        /// </summary>
+        public static DoubleSerializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
         private readonly RepresentationConverter _converter;

src/MongoDB.Bson/Serialization/Serializers/GuidSerializer.cs

@@ -23,6 +23,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class GuidSerializer : StructSerializerBase<Guid>, IRepresentationConfigurable<GuidSerializer>
     {
+        #region static
+        private static readonly GuidSerializer __standardInstance = new GuidSerializer(GuidRepresentation.Standard);
+
+        /// <summary>
+        /// Gets a cached instance of a GuidSerializer with Standard representation.
+        /// </summary>
+        public static GuidSerializer StandardInstance => __standardInstance;
+        #endregion
+
         // private fields
         private readonly GuidRepresentation _guidRepresentation; // only relevant if _representation is Binary
         private readonly BsonType _representation;

src/MongoDB.Bson/Serialization/Serializers/Int32Serializer.cs

@@ -14,9 +14,7 @@
 */
 
 using System;
-using System.IO;
 using MongoDB.Bson.IO;
-using MongoDB.Bson.Serialization.Attributes;
 using MongoDB.Bson.Serialization.Options;
 
 namespace MongoDB.Bson.Serialization.Serializers
@@ -26,6 +24,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class Int32Serializer : StructSerializerBase<int>, IRepresentationConfigurable<Int32Serializer>, IRepresentationConverterConfigurable<Int32Serializer>
     {
+        #region static
+        private static readonly Int32Serializer __instance = new Int32Serializer();
+
+        /// <summary>
+        /// Gets a cached instance of an Int32Serializer;
+        /// </summary>
+        public static Int32Serializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
         private readonly RepresentationConverter _converter;

src/MongoDB.Bson/Serialization/Serializers/Int64Serializer.cs

@@ -14,9 +14,7 @@
 */
 
 using System;
-using System.IO;
 using MongoDB.Bson.IO;
-using MongoDB.Bson.Serialization.Attributes;
 using MongoDB.Bson.Serialization.Options;
 
 namespace MongoDB.Bson.Serialization.Serializers
@@ -26,6 +24,15 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class Int64Serializer : StructSerializerBase<long>, IRepresentationConfigurable<Int64Serializer>, IRepresentationConverterConfigurable<Int64Serializer>
     {
+        #region static
+        private static readonly Int64Serializer __instance = new Int64Serializer();
+
+        /// <summary>
+        /// Gets a cached instance of an Int64Serializer;
+        /// </summary>
+        public static Int64Serializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
         private readonly RepresentationConverter _converter;

src/MongoDB.Bson/Serialization/Serializers/ObjectIdSerializer.cs

@@ -14,10 +14,6 @@
 */
 
 using System;
-using System.IO;
-using MongoDB.Bson.IO;
-using MongoDB.Bson.Serialization.Attributes;
-using MongoDB.Bson.Serialization.Options;
 
 namespace MongoDB.Bson.Serialization.Serializers
 {
@@ -26,6 +22,16 @@ namespace MongoDB.Bson.Serialization.Serializers
     /// </summary>
     public class ObjectIdSerializer : StructSerializerBase<ObjectId>, IRepresentationConfigurable<ObjectIdSerializer>
     {
+        #region static
+        private static readonly ObjectIdSerializer __instance = new ObjectIdSerializer();
+
+        // public static properties
+        /// <summary>
+        /// Gets a cached instance of an ObjectId serializer.
+        /// </summary>
+        public static ObjectIdSerializer Instance => __instance;
+        #endregion
+
         // private fields
         private readonly BsonType _representation;
 

src/MongoDB.Bson/Serialization/Serializers/RegexSerializer.cs

@@ -0,0 +1,153 @@
+/* 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 System.Text.RegularExpressions;
+
+namespace MongoDB.Bson.Serialization.Serializers
+{
+    /// <summary>
+    /// Represents a serializer for Regex.
+    /// </summary>
+    public class RegexSerializer : SealedClassSerializerBase<Regex>, IRepresentationConfigurable<RegexSerializer>
+    {
+        #region static
+        private static readonly RegexSerializer __regularExpressionInstance = new RegexSerializer(BsonType.RegularExpression);
+
+        /// <summary>
+        /// Gets a cached instance of a RegexSerializer with RegularExpression representation.
+        /// </summary>
+        public static RegexSerializer RegularExpressionInstance => __regularExpressionInstance;
+        #endregion
+
+        // private fields
+        private readonly BsonType _representation;
+
+        // constructors
+        /// <summary>
+        /// Initializes a new instance of the <see cref="RegexSerializer"/> class.
+        /// </summary>
+        public RegexSerializer()
+            : this(BsonType.RegularExpression)
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="RegexSerializer"/> class.
+        /// </summary>
+        /// <param name="representation">The representation.</param>
+        public RegexSerializer(BsonType representation)
+        {
+            switch (representation)
+            {
+                case BsonType.RegularExpression:
+                case BsonType.String:
+                    break;
+
+                default:
+                    var message = string.Format("{0} is not a valid representation for an RegexSerializer.", representation);
+                    throw new ArgumentException(message);
+            }
+
+            _representation = representation;
+        }
+
+        // public properties
+        /// <summary>
+        /// Gets the representation.
+        /// </summary>
+        /// <value>
+        /// The representation.
+        /// </value>
+        public BsonType Representation
+        {
+            get { return _representation; }
+        }
+
+        // public methods
+        /// <summary>
+        /// Deserializes a value.
+        /// </summary>
+        /// <param name="context">The deserialization context.</param>
+        /// <param name="args">The deserialization args.</param>
+        /// <returns>A deserialized value.</returns>
+        public override Regex Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
+        {
+            var reader = context.Reader;
+
+            var bsonType = reader.GetCurrentBsonType();
+            switch (bsonType)
+            {
+                case BsonType.RegularExpression:
+                    return reader.ReadRegularExpression().ToRegex();
+
+                case BsonType.String:
+                    return new Regex(reader.ReadString());
+
+                default:
+                    throw CreateCannotDeserializeFromBsonTypeException(bsonType);
+            }
+        }
+
+        /// <summary>
+        /// Serializes a value.
+        /// </summary>
+        /// <param name="context">The serialization context.</param>
+        /// <param name="args">The serialization args.</param>
+        /// <param name="value">The object.</param>
+        public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, Regex value)
+        {
+            var writer = context.Writer;
+
+            switch (_representation)
+            {
+                case BsonType.RegularExpression:
+                    writer.WriteRegularExpression(new BsonRegularExpression(value));
+                    break;
+
+                case BsonType.String:
+                    writer.WriteString(value.ToString());
+                    break;
+
+                default:
+                    var message = string.Format("'{0}' is not a valid Regex representation.", _representation);
+                    throw new BsonSerializationException(message);
+            }
+        }
+
+        /// <summary>
+        /// Returns a serializer that has been reconfigured with the specified representation.
+        /// </summary>
+        /// <param name="representation">The representation.</param>
+        /// <returns>The reconfigured serializer.</returns>
+        public RegexSerializer WithRepresentation(BsonType representation)
+        {
+            if (representation == _representation)
+            {
+                return this;
+            }
+            else
+            {
+                return new RegexSerializer(representation);
+            }
+        }
+
+        // explicit interface implementations
+        IBsonSerializer IRepresentationConfigurable.WithRepresentation(BsonType representation)
+        {
+            return WithRepresentation(representation);
+        }
+    }
+}