Template per la classe TFactory< T >

#include <TFactory.h>

Diagramma di collaborazione per TFactory< T >:

[legenda]Lista di tutti i membri.

---

Descrizione Dettagliata

template<class T>
class TFactory< T >

Questa Classe Template ha il compito di Istanziare a Run-Time Classi la cui Dichiarazione e Definizione non e' avvenuta a Compile-Time.

In sostanza, si parla di realizzare un sistema per la gestione di quelli che, in gergo, si chiamano Plug-In: mini-programmi che si aggiungono ad altri piu' grandi per aumentarne le funzionalita'.

E' una "Factory" di Classi Plug-In.
Carica da libreria SO la definizione di una Classe che ha come Classe di Base il Parametro passato alla Factory: in questo modo e' sufficiente, per realizzare classi Plug-In, che le Classi da Istanziare a Run-Time implementino un'interfaccia comune.

Per la precisione, e' anche necessario che nella libreria SO che contiene la classe sia presente una funzione così definita:

extern "C"
*buildObject(void) { return new ; }


buildObject(void) crea effettivamente una istanza della Classe Plug-In.

Questa soluzione permette quindi di caricare nuove Classi senza bisogno ne di ricompilare, ne di modificare il codice.

Definizione alla linea 40 del file TFactory.h.

Membri pubblici
	TFactory (const string &)
	Costruttore TFactory.
	~TFactory ()
	Distruttore TFactory.
T	build ()
	Restituisce una istanza della Classe contenuta nella SO.
void	closeSo ()
	Chiude la libreria SO.
Membri privati
void	openSo (const string &)
	Carica la libreria SO.
Attributi privati
void *	handler
T(*	builder )(void)

---

Documentazione dei costruttori e dei distruttori

template<class T> TFactory< T >::TFactory (  const string &  soLibPath  )

Costruttore TFactory. Si occupa anche di recuperare i Simboli ("buildObject" ) necessari all'istanziazione di una nuova T Class. Parametri: soLibPath  Path alla Libreria SO da dove caricare la definizione della Classe Definizione alla linea 64 del file TFactory.h. Riferimenti TFactory< T >::builder, TFactory< T >::handler, e TFactory< T >::openSo(). { try { /* Caricamento della SO */ openSo(soLibPath); /* Casting necessario per una corretta assegnazione * della funzione al relativo puntatore */ *(void **) (&builder) = dlsym(handler, "buildObject"); /* Controlla che il Simbolo Cercato ("buildObject") sia * stato trovato... */ if ( builder == NULL ) { // Errore nel caricamento della funzione /* ...in caso negativo, lancia un TFactoryException */ string exceptionMessage("<TFactory msg> ERROR: "); exceptionMessage += dlerror(); throw TFactoryException(exceptionMessage); } } catch ( TFactoryException &e ) { throw e; } cout << "<TFactory msg> Plug-In Loaded. Library-Path: "<< soLibPath << endl; }

Questo è il grafo delle chiamate per questa funzione:

template<class T> TFactory< T >::~TFactory (   )

Distruttore TFactory. Definizione alla linea 88 del file TFactory.h. {}

---

Documentazione delle funzioni membro

template<class T> T TFactory< T >::build (   )

Restituisce una istanza della Classe contenuta nella SO. L'oggetto restituito e' UP-Castato alla Classe Base "T" (parametro del Template) Restituisce: Una nuova istanza di T (T = Parametro di TFactory) Definizione alla linea 96 del file TFactory.h. Referenziato da Server::loadPlugInGames(). { return ( (*builder)() ); // Ritorna la nuova istanza di T }

template<class T> void TFactory< T >::closeSo (   )

Chiude la libreria SO. Definizione alla linea 118 del file TFactory.h. Riferimenti TFactory< T >::handler. { if (handler) { dlclose(handler); handler = NULL; } }

template<class T> void TFactory< T >::openSo (  const string &  soLibPath  )  [private]

Carica la libreria SO. Parametri: soLibPath  Libreria SO da caricare Definizione alla linea 105 del file TFactory.h. Riferimenti TFactory< T >::handler. Referenziato da TFactory< T >::TFactory(). { /* Apertura della Libreria SO */ handler = dlopen( soLibPath.data(), RTLD_NOW); if (!handler) { string exceptionMessage("<TFactory msg> ERROR: "); exceptionMessage += dlerror(); throw TFactoryException(exceptionMessage); } }

---

Documentazione dei dati membri

template<class T> T(* TFactory< T >::builder)(void) [private]

Referenziato da TFactory< T >::TFactory().

template<class T> void* TFactory< T >::handler [private]

Definizione alla linea 49 del file TFactory.h. Referenziato da TFactory< T >::closeSo(), TFactory< T >::openSo(), e TFactory< T >::TFactory().

---

La documentazione per questa classe è stata generata a partire dal seguente file:

• /Desktop/MGS-MultithreadedGameServer/TFactory.h

---