JAVA-2685: Deprecate CreateCollectionOptions autoIndex property

This property was deprecated in MongoDB 3.2 and removed in MongoDB 4.0.

Along with deprecating the property, ensure that the field is only
included in the "create" command if the property has explicitly been
set to false.  Otherwise, a 4.0 server will reject the command.

Author: jyemin

driver-core/src/main/com/mongodb/client/model/CreateCollectionOptions.java

@@ -42,7 +42,9 @@ public class CreateCollectionOptions {
      * Gets if auto-index is enabled
      *
      * @return true if auto-index is enabled
+     * @deprecated this option was deprecated in MongoDB 3.2 and removed in MongodB 4.0
      */
+    @Deprecated
     public boolean isAutoIndex() {
         return autoIndex;
     }
@@ -52,7 +54,9 @@ public boolean isAutoIndex() {
      *
      * @param autoIndex true if auto-index is enabled
      * @return this
+     * @deprecated this option was deprecated in MongoDB 3.2 and removed in MongodB 4.0
      */
+    @Deprecated
     public CreateCollectionOptions autoIndex(final boolean autoIndex) {
         this.autoIndex = autoIndex;
         return this;

driver-core/src/main/com/mongodb/operation/CreateCollectionOperation.java

@@ -36,6 +36,7 @@
 import static com.mongodb.internal.async.ErrorHandlingResultCallback.errorHandlingCallback;
 import static com.mongodb.operation.CommandOperationHelper.executeWrappedCommandProtocol;
 import static com.mongodb.operation.CommandOperationHelper.executeWrappedCommandProtocolAsync;
+import static com.mongodb.operation.DocumentHelper.putIfFalse;
 import static com.mongodb.operation.DocumentHelper.putIfNotZero;
 import static com.mongodb.operation.OperationHelper.LOGGER;
 import static com.mongodb.operation.OperationHelper.releasingCallback;
@@ -412,7 +413,7 @@ public void call(final AsyncConnection connection, final Throwable t) {
 
     private BsonDocument getCommand(final ConnectionDescription description) {
         BsonDocument document = new BsonDocument("create", new BsonString(collectionName));
-        document.put("autoIndexId", BsonBoolean.valueOf(autoIndex));
+        putIfFalse(document, "autoIndexId", autoIndex);
         document.put("capped", BsonBoolean.valueOf(capped));
         if (capped) {
             putIfNotZero(document, "size", sizeInBytes);

driver-core/src/main/com/mongodb/operation/DocumentHelper.java

@@ -33,6 +33,12 @@ static void putIfTrue(final BsonDocument command, final String key, final boolea
         }
     }
 
+    static void putIfFalse(final BsonDocument command, final String key, final boolean condition) {
+        if (!condition) {
+            command.put(key, BsonBoolean.FALSE);
+        }
+    }
+
     static void putIfNotNullOrEmpty(final BsonDocument command, final String key, final BsonDocument documentValue) {
         if (documentValue != null && !documentValue.isEmpty()) {
             command.put(key, documentValue);

driver-core/src/test/functional/com/mongodb/client/test/CollectionHelper.java

@@ -127,6 +127,7 @@ public void create(final String collectionName, final CreateCollectionOptions op
         create(collectionName, options, WriteConcern.ACKNOWLEDGED);
     }
 
+    @SuppressWarnings("deprecation")
     public void create(final String collectionName, final CreateCollectionOptions options, final WriteConcern writeConcern) {
         drop(namespace, writeConcern);
         CreateCollectionOperation operation = new CreateCollectionOperation(namespace.getDatabaseName(), collectionName, writeConcern)

driver-core/src/test/functional/com/mongodb/operation/CreateCollectionOperationSpecification.groovy

@@ -146,7 +146,6 @@ class CreateCollectionOperationSpecification extends OperationFunctionalSpecific
         assert !collectionNameExists(getCollectionName())
         def operation = new CreateCollectionOperation(getDatabaseName(), getCollectionName())
                 .capped(true)
-                .autoIndex(false)
                 .maxDocuments(100)
                 .sizeInBytes(40 * 1024)
 
@@ -172,6 +171,7 @@ class CreateCollectionOperationSpecification extends OperationFunctionalSpecific
         async << [true, false]
     }
 
+    @IgnoreIf({ serverVersionAtLeast(3, 7) })
     def 'should create collection in respect to the autoIndex option'() {
         given:
         assert !collectionNameExists(getCollectionName())