com.mongodb

Interface DBConnector

All Known Implementing Classes:

DBTCPConnector

Deprecated.

This class is NOT part of the public API. It will be dropped in 3.x releases.

@Deprecated
public interface DBConnector

Interface that provides the ability to exchange request/response with the database

Method Summary

Modifier and Type	Method and Description
CommandResult	authenticate(MongoCredential credentials) Deprecated. Authenticate using the given credentials.
com.mongodb.Response	call(DB db, DBCollection coll, com.mongodb.OutMessage m, ServerAddress hostNeeded, DBDecoder decoder) Deprecated. does a read operation on the database
com.mongodb.Response	call(DB db, DBCollection coll, com.mongodb.OutMessage m, ServerAddress hostNeeded, int retries) Deprecated. does a read operation on the database
com.mongodb.Response	call(DB db, DBCollection coll, com.mongodb.OutMessage m, ServerAddress hostNeeded, int retries, ReadPreference readPref, DBDecoder decoder) Deprecated. does a read operation on the database
boolean	isOpen() Deprecated. returns true if the connector is in a usable state
void	requestDone() Deprecated. terminates the "consistent request".
void	requestEnsureConnection() Deprecated. Ensures that a connection exists for the "consistent request"
void	requestStart() Deprecated. initiates a "consistent request" on the thread.
WriteResult	say(DB db, com.mongodb.OutMessage m, WriteConcern concern) Deprecated. does a write operation
WriteResult	say(DB db, com.mongodb.OutMessage m, WriteConcern concern, ServerAddress hostNeeded) Deprecated. does a write operation

Method Detail

requestStart

void requestStart()

Deprecated.

initiates a "consistent request" on the thread. Once this has been called, the connector will ensure that the same underlying connection is always used for a given thread. This happens until requestStop() is called.

requestDone

void requestDone()

Deprecated.

terminates the "consistent request".

requestEnsureConnection

void requestEnsureConnection()

Deprecated.

Ensures that a connection exists for the "consistent request"

say

WriteResult say(DB db,
                com.mongodb.OutMessage m,
                WriteConcern concern)

Deprecated.

does a write operation

Parameters:

db - the database

m - the request message

concern - the write concern

Returns:

the write result

Throws:

MongoException

say

WriteResult say(DB db,
                com.mongodb.OutMessage m,
                WriteConcern concern,
                ServerAddress hostNeeded)

Deprecated.

does a write operation

Parameters:

db - the database

m - the request message

concern - the write concern

hostNeeded - specific server to connect to

Returns:

the write result

Throws:

MongoException

call

com.mongodb.Response call(DB db,
                          DBCollection coll,
                          com.mongodb.OutMessage m,
                          ServerAddress hostNeeded,
                          DBDecoder decoder)

Deprecated.

does a read operation on the database

Parameters:

db - the database

coll - the collection

m - the request message

hostNeeded - specific server to connect to

decoder - the decoder to use

Returns:

the read result

Throws:

MongoException

call

com.mongodb.Response call(DB db,
                          DBCollection coll,
                          com.mongodb.OutMessage m,
                          ServerAddress hostNeeded,
                          int retries)

Deprecated.

does a read operation on the database

Parameters:

db - the database

coll - the collection

m - the request message

hostNeeded - specific server to connect to

retries - the number of retries in case of an error

Returns:

the read result

Throws:

MongoException

call

com.mongodb.Response call(DB db,
                          DBCollection coll,
                          com.mongodb.OutMessage m,
                          ServerAddress hostNeeded,
                          int retries,
                          ReadPreference readPref,
                          DBDecoder decoder)

Deprecated.

does a read operation on the database

Parameters:

db - the database

coll - the collection

m - the request message

hostNeeded - specific server to connect to

retries - number of retries in case of error

readPref - the read preferences

decoder - the decoder to use

Returns:

the read result

Throws:

MongoException

isOpen

boolean isOpen()

Deprecated.

returns true if the connector is in a usable state

Returns:

authenticate

CommandResult authenticate(MongoCredential credentials)

Deprecated.

Authenticate using the given credentials.

Parameters:

credentials - the credentials.

Returns:

the result of the authentication command, if successful

Throws:

CommandFailureException - if the authentication failed

Since:

2.11.0