Deprecate connection pool wait queue-related classes and properties.

The connection pooling specification calls for removal of limits
on the wait queue size, and does not define wait queue-related events,
so we plan to remove events and settings related to the connection pool
wait queue in the next major release.

JAVA-3460

Author: jyemin

driver-core/src/main/com/mongodb/MongoWaitQueueFullException.java

@@ -21,7 +21,9 @@
  *
  * @see com.mongodb.connection.ConnectionPoolSettings#getMaxWaitQueueSize()
  * @since 3.0
+ * @deprecated In the next major release the limit on wait queue size will be removed, so this exception will no longer be thrown
  */
+@Deprecated
 public class MongoWaitQueueFullException extends MongoClientException {
 
     private static final long serialVersionUID = 1482094507852255793L;

driver-core/src/main/com/mongodb/connection/ClusterSettings.java

@@ -261,7 +261,9 @@ public Builder serverSelectionTimeout(final long serverSelectionTimeout, final T
          *
          * @param maxWaitQueueSize the number of threads that are allowed to be waiting for a connection.
          * @return this
+         * @deprecated in the next major release, wait queue size limitations will be removed
          */
+        @Deprecated
         public Builder maxWaitQueueSize(final int maxWaitQueueSize) {
             this.maxWaitQueueSize = maxWaitQueueSize;
             return this;
@@ -476,7 +478,9 @@ public long getLocalThreshold(final TimeUnit timeUnit) {
      * <p>Default is 500.</p>
      *
      * @return the number of threads that are allowed to be waiting for a connection.
+     * @deprecated in the next major release, wait queue size limitations will be removed
      */
+    @Deprecated
     public int getMaxWaitQueueSize() {
         return maxWaitQueueSize;
     }

driver-core/src/main/com/mongodb/connection/ConnectionPoolSettings.java

@@ -145,7 +145,9 @@ public Builder minSize(final int minSize) {
          *
          * @param maxWaitQueueSize the number of threads that are allowed to be waiting for a connection.
          * @return this
+         * @deprecated in the next major release, wait queue size limitations will be removed
          */
+        @Deprecated
         public Builder maxWaitQueueSize(final int maxWaitQueueSize) {
             this.maxWaitQueueSize = maxWaitQueueSize;
             return this;
@@ -308,7 +310,9 @@ public int getMinSize() {
      * <p>Default is 500.</p>
      *
      * @return the number of threads that are allowed to be waiting for a connection.
+     * @deprecated in the next major release, wait queue size limitations will be removed
      */
+    @Deprecated
     public int getMaxWaitQueueSize() {
         return maxWaitQueueSize;
     }

driver-core/src/main/com/mongodb/event/ConnectionPoolListener.java

@@ -56,14 +56,18 @@ public interface ConnectionPoolListener extends EventListener {
      * Invoked when a connection pool's wait queue is entered.
      *
      * @param event the event
+     * @deprecated In the next major release, this event will no longer be published
      */
+    @Deprecated
     void waitQueueEntered(ConnectionPoolWaitQueueEnteredEvent event);
 
     /**
      * Invoked when a connection pools wait queue is exited.
      *
      * @param event the event
+     * @deprecated In the next major release, this event will no longer be published
      */
+    @Deprecated
     void waitQueueExited(ConnectionPoolWaitQueueExitedEvent event);
 
     /**

driver-core/src/main/com/mongodb/event/ConnectionPoolWaitQueueEnteredEvent.java

@@ -22,7 +22,9 @@
  * An event for entering the wait queue of the connection pool.
  *
  * @since 3.5
+ * @deprecated In the next major release, this event will no longer be published
  */
+@Deprecated
 public final class ConnectionPoolWaitQueueEnteredEvent {
     private final ServerId serverId;
 

driver-core/src/main/com/mongodb/event/ConnectionPoolWaitQueueExitedEvent.java

@@ -22,7 +22,9 @@
  * An event for entering the wait queue of the connection pool.
  *
  * @since 3.5
+ * @deprecated In the next major release, this event will no longer be published
  */
+@Deprecated
 public final class ConnectionPoolWaitQueueExitedEvent {
     private final ServerId serverId;
 

driver-core/src/main/com/mongodb/management/ConnectionPoolStatisticsMBean.java

@@ -71,6 +71,8 @@ public interface ConnectionPoolStatisticsMBean {
      * Gets the size of the wait queue for a connection from this pool. *
      *
      * @return size of the wait queue
+     * @deprecated In the next major release, wait queue events will no longer be published so this statistic will be unavailable
      */
+    @Deprecated
     int getWaitQueueSize();
 }