Deprecate API elements in driver-core module

Deprecate API element in driver-core module that are not exposed via
the high-level driver APIS (driver-sync, driver-sync, driver-legacy).
The driver-core module is a useful abstraction on which to build these
high-level drivers, but as a public API it has not seen the sort of
adoption that we initially expected.  Formally deprecating it and using
it just as an internal abstraction will allow us to more rapidly evolve
its API without concern for backwards compatibility that doesn't
actually help external users.

JAVA-3007

Author: jyemin

build.gradle

@@ -75,7 +75,7 @@ configure(subprojects.findAll { it.name != 'util' }) {
         options.encoding = 'ISO-8859-1'
         options.fork = true
         options.debug = true
-        options.compilerArgs = ['-Xlint:all', '-Xlint:-options']
+        options.compilerArgs = ['-Xlint:all', '-Xlint:-options', '-Xlint:-deprecation']
 
         onlyIf { JavaVersion.current().isJava7Compatible() }
     }

driver-core/src/main/com/mongodb/binding/AsyncClusterBinding.java

@@ -37,6 +37,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public class AsyncClusterBinding extends AbstractReferenceCounted implements AsyncReadWriteBinding {
     private final Cluster cluster;
     private final ReadPreference readPreference;

driver-core/src/main/com/mongodb/binding/AsyncConnectionSource.java

@@ -26,6 +26,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface AsyncConnectionSource extends ReferenceCounted {
 
     /**

driver-core/src/main/com/mongodb/binding/AsyncReadBinding.java

@@ -25,6 +25,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface AsyncReadBinding extends ReferenceCounted {
     /**
      * The read preference that all connection sources returned by this instance will satisfy.

driver-core/src/main/com/mongodb/binding/AsyncReadWriteBinding.java

@@ -22,6 +22,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface AsyncReadWriteBinding extends AsyncReadBinding, AsyncWriteBinding, ReferenceCounted {
     @Override
     AsyncReadWriteBinding retain();

driver-core/src/main/com/mongodb/binding/AsyncSingleConnectionReadBinding.java

@@ -30,6 +30,7 @@
  *
  * @since 3.2
  */
+@Deprecated
 public class AsyncSingleConnectionReadBinding extends AbstractReferenceCounted implements AsyncReadBinding {
     private final ReadPreference readPreference;
     private final ServerDescription serverDescription;

driver-core/src/main/com/mongodb/binding/AsyncWriteBinding.java

@@ -24,6 +24,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface AsyncWriteBinding extends ReferenceCounted {
 
     /**

driver-core/src/main/com/mongodb/binding/ClusterBinding.java

@@ -36,6 +36,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public class ClusterBinding extends AbstractReferenceCounted implements ReadWriteBinding {
     private final Cluster cluster;
     private final ReadPreference readPreference;

driver-core/src/main/com/mongodb/binding/ConnectionSource.java

@@ -25,6 +25,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface ConnectionSource extends ReferenceCounted {
 
     /**

driver-core/src/main/com/mongodb/binding/ReadBinding.java

@@ -24,6 +24,7 @@
  *
  * @since 3.0
  */
+@Deprecated
 public interface ReadBinding extends ReferenceCounted {
     /**
      * The read preference that all connection sources returned by this instance will satisfy.