Handler.h

Go to the documentation of this file.

/*
 * Copyright Onix Solutions Limited [OnixS]. All rights reserved.
 *
 * This software owned by Onix Solutions Limited [OnixS] and is protected by copyright law
 * and international copyright treaties.
 *
 * Access to and use of the software is governed by the terms of the applicable ONIXS Software
 * Services Agreement (the Agreement) and Customer end user license agreements granting
 * a non-assignable, non-transferable and non-exclusive license to use the software
 * for it's own data processing purposes under the terms defined in the Agreement.
 *
 * Except as otherwise granted within the terms of the Agreement, copying or reproduction of any part
 * of this source code or associated reference material to any other location for further reproduction
 * or redistribution, and any amendments to this copyright notice, are expressly prohibited.
 *
 * Any reproduction or redistribution for sale or hiring of the Software not in accordance with
 * the terms of the Agreement is a violation of copyright law.
 */

#pragma once

#include "OnixS/Eurex/Trading/Export.h"
#include "OnixS/Eurex/Trading/AdminListener.h"
#include "OnixS/Eurex/Trading/ConnectionStateListener.h"
#include "OnixS/Eurex/Trading/CLIPListener.h"
#include "OnixS/Eurex/Trading/Defines.h"
#include "OnixS/Eurex/Trading/ErrorListener.h"
#include "OnixS/Eurex/Trading/HandlerSettings.h"
#include "OnixS/Eurex/Trading/HandlerStateListener.h"
#include "OnixS/Eurex/Trading/InfoListener.h"
#include "OnixS/Eurex/Trading/Logon.h"
#include "OnixS/Eurex/Trading/OrderHandlingListener.h"
#include "OnixS/Eurex/Trading/QuoteAndCrossRequestListener.h"
#include "OnixS/Eurex/Trading/QuoteHandlingListener.h"
#include "OnixS/Eurex/Trading/SessionListener.h"
#include "OnixS/Eurex/Trading/SRQSListener.h"
#include "OnixS/Eurex/Trading/StrategyCreationListener.h"
#include "OnixS/Eurex/Trading/TESListener.h"
#include "OnixS/Eurex/Trading/WarningListener.h"

#include <string>

namespace OnixS {
namespace Eurex {
namespace Trading {

/// Eurex ETI Trading Handler.
class ONIXS_EUREX_ETI_EXPORT Handler
{
public:
    /// Performs instance initialization.
    /// \param settings defines values for various options
    /// which affect handler behavior like enabling logging
    /// during execution of the handler.
    Handler (const HandlerSettings& settings);

    /// Finalizes the Handler.
    virtual ~Handler();

    /**
    * Establishes the connection.
    *
    * @note Blocks until the logon reply is received.
    *
    * @note Should be called only when Handler is disconnected.
    *
    * @param hostName Hostname to connect to.
    *
    * @param port Port number to connect to.
    *
    * @param logon Initial logon message parameters.
    *
    * @param localNetworkInterface Local network interface.
    *
    * @throw std::exception Cannot set the local network interface.
    * @throw std::exception Cannot connect to hostname on port.
    * @throw std::exception Cannot configure size of receive buffer for the socket.
    * @throw std::exception Cannot configure size of send buffer for the socket.
    * @throw OperationException Invalid argument is given.
    */
    void connect (const char* hostName, UInt16 port, const Logon& logon, const char* localNetworkInterface = "");

    /**
    * Establishes the connection.
    *
    * @note Blocks until the logon reply is received.
    *
    * @note Should be called only when Handler is disconnected.
    *
    * @param primaryHostName Primary hostname to connect to.
    *
    * @param primaryPort Primary port number to connect to.
    *
    * @param secondaryHostName Secondary hostname to connect to.
    *
    * @param secondaryPort Secondary port number to connect to.
    *
    * @param logon Initial logon message parameters.
    *
    * @param localNetworkInterface Local network interface.
    *
    * @throw std::exception Cannot set the local network interface.
    * @throw std::exception Cannot connect to hostname on port.
    * @throw std::exception Cannot configure size of receive buffer for the socket.
    * @throw std::exception Cannot configure size of send buffer for the socket.
    * @throw OperationException Invalid argument is given.
    */
    void connect (const char* primaryHostName, UInt16 primaryPort, const char* secondaryHostName, UInt16 secondaryPort, const Logon& logon, const char* localNetworkInterface = "");

    /**
    * Force session disconnect.
    *
    * @note Blocks until the Session Logout procedure is finished.
    */
    void disconnect ();

    /**
    * Async force session disconnect.
    */
    void disconnectAsync ();

    /// Send message
    ///
    /// \returns MsgSeqNum
    ///
    /// \throws OperationException Attempt to send data before connection creation
    /// \throws std::exception with system dependent message if sending has been failed
    UInt32 send (Message&);

    /// Assigns listener for errors occurred while executing handler.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected
    void registerErrorListener (ErrorListener* listener);

    /// Assigns listener for warnings occurred while executing handler.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected
    void registerWarningListener (WarningListener* listener);

    /// Assigns listener for state change events occurred while executing handler.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerHandlerStateListener (HandlerStateListener* listener);

    /// Assigns listener for session events occurred while executing handler.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerSessionListener (SessionListener* listener);

    /// Assigns listener for connection state change events occurred while executing handler.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerConnectionStateListener (ConnectionStateListener* listener);

    /// Assigns listener for administrative events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerAdminListener (AdminListener* listener);

    /// Assigns listener for strategy creation events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerStrategyCreationListener (StrategyCreationListener* listener);

    /// Assigns listener for order handling events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerOrderHandlingListener (OrderHandlingListener* listener);

    /// Assigns listener for quote and cross request events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerQuoteAndCrossRequestListener (QuoteAndCrossRequestListener* listener);

    /// Assigns listener for quote handling events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerQuoteHandlingListener (QuoteHandlingListener* listener);

    /// Assigns listener for other events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerInfoListener (InfoListener* listener);

    /// Assigns listener for TES events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerTESListener (TESListener* listener);

    /// Assigns listener for SRQS events.
    /// It's permissible to change the listener multiple times during
    /// handler's life-time, but only when handler is in disconnected state.
    /// \throw OperationException if handler not disconnected.
    void registerSRQSListener (SRQSListener* listener);

    /// Returns handler state.
    HandlerState::Enum state () const;

    /// Logs the given user-level message to the handler log.
    void log (LogLevel::Enum logLevel, const char* logMessage, size_t length);

    /// Logs the given user-level message to the handler log
    void log (LogLevel::Enum logLevel, const char* logMessage);

    /// Logs the given user-level message to the handler log.
    void log (LogLevel::Enum logLevel, const std::string& str);

    /// Returns the license expiration date.
    const std::string& licenseExpirationDate () const;

    /// Encrypts the given password using the given key.
    /// \param password Password to encrypt.
    /// \param pubKeyPath Path to the RSA public key file.
    /// \return Encrypted and Base64-encoded password.
    static std::string encryptPassword(const std::string& password, const std::string& pubKeyPath);

    /// Returns Handler's version.
    static const std::string& version ();

private:
    Handler (const Handler&); //no implementation
    Handler& operator = (const Handler&); //no implementation

private:
    struct Impl;
    Impl* impl_;
};
}
}
}