---

TCPSession Class Reference

The TCP session is used to primarily to represent a client connection that can be managed on a seperate thread. Threaded streamable socket with non-blocking constructor. More...

#include <socket.h>

Inheritance diagram for TCPSession::

List of all members.

Public Methods
	TCPSession (const InetHostAddress &host, tpport_t port, int size=512, int pri=0, int stack=0)
	Create a TCP socket that will be connected to a remote TCP server and that will execute under it's own thread. More...
	TCPSession (TCPSocket &server, int size=512, int pri=0, int stack=0)
	Create a TCP socket from a bound TCP server by accepting a pending connection from that server and execute a thread for the accepted connection. More...
Protected Methods
int	WaitConnection (timeout_t timeout=TIMEOUT_INF)
	Normally called during the thread Initial() method by default, this will wait for the socket connection to complete when connecting to a remote socket. More...
	CCXX_MEMBER (void) Initial(void)
	The initial method is used to esablish a connection when delayed completion is used. More...
	CCXX_MEMBER (void) Final(void)
	TCPSession derived objects can be freely created with "new" and safely terminate their "Run" method on their own by self-deleting when the thread terminates. More...

---

Detailed Description

The TCP session is used to primarily to represent a client connection that can be managed on a seperate thread. Threaded streamable socket with non-blocking constructor.

The TCP session also supports a non-blocking connection scheme which prevents blocking during the constructor and moving the process of completing a connection into the thread that executes for the session.

Author:

David Sugar <dyfet@ostel.com>

---

Constructor & Destructor Documentation

TCPSession::TCPSession (  const InetHostAddress &   host, tpport_t   port, int   size = 512, int   pri = 0, int   stack = 0 )

Create a TCP socket that will be connected to a remote TCP server and that will execute under it's own thread. Parameters: host   internet address of remote TCP server. port   number of remote server. size   of streaming buffer. pri   execution priority relative to parent. stack   allocation needed on some platforms.

TCPSession::TCPSession (  TCPSocket &   server, int   size = 512, int   pri = 0, int   stack = 0 )

Create a TCP socket from a bound TCP server by accepting a pending connection from that server and execute a thread for the accepted connection. Parameters: server   tcp socket to accept a connection from. size   of streaming buffer. pri   execution priority relative to parent. stack   allocation needed on some platforms.

---

Member Function Documentation

TCPSession::CCXX_MEMBER (  void   )  [inline, protected]

TCPSession derived objects can be freely created with "new" and safely terminate their "Run" method on their own by self-deleting when the thread terminates.

TCPSession::CCXX_MEMBER (  void   )  [protected]

The initial method is used to esablish a connection when delayed completion is used. This assures the constructor terminates without having to wait for a connection request to complete.

int TCPSession::WaitConnection (  timeout_t   timeout = TIMEOUT_INF )  [protected]

Normally called during the thread Initial() method by default, this will wait for the socket connection to complete when connecting to a remote socket. One might wish to use setCompletion() to change the socket back to blocking I/O calls after the connection completes. To implement the session one must create a derived class which implements Run(). Returns: 0 if successful, -1 if timed out. Parameters: timeout   to wait for completion in milliseconds.

---

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

• socket.h

---