MessageSessionHandler Class ReferenceA virtual interface which can be reimplemented to receive incoming message sessions.
List of all members.
A virtual interface which can be reimplemented to receive incoming message sessions.
Derived classes can be registered as MessageSessionHandlers with the Client. If you have enabled automatic MessageSession creation by calling Client::setAutoMessageSession(), handleMessageSession() will be called if a message stanza arrives for which there is no MessageSession yet.
- Jakob Schroeter <email@example.com>
Definition at line 34 of file messagesessionhandler.h.
Constructor & Destructor Documentation
Member Function Documentation
|virtual void handleMessageSession
Reimplement this function if you want to be notified about incoming messages by means of automatically created MessageSessions. You receive ownership of the supplied session (not the stanza) and are responsible for deleting it at the end of its life.
- Make sure to read the note in ClientBase::registerMessageSessionHandler() regarding the feeding of decorators.
After receiving a MessageSession your object is the owner and is responsible for the destruction of the session.
If you don't need the MessageSession, you should not delete it here. You will get an endless loop if you do.
You should register your MessageHandler here, or else the first message (that caused the MessageSession to be created) may get lost.
The documentation for this class was generated from the following file:
Generated on Sat Oct 31 19:54:38 2009 for gloox by