BinaryMessage.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/Tradeweb/MarketData/Apa/Memory.h>
#include <OnixS/Tradeweb/MarketData/Apa/Defines.h>
#include <OnixS/Tradeweb/MarketData/Apa/String.h>

#include <cassert>

namespace OnixS
{
    namespace Tradeweb
    {
        namespace MarketData
        {
            namespace Apa
            {

                /// Exposes base services to access fields stored in 
                /// little Endian block of memory. Class represents an 
                /// abstraction, instance construction available through 
                /// descendants implementing actual access to encoded data. 
                template <class Block, class BlockSize> 
                class BinaryFields
                {
                    /// Instance of block providing 
                    /// actual access to encoded data.
                    const Block& block() const
                    {
                        return *static_cast<const Block*>(this);
                    }

                protected:
                    /// Returns sub message. 
                    template <class SubMessage>
                    const SubMessage submessage(BlockSize offset, BlockSize size) const
                    {
                        assert(static_cast<size_t>(block().binarySize()) >= (offset + size));

                        const void* const data = advanceByBytes(block().binary(), offset);

                        return SubMessage(data, size);
                    }

                    /// Returns value of a field by its offset. 
                    template <class FieldValue>
                    const FieldValue& ordinary(BlockSize offset) const
                    {
                        assert(static_cast<size_t>(block().binarySize()) >= (offset + sizeof(FieldValue)));

                        const void* const fieldValue = advanceByBytes(block().binary(), offset);

                        return *static_cast <const FieldValue*>(fieldValue);
                    }

                    /// Returns value of a field by its offset. 
                    /// 
                    /// Given function serves as specialization of 
                    /// general case for fields of enumeration type. 
                    template <class Enumeration>
                    typename Enumeration::Enum enumeration(BlockSize offset) const
                    {
                        typedef typename Enumeration::Base Base;

                        typedef typename Enumeration::Enum Enum;

                        return static_cast<Enum>( ordinary<Base>(offset));
                    }

                    /// Provides access to string field by its offset. 
                    /// 
                    /// Given function serves as specialization 
                    /// of general case for fields of string type. 
                    template <BlockSize Size> 
                    StrRef fixedStr(BlockSize offset) const
                    {
                        typedef Char Str[Size];

                        const Str& str = ordinary<Str>(offset);

                        return StrRef(str, strnlen(str, Size));
                    }
                };

                /// Aliases message length type. 
                typedef Integer2 MessageSize;

                /// Encapsulates services for manipulating little endian encoded messages.
                class ONIXS_TRADEWEB_APA_API BinaryMessage : public BinaryFields<BinaryMessage, MessageSize>
                {
                    const void* data_;
                    MessageSize size_;

                public:
                    /// Length of message binary data. 
                    typedef MessageSize BinarySize;

                    /// Initializes blank instance referencing to nothing. 
                    BinaryMessage()
                        : data_(NULL)
                        , size_(0)
                    {
                    }

                    /// Initializes instance over given memory block.
                    BinaryMessage(
                        const void* data,
                        MessageSize size)
                        : data_(data)
                        , size_(size)
                    {
                        assert(NULL != data);
                    }

                    /// Initializes instance as copy of the other one.
                    BinaryMessage(
                        const BinaryMessage& other)
                        : data_(other.data_)
                        , size_(other.size_)
                    {
                    }

                    /// Indicates whether instance refers to a valid message. 
                    operator bool() const
                    {
                        return (NULL != data_);
                    }

                    /// Message content. 
                    const void* binary() const
                    {
                        return data_;
                    }

                    /// Size of message. 
                    MessageSize binarySize() const
                    {
                        return size_;
                    }

                    /// Re-initializes instance as a copy of the other one.
                    BinaryMessage&
                        operator =(
                            const BinaryMessage& other)
                    {
                        data_ = other.data_;
                        size_ = other.size_;

                        return *this;
                    }
                };

                /// conversion to UInt32
                ONIXS_TRADEWEB_APA_API
                UInt32 toUInt32(StrRef);

                /// conversion to UInt64
                ONIXS_TRADEWEB_APA_API
                UInt64 toUInt64(StrRef);
            }
        }
    }
}