Package com.mongodb.connection

Class ClusterSettings

java.lang.Object
com.mongodb.connection.ClusterSettings
@Immutable @Deprecated(since="2021-05-27") public final class ClusterSettings extends Object
Deprecated.
Usage of this API is not supported in AEM as a Cloud Service.
Settings for the cluster.
Since:
3.0

  • Method Details

    • builder

      public static ClusterSettings.Builder builder()
      Deprecated.
      Get a builder for this class.
      Returns:
      a new Builder for creating ClusterSettings.

    • builder

      public static ClusterSettings.Builder builder(ClusterSettings clusterSettings)
      Deprecated.
      Creates a builder instance.
      Parameters:
      clusterSettings - existing ClusterSettings to default the builder settings on.
      Returns:
      a builder
      Since:
      3.5

    • getDescription

      @Deprecated public String getDescription()
      Deprecated.
      Prefer MongoClientSettings.getApplicationName()
      Gets the user defined description of the MongoClient.
      Returns:
      the user defined description of the MongoClient

    • getSrvHost

      public String getSrvHost()
      Deprecated.
      Gets the host name from which to lookup SRV record for the seed list
      Returns:
      the SRV host, or null if none specified
      Since:
      3.10

    • getHosts

      public List<ServerAddress> getHosts()
      Deprecated.
      Gets the seed list of hosts for the cluster.
      Returns:
      the seed list of hosts

    • getMode

      public ClusterConnectionMode getMode()
      Deprecated.
      Gets the mode.
      Returns:
      the mode

    • getRequiredClusterType

      public ClusterType getRequiredClusterType()
      Deprecated.
      Gets the required cluster type
      Returns:
      the required cluster type

    • getRequiredReplicaSetName

      public String getRequiredReplicaSetName()
      Deprecated.
      Gets the required replica set name.
      Returns:
      the required replica set name

    • getServerSelector

      public ServerSelector getServerSelector()
      Deprecated.
      Gets the server selector.

      The server selector augments the normal server selection rules applied by the driver when determining which server to send an operation to. At the point that it's called by the driver, the ClusterDescription which is passed to it contains a list of ServerDescription instances which satisfy either the configured ReadPreference for any read operation or ones that can take writes (e.g. a standalone, mongos, or replica set primary).

      The server selector can then filter the ServerDescription list using whatever criteria that is required by the application.

      After this selector executes, two additional selectors are applied by the driver:

      • select from within the latency window
      • select a random server from those remaining

      To skip the latency window selector, an application can:

      • configure the local threshold to a sufficiently high value so that it doesn't exclude any servers
      • return a list containing a single server from this selector (which will also make the random member selector a no-op)
      Returns:
      the server selector, which may be null
      See Also:

    • getServerSelectionTimeout

      public long getServerSelectionTimeout(TimeUnit timeUnit)
      Deprecated.
      Gets the timeout to apply when selecting a server. If the timeout expires before a server is found to handle a request, a MongoTimeoutException will be thrown. The default value is 30 seconds.

      A value of 0 means that it will timeout immediately if no server is available. A negative value means to wait indefinitely.

      Parameters:
      timeUnit - the time unit
      Returns:
      the timeout in the given time unit

    • getLocalThreshold

      public long getLocalThreshold(TimeUnit timeUnit)
      Deprecated.
      Gets the local threshold. When choosing among multiple MongoDB servers to send a request, the MongoClient will only send that request to a server whose ping time is less than or equal to the server with the fastest ping time plus the local threshold.

      For example, let's say that the client is choosing a server to send a query when the read preference is ReadPreference.secondary(), and that there are three secondaries, server1, server2, and server3, whose ping times are 10, 15, and 16 milliseconds, respectively. With a local threshold of 5 milliseconds, the client will send the query to either server1 or server2 (randomly selecting between the two).

      Default is 15 milliseconds.

      Parameters:
      timeUnit - the time unit
      Returns:
      the local threshold in the given timeunit.
      Since:
      3.7

    • getMaxWaitQueueSize

      @Deprecated public int getMaxWaitQueueSize()
      Deprecated.
      in the next major release, wait queue size limitations will be removed

      This is the maximum number of threads that may be waiting for a connection to become available from the pool. All further threads will get an exception immediately.

      Default is 500.

      Returns:
      the number of threads that are allowed to be waiting for a connection.

    • getClusterListeners

      public List<ClusterListener> getClusterListeners()
      Deprecated.
      Gets the cluster listeners. The default value is an empty list.
      Returns:
      the cluster listeners
      Since:
      3.3

    • equals

      public boolean equals(Object o)
      Deprecated.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Deprecated.
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Deprecated.
      Overrides:
      toString in class Object

    • getShortDescription

      public String getShortDescription()
      Deprecated.
      Returns a short, pretty description for these ClusterSettings.
      Returns:
      a String description of the relevant settings.