← Back to branch summary

~blamar/+junk/openstack-api-arrrg

« back to all changes in this revision

Viewing changes to vendor/Twisted-10.0.0/doc/core/howto/pb.html

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
vendor/Twisted-10.0.0/doc/core/howto/pb.html
 
1
<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html  PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN'  'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'><html lang="en" xmlns="http://www.w3.org/1999/xhtml">
 
2
  <head>
 
3
<title>Twisted Documentation: Overview of Twisted Spread</title>
 
4
<link href="stylesheet.css" rel="stylesheet" type="text/css"/>
 
5
  </head>
 
6
 
 
7
  <body bgcolor="white">
 
8
    <h1 class="title">Overview of Twisted Spread</h1>
 
9
    <div class="toc"><ol><li><a href="#auto0">Rationale</a></li></ol></div>
 
10
    <div class="content">
 
11
<span/>
 
12
 
 
13
<p> Perspective Broker (affectionately known as <q>PB</q>) is an
 
14
asynchronous, symmetric<a href="#footnote-1" title="There is a negotiation phase for banana with particular roles for listener and initiator, so it's not completely symmetric, but after the connection is fully established, the protocol is completely symmetrical."><super>1</super></a> network protocol for secure,
 
15
remote method calls and transferring of objects. PB is <q>translucent, not
 
16
transparent</q>, meaning that it is very visible and obvious to see the
 
17
difference between local method calls and potentially remote method calls,
 
18
but remote method calls are still extremely convenient to make, and it is
 
19
easy to emulate them to have objects which work both locally and
 
20
remotely.</p>
 
21
 
 
22
<p>PB supports user-defined serialized data in return values, which can be
 
23
either copied each time the value is returned, or <q>cached</q>: only copied
 
24
once and updated by notifications.</p>
 
25
 
 
26
<p>PB gets its name from the fact that access to objects is through a
 
27
<q>perspective</q>. This means that when you are responding to a remote
 
28
method call, you can establish who is making the call.</p>
 
29
 
 
30
<h2>Rationale<a name="auto0"/></h2>
 
31
 
 
32
<p>No other currently existing protocols have all the properties of PB at the
 
33
same time. The particularly interesting combination of attributes, though, is
 
34
that PB is flexible and lightweight, allowing for rapid development, while
 
35
still powerful enough to do two-way method calls and user-defined data
 
36
types.</p>
 
37
 
 
38
<p>It is important to have these attributes in order to allow for a protocol
 
39
which is extensible. One of the facets of this flexibility is that PB can
 
40
integrate an arbitrary number of services could be aggregated over a single
 
41
connection, as well as publish and call new methods on existing objects
 
42
without restarting the server or client.</p>
 
43
 
 
44
<h2>Footnotes</h2><ol><li><a name="footnote-1"><span class="footnote">There is a negotiation phase
 
45
for banana with particular roles for listener and initiator, so it's not
 
46
<em>completely</em> symmetric, but after the connection is fully established,
 
47
the protocol is completely symmetrical.</span></a></li></ol></div>
 
48
 
 
49
    <p><a href="index.html">Index</a></p>
 
50
    <span class="version">Version: 10.0.0</span>
 
51
  </body>
 
52
</html>
 
 
b'\\ No newline at end of file'