Package com.mongodb.connection

Class ClusterDescription

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

  • Constructor Details

    • ClusterDescription

      public ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, List<ServerDescription> serverDescriptions)
      Deprecated.
      Creates a new ClusterDescription.
      Parameters:
      connectionMode - whether to connect directly to a single server or to multiple servers
      type - what sort of cluster this is
      serverDescriptions - the descriptions of all the servers currently in this cluster

    • ClusterDescription

      public ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, List<ServerDescription> serverDescriptions, ClusterSettings clusterSettings, ServerSettings serverSettings)
      Deprecated.
      Creates a new ClusterDescription.
      Parameters:
      connectionMode - whether to connect directly to a single server or to multiple servers
      type - what sort of cluster this is
      serverDescriptions - the descriptions of all the servers currently in this cluster
      clusterSettings - the cluster settings
      serverSettings - the server settings
      Since:
      3.4

    • ClusterDescription

      public ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, MongoException srvResolutionException, List<ServerDescription> serverDescriptions, ClusterSettings clusterSettings, ServerSettings serverSettings)
      Deprecated.
      Creates a new ClusterDescription.
      Parameters:
      connectionMode - whether to connect directly to a single server or to multiple servers
      type - what sort of cluster this is
      srvResolutionException - an exception resolving the SRV record
      serverDescriptions - the descriptions of all the servers currently in this cluster
      clusterSettings - the cluster settings
      serverSettings - the server settings
      Since:
      3.10

  • Method Details

    • getClusterSettings

      public ClusterSettings getClusterSettings()
      Deprecated.
      Gets the cluster settings, which may be null if not provided.
      Returns:
      the cluster settings
      Since:
      3.4

    • getServerSettings

      public ServerSettings getServerSettings()
      Deprecated.
      Gets the server settings, which may be null if not provided.
      Returns:
      the server settings
      Since:
      3.4

    • isCompatibleWithDriver

      public boolean isCompatibleWithDriver()
      Deprecated.
      Return whether all servers in the cluster are compatible with the driver.
      Returns:
      true if all servers in the cluster are compatible with the driver

    • findServerIncompatiblyOlderThanDriver

      public ServerDescription findServerIncompatiblyOlderThanDriver()
      Deprecated.
      Return a server in the cluster that is incompatibly older than the driver.
      Returns:
      a server in the cluster that is incompatibly older than the driver, or null if there are none
      Since:
      3.6

    • findServerIncompatiblyNewerThanDriver

      public ServerDescription findServerIncompatiblyNewerThanDriver()
      Deprecated.
      Return a server in the cluster that is incompatibly newer than the driver.
      Returns:
      a server in the cluster that is incompatibly newer than the driver, or null if there are none
      Since:
      3.6

    • hasReadableServer

      public boolean hasReadableServer(ReadPreference readPreference)
      Deprecated.
      Returns true if this cluster has at least one server that satisfies the given read preference.
      Parameters:
      readPreference - the non-null read preference
      Returns:
      whether this cluster has at least one server that satisfies the given read preference
      Since:
      3.3

    • hasWritableServer

      public boolean hasWritableServer()
      Deprecated.
      Returns true if this cluster has at least one server that can be used for write operations.
      Returns:
      true if this cluster has at least one server that can be used for write operations
      Since:
      3.3

    • getConnectionMode

      public ClusterConnectionMode getConnectionMode()
      Deprecated.
      Gets whether this cluster is connecting to a single server or multiple servers.
      Returns:
      the ClusterConnectionMode for this cluster

    • getType

      public ClusterType getType()
      Deprecated.
      Gets the specific type of this cluster
      Returns:
      a ClusterType enum representing the type of this cluster

    • getSrvResolutionException

      public MongoException getSrvResolutionException()
      Deprecated.
      Gets any exception encountered while resolving the SRV record for the initial host.
      Returns:
      any exception encountered while resolving the SRV record for the initial host, or null if none
      Since:
      3.10

    • getServerDescriptions

      public List<ServerDescription> getServerDescriptions()
      Deprecated.
      Returns an unmodifiable list of the server descriptions in this cluster description.
      Returns:
      an unmodifiable list of the server descriptions in this cluster description
      Since:
      3.3

    • getLogicalSessionTimeoutMinutes

      public Integer getLogicalSessionTimeoutMinutes()
      Deprecated.
      Gets the logical session timeout in minutes, or null if at least one of the known servers does not support logical sessions.
      Returns:
      the logical session timeout in minutes, which may be null
      Since:
      3.6

    • getAll

      @Deprecated public Set<ServerDescription> getAll()
      Deprecated.
      Use getServerDescriptions() instead
      Returns the Set of all server descriptions in this cluster, sorted by the String value of the ServerAddress of each one.
      Returns:
      the set of server descriptions

    • getByServerAddress

      @Deprecated public ServerDescription getByServerAddress(ServerAddress serverAddress)
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Returns the ServerDescription for the server at the given address
      Parameters:
      serverAddress - the ServerAddress for a server in this cluster
      Returns:
      the ServerDescription for this server

    • getPrimaries

      @Deprecated public List<ServerDescription> getPrimaries()
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      While it may seem counter-intuitive that a MongoDB cluster can have more than one primary, it can in the case where the client's view of the cluster is a set of mongos servers, any of which can serve as the primary.
      Returns:
      a list of servers that can act as primaries

    • getSecondaries

      @Deprecated public List<ServerDescription> getSecondaries()
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Get a list of all the secondaries in this cluster
      Returns:
      a List of ServerDescriptions of all the secondaries this cluster is currently aware of

    • getSecondaries

      @Deprecated public List<ServerDescription> getSecondaries(TagSet tagSet)
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Get a list of all the secondaries in this cluster that match a given TagSet
      Parameters:
      tagSet - a Set of replica set tags
      Returns:
      a List of ServerDescriptions of all the secondaries this cluster that match all of the given tags

    • getAny

      @Deprecated public List<ServerDescription> getAny()
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Gets a list of ServerDescriptions for all the servers in this cluster which are currently accessible.
      Returns:
      a List of ServerDescriptions for all servers that have a status of OK

    • getAnyPrimaryOrSecondary

      @Deprecated public List<ServerDescription> getAnyPrimaryOrSecondary()
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Gets a list of all the primaries and secondaries in this cluster.
      Returns:
      a list of ServerDescriptions for all primary and secondary servers

    • getAnyPrimaryOrSecondary

      @Deprecated public List<ServerDescription> getAnyPrimaryOrSecondary(TagSet tagSet)
      Deprecated.
      Replace with a filter on ServerDescription in the caller
      Gets a list of all the primaries and secondaries in this cluster that match the given replica set tags.
      Parameters:
      tagSet - a Set of replica set tags
      Returns:
      a list of ServerDescriptions for all primary and secondary servers that contain all of the given tags

    • 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 this ClusterDescription.
      Returns:
      a String describing this cluster.