twisted.words.protocols.jabber.component.Service : API documentation

Method	componentConnected	Parent component has established a connection.
Method	componentDisconnected	Parent component has lost the connection to the Jabber server.
Method	transportConnected	Parent component has established a connection over the underlying transport.
Method	send	Send data over service parent's XML stream.

Inherited from Service:

Method	__getstate__	Undocumented
Method	setName	Undocumented
Method	setServiceParent	Undocumented
Method	disownServiceParent	Undocumented
Method	privilegedStartService	Undocumented
Method	startService	Undocumented
Method	stopService	Undocumented

def componentConnected(self, xs): (source)

from twisted.words.protocols.jabber.ijabber.IService

Parent component has established a connection.

At this point, authentication was succesful, and XML stanzas can be exchanged over the XML stream xs. This method can be used to setup observers for incoming stanzas.

Parameters xs XML Stream that represents the established connection. (type: xmlstream.XmlStream)

def componentDisconnected(self): (source)

from twisted.words.protocols.jabber.ijabber.IService

Parent component has lost the connection to the Jabber server.

Subsequent use of self.parent.send will result in data being queued until a new connection has been established.

def transportConnected(self, xs): (source)

from twisted.words.protocols.jabber.ijabber.IService

Parent component has established a connection over the underlying transport.

At this point, no traffic has been exchanged over the XML stream. This method can be used to change properties of the XML Stream (in xs), the service manager or it's authenticator prior to stream initialization (including authentication).

def send(self, obj): (source)

Send data over service parent's XML stream.

Parameters	obj	data to be sent over the XML stream. This is usually an object providing `domish.IElement`, or serialized XML. See `xmlstream.XmlStream` for details.
Note	`ServiceManager` maintains a queue for data sent using this method when there is no current established XML stream. This data is then sent as soon as a new stream has been established and initialized. Subsequently, `componentConnected` will be called again. If this queueing is not desired, use `send` on the XmlStream object (passed to `componentConnected`) directly.

t.w.p.j.c.Service(service.Service) : class documentation