// [License] // The Ariba-Underlay Copyright // // Copyright (c) 2008-2009, Institute of Telematics, Universität Karlsruhe (TH) // // Institute of Telematics // Universität Karlsruhe (TH) // Zirkel 2, 76128 Karlsruhe // Germany // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // 1. Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // 2. Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // THIS SOFTWARE IS PROVIDED BY THE INSTITUTE OF TELEMATICS ``AS IS'' AND // ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OF TELEMATICS OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // // The views and conclusions contained in the software and documentation // are those of the authors and should not be interpreted as representing // official policies, either expressed or implied, of the Institute of // Telematics. // [License] #ifndef SPOVNETPROPERTIES_H_ #define SPOVNETPROPERTIES_H_ #include #include #include using std::string; namespace ariba { // forward declaration class SpoVNetProperties; } #include "Identifiers.h" #include "Name.h" namespace ariba { /** * This class implements a container that holds all properties of a * SpoVNet instance. It may evolve with new features when new features * are introduced. * * @author Sebastian Mies */ class SpoVNetProperties { public: enum OverlayType { ONE_HOP_OVERLAY = 0, CHORD_OVERLAY = 1, KADEMLIA_OVERLAY = 2, }; private: Name name; SpoVNetID id; uint8_t type; uint16_t idLength; NodeID initiator; bool hidden; public: /** * This object holds the default settings for a newly created spovnet * instance. */ const static SpoVNetProperties DEFAULT; public: /** * Constructs a new default SpoVnet property object. */ SpoVNetProperties() { name = Name::random(); id = name.toSpoVNetId(); type = ONE_HOP_OVERLAY; idLength = 192; initiator = NodeID::UNSPECIFIED; hidden = false; } /** * Constructs a new SpoVnet property object. * * TODO: replace with setters! for downwards compatibility */ /* SpoVNetProperties(const Name& name, SpoVNetID id, OverlayType type, uint16_t idLength, const NodeID& initiator, bool hidden = false) : name(name), id(id), type(type), idLength(idLength), initiator(initiator), hidden(hidden) { }*/ /** * Copy constructor. */ SpoVNetProperties(const SpoVNetProperties& copy) { this->name = copy.name; this->id = copy.id; this->type = copy.type; this->idLength = copy.idLength; this->initiator = copy.initiator; this->hidden = copy.hidden; } /** * Destructor. */ ~SpoVNetProperties() { } /** * Returns the canonical SpoVNet name */ const Name& getName() const { return name; } /** * Returns the SpoVNet id */ const SpoVNetID& getId() const { return id; } /** * Returns the node id of the initiator of the spovnet. * If the node id is unspecified, the initiator wanted to be anonymous. */ const NodeID& getInitiator() const { return initiator; } /** * Returns the node identifier length in bites */ uint16_t getIdentifierLength() const { return idLength; } /** * Returns the overlay type. */ const OverlayType getBaseOverlayType() const { return (OverlayType)type; } /** * Returns true, if the spovnet is hidden */ bool isHidden() const { return hidden; } /** * Returns a human readable string representation of the SpoVNet properties * * @return A human readable string representation of the SpoVNet properties */ std::string toString() const { std::ostringstream buf; buf << "spovnet" << " name=" << name.toString() << " id=" << id.toString() << " base_overlay_type=" << type << " id_length=" << idLength << " initiator=" << initiator << " hidden=" << hidden; return buf.str(); } }; } #endif /* SPOVNETPROPERTIES_H_ */