biz.onixs.fix.engine.storage

Interface SessionStorage

All Known Implementing Classes:

AbstractSessionStorage, AsyncFileSessionStorage, FileBasedSessionStorage, MemoryBasedSessionStorage, NullSessionStorage, TimingSessionStorage

public interface SessionStorage

Method Summary

Modifier and Type	Method and Description
void	clear() Clears session storage state.
void	close(boolean terminated) Closes session storage.
String	getId() Returns session storage unique id.
long	getInSeqNum() Returns last inbound message sequence number or 0 if no inbound message is stored.
int	getMaxStorageSize() Returns the maximum size of the message storage.
List<FixMessage>	getOutboundMessages(long beginSequenceNumber, long endSequenceNumber) Returns outbound messages with the specified sequence number interval.
long	getOutSeqNum() Returns last outbound sequence number or 0 if no outbound message is stored.
boolean	isTerminated() Returns the flag whether this storage state should be kept or cleaned.
void	setInSeqNum(long msgSeqNum) Sets last inbound message sequence number
void	setMaxStorageSize(int maxStorageSize) Sets the maximum size of the message storage.
void	setOutSeqNum(long msgSeqNum) Sets last outbound message sequence number.
void	setTerminated(boolean terminated) Sets the flag whether this storage state should be kept or cleaned
void	storeInboundMessage(ByteBuffer rawMessage, long msgSeqNum, boolean isOriginal) Stores inbound message.
void	storeOutboundMessage(ByteBuffer rawMessage, long msgSeqNum, boolean isOriginal, boolean warmUp) Stores outbound message.

Method Detail

clear

void clear()

Clears session storage state. Inbound and outbound sequence numbers are reset to 0.

close

void close(boolean terminated)

Closes session storage.
The terminated set to true means that after closing this session storage can not be restored. Its state is vanished. The session with the same parameters will be started from scratch.
The terminated set to false means that after closing this session can be restored at some point in the future. The session state need to be kept - sequence numbers, etc.

Parameters:

terminated - controls whether this session storage state should be kept or cleaned

Throws:

StorageException - if closing failed

getOutboundMessages

List<FixMessage> getOutboundMessages(long beginSequenceNumber,
                                     long endSequenceNumber)

Returns outbound messages with the specified sequence number interval. Ends are included.
Warning. This is critical to avoid using the method directly.

Parameters:

beginSequenceNumber - sequence number to begin with, 0 means the minimum available

endSequenceNumber - sequence number to end with, 0 means the maximum available

Returns:

outbound messages

Throws:

IllegalArgumentException - if (beginSeqNum < 0) or ((endSeqNum != 0) and (beginSeqNum > endSeqNum))

storeInboundMessage

void storeInboundMessage(ByteBuffer rawMessage,
                         long msgSeqNum,
                         boolean isOriginal)

Stores inbound message.

Parameters:

rawMessage - message to store

msgSeqNum - message sequence number

isOriginal - whether message is original or not

Throws:

StorageException - if storing failed

storeOutboundMessage

void storeOutboundMessage(ByteBuffer rawMessage,
                          long msgSeqNum,
                          boolean isOriginal,
                          boolean warmUp)

Stores outbound message.

Parameters:

rawMessage - message to store

msgSeqNum - message sequence number

isOriginal - whether message is original or not

warmUp - indicates whether it is a warmUp message

Throws:

StorageException - if storing failed

getId

String getId()

Returns session storage unique id.

Returns:

session storage unique id

getInSeqNum

long getInSeqNum()

Returns last inbound message sequence number or 0 if no inbound message is stored.

Returns:

inbound sequence number

setInSeqNum

void setInSeqNum(long msgSeqNum)

Sets last inbound message sequence number

Parameters:

msgSeqNum - inbound message sequence number

Throws:

StorageException - if set failed

getOutSeqNum

long getOutSeqNum()

Returns last outbound sequence number or 0 if no outbound message is stored.

Returns:

outbound sequence number

setOutSeqNum

void setOutSeqNum(long msgSeqNum)

Sets last outbound message sequence number.

Parameters:

msgSeqNum - last outbound message sequence number

Throws:

StorageException - if set failed

isTerminated

boolean isTerminated()

Returns the flag whether this storage state should be kept or cleaned.

Returns:

flag whether this storage state should be kept or cleaned

setTerminated

void setTerminated(boolean terminated)

Sets the flag whether this storage state should be kept or cleaned

Parameters:

terminated - flag whether this storage state should be kept or cleaned

Throws:

StorageException - if set failed

getMaxStorageSize

int getMaxStorageSize()

Returns the maximum size of the message storage.
The details depend on the selected storage implementation.

Returns:

maximum size of the message storage

setMaxStorageSize

void setMaxStorageSize(int maxStorageSize)

Sets the maximum size of the message storage.
The details depend on the selected storage implementation.

Parameters:

maxStorageSize - maximum size of the message storage

Throws:

IllegalArgumentException - if (maxStorageSize < 0)