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

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

Implements interfaces: twisted.words.protocols.jabber.ijabber.IService

External server-side component service.
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 Set the name of the service.
Method setServiceParent Set the parent of the service.
Method disownServiceParent Use this API to remove an IService from an IServiceCollection.
Method privilegedStartService Do preparation work for starting the service.
Method startService Start the service.
Method stopService Stop the service.
def componentConnected(self, xs): (source)

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.
ParametersxsXML Stream that represents the established connection. (type: xmlstream.XmlStream )
def componentDisconnected(self): (source)

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)

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.
Parametersobjdata to be sent over the XML stream. This is usually an object providing domish.IElement, or serialized XML. See xmlstream.XmlStream for details.
NoteServiceManager 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.
API Documentation for Twisted, generated by pydoctor at 2011-10-27 16:27:37.