cfg_option.h

Go to the documentation of this file.

// Copyright (C) 2014-2018 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
#ifndef CFG_OPTION_H
#define CFG_OPTION_H
 
#include <dhcp/option.h>
#include <dhcp/option_space_container.h>
#include <cc/cfg_to_element.h>
#include <cc/stamped_element.h>
#include <cc/user_context.h>
#include <dhcpsrv/key_from_key.h>
#include <boost/multi_index_container.hpp>
#include <boost/multi_index/hashed_index.hpp>
#include <boost/multi_index/sequenced_index.hpp>
#include <boost/multi_index/mem_fun.hpp>
#include <boost/multi_index/member.hpp>
#include <boost/shared_ptr.hpp>
#include <stdint.h>
#include <string>
#include <list>
 
namespace isc {
namespace dhcp {
 
class OptionDescriptor : public data::StampedElement, public data::UserContext {
public:
    OptionPtr option_;
 
    bool persistent_;
 
    std::string formatted_value_;
 
    std::string space_name_;
 
    OptionDescriptor(const OptionPtr& opt, bool persist,
                     const std::string& formatted_value = "",
                     data::ConstElementPtr user_context = data::ConstElementPtr())
        : option_(opt), persistent_(persist),
          formatted_value_(formatted_value),
          space_name_() {
        setContext(user_context);
    };
 
    OptionDescriptor(bool persist)
        : option_(OptionPtr()), persistent_(persist),
          formatted_value_(), space_name_() {};
 
    OptionDescriptor(const OptionDescriptor& desc)
        : option_(desc.option_), persistent_(desc.persistent_),
          formatted_value_(desc.formatted_value_),
          space_name_(desc.space_name_) {
        setContext(desc.getContext());
    };
 
    bool equals(const OptionDescriptor& other) const;
 
    bool operator==(const OptionDescriptor& other) const {
        return (equals(other));
    }
 
    bool operator!=(const OptionDescriptor& other) const {
        return (!equals(other));
    }
};
 
typedef boost::shared_ptr<OptionDescriptor> OptionDescriptorPtr;
 
typedef boost::multi_index_container<
    // Container comprises elements of OptionDescriptor type.
    OptionDescriptor,
    // Here we start enumerating various indexes.
    boost::multi_index::indexed_by<
        // Sequenced index allows accessing elements in the same way
        // as elements in std::list.
        // Sequenced is an index #0.
        boost::multi_index::sequenced<>,
        // Start definition of index #1.
        boost::multi_index::hashed_non_unique<
            // KeyFromKeyExtractor is the index key extractor that allows
            // accessing option type being held by the OptionPtr through
            // OptionDescriptor structure.
            KeyFromKeyExtractor<
                // Use option type as the index key. The type is held
                // in OptionPtr object so we have to call Option::getType
                // to retrieve this key for each element.
                boost::multi_index::const_mem_fun<
                    Option,
                    uint16_t,
                    &Option::getType
                >,
                // Indicate that OptionPtr is a member of
                // OptionDescriptor structure.
                boost::multi_index::member<
                    OptionDescriptor,
                    OptionPtr,
                    &OptionDescriptor::option_
                 >
            >
        >,
        // Start definition of index #2.
        // Use 'persistent' struct member as a key.
        boost::multi_index::hashed_non_unique<
            boost::multi_index::member<
                OptionDescriptor,
                bool,
                &OptionDescriptor::persistent_
            >
        >
    >
> OptionContainer;
 
typedef boost::shared_ptr<OptionContainer> OptionContainerPtr;
typedef OptionContainer::nth_index<1>::type OptionContainerTypeIndex;
typedef std::pair<OptionContainerTypeIndex::const_iterator,
                  OptionContainerTypeIndex::const_iterator> OptionContainerTypeRange;
typedef OptionContainer::nth_index<2>::type OptionContainerPersistIndex;
typedef std::pair<OptionContainerPersistIndex::const_iterator,
                  OptionContainerPersistIndex::const_iterator> OptionContainerPersistRange;
 
class CfgOption : public isc::data::CfgToElement {
public:
 
    CfgOption();
 
    bool empty() const;
 
 
 
    bool equals(const CfgOption& other) const;
 
    bool operator==(const CfgOption& other) const {
        return (equals(other));
    }
 
    bool operator!=(const CfgOption& other) const {
        return (!equals(other));
    }
 
 
    void add(const OptionPtr& option, const bool persistent,
             const std::string& option_space);
 
    void add(const OptionDescriptor& desc, const std::string& option_space);
 
    void mergeTo(CfgOption& other) const;
 
    void copyTo(CfgOption& other) const;
 
    void encapsulate();
 
    OptionContainerPtr getAll(const std::string& option_space) const;
 
    OptionContainerPtr getAll(const uint32_t vendor_id) const;
 
    template<typename Selector>
    OptionDescriptor get(const Selector& key,
                         const uint16_t option_code) const {
 
        // Check for presence of options.
        OptionContainerPtr options = getAll(key);
        if (!options || options->empty()) {
            return (OptionDescriptor(false));
        }
 
        // Some options present, locate the one we are interested in.
        const OptionContainerTypeIndex& idx = options->get<1>();
        OptionContainerTypeIndex::const_iterator od_itr = idx.find(option_code);
        if (od_itr == idx.end()) {
            return (OptionDescriptor(false));
        }
 
        return (*od_itr);
    }
 
    std::list<std::string> getOptionSpaceNames() const {
        return (options_.getOptionSpaceNames());
    }
 
    std::list<uint32_t> getVendorIds() const {
        return (vendor_options_.getOptionSpaceNames());
    }
 
    std::list<std::string> getVendorIdsSpaceNames() const;
 
    virtual isc::data::ElementPtr toElement() const;
 
private:
 
    void encapsulateInternal(const std::string& option_space);
 
    void encapsulateInternal(const OptionPtr& option);
 
    template <typename Selector>
    void mergeInternal(const OptionSpaceContainer<OptionContainer,
                       OptionDescriptor, Selector>& src_container,
                       OptionSpaceContainer<OptionContainer,
                       OptionDescriptor, Selector>& dest_container) const;
 
    typedef OptionSpaceContainer<OptionContainer, OptionDescriptor,
                                 std::string> OptionSpaceCollection;
    OptionSpaceCollection options_;
 
    typedef OptionSpaceContainer<OptionContainer, OptionDescriptor,
                                 uint32_t> VendorOptionSpaceCollection;
    VendorOptionSpaceCollection vendor_options_;
};
 
 
 
typedef boost::shared_ptr<CfgOption> CfgOptionPtr;
 
typedef boost::shared_ptr<const CfgOption> ConstCfgOptionPtr;
 
typedef std::list<ConstCfgOptionPtr> CfgOptionList;
 
 
}
}
 
#endif // CFG_OPTION_H