FilterDefinitionBuilder.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 System.Collections.Generic;
using System.Linq;
using System.Linq.Expressions;
using MongoDB.Bson;
using MongoDB.Bson.IO;
using MongoDB.Bson.Serialization;
using MongoDB.Bson.Serialization.Serializers;
using MongoDB.Driver.Core.Misc;
using MongoDB.Driver.GeoJsonObjectModel;
using MongoDB.Driver.Linq;

namespace MongoDB.Driver
{
    /// <summary>
    /// A builder for a <see cref="FilterDefinition{TDocument}"/>.
    /// </summary>
    /// <typeparam name="TDocument">The type of the document.</typeparam>
    public sealed class FilterDefinitionBuilder<TDocument>
    {
        /// <summary>
        /// Gets an empty filter. An empty filter matches everything.
        /// </summary>
        public FilterDefinition<TDocument> Empty
        {
            get { return FilterDefinition<TDocument>.Empty; }
        }

        /// <summary>
        /// Creates an all filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An all filter.</returns>
        public FilterDefinition<TDocument> All<TItem>(FieldDefinition<TDocument> field, IEnumerable<TItem> values)
        {
            return new ArrayOperatorFilterDefinition<TDocument, TItem>("$all", field, values);
        }

        /// <summary>
        /// Creates an all filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An all filter.</returns>
        public FilterDefinition<TDocument> All<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, IEnumerable<TItem> values)
        {
            return All(new ExpressionFieldDefinition<TDocument>(field), values);
        }

        /// <summary>
        /// Creates an and filter.
        /// </summary>
        /// <param name="filters">The filters.</param>
        /// <returns>A filter.</returns>
        public FilterDefinition<TDocument> And(params FilterDefinition<TDocument>[] filters)
        {
            return And((IEnumerable<FilterDefinition<TDocument>>)filters);
        }

        /// <summary>
        /// Creates an and filter.
        /// </summary>
        /// <param name="filters">The filters.</param>
        /// <returns>An and filter.</returns>
        public FilterDefinition<TDocument> And(IEnumerable<FilterDefinition<TDocument>> filters)
        {
            return new AndFilterDefinition<TDocument>(filters);
        }

        /// <summary>
        /// Creates an equality filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>An equality filter.</returns>
        public FilterDefinition<TDocument> AnyEq<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemSimpleFilterDefinition<TDocument, TItem>(field, value);
        }

        /// <summary>
        /// Creates an equality filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>An equality filter.</returns>
        public FilterDefinition<TDocument> AnyEq<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyEq(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates a greater than filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        public FilterDefinition<TDocument> AnyGt<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem>(
                "$gt",
                field,
                value);
        }

        /// <summary>
        /// Creates a greater than filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        public FilterDefinition<TDocument> AnyGt<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyGt(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates a greater than or equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        public FilterDefinition<TDocument> AnyGte<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem>(
                "$gte",
                field,
                value);
        }

        /// <summary>
        /// Creates a greater than or equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        public FilterDefinition<TDocument> AnyGte<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyGte(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates a less than filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        public FilterDefinition<TDocument> AnyLt<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem>(
                "$lt",
                field,
                value);
        }

        /// <summary>
        /// Creates a less than filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        public FilterDefinition<TDocument> AnyLt<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyLt(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates a less than or equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        public FilterDefinition<TDocument> AnyLte<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem>(
                "$lte",
                field,
                value);
        }

        /// <summary>
        /// Creates a less than or equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        public FilterDefinition<TDocument> AnyLte<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyLte(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates an in filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyIn<TItem>(FieldDefinition<TDocument> field, IEnumerable<TItem> values)
        {
            return new ArrayOperatorFilterDefinition<TDocument, TItem>("$in", field, values);
        }

        /// <summary>
        /// Creates an in filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyIn<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, IEnumerable<TItem> values)
        {
            return AnyIn(new ExpressionFieldDefinition<TDocument>(field), values);
        }

        /// <summary>
        /// Creates a not equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A not equal filter.</returns>
        public FilterDefinition<TDocument> AnyNe<TItem>(FieldDefinition<TDocument> field, TItem value)
        {
            return new ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem>(
                "$ne",
                field,
                value);
        }

        /// <summary>
        /// Creates a not equal filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A not equal filter.</returns>
        public FilterDefinition<TDocument> AnyNe<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, TItem value)
        {
            return AnyNe(new ExpressionFieldDefinition<TDocument>(field), value);
        }

        /// <summary>
        /// Creates a not in filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyNin<TItem>(FieldDefinition<TDocument> field, IEnumerable<TItem> values)
        {
            return new ArrayOperatorFilterDefinition<TDocument, TItem>("$nin", field, values);
        }

        /// <summary>
        /// Creates a not in filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyNin<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, IEnumerable<TItem> values)
        {
            return AnyNin(new ExpressionFieldDefinition<TDocument>(field), values);
        }

        /// <summary>
        /// Creates an in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyStringIn(FieldDefinition<TDocument, IEnumerable<string>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringArrayFieldInOrNinFilterDefinition<TDocument>(field, "$in", values);
        }

        /// <summary>
        /// Creates an in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyStringIn(FieldDefinition<TDocument, IEnumerable<string>> field, params StringOrRegularExpression[] values)
        {
            return AnyStringIn(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates an in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyStringIn(Expression<Func<TDocument, IEnumerable<string>>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringArrayFieldInOrNinFilterDefinition<TDocument>(new ExpressionFieldDefinition<TDocument, IEnumerable<string>>(field), "$in", values);
        }

        /// <summary>
        /// Creates an in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> AnyStringIn(Expression<Func<TDocument, IEnumerable<string>>> field, params StringOrRegularExpression[] values)
        {
            return AnyStringIn(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a not in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyStringNin(FieldDefinition<TDocument, IEnumerable<string>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringArrayFieldInOrNinFilterDefinition<TDocument>(field, "$nin", values);
        }

        /// <summary>
        /// Creates a not in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyStringNin(FieldDefinition<TDocument, IEnumerable<string>> field, params StringOrRegularExpression[] values)
        {
            return AnyStringNin(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a not in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyStringNin(Expression<Func<TDocument, IEnumerable<string>>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringArrayFieldInOrNinFilterDefinition<TDocument>(new ExpressionFieldDefinition<TDocument, IEnumerable<string>>(field), "$nin", values);
        }

        /// <summary>
        /// Creates a not in filter for a string array field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> AnyStringNin(Expression<Func<TDocument, IEnumerable<string>>> field, params StringOrRegularExpression[] values)
        {
            return AnyStringNin(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a bits all clear filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits all clear filter.</returns>
        public FilterDefinition<TDocument> BitsAllClear(FieldDefinition<TDocument> field, long bitmask)
        {
            return new OperatorFilterDefinition<TDocument>("$bitsAllClear", field, bitmask);
        }

        /// <summary>
        /// Creates a bits all clear filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits all clear filter.</returns>
        public FilterDefinition<TDocument> BitsAllClear(Expression<Func<TDocument, object>> field, long bitmask)
        {
            return BitsAllClear(new ExpressionFieldDefinition<TDocument>(field), bitmask);
        }

        /// <summary>
        /// Creates a bits all set filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits all set filter.</returns>
        public FilterDefinition<TDocument> BitsAllSet(FieldDefinition<TDocument> field, long bitmask)
        {
            return new OperatorFilterDefinition<TDocument>("$bitsAllSet", field, bitmask);
        }

        /// <summary>
        /// Creates a bits all set filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits all set filter.</returns>
        public FilterDefinition<TDocument> BitsAllSet(Expression<Func<TDocument, object>> field, long bitmask)
        {
            return BitsAllSet(new ExpressionFieldDefinition<TDocument>(field), bitmask);
        }

        /// <summary>
        /// Creates a bits any clear filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits any clear filter.</returns>
        public FilterDefinition<TDocument> BitsAnyClear(FieldDefinition<TDocument> field, long bitmask)
        {
            return new OperatorFilterDefinition<TDocument>("$bitsAnyClear", field, bitmask);
        }

        /// <summary>
        /// Creates a bits any clear filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits any clear filter.</returns>
        public FilterDefinition<TDocument> BitsAnyClear(Expression<Func<TDocument, object>> field, long bitmask)
        {
            return BitsAnyClear(new ExpressionFieldDefinition<TDocument>(field), bitmask);
        }

        /// <summary>
        /// Creates a bits any set filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits any set filter.</returns>
        public FilterDefinition<TDocument> BitsAnySet(FieldDefinition<TDocument> field, long bitmask)
        {
            return new OperatorFilterDefinition<TDocument>("$bitsAnySet", field, bitmask);
        }

        /// <summary>
        /// Creates a bits any set filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="bitmask">The bitmask.</param>
        /// <returns>A bits any set filter.</returns>
        public FilterDefinition<TDocument> BitsAnySet(Expression<Func<TDocument, object>> field, long bitmask)
        {
            return BitsAnySet(new ExpressionFieldDefinition<TDocument>(field), bitmask);
        }

        /// <summary>
        /// Creates an element match filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="filter">The filter.</param>
        /// <returns>An element match filter.</returns>
        public FilterDefinition<TDocument> ElemMatch<TItem>(FieldDefinition<TDocument> field, FilterDefinition<TItem> filter)
        {
            return new ElementMatchFilterDefinition<TDocument, TItem>(field, filter);
        }

        /// <summary>
        /// Creates an element match filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="filter">The filter.</param>
        /// <returns>An element match filter.</returns>
        public FilterDefinition<TDocument> ElemMatch<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, FilterDefinition<TItem> filter)
        {
            return ElemMatch(new ExpressionFieldDefinition<TDocument>(field), filter);
        }

        /// <summary>
        /// Creates an element match filter for an array field.
        /// </summary>
        /// <typeparam name="TItem">The type of the item.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="filter">The filter.</param>
        /// <returns>An element match filter.</returns>
        public FilterDefinition<TDocument> ElemMatch<TItem>(Expression<Func<TDocument, IEnumerable<TItem>>> field, Expression<Func<TItem, bool>> filter)
        {
            return ElemMatch(new ExpressionFieldDefinition<TDocument>(field), new ExpressionFilterDefinition<TItem>(filter));
        }

        /// <summary>
        /// Creates an equality filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>An equality filter.</returns>
        public FilterDefinition<TDocument> Eq<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new SimpleFilterDefinition<TDocument, TField>(field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates an equality filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>An equality filter.</returns>
        public FilterDefinition<TDocument> Eq<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Eq(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates an exists filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="exists">if set to <c>true</c> [exists].</param>
        /// <returns>An exists filter.</returns>
        public FilterDefinition<TDocument> Exists(FieldDefinition<TDocument> field, bool exists = true)
        {
            return new OperatorFilterDefinition<TDocument>("$exists", field, exists);
        }

        /// <summary>
        /// Creates an exists filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="exists">if set to <c>true</c> [exists].</param>
        /// <returns>An exists filter.</returns>
        public FilterDefinition<TDocument> Exists(Expression<Func<TDocument, object>> field, bool exists = true)
        {
            return Exists(new ExpressionFieldDefinition<TDocument>(field), exists);
        }

        /// <summary>
        /// Creates a geo intersects filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="geometry">The geometry.</param>
        /// <returns>A geo intersects filter.</returns>
        public FilterDefinition<TDocument> GeoIntersects<TCoordinates>(FieldDefinition<TDocument> field, GeoJsonGeometry<TCoordinates> geometry)
            where TCoordinates : GeoJsonCoordinates
        {
            return new GeometryOperatorFilterDefinition<TDocument, TCoordinates>("$geoIntersects", field, geometry);
        }

        /// <summary>
        /// Creates a geo intersects filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="geometry">The geometry.</param>
        /// <returns>A geo intersects filter.</returns>
        public FilterDefinition<TDocument> GeoIntersects<TCoordinates>(Expression<Func<TDocument, object>> field, GeoJsonGeometry<TCoordinates> geometry)
            where TCoordinates : GeoJsonCoordinates
        {
            return GeoIntersects(new ExpressionFieldDefinition<TDocument>(field), geometry);
        }

        /// <summary>
        /// Creates a geo within filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="geometry">The geometry.</param>
        /// <returns>A geo within filter.</returns>
        public FilterDefinition<TDocument> GeoWithin<TCoordinates>(FieldDefinition<TDocument> field, GeoJsonGeometry<TCoordinates> geometry)
            where TCoordinates : GeoJsonCoordinates
        {
            return new GeometryOperatorFilterDefinition<TDocument, TCoordinates>("$geoWithin", field, geometry);
        }

        /// <summary>
        /// Creates a geo within filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="geometry">The geometry.</param>
        /// <returns>A geo within filter.</returns>
        public FilterDefinition<TDocument> GeoWithin<TCoordinates>(Expression<Func<TDocument, object>> field, GeoJsonGeometry<TCoordinates> geometry)
            where TCoordinates : GeoJsonCoordinates
        {
            return GeoWithin(new ExpressionFieldDefinition<TDocument>(field), geometry);
        }

        /// <summary>
        /// Creates a geo within box filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="lowerLeftX">The lower left x.</param>
        /// <param name="lowerLeftY">The lower left y.</param>
        /// <param name="upperRightX">The upper right x.</param>
        /// <param name="upperRightY">The upper right y.</param>
        /// <returns>A geo within box filter.</returns>
        public FilterDefinition<TDocument> GeoWithinBox(FieldDefinition<TDocument> field, double lowerLeftX, double lowerLeftY, double upperRightX, double upperRightY)
        {
            return new OperatorFilterDefinition<TDocument>(
                "$geoWithin",
                field,
                new BsonDocument("$box",
                    new BsonArray
                    {
                        new BsonArray { lowerLeftX, lowerLeftY },
                        new BsonArray { upperRightX, upperRightY }
                    }));
        }

        /// <summary>
        /// Creates a geo within box filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="lowerLeftX">The lower left x.</param>
        /// <param name="lowerLeftY">The lower left y.</param>
        /// <param name="upperRightX">The upper right x.</param>
        /// <param name="upperRightY">The upper right y.</param>
        /// <returns>A geo within box filter.</returns>
        public FilterDefinition<TDocument> GeoWithinBox(Expression<Func<TDocument, object>> field, double lowerLeftX, double lowerLeftY, double upperRightX, double upperRightY)
        {
            return GeoWithinBox(new ExpressionFieldDefinition<TDocument>(field), lowerLeftX, lowerLeftY, upperRightX, upperRightY);
        }

        /// <summary>
        /// Creates a geo within center filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="radius">The radius.</param>
        /// <returns>A geo within center filter.</returns>
        public FilterDefinition<TDocument> GeoWithinCenter(FieldDefinition<TDocument> field, double x, double y, double radius)
        {
            return new OperatorFilterDefinition<TDocument>("$geoWithin", field, new BsonDocument("$center", new BsonArray { new BsonArray { x, y }, radius }));
        }

        /// <summary>
        /// Creates a geo within center filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="radius">The radius.</param>
        /// <returns>A geo within center filter.</returns>
        public FilterDefinition<TDocument> GeoWithinCenter(Expression<Func<TDocument, object>> field, double x, double y, double radius)
        {
            return GeoWithinCenter(new ExpressionFieldDefinition<TDocument>(field), x, y, radius);
        }

        /// <summary>
        /// Creates a geo within center sphere filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="radius">The radius.</param>
        /// <returns>A geo within center sphere filter.</returns>
        public FilterDefinition<TDocument> GeoWithinCenterSphere(FieldDefinition<TDocument> field, double x, double y, double radius)
        {
            return new OperatorFilterDefinition<TDocument>("$geoWithin", field, new BsonDocument("$centerSphere", new BsonArray { new BsonArray { x, y }, radius }));
        }

        /// <summary>
        /// Creates a geo within center sphere filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="radius">The radius.</param>
        /// <returns>A geo within center sphere filter.</returns>
        public FilterDefinition<TDocument> GeoWithinCenterSphere(Expression<Func<TDocument, object>> field, double x, double y, double radius)
        {
            return GeoWithinCenterSphere(new ExpressionFieldDefinition<TDocument>(field), x, y, radius);
        }

        /// <summary>
        /// Creates a geo within polygon filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="points">The points.</param>
        /// <returns>A geo within polygon filter.</returns>
        public FilterDefinition<TDocument> GeoWithinPolygon(FieldDefinition<TDocument> field, double[,] points)
        {
            var arrayOfPoints = new BsonArray(points.GetLength(0));
            for (var i = 0; i < points.GetLength(0); i++)
            {
                arrayOfPoints.Add(new BsonArray(2) { points[i, 0], points[i, 1] });
            }

            return new OperatorFilterDefinition<TDocument>("$geoWithin", field, new BsonDocument("$polygon", arrayOfPoints));
        }

        /// <summary>
        /// Creates a geo within polygon filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="points">The points.</param>
        /// <returns>A geo within polygon filter.</returns>
        public FilterDefinition<TDocument> GeoWithinPolygon(Expression<Func<TDocument, object>> field, double[,] points)
        {
            return GeoWithinPolygon(new ExpressionFieldDefinition<TDocument>(field), points);
        }

        /// <summary>
        /// Creates a greater than filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gt(FieldDefinition<TDocument, uint> field, uint value)
        {
            return new UInt32GreaterThanFilterDefinition<TDocument>("$gt", field, value);
        }

        /// <summary>
        /// Creates a greater than filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gt(FieldDefinition<TDocument, ulong> field, ulong value)
        {
            return new UInt64GreaterThanFilterDefinition<TDocument>("$gt", field, value);
        }

        /// <summary>
        /// Creates a greater than filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        public FilterDefinition<TDocument> Gt<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new OperatorFilterDefinition<TDocument, TField>("$gt", field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates a greater than filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gt(Expression<Func<TDocument, uint>> field, uint value)
        {
            return Gt(new ExpressionFieldDefinition<TDocument, uint>(field), value);
        }

        /// <summary>
        /// Creates a greater than filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gt(Expression<Func<TDocument, ulong>> field, ulong value)
        {
            return Gt(new ExpressionFieldDefinition<TDocument, ulong>(field), value);
        }

        /// <summary>
        /// Creates a greater than filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than filter.</returns>
        public FilterDefinition<TDocument> Gt<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Gt(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates a greater than or equal filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gte(FieldDefinition<TDocument, uint> field, uint value)
        {
            return new UInt32GreaterThanFilterDefinition<TDocument>("$gte", field, value);
        }

        /// <summary>
        /// Creates a greater than or equal filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gte(FieldDefinition<TDocument, ulong> field, ulong value)
        {
            return new UInt64GreaterThanFilterDefinition<TDocument>("$gte", field, value);
        }

        /// <summary>
        /// Creates a greater than or equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        public FilterDefinition<TDocument> Gte<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new OperatorFilterDefinition<TDocument, TField>("$gte", field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates a greater than or equal filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gte(Expression<Func<TDocument, uint>> field, uint value)
        {
            return Gte(new ExpressionFieldDefinition<TDocument, uint>(field), value);
        }

        /// <summary>
        /// Creates a greater than or equal filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Gte(Expression<Func<TDocument, ulong>> field, ulong value)
        {
            return Gte(new ExpressionFieldDefinition<TDocument, ulong>(field), value);
        }

        /// <summary>
        /// Creates a greater than or equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A greater than or equal filter.</returns>
        public FilterDefinition<TDocument> Gte<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Gte(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates an in filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> In<TField>(FieldDefinition<TDocument, TField> field, IEnumerable<TField> values)
        {
            return new SingleItemAsArrayOperatorFilterDefinition<TDocument, TField>("$in", field, values, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates an in filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> In<TField>(Expression<Func<TDocument, TField>> field, IEnumerable<TField> values)
        {
            return In(new ExpressionFieldDefinition<TDocument, TField>(field), values);
        }

        /// <summary>
        /// Creates a json schema filter.
        /// </summary>
        /// <param name="schema">The json validation schema.</param>
        /// <returns>A schema filter.</returns>
        public FilterDefinition<TDocument> JsonSchema(BsonDocument schema)
        {
            return new BsonDocumentFilterDefinition<TDocument>(new BsonDocument("$jsonSchema", schema));
        }

        /// <summary>
        /// Creates a less than filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lt(FieldDefinition<TDocument, uint> field, uint value)
        {
            return new UInt32LessThanFilterDefinition<TDocument>("$lt", field, value);
        }

        /// <summary>
        /// Creates a less than filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lt(FieldDefinition<TDocument, ulong> field, ulong value)
        {
            return new UInt64LessThanFilterDefinition<TDocument>("$lt", field, value);
        }

        /// <summary>
        /// Creates a less than filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        public FilterDefinition<TDocument> Lt<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new OperatorFilterDefinition<TDocument, TField>("$lt", field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates a less than filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lt(Expression<Func<TDocument, uint>> field, uint value)
        {
            return Lt(new ExpressionFieldDefinition<TDocument, uint>(field), value);
        }

        /// <summary>
        /// Creates a less than filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lt(Expression<Func<TDocument, ulong>> field, ulong value)
        {
            return Lt(new ExpressionFieldDefinition<TDocument, ulong>(field), value);
        }

        /// <summary>
        /// Creates a less than filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than filter.</returns>
        public FilterDefinition<TDocument> Lt<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Lt(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates a less than or equal filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lte(FieldDefinition<TDocument, uint> field, uint value)
        {
            return new UInt32LessThanFilterDefinition<TDocument>("$lte", field, value);
        }

        /// <summary>
        /// Creates a less than or equal filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lte(FieldDefinition<TDocument, ulong> field, ulong value)
        {
            return new UInt64LessThanFilterDefinition<TDocument>("$lte", field, value);
        }

        /// <summary>
        /// Creates a less than or equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        public FilterDefinition<TDocument> Lte<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new OperatorFilterDefinition<TDocument, TField>("$lte", field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates a less than or equal filter for a UInt32 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lte(Expression<Func<TDocument, uint>> field, uint value)
        {
            return Lte(new ExpressionFieldDefinition<TDocument, uint>(field), value);
        }

        /// <summary>
        /// Creates a less than or equal filter for a UInt64 field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        [CLSCompliant(false)]
        public FilterDefinition<TDocument> Lte(Expression<Func<TDocument, ulong>> field, ulong value)
        {
            return Lte(new ExpressionFieldDefinition<TDocument, ulong>(field), value);
        }

        /// <summary>
        /// Creates a less than or equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A less than or equal filter.</returns>
        public FilterDefinition<TDocument> Lte<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Lte(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates a modulo filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="modulus">The modulus.</param>
        /// <param name="remainder">The remainder.</param>
        /// <returns>A modulo filter.</returns>
        public FilterDefinition<TDocument> Mod(FieldDefinition<TDocument> field, long modulus, long remainder)
        {
            return new OperatorFilterDefinition<TDocument>("$mod", field, new BsonArray { modulus, remainder });
        }

        /// <summary>
        /// Creates a modulo filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="modulus">The modulus.</param>
        /// <param name="remainder">The remainder.</param>
        /// <returns>A modulo filter.</returns>
        public FilterDefinition<TDocument> Mod(Expression<Func<TDocument, object>> field, long modulus, long remainder)
        {
            return Mod(new ExpressionFieldDefinition<TDocument>(field), modulus, remainder);
        }

        /// <summary>
        /// Creates a not equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A not equal filter.</returns>
        public FilterDefinition<TDocument> Ne<TField>(FieldDefinition<TDocument, TField> field, TField value)
        {
            return new OperatorFilterDefinition<TDocument, TField>("$ne", field, value, allowScalarValueForArrayField: true);
        }

        /// <summary>
        /// Creates a not equal filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="value">The value.</param>
        /// <returns>A not equal filter.</returns>
        public FilterDefinition<TDocument> Ne<TField>(Expression<Func<TDocument, TField>> field, TField value)
        {
            return Ne(new ExpressionFieldDefinition<TDocument, TField>(field), value);
        }

        /// <summary>
        /// Creates a near filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near filter.</returns>
        public FilterDefinition<TDocument> Near(FieldDefinition<TDocument> field, double x, double y, double? maxDistance = null, double? minDistance = null)
        {
            var document = new BsonDocument
            {
                { "$near", new BsonArray { x, y } },
                { "$maxDistance", () => maxDistance.Value, maxDistance.HasValue },
                { "$minDistance", () => minDistance.Value, minDistance.HasValue }
            };

            return new SimpleFilterDefinition<TDocument>(field, document);
        }

        /// <summary>
        /// Creates a near filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near filter.</returns>
        public FilterDefinition<TDocument> Near(Expression<Func<TDocument, object>> field, double x, double y, double? maxDistance = null, double? minDistance = null)
        {
            return Near(new ExpressionFieldDefinition<TDocument>(field), x, y, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a near filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="point">The geometry.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near filter.</returns>
        public FilterDefinition<TDocument> Near<TCoordinates>(FieldDefinition<TDocument> field, GeoJsonPoint<TCoordinates> point, double? maxDistance = null, double? minDistance = null)
            where TCoordinates : GeoJsonCoordinates
        {
            return new NearFilterDefinition<TDocument, TCoordinates>(field, point, false, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a near filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="point">The geometry.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near filter.</returns>
        public FilterDefinition<TDocument> Near<TCoordinates>(Expression<Func<TDocument, object>> field, GeoJsonPoint<TCoordinates> point, double? maxDistance = null, double? minDistance = null)
            where TCoordinates : GeoJsonCoordinates
        {
            return Near(new ExpressionFieldDefinition<TDocument>(field), point, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a near sphere filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near sphere filter.</returns>
        public FilterDefinition<TDocument> NearSphere(FieldDefinition<TDocument> field, double x, double y, double? maxDistance = null, double? minDistance = null)
        {
            var document = new BsonDocument
            {
                { "$nearSphere", new BsonArray { x, y } },
                { "$maxDistance", () => maxDistance.Value, maxDistance.HasValue },
                { "$minDistance", () => minDistance.Value, minDistance.HasValue }
            };

            return new SimpleFilterDefinition<TDocument>(field, document);
        }

        /// <summary>
        /// Creates a near sphere filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="x">The x.</param>
        /// <param name="y">The y.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near sphere filter.</returns>
        public FilterDefinition<TDocument> NearSphere(Expression<Func<TDocument, object>> field, double x, double y, double? maxDistance = null, double? minDistance = null)
        {
            return NearSphere(new ExpressionFieldDefinition<TDocument>(field), x, y, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a near sphere filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="point">The geometry.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near sphere filter.</returns>
        public FilterDefinition<TDocument> NearSphere<TCoordinates>(FieldDefinition<TDocument> field, GeoJsonPoint<TCoordinates> point, double? maxDistance = null, double? minDistance = null)
            where TCoordinates : GeoJsonCoordinates
        {
            return new NearFilterDefinition<TDocument, TCoordinates>(field, point, true, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a near sphere filter.
        /// </summary>
        /// <typeparam name="TCoordinates">The type of the coordinates.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="point">The geometry.</param>
        /// <param name="maxDistance">The maximum distance.</param>
        /// <param name="minDistance">The minimum distance.</param>
        /// <returns>A near sphere filter.</returns>
        public FilterDefinition<TDocument> NearSphere<TCoordinates>(Expression<Func<TDocument, object>> field, GeoJsonPoint<TCoordinates> point, double? maxDistance = null, double? minDistance = null)
            where TCoordinates : GeoJsonCoordinates
        {
            return NearSphere(new ExpressionFieldDefinition<TDocument>(field), point, maxDistance, minDistance);
        }

        /// <summary>
        /// Creates a not in filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> Nin<TField>(FieldDefinition<TDocument, TField> field, IEnumerable<TField> values)
        {
            return new SingleItemAsArrayOperatorFilterDefinition<TDocument, TField>(
                "$nin",
                field,
                values);
        }

        /// <summary>
        /// Creates a not in filter.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> Nin<TField>(Expression<Func<TDocument, TField>> field, IEnumerable<TField> values)
        {
            return Nin(new ExpressionFieldDefinition<TDocument, TField>(field), values);
        }

        /// <summary>
        /// Creates a not filter.
        /// </summary>
        /// <param name="filter">The filter.</param>
        /// <returns>A not filter.</returns>
        public FilterDefinition<TDocument> Not(FilterDefinition<TDocument> filter)
        {
            return new NotFilterDefinition<TDocument>(filter);
        }

        /// <summary>
        /// Creates an OfType filter that matches documents of a derived type.
        /// </summary>
        /// <typeparam name="TDerived">The type of the matching derived documents.</typeparam>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TDerived>() where TDerived : TDocument
        {
            return new DocumentOfTypeFilterDefinition<TDocument, TDerived>();
        }

        /// <summary>
        /// Creates an OfType filter that matches documents of a derived type and that also match a filter on the derived document.
        /// </summary>
        /// <typeparam name="TDerived">The type of the matching derived documents.</typeparam>
        /// <param name="derivedDocumentFilter">A filter on the derived document.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TDerived>(FilterDefinition<TDerived> derivedDocumentFilter) where TDerived : TDocument
        {
            Ensure.IsNotNull(derivedDocumentFilter, nameof(derivedDocumentFilter));
            return new DocumentOfTypeFilterDefinition<TDocument, TDerived>(derivedDocumentFilter);
        }

        /// <summary>
        /// Creates an OfType filter that matches documents of a derived type and that also match a filter on the derived document.
        /// </summary>
        /// <typeparam name="TDerived">The type of the matching derived documents.</typeparam>
        /// <param name="derivedDocumentFilter">A filter on the derived document.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TDerived>(Expression<Func<TDerived, bool>> derivedDocumentFilter) where TDerived : TDocument
        {
            Ensure.IsNotNull(derivedDocumentFilter, nameof(derivedDocumentFilter));
            return OfType<TDerived>(new ExpressionFilterDefinition<TDerived>(derivedDocumentFilter));
        }

        /// <summary>
        /// Creates an OfType filter that matches documents with a field of a derived typer.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <typeparam name="TDerived">The type of the matching derived field value.</typeparam>
        /// <param name="field">The field.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TField, TDerived>(FieldDefinition<TDocument, TField> field) where TDerived : TField
        {
            Ensure.IsNotNull(field, nameof(field));
            return new FieldOfTypeFilterDefinition<TDocument, TField, TDerived>(field);
        }

        /// <summary>
        /// Creates an OfType filter that matches documents with a field of a derived type and that also match a filter on the derived field.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <typeparam name="TDerived">The type of the matching derived field value.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="derivedFieldFilter">A filter on the derived field.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TField, TDerived>(FieldDefinition<TDocument, TField> field, FilterDefinition<TDerived> derivedFieldFilter) where TDerived : TField
        {
            Ensure.IsNotNull(field, nameof(field));
            Ensure.IsNotNull(derivedFieldFilter, nameof(derivedFieldFilter));
            return new FieldOfTypeFilterDefinition<TDocument, TField, TDerived>(field, derivedFieldFilter);
        }

        /// <summary>
        /// Creates an OfType filter that matches documents with a field of a derived type.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <typeparam name="TDerived">The type of the matching derived field value.</typeparam>
        /// <param name="field">The field.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TField, TDerived>(Expression<Func<TDocument, TField>> field) where TDerived : TField
        {
            Ensure.IsNotNull(field, nameof(field));
            return OfType<TField, TDerived>(new ExpressionFieldDefinition<TDocument, TField>(field));
        }

        /// <summary>
        /// Creates an OfType filter that matches documents with a field of a derived type and that also match a filter on the derived field.
        /// </summary>
        /// <typeparam name="TField">The type of the field.</typeparam>
        /// <typeparam name="TDerived">The type of the matching derived field value.</typeparam>
        /// <param name="field">The field.</param>
        /// <param name="derivedFieldFilter">A filter on the derived field.</param>
        /// <returns>An OfType filter.</returns>
        public FilterDefinition<TDocument> OfType<TField, TDerived>(Expression<Func<TDocument, TField>> field, Expression<Func<TDerived, bool>> derivedFieldFilter) where TDerived : TField
        {
            Ensure.IsNotNull(field, nameof(field));
            Ensure.IsNotNull(derivedFieldFilter, nameof(derivedFieldFilter));
            return OfType<TField, TDerived>(new ExpressionFieldDefinition<TDocument, TField>(field), new ExpressionFilterDefinition<TDerived>(derivedFieldFilter));
        }

        /// <summary>
        /// Creates an or filter.
        /// </summary>
        /// <param name="filters">The filters.</param>
        /// <returns>An or filter.</returns>
        public FilterDefinition<TDocument> Or(params FilterDefinition<TDocument>[] filters)
        {
            return Or((IEnumerable<FilterDefinition<TDocument>>)filters);
        }

        /// <summary>
        /// Creates an or filter.
        /// </summary>
        /// <param name="filters">The filters.</param>
        /// <returns>An or filter.</returns>
        public FilterDefinition<TDocument> Or(IEnumerable<FilterDefinition<TDocument>> filters)
        {
            return new OrFilterDefinition<TDocument>(filters);
        }

        /// <summary>
        /// Creates a regular expression filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="regex">The regex.</param>
        /// <returns>A regular expression filter.</returns>
        public FilterDefinition<TDocument> Regex(FieldDefinition<TDocument> field, BsonRegularExpression regex)
        {
            return new SimpleFilterDefinition<TDocument>(field, regex);
        }

        /// <summary>
        /// Creates a regular expression filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="regex">The regex.</param>
        /// <returns>A regular expression filter.</returns>
        public FilterDefinition<TDocument> Regex(Expression<Func<TDocument, object>> field, BsonRegularExpression regex)
        {
            return Regex(new ExpressionFieldDefinition<TDocument>(field), regex);
        }

        /// <summary>
        /// Creates a size filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size filter.</returns>
        public FilterDefinition<TDocument> Size(FieldDefinition<TDocument> field, int size)
        {
            return new OperatorFilterDefinition<TDocument>("$size", field, size);
        }

        /// <summary>
        /// Creates a size filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size filter.</returns>
        public FilterDefinition<TDocument> Size(Expression<Func<TDocument, object>> field, int size)
        {
            return Size(new ExpressionFieldDefinition<TDocument>(field), size);
        }

        /// <summary>
        /// Creates a size greater than filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size greater than filter.</returns>
        public FilterDefinition<TDocument> SizeGt(FieldDefinition<TDocument> field, int size)
        {
            return new ArrayIndexExistsFilterDefinition<TDocument>(field, size, true);
        }

        /// <summary>
        /// Creates a size greater than filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size greater than filter.</returns>
        public FilterDefinition<TDocument> SizeGt(Expression<Func<TDocument, object>> field, int size)
        {
            return SizeGt(new ExpressionFieldDefinition<TDocument>(field), size);
        }

        /// <summary>
        /// Creates a size greater than or equal filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size greater than or equal filter.</returns>
        public FilterDefinition<TDocument> SizeGte(FieldDefinition<TDocument> field, int size)
        {
            return new ArrayIndexExistsFilterDefinition<TDocument>(field, size - 1, true);
        }

        /// <summary>
        /// Creates a size greater than or equal filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size greater than or equal filter.</returns>
        public FilterDefinition<TDocument> SizeGte(Expression<Func<TDocument, object>> field, int size)
        {
            return SizeGte(new ExpressionFieldDefinition<TDocument>(field), size);
        }

        /// <summary>
        /// Creates a size less than filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size less than filter.</returns>
        public FilterDefinition<TDocument> SizeLt(FieldDefinition<TDocument> field, int size)
        {
            return new ArrayIndexExistsFilterDefinition<TDocument>(field, size - 1, false);
        }

        /// <summary>
        /// Creates a size less than filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size less than filter.</returns>
        public FilterDefinition<TDocument> SizeLt(Expression<Func<TDocument, object>> field, int size)
        {
            return SizeLt(new ExpressionFieldDefinition<TDocument>(field), size);
        }

        /// <summary>
        /// Creates a size less than or equal filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size less than or equal filter.</returns>
        public FilterDefinition<TDocument> SizeLte(FieldDefinition<TDocument> field, int size)
        {
            return new ArrayIndexExistsFilterDefinition<TDocument>(field, size, false);
        }

        /// <summary>
        /// Creates a size less than or equal filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="size">The size.</param>
        /// <returns>A size less than or equal filter.</returns>
        public FilterDefinition<TDocument> SizeLte(Expression<Func<TDocument, object>> field, int size)
        {
            return SizeLte(new ExpressionFieldDefinition<TDocument>(field), size);
        }

        /// <summary>
        /// Creates an in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> StringIn(FieldDefinition<TDocument, string> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringFieldInOrNinFilterDefinition<TDocument>(field, "$in", values);
        }

        /// <summary>
        /// Creates an in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> StringIn(FieldDefinition<TDocument, string> field, params StringOrRegularExpression[] values)
        {
            return StringIn(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates an in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> StringIn(Expression<Func<TDocument, string>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringFieldInOrNinFilterDefinition<TDocument>(new ExpressionFieldDefinition<TDocument, string>(field), "$in", values);
        }

        /// <summary>
        /// Creates an in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>An in filter.</returns>
        public FilterDefinition<TDocument> StringIn(Expression<Func<TDocument, string>> field, params StringOrRegularExpression[] values)
        {
            return StringIn(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a not in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> StringNin(FieldDefinition<TDocument, string> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringFieldInOrNinFilterDefinition<TDocument>(field, "$nin", values);
        }

        /// <summary>
        /// Creates a not in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> StringNin(FieldDefinition<TDocument, string> field, params StringOrRegularExpression[] values)
        {
            return StringNin(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a not in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> StringNin(Expression<Func<TDocument, string>> field, IEnumerable<StringOrRegularExpression> values)
        {
            return new StringFieldInOrNinFilterDefinition<TDocument>(new ExpressionFieldDefinition<TDocument, string>(field), "$nin", values);
        }

        /// <summary>
        /// Creates a not in filter for a string field.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="values">The values.</param>
        /// <returns>A not in filter.</returns>
        public FilterDefinition<TDocument> StringNin(Expression<Func<TDocument, string>> field, params StringOrRegularExpression[] values)
        {
            return StringNin(field, (IEnumerable<StringOrRegularExpression>)values);
        }

        /// <summary>
        /// Creates a text filter.
        /// </summary>
        /// <param name="search">The search.</param>
        /// <param name="options">The text search options.</param>
        /// <returns>A text filter.</returns>
        public FilterDefinition<TDocument> Text(string search, TextSearchOptions options = null)
        {
            var document = new BsonDocument
            {
                { "$search", search },
                { "$language", () => options.Language, options != null && options.Language != null },
                { "$caseSensitive", () => options.CaseSensitive.Value, options != null && options.CaseSensitive.HasValue },
                { "$diacriticSensitive", () => options.DiacriticSensitive.Value, options != null && options.DiacriticSensitive.HasValue }
            };
            return new BsonDocumentFilterDefinition<TDocument>(new BsonDocument("$text", document));
        }

        /// <summary>
        /// Creates a text filter.
        /// </summary>
        /// <param name="search">The search.</param>
        /// <param name="language">The language.</param>
        /// <returns>A text filter.</returns>
        public FilterDefinition<TDocument> Text(string search, string language)
        {
            var options = new TextSearchOptions { Language = language };
            return Text(search, options);
        }

        /// <summary>
        /// Creates a type filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="type">The type.</param>
        /// <returns>A type filter.</returns>
        public FilterDefinition<TDocument> Type(FieldDefinition<TDocument> field, BsonType type)
        {
            return new OperatorFilterDefinition<TDocument>("$type", field, (int)type);
        }

        /// <summary>
        /// Creates a type filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="type">The type.</param>
        /// <returns>A type filter.</returns>
        public FilterDefinition<TDocument> Type(FieldDefinition<TDocument> field, string type)
        {
            return new OperatorFilterDefinition<TDocument>("$type", field, type);
        }

        /// <summary>
        /// Creates a type filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="type">The type.</param>
        /// <returns>A type filter.</returns>
        public FilterDefinition<TDocument> Type(Expression<Func<TDocument, object>> field, BsonType type)
        {
            return Type(new ExpressionFieldDefinition<TDocument>(field), type);
        }
        /// <summary>
        /// Creates a type filter.
        /// </summary>
        /// <param name="field">The field.</param>
        /// <param name="type">The type.</param>
        /// <returns>A type filter.</returns>
        public FilterDefinition<TDocument> Type(Expression<Func<TDocument, object>> field, string type)
        {
            return Type(new ExpressionFieldDefinition<TDocument>(field), type);
        }

        /// <summary>
        /// Creates a filter based on the expression.
        /// </summary>
        /// <param name="expression">The expression.</param>
        /// <returns>An expression filter.</returns>
        public FilterDefinition<TDocument> Where(Expression<Func<TDocument, bool>> expression)
        {
            return new ExpressionFilterDefinition<TDocument>(expression);
        }
    }

    internal sealed class AndFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        #region static
        private static readonly string[] __operatorsThatCannotBeCombined = new[]
        {
            "$geoWithin",
            "$near",
            "$geoIntersects",
            "$nearSphere"
        };
        #endregion

        private readonly List<FilterDefinition<TDocument>> _filters;

        public AndFilterDefinition(IEnumerable<FilterDefinition<TDocument>> filters)
        {
            _filters = Ensure.IsNotNull(filters, nameof(filters)).ToList();
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            if (_filters.Count == 0)
            {
                return new BsonDocument("$and", new BsonArray(0));
            }

            var document = new BsonDocument();

            foreach (var filter in _filters)
            {
                var renderedFilter = filter.Render(documentSerializer, serializerRegistry, linqProvider);
                foreach (var clause in renderedFilter)
                {
                    AddClause(document, clause);
                }
            }

            if (FilterDefinitionRenderContext.RenderDollarForm)
            {
                if (document.ElementCount > 1 ||
                    document.ElementCount == 1 && document.GetElement(0).Name != "$and")
                {
                    PromoteFilterToDollarForm(document, null);
                }
            }

            return document;
        }

        private static void AddClause(BsonDocument document, BsonElement clause)
        {
            var fieldOrOperatorName = clause.Name;

            if (fieldOrOperatorName == "$and")
            {
                // flatten out nested $and
                foreach (var item in (BsonArray)clause.Value)
                {
                    foreach (var element in (BsonDocument)item)
                    {
                        AddClause(document, element);
                    }
                }
            }
            else if (document.ElementCount == 1 && document.GetElement(0).Name == "$and")
            {
                ((BsonArray)document[0]).Add(new BsonDocument(clause));
            }
            else if (document.Contains(fieldOrOperatorName))
            {
                var existingClause = document.GetElement(fieldOrOperatorName);
                if (IsFieldName(fieldOrOperatorName) &&
                    existingClause.Value is BsonDocument existingClauseValue &&
                    clause.Value is BsonDocument clauseValue)
                {
                    var clauseOperator = clauseValue.ElementCount > 0 ? clauseValue.GetElement(0).Name : null;
                    if (clauseValue.Names.Any(op => existingClauseValue.Contains(op)) ||
                        __operatorsThatCannotBeCombined.Contains(clauseOperator))
                    {
                        PromoteFilterToDollarForm(document, clause);
                    }
                    else
                    {
                        existingClauseValue.AddRange(clauseValue);
                    }
                }
                else
                {
                    PromoteFilterToDollarForm(document, clause);
                }
            }
            else
            {
                document.Add(clause);
            }

            static bool IsFieldName(string fieldOrOperatorName) => !fieldOrOperatorName.StartsWith("$");
        }

        private static void PromoteFilterToDollarForm(BsonDocument document, BsonElement? clause)
        {
            var clauses = new BsonArray();
            foreach (var queryElement in document)
            {
                clauses.Add(new BsonDocument(queryElement));
            }

            if (clause != null)
            {
                clauses.Add(new BsonDocument(clause.Value));
            }

            document.Clear();
            document.Add("$and", clauses);
        }
    }

    internal sealed class ArrayOperatorFilterDefinition<TDocument, TItem> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument> _field;
        private readonly IEnumerable<TItem> _values;

        public ArrayOperatorFilterDefinition(string operatorName, FieldDefinition<TDocument> field, IEnumerable<TItem> values)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _values = values;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            IBsonSerializer itemSerializer;
            if (renderedField.FieldSerializer != null)
            {
                var arraySerializer = renderedField.FieldSerializer as IBsonArraySerializer;
                BsonSerializationInfo itemSerializationInfo;
                if (arraySerializer == null || !arraySerializer.TryGetItemSerializationInfo(out itemSerializationInfo))
                {
                    var message = string.Format("The serializer for field '{0}' must implement IBsonArraySerializer and provide item serialization info.", renderedField.FieldName);
                    throw new InvalidOperationException(message);
                }
                itemSerializer = FieldValueSerializerHelper.GetSerializerForValueType(itemSerializationInfo.Serializer, serializerRegistry, typeof(TItem), linqProvider);
            }
            else
            {
                itemSerializer = serializerRegistry.GetSerializer<TItem>();
            }

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operatorName);
                bsonWriter.WriteStartArray();
                foreach (var value in _values)
                {
                    itemSerializer.Serialize(context, value);
                }
                bsonWriter.WriteEndArray();
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class ElementMatchFilterDefinition<TDocument, TItem> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument> _field;
        private readonly FilterDefinition<TItem> _filter;

        public ElementMatchFilterDefinition(FieldDefinition<TDocument> field, FilterDefinition<TItem> filter)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _filter = filter;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            IBsonSerializer<TItem> itemSerializer;
            if (renderedField.FieldSerializer != null)
            {
                var arraySerializer = renderedField.FieldSerializer as IBsonArraySerializer;
                BsonSerializationInfo itemSerializationInfo;
                if (arraySerializer == null || !arraySerializer.TryGetItemSerializationInfo(out itemSerializationInfo))
                {
                    var message = string.Format("The serializer for field '{0}' must implement IBsonArraySerializer and provide item serialization info.", renderedField.FieldName);
                    throw new InvalidOperationException(message);
                }
                itemSerializer = (IBsonSerializer<TItem>)itemSerializationInfo.Serializer;
            }
            else
            {
                itemSerializer = serializerRegistry.GetSerializer<TItem>();
            }

            var renderedFilter = _filter.Render(itemSerializer, serializerRegistry, linqProvider);

            return new BsonDocument(renderedField.FieldName, new BsonDocument("$elemMatch", renderedFilter));
        }
    }

    internal sealed class ScalarElementMatchFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly FilterDefinition<TDocument> _elementMatchFilter;

        public ScalarElementMatchFilterDefinition(FilterDefinition<TDocument> elementMatchFilter)
        {
            _elementMatchFilter = Ensure.IsNotNull(elementMatchFilter, nameof(elementMatchFilter));
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var document = _elementMatchFilter.Render(documentSerializer, serializerRegistry, linqProvider);

            var elemMatch = (BsonDocument)document[0]["$elemMatch"];
            Compress(elemMatch);

            return document;
        }

        private static void Compress(BsonDocument elemMatch)
        {
            BsonValue condition;
            if (elemMatch.TryGetValue("$and", out condition))
            {
                var array = (BsonArray)condition;
                foreach (BsonDocument singleCondition in array)
                {
                    Compress(singleCondition);
                }
            }
            else if (elemMatch.TryGetValue("", out condition))
            {
                elemMatch.Remove("");

                if (condition is BsonDocument)
                {
                    var nestedDocument = (BsonDocument)condition;
                    foreach (var element in nestedDocument)
                    {
                        elemMatch.Add(element);
                    }
                }
                else if (condition is BsonRegularExpression)
                {
                    elemMatch.Add("$regex", condition);
                }
                else
                {
                    elemMatch.Add("$eq", condition);
                }
            }
        }
    }

    internal sealed class GeometryOperatorFilterDefinition<TDocument, TCoordinates> : FilterDefinition<TDocument>
        where TCoordinates : GeoJsonCoordinates
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument> _field;
        private readonly GeoJsonGeometry<TCoordinates> _geometry;

        public GeometryOperatorFilterDefinition(string operatorName, FieldDefinition<TDocument> field, GeoJsonGeometry<TCoordinates> geometry)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _geometry = Ensure.IsNotNull(geometry, nameof(geometry));
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operatorName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName("$geometry");
                serializerRegistry.GetSerializer<GeoJsonGeometry<TCoordinates>>().Serialize(context, _geometry);
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class NearFilterDefinition<TDocument, TCoordinates> : FilterDefinition<TDocument>
        where TCoordinates : GeoJsonCoordinates
    {
        private readonly FieldDefinition<TDocument> _field;
        private readonly GeoJsonPoint<TCoordinates> _point;
        private readonly double? _maxDistance;
        private readonly double? _minDistance;
        private readonly bool _spherical;

        public NearFilterDefinition(FieldDefinition<TDocument> field, GeoJsonPoint<TCoordinates> point, bool spherical, double? maxDistance = null, double? minDistance = null)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _point = Ensure.IsNotNull(point, nameof(point));
            _spherical = spherical;
            _maxDistance = maxDistance;
            _minDistance = minDistance;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_spherical ? "$nearSphere" : "$near");
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName("$geometry");
                serializerRegistry.GetSerializer<GeoJsonPoint<TCoordinates>>().Serialize(context, _point);
                if (_maxDistance.HasValue)
                {
                    bsonWriter.WriteName("$maxDistance");
                    bsonWriter.WriteDouble(_maxDistance.Value);
                }
                if (_minDistance.HasValue)
                {
                    bsonWriter.WriteName("$minDistance");
                    bsonWriter.WriteDouble(_minDistance.Value);
                }
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class NotFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly FilterDefinition<TDocument> _filter;

        public NotFilterDefinition(FilterDefinition<TDocument> filter)
        {
            _filter = Ensure.IsNotNull(filter, nameof(filter));
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedFilter = _filter.Render(documentSerializer, serializerRegistry, linqProvider);

            if (renderedFilter.ElementCount == 1)
            {
                return NegateSingleElementFilter(renderedFilter, renderedFilter.GetElement(0));
            }

            return NegateArbitraryFilter(renderedFilter);
        }

        private static BsonDocument NegateArbitraryFilter(BsonDocument filter)
        {
            if (filter.ElementCount == 1 && filter.GetElement(0).Name.StartsWith("$", StringComparison.Ordinal))
            {
                return new BsonDocument("$not", filter);
            }
            else
            {
                // $not only works as a meta operator on a single operator so simulate Not using $nor
                return new BsonDocument("$nor", new BsonArray { filter });
            }
        }

        private static BsonDocument NegateSingleElementFilter(BsonDocument filter, BsonElement element)
        {
            if (element.Name[0] == '$')
            {
                return NegateSingleElementTopLevelOperatorFilter(filter, element);
            }

            if (element.Value is BsonDocument)
            {
                var selector = (BsonDocument)element.Value;
                if (selector.ElementCount >= 1)
                {
                    var operatorName = selector.GetElement(0).Name;
                    if (operatorName[0] == '$' && operatorName != "$ref")
                    {
                        if (selector.ElementCount == 1)
                        {
                            return NegateSingleFieldOperatorFilter(element.Name, selector.GetElement(0));
                        }

                        return NegateArbitraryFilter(filter);
                    }
                }
            }

            if (element.Value is BsonRegularExpression)
            {
                return new BsonDocument(element.Name, new BsonDocument("$not", element.Value));
            }

            return new BsonDocument(element.Name, new BsonDocument("$ne", element.Value));
        }

        private static BsonDocument NegateSingleFieldOperatorFilter(string field, BsonElement element)
        {
            switch (element.Name)
            {
                case "$exists":
                    return new BsonDocument(field, new BsonDocument("$exists", !element.Value.ToBoolean()));
                case "$in":
                    return new BsonDocument(field, new BsonDocument("$nin", (BsonArray)element.Value));
                case "$ne":
                case "$not":
                    return new BsonDocument(field, element.Value);
                case "$nin":
                    return new BsonDocument(field, new BsonDocument("$in", (BsonArray)element.Value));
                default:
                    return new BsonDocument(field, new BsonDocument("$not", new BsonDocument(element)));
            }
        }

        private static BsonDocument NegateSingleElementTopLevelOperatorFilter(BsonDocument filter, BsonElement element)
        {
            switch (element.Name)
            {
                case "$and":
                    return new BsonDocument("$nor", new BsonArray { filter });
                case "$or":
                    return new BsonDocument("$nor", element.Value);
                case "$nor":
                    return new BsonDocument("$or", element.Value);
                default:
                    return NegateArbitraryFilter(filter);
            }
        }
    }

    internal sealed class DocumentOfTypeFilterDefinition<TDocument, TDerived> : FilterDefinition<TDocument>
        where TDerived : TDocument
    {
        private readonly FilterDefinition<TDerived> _derivedDocumentFilter;

        public DocumentOfTypeFilterDefinition(FilterDefinition<TDerived> derivedDocumentFilter = null)
        {
            _derivedDocumentFilter = derivedDocumentFilter; // can be null
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var discriminatorConvention = BsonSerializer.LookupDiscriminatorConvention(typeof(TDocument));
            if (discriminatorConvention == null)
            {
                var message = string.Format("OfType requires a discriminator convention for type: {0}.", BsonUtils.GetFriendlyTypeName(typeof(TDocument)));
                throw new NotSupportedException(message);
            }

            var discriminatorValue = discriminatorConvention.GetDiscriminator(typeof(TDocument), typeof(TDerived));
            if (discriminatorValue == null)
            {
                throw new NotSupportedException($"OfType requires that documents of type {BsonUtils.GetFriendlyTypeName(typeof(TDerived))} have a discriminator value.");
            }
            if (discriminatorValue.IsBsonArray)
            {
                discriminatorValue = discriminatorValue.AsBsonArray.Last();
            }
            var renderedOfTypeFilter = new BsonDocument(discriminatorConvention.ElementName, discriminatorValue);

            if (_derivedDocumentFilter == null)
            {
                return renderedOfTypeFilter;
            }

            var derivedDocumentSerializer = serializerRegistry.GetSerializer<TDerived>();
            var renderedDerivedDocumentFilter = _derivedDocumentFilter.Render(derivedDocumentSerializer, serializerRegistry, linqProvider);
            var combinedFilter = Builders<TDerived>.Filter.And(
                new BsonDocumentFilterDefinition<TDerived>(renderedOfTypeFilter),
                new BsonDocumentFilterDefinition<TDerived>(renderedDerivedDocumentFilter));
            return combinedFilter.Render(derivedDocumentSerializer, serializerRegistry, linqProvider);
        }
    }

    internal sealed class FieldOfTypeFilterDefinition<TDocument, TField, TDerived> : FilterDefinition<TDocument>
        where TDerived : TField
    {
        private readonly FilterDefinition<TDerived> _derivedFieldFilter;
        private readonly FieldDefinition<TDocument, TField> _field;

        public FieldOfTypeFilterDefinition(FieldDefinition<TDocument, TField> field, FilterDefinition<TDerived> derivedFieldFilter = null)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _derivedFieldFilter = derivedFieldFilter; // can be null
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var discriminatorConvention = BsonSerializer.LookupDiscriminatorConvention(typeof(TField));
            if (discriminatorConvention == null)
            {
                var message = string.Format("OfType requires a discriminator convention for type: {0}.", BsonUtils.GetFriendlyTypeName(typeof(TField)));
                throw new NotSupportedException(message);
            }

            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var discriminatorElementName = renderedField.FieldName + "." + discriminatorConvention.ElementName;
            var discriminatorValue = discriminatorConvention.GetDiscriminator(typeof(TField), typeof(TDerived));
            var renderedDiscriminatorFilter = new BsonDocument(discriminatorElementName, discriminatorValue);

            if (_derivedFieldFilter == null)
            {
                return renderedDiscriminatorFilter;
            }

            var derivedDocumentSerializer = serializerRegistry.GetSerializer<TDerived>();
            var unprefixedRenderedDerivedFilter = _derivedFieldFilter.Render(derivedDocumentSerializer, serializerRegistry, linqProvider);
            var renderedDerivedFilter = new BsonDocument(
                unprefixedRenderedDerivedFilter.Select(e => new BsonElement(renderedField.FieldName + "." + e.Name, e.Value)));
            var combinedFilter = Builders<TDerived>.Filter.And(
                new BsonDocumentFilterDefinition<TDerived>(renderedDiscriminatorFilter),
                new BsonDocumentFilterDefinition<TDerived>(renderedDerivedFilter));
            return combinedFilter.Render(derivedDocumentSerializer, serializerRegistry, linqProvider);
        }
    }

    internal sealed class OperatorFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument> _field;
        private readonly BsonValue _value;

        public OperatorFilterDefinition(string operatorName, FieldDefinition<TDocument> field, BsonValue value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            return new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, _value));
        }
    }

    internal sealed class OperatorFilterDefinition<TDocument, TField> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, TField> _field;
        private readonly TField _value;
        private readonly bool _allowScalarValueForArrayField;

        public OperatorFilterDefinition(
            string operatorName,
            FieldDefinition<TDocument, TField> field,
            TField value,
            bool allowScalarValueForArrayField = false)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
            _allowScalarValueForArrayField = allowScalarValueForArrayField;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider, _allowScalarValueForArrayField);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operatorName);
                renderedField.ValueSerializer.Serialize(context, _value);
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class OrFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly List<FilterDefinition<TDocument>> _filters;

        public OrFilterDefinition(IEnumerable<FilterDefinition<TDocument>> filters)
        {
            _filters = Ensure.IsNotNull(filters, nameof(filters)).ToList();
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var clauses = new BsonArray();

            foreach (var filter in _filters)
            {
                var renderedFilter = filter.Render(documentSerializer, serializerRegistry, linqProvider);
                AddClause(clauses, renderedFilter);
            }

            return new BsonDocument("$or", clauses);
        }

        private static void AddClause(BsonArray clauses, BsonDocument filter)
        {
            if (filter.ElementCount == 1 && filter.GetElement(0).Name == "$or")
            {
                // flatten nested $or
                clauses.AddRange((BsonArray)filter[0]);
            }
            else
            {
                // we could shortcut the user's query if there are no elements in the filter, but
                // I'd rather be literal and let them discover the problem on their own.
                clauses.Add(filter);
            }
        }
    }

    internal sealed class SimpleFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument> _field;
        private readonly BsonValue _value;

        public SimpleFilterDefinition(FieldDefinition<TDocument> field, BsonValue value)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            return new BsonDocument(renderedField.FieldName, _value);
        }
    }

    internal sealed class SimpleFilterDefinition<TDocument, TField> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument, TField> _field;
        private readonly TField _value;
        private readonly bool _allowScalarValueForArrayField;

        public SimpleFilterDefinition(
            FieldDefinition<TDocument, TField> field,
            TField value,
            bool allowScalarValueForArrayField = false)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
            _allowScalarValueForArrayField = allowScalarValueForArrayField;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider, _allowScalarValueForArrayField);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);

                if (FilterDefinitionRenderContext.RenderDollarForm)
                {
                    bsonWriter.WriteStartDocument();
                    bsonWriter.WriteName("$eq");
                    renderedField.ValueSerializer.Serialize(context, _value);
                    bsonWriter.WriteEndDocument();
                }
                else
                {
                    renderedField.ValueSerializer.Serialize(context, _value);
                }

                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class SingleItemAsArrayOperatorFilterDefinition<TDocument, TField> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, TField> _field;
        private readonly IEnumerable<TField> _values;
        private readonly bool _allowScalarValueForArrayField;

        public SingleItemAsArrayOperatorFilterDefinition(
            string operatorName,
            FieldDefinition<TDocument, TField> field,
            IEnumerable<TField> values,
            bool allowScalarValueForArrayField = false)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _values = Ensure.IsNotNull(values, nameof(values));
            _allowScalarValueForArrayField = allowScalarValueForArrayField;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider, _allowScalarValueForArrayField);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operatorName);
                bsonWriter.WriteStartArray();
                foreach (var value in _values)
                {
                    renderedField.ValueSerializer.Serialize(context, value);
                }
                bsonWriter.WriteEndArray();
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class ArrayAsSingleItemOperatorFilterDefinition<TDocument, TItem> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument> _field;
        private readonly TItem _value;

        public ArrayAsSingleItemOperatorFilterDefinition(string operatorName, FieldDefinition<TDocument> field, TItem value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            IBsonSerializer itemSerializer;
            if (renderedField.FieldSerializer != null)
            {
                var arraySerializer = renderedField.FieldSerializer as IBsonArraySerializer;
                BsonSerializationInfo itemSerializationInfo;
                if (arraySerializer == null || !arraySerializer.TryGetItemSerializationInfo(out itemSerializationInfo))
                {
                    var message = string.Format("The serializer for field '{0}' must implement IBsonArraySerializer and provide item serialization info.", renderedField.FieldName);
                    throw new InvalidOperationException(message);
                }
                itemSerializer = FieldValueSerializerHelper.GetSerializerForValueType(itemSerializationInfo.Serializer, serializerRegistry, typeof(TItem), linqProvider);
            }
            else
            {
                itemSerializer = serializerRegistry.GetSerializer<TItem>();
            }

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operatorName);
                itemSerializer.Serialize(context, _value);
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class ArrayAsSingleItemSimpleFilterDefinition<TDocument, TItem> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument> _field;
        private readonly TItem _value;

        public ArrayAsSingleItemSimpleFilterDefinition(FieldDefinition<TDocument> field, TItem value)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            IBsonSerializer<TItem> itemSerializer;
            if (renderedField.FieldSerializer != null)
            {
                var arraySerializer = renderedField.FieldSerializer as IBsonArraySerializer;
                BsonSerializationInfo itemSerializationInfo;
                if (arraySerializer == null || !arraySerializer.TryGetItemSerializationInfo(out itemSerializationInfo))
                {
                    var message = string.Format("The serializer for field '{0}' must implement IBsonArraySerializer and provide item serialization info.", renderedField.FieldName);
                    throw new InvalidOperationException(message);
                }
                itemSerializer = (IBsonSerializer<TItem>)FieldValueSerializerHelper.GetSerializerForValueType(itemSerializationInfo.Serializer, serializerRegistry, typeof(TItem), linqProvider);
            }
            else
            {
                itemSerializer = serializerRegistry.GetSerializer<TItem>();
            }

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                itemSerializer.Serialize(context, _value);
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class ArrayIndexExistsFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument> _field;
        private readonly int _index;
        private readonly bool _exists;

        public ArrayIndexExistsFilterDefinition(FieldDefinition<TDocument> field, int index, bool exists)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _index = index;
            _exists = exists;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var fieldName = renderedField.FieldName + "." + _index;
            return new BsonDocument(fieldName, new BsonDocument("$exists", _exists));
        }
    }

    internal abstract class StringInOrNinFilterDefinition<TDocument, TField> : FilterDefinition<TDocument>
    {
        private readonly FieldDefinition<TDocument, TField> _field;
        private readonly string _operator;
        private readonly IEnumerable<StringOrRegularExpression> _values;

        public StringInOrNinFilterDefinition(
            FieldDefinition<TDocument, TField> field,
            string @operator,
            IEnumerable<StringOrRegularExpression> values)
        {
            _field = Ensure.IsNotNull(field, nameof(field));
            _operator = Ensure.IsNotNull(@operator, nameof(@operator));
            _values = Ensure.IsNotNull(values, nameof(values));

            if (@operator != "$in" && @operator != "$nin")
            {
                throw new ArgumentException($"Invalid operator: {@operator}.");
            }
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);

            var document = new BsonDocument();
            using (var bsonWriter = new BsonDocumentWriter(document))
            {
                var context = BsonSerializationContext.CreateRoot(bsonWriter);
                var stringSerializer = BsonStringSerializer.Instance;
                var regularExpressionSerializer = BsonRegularExpressionSerializer.Instance;

                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(renderedField.FieldName);
                bsonWriter.WriteStartDocument();
                bsonWriter.WriteName(_operator);
                bsonWriter.WriteStartArray();
                foreach (var value in _values)
                {
                    if (value?.Type == typeof(BsonRegularExpression))
                    {
                        regularExpressionSerializer.Serialize(context, value.RegularExpression);
                    }
                    else
                    {
                        stringSerializer.Serialize(context, value?.String);
                    }
                }
                bsonWriter.WriteEndArray();
                bsonWriter.WriteEndDocument();
                bsonWriter.WriteEndDocument();
            }

            return document;
        }
    }

    internal sealed class StringArrayFieldInOrNinFilterDefinition<TDocument> : StringInOrNinFilterDefinition<TDocument, IEnumerable<string>>
    {
        public StringArrayFieldInOrNinFilterDefinition(
            FieldDefinition<TDocument, IEnumerable<string>> field,
            string @operator,
            IEnumerable<StringOrRegularExpression> values)
            : base(field, @operator, values)
        {
        }
    }

    internal sealed class StringFieldInOrNinFilterDefinition<TDocument> : StringInOrNinFilterDefinition<TDocument, string>
    {
        public StringFieldInOrNinFilterDefinition(
            FieldDefinition<TDocument, string> field,
            string @operator,
            IEnumerable<StringOrRegularExpression> values)
            : base(field, @operator, values)
        {
        }
    }

    internal sealed class UInt32GreaterThanFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, uint> _field;
        private readonly uint _value;

        public UInt32GreaterThanFilterDefinition(string operatorName, FieldDefinition<TDocument, uint> field, uint value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var serializedValue = renderedField.ValueSerializer.ToBsonValue(_value);

            if (serializedValue.BsonType != BsonType.Int32)
            {
                return new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue));
            }

            if (serializedValue.AsInt32 >= 0)
            {
                return new BsonDocument
                {
                    { "$or",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$lt", 0))
                        }
                    }
                };
            }
            else
            {
                return new BsonDocument
                {
                    { "$and",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$lt", 0))
                        }
                    }
                };
            }
        }
    }

    internal sealed class UInt32LessThanFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, uint> _field;
        private readonly uint _value;

        public UInt32LessThanFilterDefinition(string operatorName, FieldDefinition<TDocument, uint> field, uint value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var serializedValue = renderedField.ValueSerializer.ToBsonValue(_value);

            if (serializedValue.BsonType != BsonType.Int32)
            {
                return new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue));
            }

            if (serializedValue.AsInt32 >= 0)
            {
                return new BsonDocument
                {
                    { "$and",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$gte", 0)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue))
                        }
                    }
                };
            }
            else
            {
                return new BsonDocument
                {
                    { "$or",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$gte", 0)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue))
                        }
                    }
                };
            }
        }
    }

    internal sealed class UInt64GreaterThanFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, ulong> _field;
        private readonly ulong _value;

        public UInt64GreaterThanFilterDefinition(string operatorName, FieldDefinition<TDocument, ulong> field, ulong value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var serializedValue = renderedField.ValueSerializer.ToBsonValue(_value);

            if (serializedValue.BsonType != BsonType.Int64)
            {
                return new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue));
            }

            if (serializedValue.AsInt64 >= 0)
            {
                return new BsonDocument
                {
                    { "$or",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$lt", 0))
                        }
                    }
                };
            }
            else
            {
                return new BsonDocument
                {
                    { "$and",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$lt", 0))
                        }
                    }
                };
            }
        }
    }

    internal sealed class UInt64LessThanFilterDefinition<TDocument> : FilterDefinition<TDocument>
    {
        private readonly string _operatorName;
        private readonly FieldDefinition<TDocument, ulong> _field;
        private readonly ulong _value;

        public UInt64LessThanFilterDefinition(string operatorName, FieldDefinition<TDocument, ulong> field, ulong value)
        {
            _operatorName = Ensure.IsNotNull(operatorName, nameof(operatorName));
            _field = Ensure.IsNotNull(field, nameof(field));
            _value = value;
        }

        public override BsonDocument Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry, LinqProvider linqProvider)
        {
            var renderedField = _field.Render(documentSerializer, serializerRegistry, linqProvider);
            var serializedValue = renderedField.ValueSerializer.ToBsonValue(_value);

            if (serializedValue.BsonType != BsonType.Int64)
            {
                return new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue));
            }

            if (serializedValue.AsInt64 >= 0)
            {
                return new BsonDocument
                {
                    { "$and",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$gte", 0)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue))
                        }
                    }
                };
            }
            else
            {
                return new BsonDocument
                {
                    { "$or",
                        new BsonArray
                        {
                            new BsonDocument(renderedField.FieldName, new BsonDocument("$gte", 0)),
                            new BsonDocument(renderedField.FieldName, new BsonDocument(_operatorName, serializedValue))
                        }
                    }
                };
            }
        }
    }
}