GroupSubscription.h

Go to the documentation of this file.

/*
 * Copyright (c) Onix Solutions Limited. All rights reserved.
 *
 * This software owned by Onix Solutions Limited 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 "Export.h"
#include "Types.h"
#include "Enumerations.h"

#include <iosfwd>
#include <string>
#include <set>

namespace OnixS { namespace ICE { namespace iMpact { namespace MarketData {

/// Defines which books should be maintained for given group name.
struct ONIXS_ICEMDH_EXPORT GroupSubscription
{
    /// Multicast group name.
    std::string groupName;

    /// Specifies type of market functionality.
    ///
    /// \note As a result of the increased messaging over the full implied channels,
    /// you may experience additional latency as compared to the non-full implied channels.
    ///
    /// By default all subscription is for non-implied channels.
    MarketSubType::Enum marketSubType;

    /// Specifies book depth.
    BookDepth::Enum bookDepth;

    /// Specifies a list of market ID's for which Handler calls callbacks.
    /// \note If the list is empty, calls will be made for all ID's.
    MarketIds marketIds;

    /// Initializes group subscription attributes.
    GroupSubscription(
        const std::string& groupName
      , MarketSubType::Enum marketSubType = MarketSubType::NonImplied
      , BookDepth::Enum bookDepth = BookDepth::TOP5PL
    );

    /// Deserialize from a string representation.
    static GroupSubscription deserialize(const std::string&);

    /// Returns true if current instance is equal to the given.
    bool operator==(const GroupSubscription&) const;

    /// Returns true if current instance is not equal to the given.
    bool operator!=(const GroupSubscription&) const;

    /// Returns true if this market subscription is less than a given.
    bool operator<(const GroupSubscription&) const;

    /// Returns string representation.
    std::string toString() const;
};

/// Allow output to C++ I/) streams.
ONIXS_ICEMDH_EXPORT std::ostream& operator<<(std::ostream&, const GroupSubscription&);

inline bool GroupSubscription::operator==(const GroupSubscription& rhs) const
{
    if (groupName != rhs.groupName)
        return false;

    if (marketSubType != rhs.marketSubType)
        return false;

    if (bookDepth != rhs.bookDepth)
        return false;

    if (marketIds != rhs.marketIds)
        return false;

    return true;
}

inline bool GroupSubscription::operator!=(const GroupSubscription& rhs) const
{
    return !(*this == rhs);
}

inline bool GroupSubscription::operator<(const GroupSubscription& right) const
{
    if (groupName < right.groupName)
        return true;

    if (groupName > right.groupName)
        return false;

     if (marketSubType < right.marketSubType)
        return true;

     if (marketSubType > right.marketSubType)
        return false;

     if (bookDepth < right.bookDepth)
        return true;

     if (bookDepth > right.bookDepth)
        return false;

     if (marketIds < right.marketIds)
        return true;

     if (marketIds > right.marketIds)
        return false;

     return false;
}

/// Collection of group subscriptions.
typedef std::set<GroupSubscription> GroupSubscriptions;

}}}}                                                        // namespace MarketData, iMpact, ICE, OnixS