com.marketfactory.mfapi.enterprise.api.protocol

Interface SessionFactory

All Known Implementing Classes:

ProtocolSessionFactory

public interface SessionFactory

Method Summary

Modifier and Type	Method and Description
Session	build() Builds the Session.
static SessionFactory	createProtocolSessionFactory(java.lang.String host, int port)
SessionFactory	setBackPressureNotificationHandler(BackPressureNotificationHandler backPressureNotificationHandler) Optional.
SessionFactory	setHeartbeatInterval(int heartbeatIntervalSeconds) Optional.
SessionFactory	setResetSeqNum(boolean resetSeqNum) Optional.
SessionFactory	setTcpReceiveBufferSizeHint(int tcpBufferReceiveSizeHint) Optional.
SessionFactory	setTcpSendBufferSizeHint(int tcpSendBufferSizeHint) Optional.
SessionFactory	with(NextExpectedMessageSequenceNumberStore incomingMsgSeqNumStore) Required.
SessionFactory	with(NextOutgoingMessageSequenceNumberStore outgoingMsgSeqNumStore) Required.
SessionFactory	with(java.lang.String venueName, com.marketfactory.protocol.sbe4.SessionType sessionType) Required.
SessionFactory	withCallbackHandler(CallbackHandler callbackHandler) Required.
SessionFactory	withConnection(Connection connection) Optional.
SessionFactory	withCredentials(java.lang.String username, java.lang.String password) Required.

Method Detail

createProtocolSessionFactory

static SessionFactory createProtocolSessionFactory(java.lang.String host,
                                                   int port)

withCredentials

SessionFactory withCredentials(java.lang.String username,
                               java.lang.String password)

Required. Set the username and password to use for the session.

Parameters:

username - username to use to initiateLogon

password - password to use to initiateLogon

Returns:

SessionFactory

with

SessionFactory with(java.lang.String venueName,
                    com.marketfactory.protocol.sbe4.SessionType sessionType)

Required. Set the session venue and type.

Parameters:

venueName - venue to connect o

sessionType - service type to connect to

Returns:

SessionFactory

with

SessionFactory with(NextOutgoingMessageSequenceNumberStore outgoingMsgSeqNumStore)

Required. NextOutgoingMessageSequenceNumberStore to use for this session.

Parameters:

outgoingMsgSeqNumStore - to use for this session

Returns:

SessionFactory

with

SessionFactory with(NextExpectedMessageSequenceNumberStore incomingMsgSeqNumStore)

Required. NextExpectedMessageSequenceNumberStore to use for this session.

Parameters:

incomingMsgSeqNumStore - to use for this session

Returns:

SessionFactory

withCallbackHandler

SessionFactory withCallbackHandler(CallbackHandler callbackHandler)

Required. Handler for the messages and session events.

Parameters:

callbackHandler - handler

Returns:

SessionFactory

setBackPressureNotificationHandler

SessionFactory setBackPressureNotificationHandler(BackPressureNotificationHandler backPressureNotificationHandler)

Optional. Sets a back pressure notification handler. If not set, notifications will not be sent.

Parameters:

backPressureNotificationHandler - handler to notify on session back pressure events

Returns:

SessionFactory

setHeartbeatInterval

SessionFactory setHeartbeatInterval(int heartbeatIntervalSeconds)

Optional. Sets the heartbeat interval. Restricts the value to LogonEncoder.heartBtIntMinValue() ()} and LogonEncoder.heartBtIntMaxValue() If not set, defaults to ProtocolSessionFactory.DEFAULT_HEARTBEAT_INTERVAL_SECONDS

Parameters:

heartbeatIntervalSeconds - seconds to set heartbeat interval to

Returns:

SessionFactory

setResetSeqNum

SessionFactory setResetSeqNum(boolean resetSeqNum)

Optional. Defaults false.
May be used freely in UAT. In Production, may only be set to True when SessionType=Pricing/Replay. Indicates both sides of a FIX session should reset sequence numbers, all messages queued for resend will be lost.

Parameters:

resetSeqNum - true to reset sequence numbers, false to leave client and server sequence numbers

Returns:

SessionFactory

setTcpSendBufferSizeHint

SessionFactory setTcpSendBufferSizeHint(int tcpSendBufferSizeHint)

Optional. Set the size of the TCP send buffer. This is a hint - in that the OS will attempt to size it to your requested value but might not be exact. StandardSocketOptions.SO_SNDBUF

Parameters:

tcpSendBufferSizeHint - bytes to set the TCP send buffer to

Returns:

SessionFactory

setTcpReceiveBufferSizeHint

SessionFactory setTcpReceiveBufferSizeHint(int tcpBufferReceiveSizeHint)

Optional. Set the size of the TCP receive buffer. This is a hint - in that the OS will attempt to size it to your requested value but might not be exact. StandardSocketOptions.SO_RCVBUF

Parameters:

tcpBufferReceiveSizeHint - bytes to set the TCP receive buffer to

Returns:

SessionFactory

withConnection

SessionFactory withConnection(Connection connection)

Optional. Set the connection to use. Defaults to NonblockingSocketChannelConnection

Parameters:

connection - connection to use

Returns:

SessionFactory

build

Session build()

Builds the Session. Might fail if values are missing.

Returns:

the built Session, ready to use.