17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
#import "OFStream.h"
#import "socket.h"
OF_ASSUME_NONNULL_BEGIN
/*!
* @class OFStreamSocket OFStreamSocket.h ObjFW/OFStreamSocket.h
*
* @brief A class which provides methods to create and use stream sockets.
*/
@interface OFStreamSocket: OFStream <OFReadyForReadingObserving,
OFReadyForWritingObserving>
{
of_socket_t _socket;
bool _atEndOfStream;
OF_RESERVE_IVARS(4)
}
/*!
* @brief Returns a new, autoreleased OFTCPSocket.
*
* @return A new, autoreleased OFTCPSocket
*/
+ (instancetype)socket;
@end
OF_ASSUME_NONNULL_END
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
#import "OFStream.h"
#import "socket.h"
OF_ASSUME_NONNULL_BEGIN
/*! @file */
@class OFStreamSocket;
#ifdef OF_HAVE_BLOCKS
/*!
* @brief A block which is called when the socket accepted a connection.
*
* @param socket The socket which accepted the connection
* @param acceptedSocket The socket which has been accepted
* @param exception An exception which occurred while accepting the socket or
* `nil` on success
* @return A bool whether the same block should be used for the next incoming
* connection
*/
typedef bool (^of_stream_socket_async_accept_block_t)(OFStreamSocket *socket,
OFStreamSocket *acceptedSocket, id _Nullable exception);
#endif
/*!
* @protocol OFStreamSocketDelegate OFStreamSocket.h ObjFW/OFStreamSocket.h
*
* A delegate for OFStreamSocket.
*/
@protocol OFStreamSocketDelegate <OFStreamDelegate>
@optional
/*!
* @brief A method which is called when a socket accepted a connection.
*
* @param socket The socket which accepted the connection
* @param acceptedSocket The socket which has been accepted
* @param exception An exception that occurred while accepting, or nil on
* success
* @return A bool whether to accept the next incoming connection
*/
- (bool)socket: (OFStreamSocket *)socket
didAcceptSocket: (OFStreamSocket *)acceptedSocket
exception: (nullable id)exception;
@end
/*!
* @class OFStreamSocket OFStreamSocket.h ObjFW/OFStreamSocket.h
*
* @brief A class which provides methods to create and use stream sockets.
*/
@interface OFStreamSocket: OFStream <OFReadyForReadingObserving,
OFReadyForWritingObserving>
{
of_socket_t _socket;
bool _atEndOfStream, _listening;
of_socket_address_t _remoteAddress;
OF_RESERVE_IVARS(4)
}
/*!
* @brief Whether the socket is a listening socket.
*/
@property (readonly, nonatomic, getter=isListening) bool listening;
/*!
* @brief The remote address.
*
* @note This only works for accepted sockets!
*/
@property (readonly, nonatomic) const of_socket_address_t *remoteAddress;
/*!
* @brief The delegate for asynchronous operations on the socket.
*
* @note The delegate is retained for as long as asynchronous operations are
* still ongoing.
*/
@property OF_NULLABLE_PROPERTY (assign, nonatomic)
id <OFStreamSocketDelegate> delegate;
/*!
* @brief Returns a new, autoreleased OFStreamSocket.
*
* @return A new, autoreleased OFStreamSocket
*/
+ (instancetype)socket;
/*!
* @brief Listen on the socket.
*
* @param backlog Maximum length for the queue of pending connections.
*/
- (void)listenWithBacklog: (int)backlog;
/*!
* @brief Listen on the socket.
*/
- (void)listen;
/*!
* @brief Accept an incoming connection.
*
* @return An autoreleased OFStreamSocket for the accepted connection.
*/
- (instancetype)accept;
/*!
* @brief Asynchronously accept an incoming connection.
*/
- (void)asyncAccept;
/*!
* @brief Asynchronously accept an incoming connection.
*
* @param runLoopMode The run loop mode in which to perform the async accept
*/
- (void)asyncAcceptWithRunLoopMode: (of_run_loop_mode_t)runLoopMode;
#ifdef OF_HAVE_BLOCKS
/*!
* @brief Asynchronously accept an incoming connection.
*
* @param block The block to execute when a new connection has been accepted.
* Returns whether the next incoming connection should be accepted
* by the specified block as well.
*/
- (void)asyncAcceptWithBlock: (of_stream_socket_async_accept_block_t)block;
/*!
* @brief Asynchronously accept an incoming connection.
*
* @param runLoopMode The run loop mode in which to perform the async accept
* @param block The block to execute when a new connection has been accepted.
* Returns whether the next incoming connection should be accepted
* by the specified block as well.
*/
- (void)asyncAcceptWithRunLoopMode: (of_run_loop_mode_t)runLoopMode
block: (of_stream_socket_async_accept_block_t)
block;
#endif
@end
OF_ASSUME_NONNULL_END
|