3 * Copyright (c) 2013, Blue Static <http://www.bluestatic.org>
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.
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.
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
17 #import <Foundation/Foundation.h>
19 #import "BSProtocolThreadInvoker.h"
21 @protocol MessageQueueDelegate
;
23 // MessageQueue operates a listening socket, that is connected to another
24 // program with which it exchanges UTF8 string messages. A message contains two
25 // parts, both terminated by '\0'. The first is an ASCII integer number that is
26 // the length of the second part. The second part is the actual string message.
27 @interface MessageQueue
: NSObject
{
29 // The port number on which to open a listening socket.
32 // The thread and its run loop on which this class primarily operates.
36 // Whether or not the message queue is connected to a client.
39 // A queue of messages that are waiting to be sent.
40 NSMutableArray
* _queue
;
42 // The delegate for this class.
43 BSProtocolThreadInvoker
<MessageQueueDelegate
>* _delegate
;
45 // The socket that listens for new incoming connections.
48 // The child socket that has been accepted from |_socket|.
49 CFSocketNativeHandle _child
;
51 // The read and write streams that are created on the |_child| socket.
52 CFReadStreamRef _readStream
;
53 CFWriteStreamRef _writeStream
;
55 // When a message is being read, this temporary buffer is used to build up
56 // the complete message from successive reads.
57 NSMutableString
* _message
;
58 NSUInteger _totalMessageSize
;
59 NSUInteger _messageSize
;
62 // Creates a new MessasgeQueue that will listen on |port| and report information
64 - (id
)initWithPort
:(NSUInteger
)port delegate
:(id
<MessageQueueDelegate
>)delegate
;
66 // Whether or not the message queue has attached itself to a child.
69 // Opens a socket that will listen for connections.
72 // Closes either the listening or child socket and completely disconnects.
75 // Enqueues a |message| to be sent to the client. This may be called from any
77 - (void)sendMessage
:(NSString
*)message
;
81 // Delegate ////////////////////////////////////////////////////////////////////
83 // The delegate for the message queue. These methods are called from the thread
84 // on which the MessageQueue was initialized.
85 @protocol MessageQueueDelegate
<NSObject
>
86 // Callback for any errors that the MessageQueue encounters.
87 - (void)messageQueue
:(MessageQueue
*)queue error
:(NSError
*)error
;
89 // Called when the listening socket has accepted a child socket.
90 - (void)messageQueueDidConnect
:(MessageQueue
*)queue
;
92 // Called when the child socket has been disconnected.
93 - (void)messageQueueDidDisconnect
:(MessageQueue
*)queue
;
95 // Callback for when a message has been sent.
96 - (void)messageQueue
:(MessageQueue
*)queue didSendMessage
:(NSString
*)message
;
98 // Callback with the message content when one has been receieved.
99 - (void)messageQueue
:(MessageQueue
*)queue didReceiveMessage
:(NSString
*)message
;