separator.h

clustering for ns-2 simulation

/**
 * Copyright (c) 2006 Michele Mastrogiovanni.
 *
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 *
 */
 
#ifndef _SEPARATOR_UTILITY_H_
#define _SEPARATOR_UTILITY_H_

#include <map>
#include <vector>
#include <iostream>

#include "packet.h"
#include "ClusteringModule.h"

//
// Questa classe permette la giustapposizione di due algoritmi
// modulari.
//
// Questa classe necessita la registrazione di un certo
// insieme di nodi e dei differenti algoritmi dello stack
// di cui loro sono responsabili.
//
// Avviando questa classe vengono avviati gli algoritmi di
// livello più basso di ogni nodo simultaneamente.
// Ogni qualvolta uno degli algoritmi termina lo segnala
// alla classe che gestisce il sistema.
//
// Non appena ogni nodo registrato in origine ha terminato
// la propria procedura, vengono avviati simultaneamente i
// livelli superiori di tutti i nodi.
//
// Per la registrazione devono essere registrati i nodi in
// ordine: prima tutti quelli con il primo livello, poi tutti
// i nodi (li stessi) i loro secondi livelli e così via.
//

class Separator : public TclObject {

	public:

		// Parsing dei comandi.
        virtual int command(int argc, const char * const * argv);
        virtual void recv(Packet *p, Handler *h);
        virtual void recv(Packet *p, const char * h) { recv(p, (Handler*)NULL); }
		
		// Segnala che il modulo corrente di un nodo è terminato.
		void endCurrentModule(NodeAddress node);
		
		Separator();
		
		static Separator & instance() {
			return (*instance_);
		}
		
		int getIndexCurrentModule();
		
	protected:
	
		static Separator * instance_;
	
		// Lancia il modulo successivo:
		void startModule();
	
		// Registra un nuovo layer per un nodo.
		void registerNode(NodeAddress node, ClusteringModule * module);

		// Mappa dei moduli.
		map<NodeAddress, vector<ClusteringModule *> > modules;

		// Indice del modulo corrente.
		int indexCurrentModule;

		// Nodi che hanno terminato il livello corrente.
		set<NodeAddress> endedNodes;
};

#endif