ucommon

TCPBuffer Class Reference

A generic tcp socket class that offers i/o buffering. More...

#include <buffer.h>

Inheritance diagram for TCPBuffer:
Collaboration diagram for TCPBuffer:

Public Member Functions

void close (void)
 Close active connection.
void open (const char *host, const char *service, size_t size=536)
 Connect a tcp client session to a specific host uri.
void open (const TCPServer *server, size_t size=536)
 Connect a tcp socket to a client from a listener.
 TCPBuffer (const TCPServer *server, size_t size=536)
 Construct a tcp server session from a listening socket.
 TCPBuffer ()
 Construct an unconnected tcp client and specify our service profile.
 TCPBuffer (const char *host, const char *service, size_t size=536)
 Construct a tcp client session connected to a specific host uri.
virtual ~TCPBuffer ()
 Destroy the tcp socket and release all resources.

Protected Member Functions

bool _blocking (void)
 Return true if blocking.
void _buffer (size_t size)
void _clear (void)
 Method to clear low level i/o error.
int _err (void) const
 Method to get low level i/o error.
virtual bool _pending (void)
 Check for pending tcp or ssl data.
virtual size_t _pull (char *address, size_t size)
 Method to pull buffer from physical i/o (read).
virtual size_t _push (const char *address, size_t size)
 Method to push buffer into physical i/o (write).
socket_t getsocket (void) const
 Get the low level socket object.

Detailed Description

A generic tcp socket class that offers i/o buffering.

All user i/o operations are directly inherited from the IOBuffer base class public members. Some additional members are added for layering ssl services.

Author:
David Sugar <dyfet@gnutelephony.org>

Definition at line 151 of file buffer.h.


Constructor & Destructor Documentation

TCPBuffer::TCPBuffer ( const TCPServer server,
size_t  size = 536 
)

Construct a tcp server session from a listening socket.

Parameters:
serversocket we are created from.
sizeof buffer and tcp fragments.
TCPBuffer::TCPBuffer ( const char *  host,
const char *  service,
size_t  size = 536 
)

Construct a tcp client session connected to a specific host uri.

Parameters:
hostand optional :port we are connecting to.
serviceidentifier of our client.
sizeof buffer and tcp fragments.

Member Function Documentation

int TCPBuffer::_err ( void  ) const [protected, virtual]

Method to get low level i/o error.

Returns:
error from low level i/o methods.

Implements BufferProtocol.

virtual bool TCPBuffer::_pending ( void  ) [protected, virtual]

Check for pending tcp or ssl data.

Returns:
true if data pending.

Reimplemented from BufferProtocol.

Reimplemented in SSLBuffer.

virtual size_t TCPBuffer::_pull ( char *  address,
size_t  size 
) [protected, virtual]

Method to pull buffer from physical i/o (read).

The address is passed to this virtual since it is hidden as private.

Parameters:
addressof buffer to pull data into.
sizeof buffer area being pulled..
Returns:
number of read written, 0 on error or end of data.

Implements BufferProtocol.

Reimplemented in SSLBuffer.

virtual size_t TCPBuffer::_push ( const char *  address,
size_t  size 
) [protected, virtual]

Method to push buffer into physical i/o (write).

The address is passed to this virtual since it is hidden as private.

Parameters:
addressof data to push.
sizeof data to push.
Returns:
number of bytes written, 0 on error.

Implements BufferProtocol.

Reimplemented in SSLBuffer.

socket_t TCPBuffer::getsocket ( void  ) const [inline, protected]

Get the low level socket object.

Returns:
socket we are using.

Definition at line 166 of file buffer.h.

void TCPBuffer::open ( const char *  host,
const char *  service,
size_t  size = 536 
)

Connect a tcp client session to a specific host uri.

If the socket was already connected, it is automatically closed first.

Parameters:
hostwe are connecting.
serviceto connect to.
sizeof buffer and tcp fragments.

Reimplemented in SSLBuffer.

void TCPBuffer::open ( const TCPServer server,
size_t  size = 536 
)

Connect a tcp socket to a client from a listener.

If the socket was already connected, it is automatically closed first.

Parameters:
serverwe are connected from.
sizeof buffer and tcp fragments.

The documentation for this class was generated from the following file: