CSHARP-1412: Add support for text search options (1.x API).

Author: rstam

MongoDB.Driver/Builders/QueryBuilder.cs

@@ -817,7 +817,7 @@ public static IMongoQuery WithinRectangle(string name, double lowerLeftX, double
         /// <returns>An IMongoQuery that represents the text search.</returns>
         public static IMongoQuery Text(string searchString)
         {
-            return Text(searchString, null);
+            return Text(searchString, new TextSearchOptions());
         }
 
         /// <summary>
@@ -833,10 +833,29 @@ public static IMongoQuery Text(string searchString, string language)
             {
                 throw new ArgumentNullException("searchString");
             }
+            var options = new TextSearchOptions { Language = language };
+            return Text(searchString, options);
+        }
+
+        /// <summary>
+        /// Generate a text search query that tests whether the given search string is present using the specified language's rules. 
+        /// Specifies use of language appropriate stop words, stemming rules etc.
+        /// </summary>
+        /// <param name="searchString">The search string.</param>
+        /// <param name="options">The text search options.</param>
+        /// <returns>An IMongoQuery that represents the text search for the particular language.</returns>
+        public static IMongoQuery Text(string searchString, TextSearchOptions options)
+        {
+            if (options == null)
+            {
+                throw new ArgumentNullException("options");
+            }
             var condition = new BsonDocument
             {
                 { "$search", searchString },
-                { "$language", language, language != null }
+                { "$language", options.Language, options.Language != null },
+                { "$caseSensitive", () => options.CaseSensitive.Value, options.CaseSensitive.HasValue },
+                { "$diacriticSensitive", () => options.DiacriticSensitive.Value, options.DiacriticSensitive.HasValue }
             };
             return new QueryDocument("$text", condition);
         }

MongoDB.Driver/MongoDB.Driver.csproj

@@ -97,6 +97,7 @@
     <Compile Include="Operations\ListIndexesOperation.cs" />
     <Compile Include="Operations\ParallelScanOperation.cs" />
     <Compile Include="ParallelScanArgs.cs" />
+    <Compile Include="TextSearchOptions.cs" />
     <Compile Include="WriteConcernError.cs" />
     <Compile Include="BulkWriteError.cs" />
     <Compile Include="BulkWriteResult.cs" />

MongoDB.Driver/TextSearchOptions.cs

@@ -0,0 +1,56 @@
+/* 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 text search options.
+    /// </summary>
+    public class TextSearchOptions
+    {
+        // private fields
+        private bool? _caseSensitive;
+        private bool? _diacriticSensitive;
+        private string _language;
+
+        // public properties
+        /// <summary>
+        /// Gets or sets whether a text search should be case sensitive.
+        /// </summary>
+        public bool? CaseSensitive
+        {
+            get { return _caseSensitive; }
+            set { _caseSensitive = value; }
+        }
+
+        /// <summary>
+        /// Gets or sets whether a text search should be diacritic sensitive.
+        /// </summary>
+        public bool? DiacriticSensitive
+        {
+            get { return _diacriticSensitive; }
+            set { _diacriticSensitive = value; }
+        }
+
+        /// <summary>
+        /// Gets or sets the language for a text search.
+        /// </summary>
+        public string Language
+        {
+            get { return _language; }
+            set { _language = value; }
+        }
+    }
+}

MongoDB.DriverUnitTests/Builders/QueryBuilderTests.cs

@@ -847,11 +847,25 @@ public void TestTextWithLanguageQueryGeneration()
         [Test]
         public void TestTextQueryGenerationWithNullLanguage()
         {
-            var query = Query.Text("foo", null);
+            var query = Query.Text("foo", (string)null);
             var expected = "{ \"$text\" : { \"$search\" : \"foo\" } }";
             Assert.AreEqual(expected, query.ToJson());
         }
 
+        [Test]
+        public void TestTextWithOptionsQueryGeneration()
+        {
+            var options = new TextSearchOptions
+            {
+                Language = "norwegian",
+                CaseSensitive = true,
+                DiacriticSensitive = true
+            };
+            var query = Query.Text("foo", options);
+            var expected = "{ \"$text\" : { \"$search\" : \"foo\", \"$language\" : \"norwegian\", \"$caseSensitive\" : true, \"$diacriticSensitive\" : true } }";
+            Assert.AreEqual(expected, query.ToJson());
+        }
+
         [Test]
         public void TestText()
         {