SbeMessage.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/Euronext/MarketData/OptiqMdg/ABI.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/Aliases.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/StrRef.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/Memory.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/Composites.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/SchemaTraits.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/MaxMessageSize.h>
#include <OnixS/Euronext/MarketData/OptiqMdg/messaging/ExceptionHelpers.h>
 
#include <cassert>
#include <limits>
#include <stdexcept>
 
ONIXS_EURONEXT_OPTIQMDG_MESSAGING_NAMESPACE_BEGIN

typedef
MessageHeader::TemplateId MessageTemplateId;

template<typename Message> inline
void checkBinaryLength(const Message&, MessageSize length, MessageSize minimalRequiredLength)
{
    if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(length < minimalRequiredLength)
        throwBinaryBlockIsTooSmall(length, minimalRequiredLength, Message::className());
}

ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS BinaryBlockBase
{
protected:
    ~BinaryBlockBase() ONIXS_EURONEXT_OPTIQMDG_DEFAULT;
};

template < class Container, class BlockLength >
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS BinaryBlock : public BinaryBlockBase
{
    const Container& container() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return *static_cast <const Container*> (this);
    }
 
protected:
    BinaryBlock() ONIXS_EURONEXT_OPTIQMDG_DEFAULT;
 
    ~BinaryBlock() ONIXS_EURONEXT_OPTIQMDG_DEFAULT;

    template < class Value > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Value ordinary(BlockLength offset) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(container().blockLength() >= (offset + size<Value>()) &&
            "The requested field exceeds provided block boundaries.");
 
        const void* const location = advanceByBytes(container().block(), offset);
        return getValue<Value>(location);
    }

    template <class Value, class NullValue > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool ordinary(Value& value, BlockLength offset, NullValue null) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        value = ordinary<Value>(offset);
 
        return (null != value);
    }

    template < class Value, class NullValue > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool ordinary(Value& value, BlockLength offset, NullValue null, SchemaVersion since) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (since <= container().version()  && ordinary (value, offset, null ) );
    }

    template < class Enumeration > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    typename Enumeration::Enum enumeration(BlockLength offset) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        typedef typename Enumeration::Base Base;
        typedef typename Enumeration::Enum Enum;
 
        return static_cast<Enum>(ordinary<Base>(offset));
    }

    template < class Enumeration, class NullValue > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool enumeration(typename Enumeration::Enum& value, BlockLength offset, NullValue null) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        typedef typename Enumeration::Base Base;
        typedef typename Enumeration::Enum Enum;
 
        value = static_cast <Enum>(ordinary<Base>(offset));
        return null != value;
    }

    template < class Enumeration, class NullValue > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool enumeration(typename Enumeration::Enum& value, BlockLength offset, NullValue null, SchemaVersion since) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (since <= container().version() && enumeration<Enumeration>(value, offset, null) );
    }

    template < BlockLength Length > ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    StrRef fixedStr(BlockLength offset) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(container().blockLength() >= (offset + Length) && "The requested field exceeds provided block boundaries.");
 
        const Char* const text = reinterpret_cast <const Char*> (advanceByBytes(container().block(), offset));
 
        return StrRef(text, strnlen(text, Length));
    }

    template<BlockLength Length> ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool fixedStr(StrRef& value, BlockLength offset) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        value = fixedStr<Length>(offset);
        return !value.empty();
    }

    template<BlockLength Length> ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    bool fixedStr(StrRef& value, BlockLength offset, SchemaVersion since) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (since <= container().version() && fixedStr<Length>(value, offset));
    }
};

template <class Container, class BlockLength >
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeFields : public BinaryBlock<Container, BlockLength>
{
protected:
    SbeFields() ONIXS_EURONEXT_OPTIQMDG_DEFAULT;
    ~SbeFields() ONIXS_EURONEXT_OPTIQMDG_DEFAULT;
};

template <class BodySizeType>
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeGroupEntry : public SbeFields<SbeGroupEntry<BodySizeType>, BodySizeType>
{
public:
    typedef BodySizeType BlockLength;

    SbeGroupEntry()
        : encoded_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
        , size_(0)
        , version_(0)
    {
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeGroupEntry(const void* encoded, BlockLength size, SchemaVersion version)
        : encoded_(encoded)
        , size_(size)
        , version_(version)
    {
        assert(encoded);
    }

    bool valid() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (encoded_ != ONIXS_EURONEXT_OPTIQMDG_NULLPTR);
    }

    const void* encoded() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return encoded_;
    }

    const void* block() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return encoded_;
    }

    BlockLength blockLength() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return size_;
    }

    SchemaVersion version() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return version_;
    }
 
private:
    const void* encoded_;
    BodySizeType size_;
    SchemaVersion version_;
};

template <class EntryType, class BlockLength, class NumInGroup, class Length >
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeGroupEntries
{
public:
    typedef Length EncodedLength;

    typedef EntryType Entry;

    typedef NumInGroup Size;

    ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS Iterator
    {
    public:
        typedef EntryType Entry;
        typedef Entry value_type;
 
        typedef Entry* pointer;
        typedef Entry& reference;
 
        typedef ptrdiff_t difference_type;
 
        typedef std::random_access_iterator_tag iterator_category;

        Iterator() ONIXS_EURONEXT_OPTIQMDG_NOTHROW
            : entry_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
            , size_(0)
            , version_(0)
        {
        }

        ONIXS_EURONEXT_OPTIQMDG_HOTPATH
        Iterator(const void* entry, Size size, SchemaVersion version) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
            : entry_(entry)
            , size_(size)
            , version_(version)
        {
            assert(valid());
        }

        bool valid() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        {
            return (entry_ != ONIXS_EURONEXT_OPTIQMDG_NULLPTR);
        }

        ONIXS_EURONEXT_OPTIQMDG_HOTPATH
        Entry get() const
        {
            assert(valid());
 
            return Entry(entry_, size_, version_);
        }

        Entry operator *() const
        {
            return get();
        }

        bool operator == (const Iterator& other) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        {
            return entry_ == other.entry_;
        }

        bool operator !=(const Iterator& other) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        {
            return entry_ != other.entry_;
        }

        bool operator < (const Iterator& other) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        {
            return entry_ < other.entry_;
        }

        bool operator > (const Iterator& other) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        {
            return entry_ > other.entry_;
        }

        Iterator& operator ++()
        {
            assert(valid());
 
            entry_ = advanceByBytes(entry_, size_);
 
            return *this;
        }

        Iterator& operator --()
        {
            assert(valid());
 
            entry_ = advanceBackByBytes(entry_, size_);
 
            return *this;
        }

        ONIXS_EURONEXT_OPTIQMDG_HOTPATH
        Iterator operator +(difference_type distance) const
        {
            assert(valid());
 
            return Iterator(advanceByBytes(entry_, distance * size_), size_, version_);
        }

        ONIXS_EURONEXT_OPTIQMDG_HOTPATH
        Iterator operator - (difference_type distance) const
        {
            assert(valid());
 
            return Iterator(advanceBackByBytes(entry_, distance * size_), size_, version_);
        }
 
        private:
        const void* entry_;
        Size size_;
        SchemaVersion version_;
    };

    SbeGroupEntries() ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : encoded_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
        , blockLength_(0)
        , size_(0)
        , version_(0)
    {
    }

    SbeGroupEntries(const void* encoded, BlockLength blockLength, Size groupSize, SchemaVersion version) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : encoded_(encoded)
        , blockLength_(blockLength)
        , size_(groupSize)
        , version_(version)
    {
        assert(encoded_);
        assert(blockLength > 0);
        assert(version != 0);
    }

    bool valid() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (ONIXS_EURONEXT_OPTIQMDG_NULLPTR != encoded_);
    }

    bool empty() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (0 == size_);
    }

    Size size() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return size_;
    }

    Iterator begin() const
    {
        return Iterator(encoded(), blockLength_, version_);
    }

    Iterator end() const
    {
        return Iterator(advanceByBytes(encoded(), encodedLength()), blockLength_, version_);
    }

    Entry operator [](Size index) const
    {
        assert(index < size_);
        assert(encoded_);
 
        return Entry(advanceByBytes(encoded_, static_cast<ptrdiff_t>(index) * blockLength_), blockLength_, version_);
    }

    const void* encoded() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return encoded_;
    }

    EncodedLength encodedLength() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (static_cast<EncodedLength>(blockLength_) * static_cast<EncodedLength>(size_) );
    }

    template<class OtherEntry, class OtherBlockLength, class OtherNumInGroup, class OtherLength >
    SbeGroupEntries(const SbeGroupEntries<OtherEntry, OtherBlockLength, OtherNumInGroup, OtherLength >& other) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : encoded_(other.encoded_)
        , blockLength_(other.blockLength_)
        , size_(other.size_)
        , version_(other.version_)
    {
        // Dimension types may vary for the different instantiations of the template.
        // Therefore, truncation of the dimensions must be avoided.
 
        assert(blockLength_ == other.blockLength_);
        assert(size_ == other.size_);
    }
 
    template <class OtherEntry, class OtherBlockLength, class OtherNumInGroup, class OtherLength>
    SbeGroupEntries& operator = (const SbeGroupEntries <OtherEntry, OtherBlockLength, OtherNumInGroup, OtherLength>& other) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        encoded_ = other.encoded_;
 
        blockLength_ = other.blockLength_;
 
        assert(blockLength_ == other.blockLength_);
 
        size_ = other.size_;
 
        assert(size_ == other.size_);
 
        version_ = other.version_;
 
        return *this;
    }
 
private:
    // Allows coping and cloning for different instantiations.
    template <class OtherEntry, class OtherBlockLength, class OtherNumInGroup, class OtherLength> friend class SbeGroupEntries;
 
    const void* encoded_;
    BlockLength blockLength_;
    NumInGroup size_;
    SchemaVersion version_;
};

template < class EntryType, class DimensionType, class GroupSizeType >
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeGroup
{
public:
    typedef DimensionType Dimension;

    typedef GroupSizeType BinarySize;

    enum { EmptySize = Dimension::Size };

    typedef typename DimensionType::BlockLength EntrySize;

    typedef SbeGroupEntries <EntryType, typename Dimension::BlockLength, typename Dimension::NumInGroup, GroupSizeType > Entries;

    typedef typename Entries::Iterator Iterator;

    typedef typename Entries::Entry Entry;

    typedef typename Entries::Size Size;

    SbeGroup()
        ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : header_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
        , entries_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
        , version_(0)
    {
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeGroup(const void* data, ONIXS_EURONEXT_OPTIQMDG_UNUSED BinarySize size, SchemaVersion version) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : header_(static_cast <const Dimension*>(data))
        , entries_(advanceByBytes(data, Dimension::Size))
        , version_(version)
    {
        assert(header_);
        assert(entries_);
        assert(size >= Dimension::Size);
 
        assert(valid());
    }

    bool valid() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (entries_ != ONIXS_EURONEXT_OPTIQMDG_NULLPTR);
    }

    bool empty() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return 0 == size();
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Size size() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
        assert(header_);
 
        const Dimension* const group = static_cast<const Dimension*>(header_);
 
        return group->numInGroup();
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Iterator begin() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return Iterator(entries_, numericCast<Size>(entrySize()), version_);
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Iterator end() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return Iterator(advanceByBytes(binary(), binarySize()), numericCast<Size>(entrySize()), version_);
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Entry operator [](Size index) const
    {
        assert(valid());
        assert(index < size());
 
        return Entry(advanceByBytes(entries_, static_cast<ptrdiff_t>(index) * entrySize()), entrySize(), version_);
    }

    ONIXS_EURONEXT_OPTIQMDG_NODISCARD
    Entries entries() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
        assert(header_);
 
        return Entries (entries_, header_->blockLength(), header_->numInGroup(), version_);
    }

    const void* encoded() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return header_;
    }

    const void* tail() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return advanceByBytes(toByteBlock(encoded()), binarySize());
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    const void* binary() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return header_;
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    BinarySize binarySize() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return Dimension::Size + (static_cast<BinarySize>(entrySize()) * static_cast<BinarySize>(size()));
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    EntrySize entrySize() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
        assert(header_);
 
        const Dimension* const group = static_cast<const Dimension*>(header_);
        return group->blockLength();
    }
 
private:
    const Dimension* header_;
    const void* entries_;
    SchemaVersion version_;
 
    friend class SbeMessage;
};

template  <class BinarySize>
ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeGroupList
{
public:
    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeGroupList(const void* binary, BinarySize size, SchemaVersion version) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : binary_(binary)
        , size_(size)
        , version_(version)
    {
    }

    bool empty() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (0 == size_);
    }

    template<class Group> ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    Group head() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(!empty());
 
        return Group(binary_, size_, version_);
    }

    template<class Group> ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeGroupList tail() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(!empty());
 
        const BinarySize headSize = head<Group>().binarySize();
 
        assert(headSize <= size_);
 
        return SbeGroupList(advanceByBytes(binary_, headSize), size_ - headSize, version_);
    }

    template<class Group> ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeGroupList checkTail() const
    {
        const BinarySize headSize = checkHead<Group>();
 
        return SbeGroupList(advanceByBytes(binary_, headSize), size_ - headSize, version_);
    }
 
private:
    template<class Group>
    BinarySize checkHead() const
    {
        if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(size_ < Group::Dimension::Size)
        {
            throwBadBinaryBlock();
        }
 
        const Group group = head<Group>();
 
        const BinarySize headSize = group.binarySize();
 
        if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(headSize > size_)
        {
            throwBadBinaryBlock();
        }
 
        if(!group.empty())
        {
            const BinarySize entrySize = group.entrySize();
            const BinarySize expectedEntrySize = Group::Entry::minimalBlockLength(version_);
 
            if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(entrySize < expectedEntrySize)
            {
                throwBadBinaryBlock();
            }
        }
 
        return headSize;
    }
 
    const void* binary_;
    BinarySize size_;
    SchemaVersion version_;
};

template<typename Traits>
void checkVersion(SchemaVersion version)
{
    if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(version < Traits::MinimalVersion)
    {
        throwBadMessageVersion(version, Traits::MinimalVersion);
    }
}

template<typename Traits>
void checkVersion(SchemaVersion since, SchemaVersion version)
{
    checkVersion<Traits>(version);
 
    if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(version < since)
    {
        throwBadMessageVersion(version, since);
    }
}

template<typename Traits>
void checkSchemaId(SchemaId id)
{
    if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(id != Traits::Id)
    {
        throwBadSchemaId(Traits::Id, id);
    }
}

template<typename Traits>
void checkSchema(SchemaId id, SchemaVersion version)
{
    checkSchemaId<Traits>(id);
    checkVersion<Traits>(version);
}

ONIXS_EURONEXT_OPTIQMDG_LTWT_CLASS SbeMessage : public SbeFields<Messaging::SbeMessage, MessageSize>
{
public:
    struct NoCheck{};

    typedef MessageSize EncodedLength;

    typedef MessageSize BlockLength;

    SbeMessage() ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : header_(ONIXS_EURONEXT_OPTIQMDG_NULLPTR)
        , size_(0)
    {
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeMessage(const void* data, MessageSize size)
        : header_(static_cast<const MessageHeader*>(data))
        , size_(size)
    {
        assert(data);
        assert(size <= MaxMessageSize);
 
        if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(size < MessageHeader::Size)
            throwBinaryBlockIsTooSmall(size, MessageHeader::Size);
 
        // Now it is safe to read header_.
        if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(size < (MessageHeader::Size + header_->blockLength()))
            throwBinaryBlockIsTooSmall(size, MessageHeader::Size + header_->blockLength());
    }

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    SbeMessage(const void* data, MessageSize size, NoCheck) ONIXS_EURONEXT_OPTIQMDG_NOTHROW
        : header_(static_cast<const MessageHeader*>(data))
        , size_(size)
    {
        assert(data);
        assert(size <= MaxMessageSize);
 
        assert(size >= MessageHeader::Size);
        assert(size >= MessageHeader::Size + header_->blockLength());
    }

    void clear() ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        *this = SbeMessage();
        assert(!valid());
    }

    bool valid() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return (ONIXS_EURONEXT_OPTIQMDG_NULLPTR != header_);
    }

    MessageTemplateId templateId() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return header_->templateId();
    }

    SchemaVersion version() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return header_->version();
    }

    SchemaId schemaId() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return header_->schemaId();
    }

    const void* binary() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return header_;
    }
 
    // \return the end of the memory block.
    const void* blockEnd() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return advanceByBytes(header_, size_);
    }

    MessageSize bufferSize() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        return size_;
    }

    BlockLength blockLength() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return header_->blockLength();
    }

    const void* block() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(valid());
 
        return advanceByBytes(header_, MessageHeader::Size);
    }
 
protected:
    typedef SbeGroupList<MessageSize> GroupList;

    ONIXS_EURONEXT_OPTIQMDG_HOTPATH
    GroupList groups() const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        assert(header_);
 
        const void* list = advanceByBytes(block(), blockLength());
 
        const MessageSize listSize = size_ - MessageHeader::Size - header_->blockLength();
 
        return GroupList(const_cast<void*>(list), listSize, header_->version());
    }

    template<class Group, class Callable, class Owner>
    Group getGroup(Callable callable, Owner& owner) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        ONIXS_EURONEXT_OPTIQMDG_CHECK_NOTHROW(callable(owner));
        return callable(owner);
    }

    template<class Group, class Callable, class Owner>
    Group getGroup(Callable callable, SchemaVersion since, Owner& owner) const ONIXS_EURONEXT_OPTIQMDG_NOTHROW
    {
        if ONIXS_EURONEXT_OPTIQMDG_UNLIKELY(since > version())
            return Group();
 
        return getGroup<Group>(callable, owner);
    }
 
 
private:
    const MessageHeader* header_;
    MessageSize size_;
};
 
ONIXS_EURONEXT_OPTIQMDG_MESSAGING_NAMESPACE_END