Package com.mongodb.connection

Class ConnectionDescription

java.lang.Object

com.mongodb.connection.ConnectionDescription

@Immutable
public class ConnectionDescription
extends Object

A description of a connection to a MongoDB server.

Since:

3.0

Constructor Summary

Constructors

Constructor	Description
ConnectionDescription(ConnectionId connectionId, int maxWireVersion, ServerType serverType, int maxBatchCount, int maxDocumentSize, int maxMessageSize, List<String> compressors)	Construct an instance.
ConnectionDescription(ConnectionId connectionId, ServerVersion serverVersion, int maxWireVersion, ServerType serverType, int maxBatchCount, int maxDocumentSize, int maxMessageSize, List<String> compressors)	Deprecated.
ConnectionDescription(ConnectionId connectionId, ServerVersion serverVersion, ServerType serverType, int maxBatchCount, int maxDocumentSize, int maxMessageSize)	Deprecated. Prefer ConnectionDescription(ConnectionId, ServerVersion, int, ServerType, int, int, int, List)
ConnectionDescription(ConnectionId connectionId, ServerVersion serverVersion, ServerType serverType, int maxBatchCount, int maxDocumentSize, int maxMessageSize, List<String> compressors)	Deprecated. Prefer ConnectionDescription(ConnectionId, ServerVersion, int, ServerType, int, int, int, List)
ConnectionDescription(ServerId serverId)	Construct a defaulted connection description instance.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
List<String>	getCompressors()	Gets the compressors supported by this connection.
ConnectionId	getConnectionId()	Gets the id of the connection.
static int	getDefaultMaxMessageSize()	Get the default maximum message size.
static int	getDefaultMaxWriteBatchSize()	Get the default maximum write batch size.
int	getMaxBatchCount()	Gets the max batch count for bulk write operations.
int	getMaxDocumentSize()	Gets the max document size in bytes for documents to be stored in collections.
int	getMaxMessageSize()	Gets the max message size in bytes for wire protocol messages to be sent to the server.
int	getMaxWireVersion()	The latest version of the wire protocol that this MongoDB server is capable of using to communicate with clients.
ServerAddress	getServerAddress()	Gets the server address.
ServerType	getServerType()	Gets the server type.
ServerVersion	getServerVersion()	Deprecated. Use getMaxWireVersion() instead
int	hashCode()
String	toString()
ConnectionDescription	withConnectionId(ConnectionId connectionId)	Creates a new connection description with the set connection id

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectionDescription

public ConnectionDescription(ServerId serverId)

Construct a defaulted connection description instance.

Parameters:

serverId - the server address

ConnectionDescription

@Deprecated
public ConnectionDescription(ConnectionId connectionId,
                             ServerVersion serverVersion,
                             ServerType serverType,
                             int maxBatchCount,
                             int maxDocumentSize,
                             int maxMessageSize)

Deprecated.

Prefer ConnectionDescription(ConnectionId, ServerVersion, int, ServerType, int, int, int, List)

Construct an instance.

Parameters:

connectionId - the connection id

serverVersion - the server version

serverType - the server type

maxBatchCount - the max batch count

maxDocumentSize - the max document size in bytes

maxMessageSize - the max message size in bytes

ConnectionDescription

@Deprecated
public ConnectionDescription(ConnectionId connectionId,
                             ServerVersion serverVersion,
                             ServerType serverType,
                             int maxBatchCount,
                             int maxDocumentSize,
                             int maxMessageSize,
                             List<String> compressors)

Deprecated.

Prefer ConnectionDescription(ConnectionId, ServerVersion, int, ServerType, int, int, int, List)

Construct an instance.

Parameters:

connectionId - the connection id

serverVersion - the server version

serverType - the server type

maxBatchCount - the max batch count

maxDocumentSize - the max document size in bytes

maxMessageSize - the max message size in bytes

compressors - the available compressors on the connection

Since:

3.5

ConnectionDescription

@Deprecated
public ConnectionDescription(ConnectionId connectionId,
                             ServerVersion serverVersion,
                             int maxWireVersion,
                             ServerType serverType,
                             int maxBatchCount,
                             int maxDocumentSize,
                             int maxMessageSize,
                             List<String> compressors)

Deprecated.

Construct an instance.

Parameters:

connectionId - the connection id

serverVersion - the server version

maxWireVersion - the max wire version

serverType - the server type

maxBatchCount - the max batch count

maxDocumentSize - the max document size in bytes

maxMessageSize - the max message size in bytes

compressors - the available compressors on the connection

Since:

3.10

ConnectionDescription

public ConnectionDescription(ConnectionId connectionId,
                             int maxWireVersion,
                             ServerType serverType,
                             int maxBatchCount,
                             int maxDocumentSize,
                             int maxMessageSize,
                             List<String> compressors)

Construct an instance.

Parameters:

connectionId - the connection id

maxWireVersion - the max wire version

serverType - the server type

maxBatchCount - the max batch count

maxDocumentSize - the max document size in bytes

maxMessageSize - the max message size in bytes

compressors - the available compressors on the connection

Since:

3.10

Method Detail

withConnectionId

public ConnectionDescription withConnectionId(ConnectionId connectionId)

Creates a new connection description with the set connection id

Parameters:

connectionId - the connection id

Returns:

the new connection description

Since:

3.8

getServerAddress

public ServerAddress getServerAddress()

Gets the server address.

Returns:

the server address

getConnectionId

public ConnectionId getConnectionId()

Gets the id of the connection. If possible, this id will correlate with the connection id that the server puts in its log messages.

Returns:

the connection id

getServerVersion

@Deprecated
public ServerVersion getServerVersion()

Deprecated.

Use getMaxWireVersion() instead

Gets the version of the server.

Returns:

the server version

getMaxWireVersion

public int getMaxWireVersion()

The latest version of the wire protocol that this MongoDB server is capable of using to communicate with clients.

Returns:

the maximum protocol version supported by this server

Since:

3.10

Since server release

2.6

getServerType

public ServerType getServerType()

Gets the server type.

Returns:

the server type

getMaxBatchCount

public int getMaxBatchCount()

Gets the max batch count for bulk write operations.

Returns:

the max batch count

getMaxDocumentSize

public int getMaxDocumentSize()

Gets the max document size in bytes for documents to be stored in collections.

Returns:

the max document size in bytes

getMaxMessageSize

public int getMaxMessageSize()

Gets the max message size in bytes for wire protocol messages to be sent to the server.

Returns:

the max message size in bytes.

getCompressors

public List<String> getCompressors()

Gets the compressors supported by this connection.

Returns:

the non-null list of compressors supported by this connection

getDefaultMaxMessageSize

public static int getDefaultMaxMessageSize()

Get the default maximum message size.

Returns:

the default maximum message size.

getDefaultMaxWriteBatchSize

public static int getDefaultMaxWriteBatchSize()

Get the default maximum write batch size.

Returns:

the default maximum write batch size.

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