com.apama.md.user
Event BBAManager


The BBA Manager event is used for simplifying the use of the Market data interface for handling the Best Bid/Ask (BBA) data stream information.
Since:
CMF 2.0.0

Action summary
 integeraddBBAUpdateCallback(com.apama.md.adapter.ConnectionKey connKey, action<com.apama.md.client.CurrentBBAInterface> userOnAllBBA)

This function is called by the user to register an update callback function for a specific symbol.
 voidconnect(string symbol, com.apama.session.CtrlParams controlParams, action<com.apama.session.SessionError> userOnSessionError, action<com.apama.md.adapter.ConnectionKey> userOnConnectSuccess, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> userOnConnectFailure)

This function is called by the user to connect to a previously created data stream interface for a specific symbol.
 voidconnectWithoutCache(string symbol, com.apama.session.CtrlParams controlParams, action<com.apama.session.SessionError> userOnSessionError, action<com.apama.md.adapter.ConnectionKey> userOnConnectSuccess, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> userOnConnectFailure)

This function is called by the user to connect to a previously created data stream interface for a specific symbol.
 voiddisconnect(com.apama.md.adapter.ConnectionKey connKey, action<com.apama.md.adapter.ConnectionKey> success, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> failure)

This function is called by the user to disconnect a specific symbol from the data stream.
 sequence<com.apama.md.adapter.ConnectionKey>getConnectionList()

Helper function to return a sequence of the current connection keys.
 sequence<com.apama.md.adapter.ConnectionKey>getConnectionListForSymbol(string symbol)

Helper function to return a sequence of the potential connection keys for any connections with a specified symbol name.
 com.apama.session.CtrlParamsSchemagetCtrlParamSchema()

Helper function to provide access to the control parameters for this data stream.
 com.apama.md.client.CurrentBBAInterfacegetCurrentBBA(com.apama.md.adapter.ConnectionKey connKey)

Helper function to return the current Best Bid/Ask interface.
 booleanhasData(com.apama.md.adapter.ConnectionKey connKey)

Helper function to determine whether any data has been received yet.
 booleanremoveBBACallback(com.apama.md.adapter.ConnectionKey connKey, integer reference)

This function is called by the user to remove an update callback based on the reference that was returned when it was added.
 
Action detail

addBBAUpdateCallback

            integer addBBAUpdateCallback(com.apama.md.adapter.ConnectionKey connKey, action<com.apama.md.client.CurrentBBAInterface> userOnAllBBA)
        
This function is called by the user to register an update callback function for a specific symbol.

The callback function returns a reference to the current BBA interface rather than the data itself. This means that if you store the returned CurrentBBAInterface reference and attempt to use it after a series of updates, the stored CurrentBBAInterface will refer to the last update.
Parameters:
connKey - The unique key for the connection to the datastream to register the update callback for.
userOnAllBBA - A callback action called when new BBA updates are received.
Returns:
An integer reference ID which can be used to unregister the update callback.
Since:
CMF 2.0.0
See Also:
com.apama.md.user.BBAManager#removeBBACallback() - This function should be called to remove the update handler given the reference Id returned from this function.

connect

            void connect(string symbol, com.apama.session.CtrlParams controlParams, action<com.apama.session.SessionError> userOnSessionError, action<com.apama.md.adapter.ConnectionKey> userOnConnectSuccess, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> userOnConnectFailure)
        
This function is called by the user to connect to a previously created data stream interface for a specific symbol.
Parameters:
symbol - The symbol to connect to.
controlParams - Control parameters (if required).
userOnSessionError - Callback action for session errors.
userOnConnectSuccess - A callback action on successful connection to the datastream.
userOnConnectFailure - A callback action on failure to connect to the datastream.
Since:
CMF 2.0.0

connectWithoutCache

            void connectWithoutCache(string symbol, com.apama.session.CtrlParams controlParams, action<com.apama.session.SessionError> userOnSessionError, action<com.apama.md.adapter.ConnectionKey> userOnConnectSuccess, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> userOnConnectFailure)
        
This function is called by the user to connect to a previously created data stream interface for a specific symbol.
Parameters:
symbol - The symbol to connect to.
controlParams - Control parameters (if required).
userOnSessionError - Callback action for session errors.
userOnConnectSuccess - A callback action on successful connection to the datastream.
userOnConnectFailure - A callback action on failure to connect to the datastream.
Since:
CMF 2.0.0

disconnect

            void disconnect(com.apama.md.adapter.ConnectionKey connKey, action<com.apama.md.adapter.ConnectionKey> success, action<com.apama.md.adapter.ConnectionKeycom.apama.md.client.Error> failure)
        
This function is called by the user to disconnect a specific symbol from the data stream.
Parameters:
connKey - The unique key for the connection to the datastream that we want to disconnect.
success - A callback action on successful disconnection from the datastream.
failure - A callback action on failure to disconnect from to the datastream.
Since:
CMF 2.0.0

getConnectionList

            sequence<com.apama.md.adapter.ConnectionKeygetConnectionList()
        
Helper function to return a sequence of the current connection keys.
Returns:
A sequence of the current connection keys.
Since:
CMF 2.2.0

getConnectionListForSymbol

            sequence<com.apama.md.adapter.ConnectionKeygetConnectionListForSymbol(string symbol)
        
Helper function to return a sequence of the potential connection keys for any connections with a specified symbol name.
Parameters:
symbol - The symbol to get the connection list for.
Returns:
A sequence of the potential connection keys for any connections with a specified symbol name.
Since:
CMF 2.2.0

getCtrlParamSchema

            com.apama.session.CtrlParamsSchema getCtrlParamSchema()
        
Helper function to provide access to the control parameters for this data stream.
Returns:
Event for the BBA datastream.
Since:
CMF 2.0.0

getCurrentBBA

            com.apama.md.client.CurrentBBAInterface getCurrentBBA(com.apama.md.adapter.ConnectionKey connKey)
        
Helper function to return the current Best Bid/Ask interface.
Parameters:
connKey - The unique key for the connection to the datastream to request the current data for.
Returns:
The current Best Bid/Ask interface for the requested connection.
Since:
CMF 2.0.0

hasData

            boolean hasData(com.apama.md.adapter.ConnectionKey connKey)
        
Helper function to determine whether any data has been received yet.
Parameters:
connKey - The unique key for the connection to the datastream to check data exists for.
Returns:
true if data is available, false otherwise.
Since:
CMF 2.2.0

removeBBACallback

            boolean removeBBACallback(com.apama.md.adapter.ConnectionKey connKey, integer reference)
        
This function is called by the user to remove an update callback based on the reference that was returned when it was added.
Parameters:
connKey - The unique key for the connection to the datastream to remove the update callback for .
reference - The Reference ID returned from addBBAUpdateCallback.
Returns:
true if successful, false otherwise.
Since:
CMF 2.0.0
See Also:
com.apama.md.user.BBAManager#addBBAUpdateCallback() - The function that provides the reference Id.