Each DClient manages a single TCP connection. It sends and receives data, and can connect to servers. DClient takes a DEngine in its constructor, which dispatches the DClient's events. Details on event handling can be found in the Event Handling section. See the SimpleClient sample program for an example.
The default constructor, used when the DClient will be connecting to a server. engine is a pointer to the DEngine that will handle our events.
Same as above, but allows us to set the size of the DClient's send and receive buffers to bufferSize bytes. Larger buffer sizes can result in better efficiency. The default size is 16 kilobytes, which is already quite large for most networks.
This constructor should be used in DServer's connectHandler function. newSocket is a connection that was accepted by the DServer, and will be used by the created DClient.
Same as above, but allows us to set the size of the DClient's send and receive buffers to bufferSize bytes. Larger buffer sizes can result in better efficiency. The default size is 16 kilobytes, which is already quite large for most networks.
Closes the DClient's socket. Returns false on errors and sets errMsg. closeSocket is automatically called by the destructor.
Returns the size of the send and receive buffers in bytes.
Returns a description of the most recent error.
Returns this DClient's local address. Returns an empty string if an error occurred, and sets errMsg with a description of the problem.
Returns the address of the host this DClient is connected to. Returns an empty string if an error occurred, and sets errMsg with a description of the problem.
Returns true if this DClient is currently connected, false otherwise.
Sends theData to the remote host. sendHandler is called when all data is sent.
Enables or disables Nagle's algorithm. By default, Nagle's algorithm is active. If many small pieces of data are sent in a short time period, they're bundled together and sent in the same TCP packet. This improves efficiency, as each TCP packet has an overhead of 40 bytes or more. However, Nagle's algorithm increases latency as the data isn't sent immediately, as it's buffered in case it can be combined with another message.
If enabled is false, then Nagle's Algorithm will be disabled, and the send function will send the data immediately. setDelay returns false if it couldn't change the socket settings, and sets errMsg.
Causes the DClient to connect to the server at the specified hostName, which can be an IP address or domain name. portNumber is the TCP port the server is listening on. ipVersion should be set to either DA_IPV4 or DA_IPV6.
connectHandler will be called when the connection either fails or completes. It has the following method signature: void connectHandler(string errorDesc, NetworkCode status) The NetworkCode is an enumeration that will be set to one of the following values:
The string is an error description that will be set if the connection attempt failed.
Returns the number of bytes remaining to be sent.
Set the event handler that's called in response to a socket error. The string contains a description of the problem. If the bool is false, the connection is no longer valid and the socket should be closed. Otherwise, it should be possible to recover from the error.
Set the event handler that's called when data is received from the network. The DBuffer contains the data.
Set the event handler that's called when the DClient has sent all pending data.