io.debezium.connector.mongodb

Class MongoClients

java.lang.Object

io.debezium.connector.mongodb.MongoClients

@ThreadSafe
public class MongoClients
extends Object

A connection pool of MongoClient instances. This pool supports creating clients that communicate explicitly with a single server, or clients that communicate with any members of a replica set or sharded cluster given a set of seed addresses.

Author:

Randall Hauch

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MongoClients.Builder Configures and builds a ConnectionPool.

Field Summary

Fields

Modifier and Type	Field and Description
private Map<List<com.mongodb.ServerAddress>,com.mongodb.MongoClient>	connections
private List<com.mongodb.MongoCredential>	credentials
private Map<com.mongodb.ServerAddress,com.mongodb.MongoClient>	directConnections
private com.mongodb.MongoClientOptions	options

Constructor Summary

Constructors

Modifier	Constructor and Description
private	MongoClients(com.mongodb.MongoClientOptions options, List<com.mongodb.MongoCredential> credentials)

Method Summary

Modifier and Type	Method and Description
void	clear() Clear out and close any open connections.
com.mongodb.MongoClient	clientFor(com.mongodb.ServerAddress address) Obtain a direct client connection to the specified server.
com.mongodb.MongoClient	clientFor(String addressString) Obtain a direct client connection to the specified server.
com.mongodb.MongoClient	clientForMembers(List<com.mongodb.ServerAddress> seedAddresses) Obtain a client connection to the replica set or cluster.
com.mongodb.MongoClient	clientForMembers(com.mongodb.ServerAddress... seeds) Obtain a client connection to the replica set or cluster.
com.mongodb.MongoClient	clientForMembers(String addressList) Obtain a client connection to the replica set or cluster.
protected com.mongodb.MongoClient	connection(List<com.mongodb.ServerAddress> addresses)
static MongoClients.Builder	create() Obtain a builder that can be used to configure and create a connection pool.
protected com.mongodb.MongoClient	directConnection(com.mongodb.ServerAddress address)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

directConnections

private final Map<com.mongodb.ServerAddress,com.mongodb.MongoClient> directConnections

connections

private final Map<List<com.mongodb.ServerAddress>,com.mongodb.MongoClient> connections

credentials

private final List<com.mongodb.MongoCredential> credentials

options

private final com.mongodb.MongoClientOptions options

Constructor Detail

MongoClients

private MongoClients(com.mongodb.MongoClientOptions options,
                     List<com.mongodb.MongoCredential> credentials)

Method Detail

create

public static MongoClients.Builder create()

Obtain a builder that can be used to configure and create a connection pool.

Returns:

the new builder; never null

clear

public void clear()

Clear out and close any open connections.

clientFor

public com.mongodb.MongoClient clientFor(String addressString)

Obtain a direct client connection to the specified server. This is typically used to connect to a standalone server, but it also can be used to obtain a client that will only use this server, even if the server is a member of a replica set or sharded cluster.

The format of the supplied string is one of the following:

 host:port
 host
 

where host contains the resolvable hostname or IP address of the server, and port is the integral port number. If the port is not provided, the default port is used. If neither the host or port are provided (or addressString is null), then an address will use the default host and default port.

Parameters:

addressString - the string that contains the host and port of the server

Returns:

the MongoClient instance; never null

clientFor

public com.mongodb.MongoClient clientFor(com.mongodb.ServerAddress address)

Obtain a direct client connection to the specified server. This is typically used to connect to a standalone server, but it also can be used to obtain a client that will only use this server, even if the server is a member of a replica set or sharded cluster.

Parameters:

address - the address of the server to use

Returns:

the MongoClient instance; never null

clientForMembers

public com.mongodb.MongoClient clientForMembers(String addressList)

Obtain a client connection to the replica set or cluster. The supplied addresses are used as seeds, and once a connection is established it will discover all of the members.

The format of the supplied string is one of the following:

 replicaSetName/host:port
 replicaSetName/host:port,host2:port2
 replicaSetName/host:port,host2:port2,host3:port3
 host:port
 host:port,host2:port2
 host:port,host2:port2,host3:port3
 

where replicaSetName is the name of the replica set, host contains the resolvable hostname or IP address of the server, and port is the integral port number. If the port is not provided, the default port is used. If neither the host or port are provided (or addressString is null), then an address will use the default host and default port.

This method does not use the replica set name.

Parameters:

addressList - the string containing a comma-separated list of host and port pairs, optionally preceded by a replica set name

Returns:

the MongoClient instance; never null

clientForMembers

public com.mongodb.MongoClient clientForMembers(com.mongodb.ServerAddress... seeds)

Obtain a client connection to the replica set or cluster. The supplied addresses are used as seeds, and once a connection is established it will discover all of the members.

Parameters:

seeds - the seed addresses

Returns:

the MongoClient instance; never null

clientForMembers

public com.mongodb.MongoClient clientForMembers(List<com.mongodb.ServerAddress> seedAddresses)

Obtain a client connection to the replica set or cluster. The supplied addresses are used as seeds, and once a connection is established it will discover all of the members.

Parameters:

seedAddresses - the seed addresses

Returns:

the MongoClient instance; never null

directConnection

protected com.mongodb.MongoClient directConnection(com.mongodb.ServerAddress address)

connection

protected com.mongodb.MongoClient connection(List<com.mongodb.ServerAddress> addresses)