Getting Started Sample

This sample demonstrates how to connect to the BUS Gateway and BGW or the local Gateway emulator.

Source code

/*
 * 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.
 */
#include <OnixS/ICE/BOE/IceBoe.h>
 
#include <iostream>
#include <memory>
 
using namespace ONIXS_ICEBOE_NAMESPACE;
using namespace ONIXS_ICEBOE_MESSAGING_NAMESPACE;
 
 
#include <Settings/Defaults.h>
#include <Common/Helpers.h>
#include <Common/Listener.h>
#include <Common/Settings.h>
#include <Common/Signal.h>
#include <Common/Emulator.h>
 
using namespace Samples;
 
int main(int argc, char * argv[])
{
    // `--help` to show options.
    const AppConfiguration<
            SettingsConfiguration
            , ConnectivityConfiguration
            , LogonConfiguration
            , StorageConfiguration<SessionStorageType::FileBased>
            > cfg{"GettingStarted", argc, argv};
 
    try
    {
        SignalHelper::manageSignals();
 
        auto settings = fillSettings(cfg);
 
        const auto emulator = createEmulator(settings, cfg);
 
        // A `SessionListener` instance.
        Listener listener;
 
        // Credentials for Binary Order Gateway service.
        BgwCredentials bgwCredentials;
 
        // Request Binary Order Gateway credentials from Binary Utility Service (BUS) Gateway.
        {
            auto busSettings = settings;
 
            // Create an instance of a `BUS` session
            const auto busSession = std::make_unique<BusSession>(settings, &listener, cfg.storage());;
 
            // Connect.
            busSession->connect(cfg.host(), cfg.port());
 
            //request a bgw credentials
            auto bgwCredentialsFuture = busSession->getBgwCredentialsAsync(cfg.userId());
 
            // Save Binary Order Gateway service credentials.
            bgwCredentials = bgwCredentialsFuture.get();
 
            // Disconnect.
            busSession->disconnect();
        }
 
        // Log in and put an order to Binary Order Gateway service.
        {
            // Create an instance of a `BGW` session.
            const auto bgwSession = std::make_unique<BgwSession>(settings, &listener, cfg.storage());;
 
            // Connect.
            bgwSession->connect(bgwCredentials);
 
            // Create `TraderLogonRequest` message.
            auto traderLogonRequest = Helper::createTraderLogonRequest(cfg.traderId(), cfg.traderPwd());
 
            // Send `TraderLogonRequest` message.
            bgwSession->send(traderLogonRequest);
 
            // Wait until `TraderLogonReport` is received.
            Samples::wait(listener.traderLoggedOn).get();
 
            // Create an order.
            auto order = Helper::createOrder(cfg.traderId());
 
            // Put an order.
            bgwSession->send(order);
 
            // Wait for user action.
            SignalHelper::waitUntilKey("disconnect the BGW session and terminate the application");
 
            // Create `TraderLogoutRequest` message.
            auto traderLogoutRequest = Helper::createTraderLogoutRequest(cfg.traderId());
 
            // Log out trader.
            bgwSession->send(traderLogoutRequest);
 
            // Disconnect.
            bgwSession->disconnect();
        }
    }
    catch(const std::exception & ex)
    {
        std::cerr << "\nEXCEPTION: " << ex.what() << std::endl;
        return 1;
    }
 
    return 0;
}