t.w.p.j.i.IXMPPHandler(Interface) : interface documentation

Part of twisted.words.protocols.jabber.ijabber View Source View In Hierarchy

Known implementations: twisted.words.protocols.jabber.xmlstream.XMPPHandler

Interface for XMPP protocol handlers.

Objects that provide this interface can be added to a stream manager to handle of (part of) an XMPP extension protocol.
Attribute parent XML stream manager for this handler
Attribute xmlstream The managed XML stream
Method setHandlerParent Set the parent of the handler.
Method disownHandlerParent Remove the parent of the handler.
Method makeConnection A connection over the underlying transport of the XML stream has been established.
Method connectionMade Called after a connection has been established.
Method connectionInitialized The XML stream has been initialized.
Method connectionLost The XML stream has been closed.
parent =
XML stream manager for this handler
xmlstream =
The managed XML stream
def setHandlerParent(parent): (source)
Set the parent of the handler.
Parametersparent (type: IXMPPHandlerCollection )
def disownHandlerParent(parent): (source)
Remove the parent of the handler.
Parametersparent (type: IXMPPHandlerCollection )
def makeConnection(xs): (source)

A connection over the underlying transport of the XML stream has been established.

At this point, no traffic has been exchanged over the XML stream given in xs.

This should setup xmlstream and call connectionMade.
Parametersxs (type: XmlStream )
def connectionMade(): (source)

Called after a connection has been established.

This method can be used to change properties of the XML Stream, its authenticator or the stream manager prior to stream initialization (including authentication).
def connectionInitialized(): (source)

The XML stream has been initialized.

At this point, authentication was successful, and XML stanzas can be exchanged over the XML stream xmlstream. This method can be used to setup observers for incoming stanzas.
def connectionLost(reason): (source)

The XML stream has been closed.

Subsequent use of parent.send will result in data being queued until a new connection has been established.
Parametersreason (type: twisted.python.failure.Failure )
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:27:37.