/Desktop/MGS-MultithreadedGameServer/Game.h

Vai alla documentazione di questo file.

//
// File: Game.h
// Created by: <Detro /> aka Ivan De Marino 
// <detro@mandolinux.org, demarino@studenti.unina.it, demarino@na.astro.it>
// Created on: Sun Oct 24 18:47:49 2004
//

#ifndef _GAME_H_
#define _GAME_H_

#include <cc++/thread.h>
#include "Player.h"

#ifdef  CCXX_NAMESPACES
using namespace std;
using namespace ost;
#endif

/**
 * @interface Game Game.h
 * Game per MGS.
 * Questa <b>Classe Astratta</b> e' un'<b>Interfaccia</b> che
 * bisogna <i>implementare</i> per creare un nuovo Game su MGS.<br>
 * E' sufficientemente astratta da poter implementare non solo 
 * Giochi (come vederemo con la classe <code>ChatRoom</code>), ma
 * ogni tipo di Attivita' che si basi sul semplice scambio
 * di messaggi alfanumerici (es. Scacchi, Dama, Giochi di Carte,...). <br>
 * E' un @c Thread, quindi un flusso di controllo a se stante. */
class Game : public Thread {
   public:
      /** Inizializzazione del @c Game */
      virtual void init(void) = 0;
      /** Attivazione del @c Game */
      virtual void run(void) = 0;
      /** Gestione della Chiusura del @c Game */
      virtual void final(void) = 0;
      
      /** 
       * Aggiungi un <code>Player</code> al <code>Game</code>.
       *
       * @param Player* Puntatore al Player da aggiungere al Gioco */
      virtual void addPlayer (Player *) = 0;
      
      /** 
       * Rimuovi un <code>Player</code> dal <code>Game</code>.
       * @param string& Stringa contenente il Nick/Nome del Player da Rimuovere
       * @return @c true se il Player viene trovato e rimosso, 
       *    @c false altrimenti */
      virtual bool delPlayer (const string &) = 0;
      
      /** 
       * Ritorna il numero di Player presenti 
       * @return Ritorna il numero di Player presenti nel Game */
      virtual int getNumPlayers (void) const = 0;
      
      /** 
       * Stampa la lista di Player presenti
       * @param iostream* Input-Output-Stream su cui dirigere l'output */
      virtual void printPlayersList(iostream *) = 0;
   
      /** 
       * Ritorna il nome del Game 
       * @return Ritorna il Nome del Game */
      virtual string getName(void) const = 0;
};

#endif   //_GAME_H_

---