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
  58 namespace simgear
  59 {
  60
  61 class NetChannel : public Socket
  62 {
  63   bool closed, connected, accepting, write_blocked, should_delete ;
  64   NetChannel* next_channel ;
  65
  66   friend bool netPoll (unsigned int timeout);
  67
  68 public:
  69
  70   NetChannel () ;
  71   virtual ~NetChannel () ;
  72
  73   void setHandle (int s, bool is_connected = true);
  74   bool isConnected () const { return connected; }
  75   bool isClosed () const { return closed; }
  76   void shouldDelete () { should_delete = true ; }
  77
  78   // --------------------------------------------------
  79   // socket methods
  80   // --------------------------------------------------
  81
  82   bool  open    ( void ) ;
  83   void  close   ( void ) ;
  84   int   listen  ( int backlog ) ;
  85   int   connect ( const char* host, int port ) ;
  86   int   send    ( const void * buf, int size, int flags = 0 ) ;
  87   int   recv    ( void * buf, int size, int flags = 0 ) ;
  88
  89   // poll() eligibility predicates
  90   virtual bool readable (void) { return (connected || accepting); }
  91   virtual bool writable (void) { return (!connected || write_blocked); }
  92
  93   // --------------------------------------------------
  94   // event handlers
  95   // --------------------------------------------------
  96
  97   void handleReadEvent (void);
  98   void handleWriteEvent (void);
  99
 100 // These are meant to be overridden.
 101   virtual void handleClose (void) {
 102   }
 103
 104   virtual void handleRead (void);
 105   virtual void handleWrite (void);
 106   virtual void handleAccept (void);
 107   virtual void handleError (int error);
 108
 109   static bool poll (unsigned int timeout = 0 ) ;
 110   static void loop (unsigned int timeout = 0 ) ;
 111 };
 112
 113 } // of namespace simgear
 114
 115 #endif // SG_NET_CHANNEL_H