JAVA-2336: Deprecate usePowerOf2Sizes in CreateCollectionOptions and suppress any warnings of usage of CreateCollectionOperation.usePowerOf2Sizes

Author: jyemin

driver-async/src/main/com/mongodb/async/client/MongoDatabaseImpl.java

@@ -173,6 +173,7 @@ public void createCollection(final String collectionName, final SingleResultCall
     }
 
     @Override
+    @SuppressWarnings("deprecation")
     public void createCollection(final String collectionName, final CreateCollectionOptions createCollectionOptions,
                                  final SingleResultCallback<Void> callback) {
         CreateCollectionOperation operation = new CreateCollectionOperation(name, collectionName, writeConcern)

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

@@ -124,7 +124,9 @@ public CreateCollectionOptions sizeInBytes(final long sizeInBytes) {
      * @return true if the usePowerOf2Sizes allocation strategy is turned on for this collection
      * @mongodb.driver.manual reference/command/collMod/#usePowerOf2Sizes usePowerOf2Sizes
      * @mongodb.server.release 2.6
+     * @deprecated As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
      */
+    @Deprecated
     public Boolean isUsePowerOf2Sizes() {
         return usePowerOf2Sizes;
     }
@@ -136,7 +138,9 @@ public Boolean isUsePowerOf2Sizes() {
      * @return this
      * @mongodb.driver.manual reference/command/collMod/#usePowerOf2Sizes usePowerOf2Sizes
      * @mongodb.server.release 2.6
+     * @deprecated As of MongoDB 3.0, power of 2 sizes is ignored by the MongoDB server
      */
+    @Deprecated
     public CreateCollectionOptions usePowerOf2Sizes(final Boolean usePowerOf2Sizes) {
         this.usePowerOf2Sizes = usePowerOf2Sizes;
         return this;

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

@@ -108,8 +108,7 @@ public void create(final String collectionName, final CreateCollectionOptions op
                 .capped(options.isCapped())
                 .sizeInBytes(options.getSizeInBytes())
                 .autoIndex(options.isAutoIndex())
-                .maxDocuments(options.getMaxDocuments())
-                .usePowerOf2Sizes(options.isUsePowerOf2Sizes());
+                .maxDocuments(options.getMaxDocuments());
 
         IndexOptionDefaults indexOptionDefaults = options.getIndexOptionDefaults();
         if (indexOptionDefaults.getStorageEngine() != null) {

driver/src/main/com/mongodb/DB.java

@@ -347,6 +347,7 @@ public DBCollection createView(final String viewName, final String viewOn, final
     }
 
 
+    @SuppressWarnings("deprecation")
     private CreateCollectionOperation getCreateCollectionOperation(final String collectionName, final DBObject options) {
         if (options.get("size") != null && !(options.get("size") instanceof Number)) {
             throw new IllegalArgumentException("'size' should be Number");

driver/src/main/com/mongodb/MongoDatabaseImpl.java

@@ -168,6 +168,7 @@ public void createCollection(final String collectionName) {
     }
 
     @Override
+    @SuppressWarnings("deprecation")
     public void createCollection(final String collectionName, final CreateCollectionOptions createCollectionOptions) {
         CreateCollectionOperation operation = new CreateCollectionOperation(name, collectionName, writeConcern)
                 .collation(createCollectionOptions.getCollation())