Home | Trees | Index | Help |
|
---|
Package twisted :: Package spread :: Module pb :: Class Perspective |
|
Perspective
--+
|
Perspective
MotherService
,
MotherService
,
Participant
,
Perspective
,
SiblingService
A perspective on a service.
per*spec*tive, n. : The relationship of aspects of a subject to each other and to a whole: 'a perspective of history'; 'a need to view the problem in the proper perspective'.
A service represents a collection of state, plus a collection of perspectives. Perspectives are the way that networked clients have a 'view' onto an object, or collection of objects on the server.
Although you may have a service onto which there is only one perspective, the common case is that a Perspective will be analagous to (or the same as) a "user"; if you are creating a PB-enabled service, your User (or equivalent) class should subclass Perspective.
Initially, a peer requesting a perspective will receive only aRemoteReference
to a Perspective. When a
method is called on that RemoteReference
, it will translate to a
method on the remote perspective named 'perspective_methodname'. (For
more information on invoking methods on other objects, see flavors.ViewPoint
.)
Method Summary | |
---|---|
An intermediary method to override. | |
See brokerAttached . | |
This method is called when a network message is received. | |
Inherited from Perspective | |
Create me. | |
Called when a remote reference is 'attached' to me. | |
Called when a broker is 'detached' from me. | |
Request my identity. | |
Return the unique name of this perspective. | |
Return a service. | |
| |
Make an identity from this perspective with a password. | |
| |
Determine which identity I connect to. | |
| |
Change what service I am a part of. |
Class Variable Summary | |
---|---|
Inherited from Perspective | |
tuple |
__implements__ = (<class twisted.cred.perspective.IPersp...
|
int |
_attachedCount = 0 |
int |
_service_cached = 0 |
Method Details |
---|
brokerAttached(self, reference, identity, broker)An intermediary method to override. Normally you will want to use 'attached', as described intwisted.cred.perspective.Perspective .attached;
however, this method serves the same purpose, and in some
circumstances, you are sure that the protocol that objects will be
attaching to your Perspective with is Perspective Broker, and in that
case you may wish to get the Broker object they are connecting with,
for example, to determine what host they are connecting from. Bear in
mind that when overriding this method, other, non-PB protocols will not
notify you of being attached or detached.
|
brokerDetached(self, reference, identity, broker)SeebrokerAttached .
|
perspectiveMessageReceived(self, broker, message, args, kw)This method is called when a network message is received. I will call:| self.perspective_%(message)s(*broker.unserialize(args), | **broker.unserialize(kw))to handle the method; subclasses of Perspective are expected to implement methods of this naming convention. |
Home | Trees | Index | Help |
|
---|
Generated by Epydoc 2.0 on Sat Sep 13 04:21:03 2003 | http://epydoc.sf.net |