simgear/io/sg_netChannel.hxx

   1 /*
   2     NetChannel -  copied from PLIB
   3
   4      PLIB - A Suite of Portable Game Libraries
   5      Copyright (C) 1998,2002  Steve Baker
   6
   7      This library is free software; you can redistribute it and/or
   8      modify it under the terms of the GNU Library General Public
   9      License as published by the Free Software Foundation; either
  10      version 2 of the License, or (at your option) any later version.
  11
  12      This library is distributed in the hope that it will be useful,
  13      but WITHOUT ANY WARRANTY; without even the implied warranty of
  14      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15      Library General Public License for more details.
  16
  17      You should have received a copy of the GNU Library General Public
  18      License along with this library; if not, write to the Free Software
  19      Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  20
  21      For further information visit http://plib.sourceforge.net
  22
  23      $Id: netChannel.h 1899 2004-03-21 17:41:07Z sjbaker $
  24 */
  25
  26 /****
  27 * NAME
  28 *   netChannel - network channel class
  29 *
  30 * DESCRIPTION
  31 *   netChannel is adds event-handling to the low-level
  32 *   netSocket class.  Otherwise, it can be treated as
  33 *   a normal non-blocking socket object.
  34 *
  35 *   The direct interface between the netPoll() loop and
  36 *   the channel object are the handleReadEvent and
  37 *   handleWriteEvent methods. These are called
  38 *   whenever a channel object 'fires' that event.
  39 *
  40 *   The firing of these low-level events can tell us whether
  41 *   certain higher-level events have taken place, depending on
  42 *   the timing and state of the connection.
  43 *
  44 * AUTHORS
  45 *   Sam Rushing <rushing@nightmare.com> - original version for Medusa
  46 *   Dave McClurg <dpm@efn.org> - modified for use in PLIB
  47 *
  48 * CREATION DATE
  49 *   Dec-2000
  50 *
  51 ****/
  52
  53 #ifndef SG_NET_CHANNEL_H
  54 #define SG_NET_CHANNEL_H
  55
  56 #include <simgear/io/raw_socket.hxx>
  57 #include <string>
  58
  59 namespace simgear
  60 {
  61
  62 class NetChannel : public Socket
  63 {
  64   bool closed, connected, accepting, write_blocked, should_delete, resolving_host ;
  65   NetChannel* next_channel ;
  66   std::string host;
  67   int port;
  68
  69   friend bool netPoll (unsigned int timeout);
  70
  71 public:
  72
  73   NetChannel () ;
  74   virtual ~NetChannel () ;
  75
  76   void setHandle (int s, bool is_connected = true);
  77   bool isConnected () const { return connected; }
  78   bool isClosed () const { return closed; }
  79   void shouldDelete () { should_delete = true ; }
  80
  81   // --------------------------------------------------
  82   // socket methods
  83   // --------------------------------------------------
  84
  85   bool  open    ( void ) ;
  86   void  close   ( void ) ;
  87   int   listen  ( int backlog ) ;
  88   int   connect ( const char* host, int port ) ;
  89   int   send    ( const void * buf, int size, int flags = 0 ) ;
  90   int   recv    ( void * buf, int size, int flags = 0 ) ;
  91
  92   // poll() eligibility predicates
  93   virtual bool readable (void) { return (connected || accepting); }
  94   virtual bool writable (void) { return (!connected || write_blocked); }
  95
  96   // --------------------------------------------------
  97   // event handlers
  98   // --------------------------------------------------
  99
 100   void handleReadEvent (void);
 101   void handleWriteEvent (void);
 102   int handleResolve (void);
 103
 104 // These are meant to be overridden.
 105   virtual void handleClose (void) {
 106   }
 107
 108   virtual void handleRead (void);
 109   virtual void handleWrite (void);
 110   virtual void handleAccept (void);
 111   virtual void handleError (int error);
 112
 113   static bool poll (unsigned int timeout = 0 ) ;
 114   static void loop (unsigned int timeout = 0 ) ;
 115 };
 116
 117 } // of namespace simgear
 118
 119 #endif // SG_NET_CHANNEL_H