Package com.mongodb.session

Interface ClientSession

All Superinterfaces:

AutoCloseable, Closeable

All Known Subinterfaces:

ClientSession

@NotThreadSafe
public interface ClientSession
extends Closeable

A client session.

Since:

3.6

See Also:

ClientSessionOptions

Since server release

3.6

Method Summary

Modifier and Type	Method	Description
void	advanceClusterTime(BsonDocument clusterTime)
void	advanceOperationTime(BsonTimestamp operationTime)	Set the operation time of the last operation executed in this session.
void	close()
BsonDocument	getClusterTime()
BsonTimestamp	getOperationTime()	Gets the operation time of the last operation executed in this session.
ClientSessionOptions	getOptions()	Get the options for this session.
Object	getOriginator()	Gets the originator for the session.
ServerAddress	getPinnedMongosAddress()	Get the server address of the pinned mongos on this session.
ServerSession	getServerSession()
boolean	isCausallyConsistent()	Returns true if operations in this session must be causally consistent
void	setPinnedMongosAddress(ServerAddress address)	Set the server address of the pinned mongos.

Method Detail

getPinnedMongosAddress

@Nullable
ServerAddress getPinnedMongosAddress()

Get the server address of the pinned mongos on this session. For internal use only.

Returns:

the server address of the pinned mongos

Since:

3.11

Since server release

4.2

setPinnedMongosAddress

void setPinnedMongosAddress(ServerAddress address)

Set the server address of the pinned mongos. For internal use only.

Parameters:

address - the server address to pin

Since:

3.11

Since server release

4.2

getOptions

ClientSessionOptions getOptions()

Get the options for this session.

Returns:

the options, which may not be null

isCausallyConsistent

boolean isCausallyConsistent()

Returns true if operations in this session must be causally consistent

Returns:

whether operations in this session must be causally consistent.

getOriginator

Object getOriginator()

Gets the originator for the session.

Important because sessions must only be used by their own originator.

Returns:

the sessions originator

getServerSession

ServerSession getServerSession()

Returns:

the server session

getOperationTime

BsonTimestamp getOperationTime()

Gets the operation time of the last operation executed in this session.

Returns:

the operation time

advanceOperationTime

void advanceOperationTime(BsonTimestamp operationTime)

Set the operation time of the last operation executed in this session.

Parameters:

operationTime - the operation time

advanceClusterTime

void advanceClusterTime(BsonDocument clusterTime)

Parameters:

clusterTime - the cluster time to advance to

getClusterTime

BsonDocument getClusterTime()

Returns:

the latest cluster time seen by this session

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable