Source/NetworkCallbackController.h

   1 /*
   2  * MacGDBp
   3  * Copyright (c) 2007 - 2011, Blue Static <http://www.bluestatic.org>
   4  *
   5  * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
   6  * General Public License as published by the Free Software Foundation; either version 2 of the
   7  * License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
  10  * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11  * General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along with this program; if not,
  14  * write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
  15  */
  16
  17 #import <CoreFoundation/CoreFoundation.h>
  18 #import <Foundation/Foundation.h>
  19
  20 @class NetworkConnection;
  21
  22 // This class is used for the CFNetwork callbacks. It is a private class and
  23 // the instance is owned by the NewtorkConnection instance. This class can be
  24 // considered an extension of NetworkConnection.
  25 class NetworkCallbackController
  26 {
  27  public:
  28   // This object should be constructed on the thread which the streams are
  29   // to be scheduled on. It will hold a weak reference to the run loop on that
  30   // thread.
  31   explicit NetworkCallbackController(NetworkConnection* connection);
  32
  33   // Creates a socket and schedules it on the current run loop.
  34   void OpenConnection(NSUInteger port);
  35
  36   // Closes down the read/write streams.
  37   void CloseConnection();
  38
  39  private:
  40   // These static methods forward an invocation to the instance methods. The
  41   // last void pointer, named |self|, is the instance of this class.
  42   static void SocketAcceptCallback(CFSocketRef socket,
  43                                    CFSocketCallBackType callbackType,
  44                                    CFDataRef address,
  45                                    const void* data,
  46                                    void* self);
  47   static void ReadStreamCallback(CFReadStreamRef stream,
  48                                  CFStreamEventType eventType,
  49                                  void* self);
  50   static void WriteStreamCallback(CFWriteStreamRef stream,
  51                                   CFStreamEventType eventType,
  52                                   void* self);
  53
  54   void OnSocketAccept(CFSocketRef socket,
  55                       CFDataRef address,
  56                       const void* data);
  57   void OnReadStreamEvent(CFReadStreamRef stream, CFStreamEventType eventType);
  58   void OnWriteStreamEvent(CFWriteStreamRef stream, CFStreamEventType eventType);
  59
  60   // Removes the read or write stream from the run loop, closes the stream,
  61   // releases the reference.
  62   void UnscheduleReadStream();
  63   void UnscheduleWriteStream();
  64
  65   // Messages the NetworkConnection's delegate and takes ownership of |error|.
  66   void ReportError(CFErrorRef error);
  67
  68   // The actual socket.
  69   CFSocketRef socket_;  // Strong.
  70
  71   NetworkConnection* connection_;  // Weak, owns this.
  72   CFRunLoopRef runLoop_;  // Weak.
  73 };
  74