interface IO2GTableListener

Brief

The interface provides method signatures to process notifications about trading tables events: adding/updating/deleting of rows, and changes in a table status.

Details

The interface can be implemented only your the application uses the O2GTableManager.

Prerequisites

You must specify that your session uses the table manager before a login. For example,

mSession.useTableManager(O2GTableManagerMode.Yes, null);

After the successful login, you must obtain an instance of the O2GTableManager class. For example,

O2GTableManager tableManager = mSession.getTableManager();

The table manager keeps trading tables in memory and therefore allows access to the up-to-date field values and ability to capture table events.
If you want to process notifications for a specific table events, you must obtain an instance of a class derived from the O2GTable class. For example, if you need information about opened positions, write the following line:

O2GTradesTable tradesTable = (O2GTradesTable)tableManager.getTable(O2GTableType.Trades);

For complete instructions on the table manager usage, see the How to use table manager in ForexConnect API section.

Limitations

The IO2GTableListener is notified only about the trading tables updates (see O2GResponseType.TablesUpdates).
Note:In order to process the response that comes as an answer to a request execution, you application needs to implement the IO2GResponseListener interface.

Implementation

If you want to use the methods of the IO2GTableListener interface, you must create a class that implements the interface. For example,

public class TableListener : IO2GTableListener { }

In your application you must create an instance of the class that implements the interface. For example,

TableListener tableListener = new TableListener();

This instance must be subscribed to a table object event.
You must subscribe to each event individually by using different methods of the O2GTable. For example, if you want to process notifications about the Trades table update, call the O2GTable.subscribeUpdate method as follows:

tradesTable.subscribeUpdate(O2GTableUpdateType.Update, tableListener);

Before the logout, you must unsubscribe the listener from the table object. For example,

tradesTable.unsubscribeUpdate(O2GTableUpdateType.Update, tableListener);

Examples of the subscriprion/unsubscription methods syntax are listed below. These examples are based on the Trades table.

For the interface implementation details, see the example below: Example

package gettrades;

import com.fxcore2.IO2GTableListener;
import com.fxcore2.O2GRow;
import com.fxcore2.O2GTableStatus;
import com.fxcore2.O2GTradeTableRow;

public class TableListener implements IO2GTableListener {
 
    // Implementation of IO2GTableListener interface public method onAdded
    public void onAdded(String rowID, O2GRow rowData)
    {
       O2GTradeTableRow trade = (O2GTradeTableRow)(rowData);
       Console.WriteLine("Trade information added " + rowID);
       Console.WriteLine("TradeID: " + trade.TradeID +
                          " Close = " + trade.Close);
    }
 
    // Implementation of IO2GTableListener interface public method onChanged
    public void onChanged(String rowID, O2GRow rowData)
    {
       O2GTradeTableRow trade = (O2GTradeTableRow)(rowData);
       Console.WriteLine("Trade information changed " + rowID);
       Console.WriteLine("TradeID: " + trade.TradeID +
                          " Close = " + trade.Close);
    }
 
    // Implementation of IO2GTableListener interface public method onDeleted
    public void onDeleted(String rowID, O2GRow rowData)
    {
       O2GTradeTableRow trade = (O2GTradeTableRow)(rowData);
       Console.WriteLine("Trade information deleted " + rowID);
       Console.WriteLine("TradeID: " + trade.TradeID +
                          " Close = " + trade.Close);
    }
 
 
    // Implementation of IO2GTableListener interface public method onStatus
    public void onStatusChanged(O2GTableStatus status)
    {
    }
}

The type defined in the fxcore2.dll assembly. The namespace is fxcore2.