CSHARP-1439: Add document validation support to create collection (v1.x).

Author: rstam

MongoDB.Driver/Builders/CollectionOptionsBuilder.cs

@@ -85,6 +85,36 @@ public static CollectionOptionsBuilder SetStorageEngineOptions(BsonDocument valu
         {
             return new CollectionOptionsBuilder().SetStorageEngineOptions(value);
         }
+
+        /// <summary>
+        /// Sets the validation action.
+        /// </summary>
+        /// <param name="validationAction">The validation action.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public static CollectionOptionsBuilder SetValidationAction(DocumentValidationAction validationAction)
+        {
+            return new CollectionOptionsBuilder().SetValidationAction(validationAction);
+        }
+
+        /// <summary>
+        /// Sets the validation level.
+        /// </summary>
+        /// <param name="validationLevel">The validation level.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public static CollectionOptionsBuilder SetValidationLevel(DocumentValidationLevel validationLevel)
+        {
+            return new CollectionOptionsBuilder().SetValidationLevel(validationLevel);
+        }
+
+        /// <summary>
+        /// Sets the validator.
+        /// </summary>
+        /// <param name="validator">The validator.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public static CollectionOptionsBuilder SetValidator(IMongoQuery validator)
+        {
+            return new CollectionOptionsBuilder().SetValidator(validator);
+        }
     }
 
     /// <summary>
@@ -161,6 +191,39 @@ public CollectionOptionsBuilder SetStorageEngineOptions(BsonDocument value)
             return this;
         }
 
+        /// <summary>
+        /// Sets the validation action.
+        /// </summary>
+        /// <param name="validationAction">The validation action.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public CollectionOptionsBuilder SetValidationAction(DocumentValidationAction validationAction)
+        {
+            _document["validationAction"] = validationAction.ToString().ToLowerInvariant();
+            return this;
+        }
+
+        /// <summary>
+        /// Sets the validation level.
+        /// </summary>
+        /// <param name="validationLevel">The validation level.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public CollectionOptionsBuilder SetValidationLevel(DocumentValidationLevel validationLevel)
+        {
+            _document["validationLevel"] = validationLevel.ToString().ToLowerInvariant();
+            return this;
+        }
+
+        /// <summary>
+        /// Sets the validator.
+        /// </summary>
+        /// <param name="validator">The validator.</param>
+        /// <returns>The builder (so method calls can be chained).</returns>
+        public CollectionOptionsBuilder SetValidator(IMongoQuery validator)
+        {
+            _document["validator"] = validator.ToBsonDocument();
+            return this;
+        }
+
         /// <summary>
         /// Returns the result of the builder as a BsonDocument.
         /// </summary>

MongoDB.Driver/DocumentValidationAction.cs

@@ -0,0 +1,32 @@
+/* Copyright 2015 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.
+*/
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents the document validation action.
+    /// </summary>
+    public enum DocumentValidationAction
+    {
+        /// <summary>
+        /// Validation failures result in an error.
+        /// </summary>
+        Error = 0, // the default
+        /// <summary>
+        /// Validation failures result in a warning.
+        /// </summary>
+        Warn
+    }
+}

MongoDB.Driver/DocumentValidationLevel.cs

@@ -0,0 +1,36 @@
+/* Copyright 2015 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.
+*/
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents the document validation level.
+    /// </summary>
+    public enum DocumentValidationLevel
+    {
+        /// <summary>
+        /// Strict document validation.
+        /// </summary>
+        Strict = 0, // the default
+        /// <summary>
+        /// Moderate document validation.
+        /// </summary>
+        Moderate,
+        /// <summary>
+        /// No document validation.
+        /// </summary>
+        Off
+    }
+}

MongoDB.Driver/MongoDB.Driver.csproj

@@ -90,6 +90,8 @@
     <Compile Include="Communication\FeatureDetection\InstanceTypeDependency.cs" />
     <Compile Include="Communication\FeatureDetection\NotDependency.cs" />
     <Compile Include="Communication\Security\Mechanisms\ScramSha1Mechanism.cs" />
+    <Compile Include="DocumentValidationAction.cs" />
+    <Compile Include="DocumentValidationLevel.cs" />
     <Compile Include="Exceptions\MongoBulkWriteException.cs" />
     <Compile Include="Exceptions\MongoExecutionTimeoutException.cs" />
     <Compile Include="Exceptions\MongoWriteConcernException.cs" />

MongoDB.DriverUnitTests/Builders/CollectionOptionsBuilderTests.cs

@@ -1,4 +1,4 @@
-/* Copyright 2010-2014 MongoDB Inc.
+/* Copyright 2010-2015 MongoDB Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -14,6 +14,7 @@
 */
 
 using MongoDB.Bson;
+using MongoDB.Driver;
 using MongoDB.Driver.Builders;
 using NUnit.Framework;
 
@@ -89,5 +90,29 @@ public void TestSetNone()
             var expected = "{ }".Replace("'", "\"");
             Assert.AreEqual(expected, options.ToJson());
         }
+
+        [Test]
+        public void TestSetValidationAction()
+        {
+            var options = CollectionOptions.SetValidationAction(DocumentValidationAction.Error);
+            var expected = "{ \"validationAction\" : \"error\" }";
+            Assert.AreEqual(expected, options.ToJson());
+        }
+
+        [Test]
+        public void TestSetValidationLevel()
+        {
+            var options = CollectionOptions.SetValidationLevel(DocumentValidationLevel.Strict);
+            var expected = "{ \"validationLevel\" : \"strict\" }";
+            Assert.AreEqual(expected, options.ToJson());
+        }
+
+        [Test]
+        public void TestSetValidator()
+        {
+            var options = CollectionOptions.SetValidator(new QueryDocument("_id", new BsonDocument("$exists", true)));
+            var expected = "{ \"validator\" : { \"_id\" : { \"$exists\" : true } } }";
+            Assert.AreEqual(expected, options.ToJson());
+        }
     }
 }

MongoDB.DriverUnitTests/MongoDatabaseTests.cs

@@ -1,4 +1,4 @@
-/* Copyright 2010-2014 MongoDB Inc.
+/* Copyright 2010-2015 MongoDB Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -70,6 +70,27 @@ public void TestCreateCollection()
             Assert.IsTrue(_database.CollectionExists(collectionName));
         }
 
+        [Test]
+        [RequiresServer(MinimumVersion = "3.1.9999")]
+        public void TestCreateCollectionSetValidator()
+        {
+            var collection = _database.GetCollection("testvalidation");
+            collection.Drop();
+            Assert.IsFalse(collection.Exists());
+            var options = CollectionOptions
+                .SetValidator(new QueryDocument("_id", new BsonDocument("$exists", true)))
+                .SetValidationAction(DocumentValidationAction.Error)
+                .SetValidationLevel(DocumentValidationLevel.Strict);
+
+            _database.CreateCollection(collection.Name, options);
+
+            var commandResult = _database.RunCommand("listCollections");
+            var collectionInfo = commandResult.Response["cursor"]["firstBatch"].AsBsonArray.Where(c => c["name"] == collection.Name).Single();
+            Assert.That(collectionInfo["options"]["validator"], Is.EqualTo(new BsonDocument("_id", new BsonDocument("$exists", true))));
+            Assert.That(collectionInfo["options"]["validationAction"].AsString, Is.EqualTo("error"));
+            Assert.That(collectionInfo["options"]["validationLevel"].AsString, Is.EqualTo("strict"));
+        }
+
         [Test]
         public void TestDropCollection()
         {