Gateway.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/B3/BOE/testing/ABI.h>
#include <OnixS/B3/BOE/SessionSettings.h>
 
#if defined(ONIXS_B3_BOE_HAS_GATEWAY_EMULATOR)
 
#include <OnixS/B3/BOE/Messaging.h>
#include <OnixS/B3/BOE/testing/MessagePtr.h>
#include <OnixS/B3/BOE/testing/ClientMessageListener.h>
 
#include <chrono>
#include <atomic>
 
namespace OnixS {
namespace B3 {
namespace BOE {
namespace Testing {
 
// Assume NegotiateResponse2::credentials is empty
constexpr
UInt16 calculateNegotiateResponse2MaxSize()
{
    using Message = NegotiateResponse2;
 
    return
        Message::blockLength(Message::Schema::Version)
        + MessageHeader::Size
        + Message::getMinimalVariableFieldsSize(Message::Schema::Version);
}
 
//  Type aliases
using NegotiateResponse2Container = MessageHolder<NegotiateResponse2, calculateNegotiateResponse2MaxSize()>;
using NegotiateReject3Container = MessageHolder<NegotiateReject3>;
using EstablishAck5Container = MessageHolder<EstablishAck5>;
using EstablishReject6Container = MessageHolder<EstablishReject6>;
using Terminate7Container = MessageHolder<Terminate7>;
using Sequence9Container = MessageHolder<Sequence9>;
 
using MessageBasePtr = MessagePtr<SbeMessage>;
using Negotiate1Ptr = MessagePtr<Negotiate1>;
using Establish4Ptr = MessagePtr<Establish4>;
using Terminate7Ptr = MessagePtr<Terminate7>;
using Sequence9Ptr = MessagePtr<Sequence9>;

class ONIXS_B3_BOE_EXPORTED Gateway
{
public:
    using Timeout = std::chrono::milliseconds;
 
    Gateway(const SessionSettings::LicenseStores& licenseStores, int port, const char* host = "127.0.0.1",
            const Timeout& acceptTimeout = defaultTimeout(),
            const Timeout& sendReceiveTimeout = defaultTimeout());

    virtual ~Gateway();

    Gateway(const Gateway&) = delete;
    Gateway& operator=(const Gateway&) = delete;

    Gateway(Gateway&&) noexcept;
    Gateway& operator=(Gateway&&) noexcept;

    void swap(Gateway&) noexcept;

    Gateway& acceptConnection(const Timeout& acceptTimeout = defaultTimeout());

    bool tryAcceptConnection(const Timeout& acceptTimeout = defaultTimeout());

    Gateway& acceptSession(SeqNumber outgoingSequenceNumber = 1);

    Terminate7Ptr waitUntilTerminate(
        ClientMessageListener* listener = nullptr, ClientSessionMessageListener* sessionMessageListener = nullptr,
        std::atomic<bool>* stopRequested = nullptr);

    Gateway& sendSequence(UInt32 nextSeqNo);

    Gateway& disconnect();

    const char * host() const noexcept;

    ONIXS_B3_BOE_NODISCARD
    int port() const noexcept;

    Gateway& enableLogger(const std::string& logFileName, unsigned int logLevel = 3);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg, SeqNumber num);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg, SeqNumber num);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg, std::initializer_list<SeqNumber> numbers);

    template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
    Gateway& send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg, std::initializer_list<SeqNumber> numbers);
 

    template <typename TMsg>
    MessagePtr<TMsg> receiveTypedMessage();

    Gateway& run(ClientMessageListener& listener);

    Gateway& run(ClientMessageListener& appMsgListener, ClientSessionMessageListener& sessionMsgListener);

    ONIXS_B3_BOE_NODISCARD
    SeqNumber outSeqNum() const noexcept;

    Gateway& outSeqNum(SeqNumber nextOutSeqNum) noexcept;

    ONIXS_B3_BOE_NODISCARD
    UInt64 sessionVerId() const noexcept
    {
        return uId_;
    }

    ONIXS_B3_BOE_NODISCARD
    SessionID sessionId() const noexcept
    {
        return sessionId_;
    }

    Gateway& tcpNoDelayOption(bool noDelay);

    ONIXS_B3_BOE_NODISCARD
    bool tcpNoDelayOption() const noexcept ;

    ONIXS_B3_BOE_NODISCARD
    int socketReceiveBufferSize() const;

    Gateway& socketReceiveBufferSize(int bufferSize);

    ONIXS_B3_BOE_NODISCARD
    int socketSendBufferSize() const noexcept;

    Gateway& socketSendBufferSize(int bufferSize);
 
protected:
    ONIXS_B3_BOE_NODISCARD
    bool isConnectionClosed(const Timeout& timeout) const;

    ONIXS_B3_BOE_NODISCARD
    bool isConnectionClosed() const;

    MessageBasePtr receive() const;

    MessageBasePtr tryReceive(const Timeout& timeout = defaultTimeout()) const;

    Negotiate1Ptr receiveNegotiate();

    Negotiate1Ptr acceptNegotiate();

    Negotiate1Ptr rejectNegotiate(NegotiationRejectCode::Enum errorCodes = NegotiationRejectCode::Enum());

    Establish4Ptr receiveEstablish();

    Establish4Ptr acceptEstablish(UInt32 outgoingSequenceNumber = 1, unsigned gatewayKeepAliveInterval = 0);

    Establish4Ptr rejectEstablish(UInt32 outgoingSequenceNumber = 1, EstablishRejectCode::Enum errorCodes = EstablishRejectCode::Enum());

    Terminate7Ptr receiveTerminate();

    Terminate7Ptr acceptTerminate();

    Gateway& sendTerminate(TerminationCode::Enum errCode = TerminationCode::Finished);

    Terminate7Ptr terminate(TerminationCode::Enum errCode = TerminationCode::Finished);

    NegotiateResponse2Container createNegotiationResponse(const Negotiate1Ptr& request);

    NegotiateReject3Container createNegotiateReject(const Negotiate1Ptr& request, NegotiationRejectCode::Enum errorCodes);

    EstablishAck5Container createEstablishmentAck(const Establish4Ptr& request, UInt32 outgoingSequenceNumber, unsigned gatewayKeepAliveInterval = 0);

    EstablishReject6Container createEstablishReject(const Establish4Ptr& request, UInt32 outgoingSequenceNumber, EstablishRejectCode::Enum errorCodes);

    Terminate7Container createTerminate(const Terminate7Ptr& request);

    Terminate7Container createTerminate(TerminationCode::Enum errCode);

    Sequence9Container createSequence(UInt32 nextSeqNo);

    Gateway& send(Messaging::SbeMessage, Messaging::SimpleOpenFramingHeader&);

    Gateway& sendData(const void* data, size_t size);

    Gateway& close();

    static Timeout defaultTimeout()
    {
        return Timeout(30000);
    }

    UInt64 uId_{0};

    SessionID sessionId_;
 
private:
 
    class Impl;
    Impl* impl_;
};
 
 
template <typename TMsg>
MessagePtr<TMsg> Gateway::receiveTypedMessage()
{
    return cast<TMsg>(receive());
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg)
{
    const auto messageSize = msg.setHeader();
    auto* const header = msg.header();
    assert(header);
 
    return send(Messaging::SbeMessage(header + 1, messageSize), *header);
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg)
{
    return send(msg);
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg, SeqNumber num)
{
    auto & header = msg->businessHeader();
    header.setMsgSeqNum(num);
    return send(msg);
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg, SeqNumber num)
{
    auto & header = msg->businessHeader();
    header.setMsgSeqNum(num);
    return send(msg);
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(
    BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>& msg, std::initializer_list<SeqNumber> numbers)
{
    for(auto seqNum : numbers)
    {
        send(msg, seqNum);
    }
 
    return *this;
}
 
template <typename SbeMessageType, size_t MaxMessageSize, typename MessageInitializer>
Gateway& Gateway::send(
    BOE::Messaging::MessageHolder<SbeMessageType, MaxMessageSize, MessageInitializer>&& msg, std::initializer_list<SeqNumber> numbers)
{
    for(auto seqNum : numbers)
    {
        send(msg, seqNum);
    }
 
    return *this;
}
 
 
}}}}
 
 
#endif