com.caplin.motif.fx.trading

Class FXTradeAdapter

java.lang.Object

com.caplin.motif.fx.trading.FXTradeAdapter

All Implemented Interfaces:

UserSessionObservable

public class FXTradeAdapter
extends Object
implements UserSessionObservable

An FXTradeAdapter services trading capabilities for the Executable Streaming Price (ESP), Request For Stream (RFS) and Block Trade (BLOCK) protocols.

Typically, a FXTradeAdapter will be set up as follows:

 FXTradeAdapter adapter = new FXTradeAdapter(dataSource);
 adapter.registerESPTradeListenerFactory(new MyESPTradeListenerFactory());
 adapter.registerRFSTradeListenerFactory(new MyRFSTradeListenerFactory());
 adapter.registerBlockTradeListenerFactory(new MyBlockTradeListenerFactory());
 

Constructor Summary

Constructors

Constructor and Description
FXTradeAdapter(com.caplin.datasource.DataSource dataSource) Constructs an FXTradeAdapter that will utilise the specified DataSource and its configuration for communication with the motif.
FXTradeAdapter(TradeAdapter tradeAdapter) Constructs an FXTradeAdapter that will utilise the specified TradeAdapter and its configuration for communication with the motif.

Method Summary

Modifier and Type	Method and Description
void	addUserSessionListener(UserSessionListener listener) Adds a listener that will be notified whenever a user session is created and closed.
void	registerBlockTradeListenerFactory(BlockTradeListenerFactory factory) Registers a factory that will listen to Block Trade workflows initiated from the client.
void	registerBlockTradeListenerFactory(BlockTradeListenerFactory factory, TradeValidator tradeFieldsValidator) Registers a factory that will listen to Block Trade workflows initiated from the client.
void	registerESPTradeListenerFactory(ESPTradeListenerFactory factory) Registers a factory that will listen to ESP Trade workflows initiated from the client.
void	registerESPTradeListenerFactory(ESPTradeListenerFactory factory, TradeValidator tradeFieldsValidator) Registers a factory that will listen to ESP Trade workflows initiated from the client.
void	registerLegacySalesRFSTradeListenerFactory(RFSTradeListenerFactory factory, TradingSubProtocol subProtocol) Deprecated. registers an RFS TradeListenerFactory to the old SalesRFS Trading Protocol. To be used until Sales Motif refactors usages of SalesRFS
void	registerRFSTradeListenerFactory(RFSTradeListenerFactory factory) Registers a factory that will listen to RFS Trade workflows initiated from the client.
void	registerRFSTradeListenerFactory(RFSTradeListenerFactory factory, TradeValidator tradeFieldsValidator) Registers a factory that will listen to RFS Trade workflows initiated from the client.
void	removeUserSessionListener(UserSessionListener listener) Removes a listener UserSessionListener to stop receiving session events.

Methods inherited from class java.lang.Object

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

Constructor Detail

FXTradeAdapter

public FXTradeAdapter(com.caplin.datasource.DataSource dataSource)
               throws IOException

Constructs an FXTradeAdapter that will utilise the specified DataSource and its configuration for communication with the motif.

Parameters:

dataSource - The DataSource that will be used to receive requests for ESP and RFS trades.

Throws:

IOException - If an error occured reading configuration files for the adapter.

FXTradeAdapter

public FXTradeAdapter(TradeAdapter tradeAdapter)

Constructs an FXTradeAdapter that will utilise the specified TradeAdapter and its configuration for communication with the motif.

Prefer this constructor if you will be implementing multiple trade adapters in a single adapter.

Parameters:

tradeAdapter - The trade adapter

Method Detail

addUserSessionListener

public void addUserSessionListener(UserSessionListener listener)

Adds a listener that will be notified whenever a user session is created and closed. Note that you can add multiple UserSessionListeners

Specified by:

addUserSessionListener in interface UserSessionObservable

Parameters:

listener - the listener to be notified of session lifecycle events.

removeUserSessionListener

public void removeUserSessionListener(UserSessionListener listener)

Removes a listener UserSessionListener to stop receiving session events.

Specified by:

removeUserSessionListener in interface UserSessionObservable

Parameters:

listener - the listener to be removed from receiving session lifecycle events.

registerESPTradeListenerFactory

public void registerESPTradeListenerFactory(ESPTradeListenerFactory factory)

Registers a factory that will listen to ESP Trade workflows initiated from the client.

Parameters:

factory - the factory that will be asked to create the ESPTradeListener

registerESPTradeListenerFactory

public void registerESPTradeListenerFactory(ESPTradeListenerFactory factory,
                                            TradeValidator tradeFieldsValidator)

Registers a factory that will listen to ESP Trade workflows initiated from the client.

Parameters:

factory - the factory that will be asked to create the ESPTradeListener

tradeFieldsValidator - The validator that will be used to validate the incoming client message.

registerRFSTradeListenerFactory

public void registerRFSTradeListenerFactory(RFSTradeListenerFactory factory)

Registers a factory that will listen to RFS Trade workflows initiated from the client.

Parameters:

factory - the factory that will be asked to create the RFSTradeListener

registerRFSTradeListenerFactory

public void registerRFSTradeListenerFactory(RFSTradeListenerFactory factory,
                                            TradeValidator tradeFieldsValidator)

Registers a factory that will listen to RFS Trade workflows initiated from the client. The given validator will be used to validate the submission of the RFS. For example, for sales trading you can pass SalesRFSTradeValidator to ensure that the client sends the sales related fields.

Parameters:

factory - the factory that will be asked to create the RFSTradeListener

tradeFieldsValidator - The validator that will be used to validate the incoming client message.

registerLegacySalesRFSTradeListenerFactory

@Deprecated
public void registerLegacySalesRFSTradeListenerFactory(RFSTradeListenerFactory factory,
                                                                   TradingSubProtocol subProtocol)

Deprecated. registers an RFS TradeListenerFactory to the old SalesRFS Trading Protocol. To be used until Sales Motif refactors usages of SalesRFS

Registers a factory that will listen to RFS Trade workflows initiated from the client.

Parameters:

subProtocol - the sub protocol

factory - the factory that will be asked to create the RFSTradeListener

registerBlockTradeListenerFactory

public void registerBlockTradeListenerFactory(BlockTradeListenerFactory factory)

Registers a factory that will listen to Block Trade workflows initiated from the client.

Parameters:

factory - the factory that will be asked to create the BlockTradeListener

registerBlockTradeListenerFactory

public void registerBlockTradeListenerFactory(BlockTradeListenerFactory factory,
                                              TradeValidator tradeFieldsValidator)

Registers a factory that will listen to Block Trade workflows initiated from the client.

Parameters:

factory - the factory that will be asked to create the BlockTradeListener

tradeFieldsValidator - The validator that will be used to validate the incoming client message.