An Overlay-based
Virtual Network Substrate
SpoVNet

source: source/ariba/AribaModule.h @ 3037

Last change on this file since 3037 was 3037, checked in by Christoph Mayer, 15 years ago

-jede Menge fixes und Umstellungen
-angefangen ariba/interface los zu werden, erste dateien sind weg

File size: 5.5 KB
Line 
1// [License]
2// The Ariba-Underlay Copyright
3//
4// Copyright (c) 2008-2009, Institute of Telematics, UniversitÀt Karlsruhe (TH)
5//
6// Institute of Telematics
7// UniversitÀt Karlsruhe (TH)
8// Zirkel 2, 76128 Karlsruhe
9// Germany
10//
11// Redistribution and use in source and binary forms, with or without
12// modification, are permitted provided that the following conditions are
13// met:
14//
15// 1. Redistributions of source code must retain the above copyright
16// notice, this list of conditions and the following disclaimer.
17// 2. Redistributions in binary form must reproduce the above copyright
18// notice, this list of conditions and the following disclaimer in the
19// documentation and/or other materials provided with the distribution.
20//
21// THIS SOFTWARE IS PROVIDED BY THE INSTITUTE OF TELEMATICS ``AS IS'' AND
22// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ARIBA PROJECT OR
25// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
27// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
28// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
29// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
30// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
31// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32//
33// The views and conclusions contained in the software and documentation
34// are those of the authors and should not be interpreted as representing
35// official policies, either expressed or implied, of the Institute of
36// Telematics.
37// [License]
38
39#ifndef ARIBAMODULE_H_
40#define ARIBAMODULE_H_
41
42#include <string>
43#include <vector>
44#include <boost/foreach.hpp>
45
46// usings
47using std::vector;
48using std::string;
49
50// forward declaration
51namespace ariba {
52class AribaModule;
53}
54
55// local includes
56#include "Name.h"
57#include "Module.h"
58
59namespace ariba {
60
61// forward declarations of old interface
62namespace communication {
63class EndpointDescriptor;
64class NetworkLocator;
65}
66namespace communication {
67class BaseCommunication;
68}
69
70/**
71 * This class implements a container class for ariba base services. Each node
72 * is a running using this base-module. It also manages Bootstrap information
73 * in a abstract simple way.
74 *
75 *        +---+   +---+
76 *        |N1 |   |N2 |
77 *     +--|   |---|   |--+
78 *     |  +---+   +---+  |
79 *     |                 |
80 *     |     AribaModule |
81 *     +-----------------+
82 *
83 * N1, N2 are nodes.
84 *
85 * @author Sebastian Mies <mies@tm.uka.de>
86 */
87class AribaModule: public Module {
88        friend class Node;
89public:
90        /**
91         * Constructor of the ariba underlay module
92         */
93        AribaModule();
94
95        /**
96         * Destructor of the ariba underlay module
97         */
98        virtual ~AribaModule();
99
100        /**
101         * Returns all known bootstrap endpoints to this ariba module in
102         * a human-readable string. This information can be used by other
103         * nodes for bootstraping. It may also be used to publish this info
104         * to other nodes via the web, for example.
105         *
106         * @param The name of the spovnet
107         * @return A human-readable string containing all known bootstrap
108         *   information known to this module.
109         */
110        string getBootstrapHints(const Name& spoVNetName = Name::UNSPECIFIED) const;
111
112        /**
113         * Adds bootstrap hints to the local database. The format of the string
114         * must is the same as returned by <code>getBootstrapInfo</code>.
115         *
116         * @param bootinfo A string containing bootstrap information.
117         */
118        void addBootstrapHints(string bootinfo);
119
120        // --- module implementation ---
121
122        /**
123         * Module Property information:
124         *
125         * ip.addr  = preferred ip address (otherwise bind to all)
126         * tcp.port = preferred tcp port (or use default value)
127         * udp.port = preferred udp port (or use default value)
128         * bootstrap.hints = used bootstrap hints
129         * bootstrap.file  = used file for bootstrap information
130         */
131        void initialize(); ///< @see Module.h
132        void start(); ///< @see Module.h
133        void stop(); ///< @see Module.h
134        string getName() const; ///< @see Module.h
135        void setProperty(string key, string value); ///< @see Module.h
136        const string getProperty(string key) const; ///< @see Module.h
137        const vector<string> getProperties() const; ///< @see Module.h
138
139private:
140        // bootstrap node
141        class BootstrapNode {
142        public:
143                inline BootstrapNode() :
144                        timestamp(0), desc(NULL) {
145
146                }
147                inline BootstrapNode(const BootstrapNode& copy) :
148                        timestamp(copy.timestamp), desc(copy.desc) {
149                }
150                inline BootstrapNode(uint32_t timestamp,
151                                communication::EndpointDescriptor* desc) :
152                        timestamp(timestamp), desc(desc) {
153                }
154                uint32_t timestamp;
155                communication::EndpointDescriptor* desc;
156        };
157
158        // bootstrap info
159        class BootstrapInfo {
160        public:
161                BootstrapInfo() :
162                        spovnetName(), nodes() {
163
164                }
165
166                BootstrapInfo(const BootstrapInfo& copy) :
167                        spovnetName(copy.spovnetName), nodes(copy.nodes) {
168
169                }
170
171                Name spovnetName;
172                vector<BootstrapNode> nodes;
173        };
174        vector<BootstrapInfo> bootstrapNodes;
175
176protected:
177        // members
178        string bootstrapFile; //< file with bootstrap information
179        bool started; //< flag, if module has been started
180
181        // bootstrap node management
182        void addBootstrapNode(const Name& spovnet,
183                        communication::EndpointDescriptor* desc);
184        const communication::EndpointDescriptor* getBootstrapNode(
185                        const Name& spovnet) const;
186
187        communication::BaseCommunication* base_comm;
188
189        // TODO: use "abstract" representations here!
190        communication::NetworkLocator* ip_addr;
191        uint16_t tcp_port, udp_port;
192};
193
194} // namespace ariba
195
196#endif /* ENVIRONMENT_H_ */
Note: See TracBrowser for help on using the repository browser.