Exports constants for tracking status of pcj
PCJ_CONNECT PCJ_CONNECTING PCJ_CONNECTED PCJ_CONNECTFAIL PCJ_STREAMSTART PCJ_STREAMEND PCJ_NODESENT PCJ_NODERECEIVED PCJ_NODEQUEUED PCJ_SSLNEGOTIATE PCJ_SSLSUCCESS PCJ_SSLFAIL PCJ_AUTHNEGOTIATE PCJ_AUTHSUCCESS PCJ_AUTHFAIL PCJ_BINDNEGOTIATE PCJ_BINDSUCCESS PCJ_BINDFAIL PCJ_SESSIONNEGOTIATE PCJ_SESSIONSUCCESS PCJ_SESSIONFAIL PCJ_RTS_START PCJ_RTS_FINISH PCJ_READY PCJ_SHUTDOWN_START PCJ_SHUTDOWN_FINISH PCJ_SOCKETFAIL PCJ_SOCKETDISCONNECT
POE::Component::Jabber::Events exports many useful constants for tracking the status of \s-1PCJ\s0 during its operation. Simply subscribe to these events in order to receive notification.
Below are the exported constants with a brief explanation of what it is signalling to the end developer:
'connect' or 'reconnect' event has fired.
Connecting is now in process
Initial connection established
A <stream:stream/> tag has been sent. The number of these events is variable depending on which Protocol is currently active (ie. \s-1XMPP\s0 will send upto three, while \s-1LEGACY\s0 will only send one).
\s-1TLS/SSL\s0 negotiation has begun. This event only is fired from \s-1XMPP\s0 and \s-1JABBERD20_COMPONENT\s0 connections.
\s-1TLS/SSL\s0 negotiation has successfully complete. Socket layer is now encrypted. This event only is fired from \s-1XMPP\s0 and \s-1JABBERD20_COMPONENT\s0 connections.
\s-1TLS/SSL\s0 negotiation has failed. This event only is fired from \s-1XMPP\s0 and \s-1JABBERD20_COMPONENT\s0 connections.
Whatever your authentication method (ie. iq:auth, \s-1SASL\s0, <handshake/>, etc), it is in process when this status is received.
Authentication was successful.
Authentication failed.
For \s-1XMPP\s0 connections: this indicates resource binding negotiation has begun. For \s-1JABBERD20_COMPONENT\s0 connections: domain binding negotiation has begun. This event will not fire for any but the above two connection types.
For \s-1XMPP\s0 connections: this indicates resource binding negotiation was sucessful. For \s-1JABBERD20_COMPONENT\s0 connections: domain binding negotiation was successful. This event will not fire for any but the above two connection types.
Binding for which ever context has failed.
Only for \s-1XMPP:\s0 This indicates session binding (\s-1XMPP\s0 \s-1IM\s0) negotiation has begun.
Only for \s-1XMPP:\s0 This indicates session binding (\s-1XMPP\s0 \s-1IM\s0) negotiation was successful.
Session negotiation has failed for which ever context.
A Node has been placed, outbound, into the Wheel. \s-1ARG0\s0 will be the node.
A Node has been received. \s-1ARG0\s0 will be the node.
An attempt to send a Node while there is no valid, initialized connection was caught. The Node has been queued. See POE::Component::Jabber event 'purge_queue' for details. \s-1ARG0\s0 will be the node.
A return_to_sender event has been fired for an outbound node. \s-1ARG0\s0 will be the node.
A return_to_sender event has been fired for a matching inbound node. \s-1ARG0\s0 will be the node.
This event indicates that the connection is fully initialized and ready for use. Watch for this event and begin packet transactions \s-1AFTER\s0 it has been fired.
A </stream:stream> Node has been sent. This indicates the end of the connection and is called upon 'shutdown' of \s-1PCJ\s0 after the Node has been flushed.
This indicates that 'shutdown' has been fired and is currently in progress of tearing down the connection.
This indicates that 'shutdown' is complete.
This indicates a socket level error. \s-1ARG0\s0..ARG2 will be exactly what was passed to us from POE::Wheel::ReadWrite.
This indicates the socket has disconnected and will occur in both normal, and in error states.
(c) Copyright 2007-2009 Nicholas Perez. Released under the \s-1GPL\s0.