OPAL Version 3.10.4

- Main Page
- Related Pages
- Namespaces
- Data Structures
- Files

- Data Structures
- Class Hierarchy
- Data Fields

Protected Member Functions | Protected Attributes
OpalListener Class Reference

`#include <transports.h>`

Inheritance diagram for OpalListener:

## Public Member Functions

Construction
| OpalListener (OpalEndPoint &endpoint)
Overrides from PObject
void | PrintOn (ostream &strm) const

## Protected Member Functions

| PDECLARE_NOTIFIER (PThread, OpalListener, ListenForConnections)
PBoolean | StartThread (const PNotifier &acceptHandler, ThreadMode mode)

## Protected Attributes

OpalEndPoint & | endpoint
PThread * | thread
PNotifier | acceptHandler
ThreadMode | threadMode

## Operations

enum | ThreadMode { SpawnNewThreadMode, HandOffThreadMode, SingleThreadMode }
virtual PBoolean | Open (const PNotifier &acceptHandler, ThreadMode mode=SpawnNewThreadMode)=0
virtual PBoolean | IsOpen ()=0
virtual void | Close ()=0
virtual OpalTransport * | Accept (const PTimeInterval &timeout)=0
virtual OpalTransport * | CreateTransport (const OpalTransportAddress &localAddress, const OpalTransportAddress &remoteAddress) const =0
virtual OpalTransportAddress | GetLocalAddress (const OpalTransportAddress &remoteAddress=OpalTransportAddress()) const =0
void | CloseWait ()
void | CleanUpOnTermination ()

## Additional Inherited Members

## Detailed Description

This class describes a "listener" on a transport protocol. A "listener" is an object that listens for incoming connections on the particular transport. It is executed as a separate thread.

The Main() function is used to handle incoming connections and dispatch them in new threads based on the actual OpalTransport class. This is defined in the descendent class that knows what the low level transport is, eg OpalListenerIP for the TCP/IP protocol.

An application may create a descendent off this class and override functions as required for operating the channel protocol.

## Member Enumeration Documentation

enum OpalListener::ThreadMode

Enumerator:

  SpawnNewThreadMode |
  HandOffThreadMode |
  SingleThreadMode |

## Constructor & Destructor Documentation

OpalListener::OpalListener | ( | OpalEndPoint & | endpoint | ) |

Create a new listener.

Parameters:

  endpoint | Endpoint listener is used for

## Member Function Documentation

virtual OpalTransport* OpalListener::Accept | ( | const PTimeInterval & | timeout | ) |

pure virtual

Accept a new incoming transport.

Parameters:

  timeout | Time to wait for incoming connection

Implemented in OpalListenerUDP, and OpalListenerTCP.

void OpalListener::CleanUpOnTermination | ( |  | ) |

inline

Close channel and wait for associated thread to terminate. For backward compatibility with OpenH323, now deprecated.

References CloseWait().

virtual void OpalListener::Close | ( |  | ) |

pure virtual

Stop the listener thread and no longer accept incoming connections.

Implemented in OpalListenerUDP, and OpalListenerTCP.

void OpalListener::CloseWait | ( |  | ) |

Close channel and wait for associated thread to terminate.

Referenced by CleanUpOnTermination().

virtual OpalTransport* OpalListener::CreateTransport | ( | const OpalTransportAddress & | localAddress,
|  | const OpalTransportAddress & | remoteAddress
| ) |  | const

pure virtual

Create a transport compatible with this listener.

Implemented in OpalListenerUDP, and OpalListenerTCP.

virtual OpalTransportAddress OpalListener::GetLocalAddress | ( | const OpalTransportAddress & | remoteAddress = `OpalTransportAddress()` | ) | const

pure virtual

Get the local transport address on which this listener may be accessed. If remoteAddress is present and is an address that requires NAT for connectivity, then the returned address is adjusted to return the external address and port.

Implemented in OpalListenerUDP, and OpalListenerIP.

virtual PBoolean OpalListener::IsOpen | ( |  | ) |

pure virtual

Indicate if the listener is open.

Implemented in OpalListenerUDP, and OpalListenerTCP.

virtual PBoolean OpalListener::Open | ( | const PNotifier & | acceptHandler,
|  | ThreadMode | mode = `SpawnNewThreadMode`
| ) |  |

pure virtual

Open the listener. A thread is spawned to listen for incoming connections. The notifier function acceptHandler is called when a new connection is created. The INT parameter to the acceptHandler is a pointer to the new OpalTransport instance created by the listener. If this is NULL then it indicates an error occurred during the accept.

If singleThread is false the acceptHandler function is called in the context of a new thread and the continues to listen for more connections. If true, then the acceptHandler function is called from within the listener threads context and no more connections are created. That is only a single connection is ever created by this listener.

Parameters:

  acceptHandler | Handler function for new connections
  mode | How handler function is called thread wise

Implemented in OpalListenerUDP, and OpalListenerTCP.

OpalListener::PDECLARE_NOTIFIER | ( | PThread | ,
|  | OpalListener | ,
|  | ListenForConnections |
| ) |  |

protected

Handle incoming connections and dispatch them in new threads based on the OpalTransport class. This is defined in the descendent class that knows what the low level transport is, eg OpalListenerTCP for the TCP/IP protocol.

Note this function does not return until the Close() function is called or there is some other error.

void OpalListener::PrintOn | ( | ostream & | strm | ) | const

Print the description of the listener to the stream.

PBoolean OpalListener::StartThread | ( | const PNotifier & | acceptHandler,
|  | ThreadMode | mode
| ) |  |

protected

Parameters:

  acceptHandler | Handler function for new connections
  mode | How handler function is called thread wise

## Field Documentation

PNotifier OpalListener::acceptHandler

protected

OpalEndPoint& OpalListener::endpoint

protected

PThread* OpalListener::thread

protected

ThreadMode OpalListener::threadMode

protected

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

- transports.h