twisted.words.protocols.jabber.component.Service(service.Service)
class documentationtwisted.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. This method is responsible for setting
the parent attribute on this service (the child 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. |
Parent component has established a connection.
At this point, authentication was successful, 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 ) |
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.
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).
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. |