Package com.mongodb.connection

Class ClusterDescription

java.lang.Object

com.mongodb.connection.ClusterDescription

@Immutable
public class ClusterDescription
extends Object

Immutable snapshot state of a cluster.

Since:

3.0

Constructor Summary

Constructors

Constructor	Description
ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, MongoException srvResolutionException, List<ServerDescription> serverDescriptions, ClusterSettings clusterSettings, ServerSettings serverSettings)	Creates a new ClusterDescription.
ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, List<ServerDescription> serverDescriptions)	Creates a new ClusterDescription.
ClusterDescription(ClusterConnectionMode connectionMode, ClusterType type, List<ServerDescription> serverDescriptions, ClusterSettings clusterSettings, ServerSettings serverSettings)	Creates a new ClusterDescription.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
ServerDescription	findServerIncompatiblyNewerThanDriver()	Return a server in the cluster that is incompatibly newer than the driver.
ServerDescription	findServerIncompatiblyOlderThanDriver()	Return a server in the cluster that is incompatibly older than the driver.
Set<ServerDescription>	getAll()	Deprecated. Use getServerDescriptions() instead
List<ServerDescription>	getAny()	Deprecated. Replace with a filter on ServerDescription in the caller
List<ServerDescription>	getAnyPrimaryOrSecondary()	Deprecated. Replace with a filter on ServerDescription in the caller
List<ServerDescription>	getAnyPrimaryOrSecondary(TagSet tagSet)	Deprecated. Replace with a filter on ServerDescription in the caller
ServerDescription	getByServerAddress(ServerAddress serverAddress)	Deprecated. Replace with a filter on ServerDescription in the caller
ClusterSettings	getClusterSettings()	Gets the cluster settings, which may be null if not provided.
ClusterConnectionMode	getConnectionMode()	Gets whether this cluster is connecting to a single server or multiple servers.
Integer	getLogicalSessionTimeoutMinutes()	Gets the logical session timeout in minutes, or null if at least one of the known servers does not support logical sessions.
List<ServerDescription>	getPrimaries()	Deprecated. Replace with a filter on ServerDescription in the caller
List<ServerDescription>	getSecondaries()	Deprecated. Replace with a filter on ServerDescription in the caller
List<ServerDescription>	getSecondaries(TagSet tagSet)	Deprecated. Replace with a filter on ServerDescription in the caller
List<ServerDescription>	getServerDescriptions()	Returns an unmodifiable list of the server descriptions in this cluster description.
ServerSettings	getServerSettings()	Gets the server settings, which may be null if not provided.
String	getShortDescription()	Returns a short, pretty description for this ClusterDescription.
MongoException	getSrvResolutionException()	Gets any exception encountered while resolving the SRV record for the initial host.
ClusterType	getType()	Gets the specific type of this cluster
int	hashCode()
boolean	hasReadableServer(ReadPreference readPreference)	Returns true if this cluster has at least one server that satisfies the given read preference.
boolean	hasWritableServer()	Returns true if this cluster has at least one server that can be used for write operations.
boolean	isCompatibleWithDriver()	Return whether all servers in the cluster are compatible with the driver.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ClusterDescription

public ClusterDescription(ClusterConnectionMode connectionMode,
                          ClusterType type,
                          List<ServerDescription> serverDescriptions)

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)

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)

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 Detail

getClusterSettings

public ClusterSettings getClusterSettings()

Gets the cluster settings, which may be null if not provided.

Returns:

the cluster settings

Since:

3.4

getServerSettings

public ServerSettings getServerSettings()

Gets the server settings, which may be null if not provided.

Returns:

the server settings

Since:

3.4

isCompatibleWithDriver

public boolean isCompatibleWithDriver()

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()

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()

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)

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()

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()

Gets whether this cluster is connecting to a single server or multiple servers.

Returns:

the ClusterConnectionMode for this cluster

getType

public ClusterType getType()

Gets the specific type of this cluster

Returns:

a ClusterType enum representing the type of this cluster

getSrvResolutionException

public MongoException getSrvResolutionException()

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()

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()

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

Since server release

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)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

getShortDescription

public String getShortDescription()

Returns a short, pretty description for this ClusterDescription.

Returns:

a String describing this cluster.