Home | Trees | Index | Help |
---|
Package twisted :: Package spread :: Module pb |
|
Perspective Broker
"This isn't a professional opinion, but it's probably got enough internet to kill you." --glyph
Stability: semi-stable
Future Plans: 'connect' and 'IdentityConnector' will be gradually replaced with URLs, that will be able to extend resource location and discovery conversations and specify different authentication mechanisms besides username/password. This should only add to, and not change, the existing protocol. There are no anticipated protocol-breaking changes before a complete finalization but we need more users before we can be totally sure of that.This is a broker for proxies for and copies of objects. It provides a translucent interface layer to those proxies.
The protocol is not opaque, because it provides objects which represent the remote proxies and require no context (server references, IDs) to operate on.
It is not transparent because it does not attempt to make remote objects behave identically, or even similiarly, to local objects. Method calls are invoked asynchronously, and specific rules are applied when serializing arguments.Author: Glyph
Lefkowitz<mailto:glyph@twistedmatrix.com>
Classes | |
---|---|
AsReferenceable |
AsReferenceable: a reference directed towards another object. |
AuthChallenger |
XXX |
AuthRoot |
I provide AuthServs as root objects to Brokers for a BrokerFactory. |
AuthServ |
XXX |
Broker |
I am a broker for objects. |
BrokerClientFactory |
|
BrokerFactory |
I am a server for object brokerage. |
CopiedFailure |
|
CopyableFailure |
A flavors.RemoteCopy and flavors.Copyable version of twisted.python.failure.Failure for
serialization. |
IdentityConnector |
I support connecting to multiple Perspective Broker services that are in a service tree. |
IdentityWrapper |
I delegate most functionality to a twisted.cred.identity.Identity . |
Local |
(internal) A reference to a local object. |
Perspective |
A perspective on a service. |
RemoteMethod |
This is a translucent reference to a remote message. |
RemoteReference |
This is a translucent reference to a remote object. |
Service |
A service for Perspective Broker. |
Exceptions | |
---|---|
DeadReferenceError |
This error is raised when a method is called on a dead reference (one whose broker has been disconnected). |
Error |
This error can be raised to generate known error conditions. |
PBConnectionLost |
|
ProtocolError |
This error is raised when an invalid protocol statement is received. |
Function Summary | |
---|---|
Return a Deferred which will do the challenge-response dance and return a remote Identity reference. | |
Connects and authenticates, then retrieves a PB service. | |
failure2Copyable(fail)
| |
Establishes a PB connection and returns with a RemoteReference . | |
Establishes a PB connection over SSL and returns with a RemoteReference. | |
Get a factory which retreives a root object from its client | |
I return a Deferred which will be called back with a Perspective. | |
Do nothing. | |
Print a traceback (string) to the standard log. |
Variable Summary | |
---|---|
str |
__version__
|
dict |
copyTags
|
SecurityOptions |
globalSecurity
|
int |
MAX_BROKER_REFS
|
_Feature |
nested_scopes
|
int |
portno
|
SelectReactor |
reactor
|
Function Details |
---|
authIdentity(authServRef, username, password)Return a Deferred which will do the challenge-response dance and return a remote Identity reference. |
connect(host, port, username, password, serviceName, perspectiveName=None, client=None, timeout=None)Connects and authenticates, then retrieves a PB service. Required arguments:
|
getObjectAt(host, port, timeout=None)Establishes a PB connection and returns with aRemoteReference .
|
getObjectAtSSL(host, port, timeout=None)Establishes a PB connection over SSL and returns with a RemoteReference.
|
getObjectRetriever()Get a factory which retreives a root object from its client
|
logIn(authServRef, client, service, username, password, perspectiveName=None)I return a Deferred which will be called back with a Perspective. |
noOperation(*args, **kw)Do nothing. Neque porro quisquam est qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit... |
printTraceback(tb)Print a traceback (string) to the standard log. |
Variable Details |
---|
__version__
|
globalSecurity
|
MAX_BROKER_REFS
|
nested_scopes
|
portno
|
reactor
|
Home | Trees | Index | Help |
---|
Generated by Epydoc 1.1 on Thu May 8 13:16:53 2003 | http://epydoc.sf.net |