summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMichael W. Hudson <mwh@python.net>2002-03-17 19:05:18 (GMT)
committerMichael W. Hudson <mwh@python.net>2002-03-17 19:05:18 (GMT)
commite115134015cd3928611116a98ae6466768a752cc (patch)
treeef86ed2bac2c531756792fe28087dbf2f96aa80a /Doc
parent32b2b2d99d336ed93520c9b0be0b3670ac8acdc0 (diff)
downloadcpython-e115134015cd3928611116a98ae6466768a752cc.zip
cpython-e115134015cd3928611116a98ae6466768a752cc.tar.gz
cpython-e115134015cd3928611116a98ae6466768a752cc.tar.bz2
Backport montanero's checkin of revision 1.7:
update text to refer to ServerProxy class in preference to Server, which is only retained for backward compatibility with older versions of the library.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libxmlrpclib.tex19
1 files changed, 11 insertions, 8 deletions
diff --git a/Doc/lib/libxmlrpclib.tex b/Doc/lib/libxmlrpclib.tex
index 690e669..d8126e4 100644
--- a/Doc/lib/libxmlrpclib.tex
+++ b/Doc/lib/libxmlrpclib.tex
@@ -17,9 +17,9 @@ structured data. This module supports writing XML-RPC client code; it
handles all the details of translating between conformable Python
objects and XML on the wire.
-\begin{classdesc}{Server}{uri\optional{, transport\optional{,
- encoding\optional{, verbose}}}}
-A \class{Server} instance is a server proxy that manages communication
+\begin{classdesc}{ServerProxy}{uri\optional{, transport\optional{,
+ encoding\optional{, verbose}}}}
+A \class{ServerProxy} instance is an object that manages communication
with a remote XML-RPC server. The required first argument is a URI
(Uniform Resource Indicator), and will normally be the URL of the
server. The optional second argument is a transport factory instance;
@@ -34,7 +34,7 @@ server supports the introspection API, the proxy can also be used to query
the remote server for the methods it supports (service discovery) and
fetch other server-associated metadata.
-\class{Server} instance methods take Python basic types and objects as
+\class{ServerProxy} instance methods take Python basic types and objects as
arguments and return Python basic types and classes. Types that are
conformable (e.g. that can be marshalled through XML), include the
following (and except where noted, they are unmarshalled as the same
@@ -69,6 +69,9 @@ an XML-RPC request that isn't well-formed XML. If you have to pass
arbitrary strings via XML-RPC, use the \class{Binary} wrapper class
described below.
+\class{Server} is retained as an alias for \class{ServerProxy} for backwards
+compatibility. New code should use \class{ServerProxy}.
+
\end{classdesc}
@@ -83,9 +86,9 @@ described below.
\end{seealso}
-\subsection{Server Objects \label{server-objects}}
+\subsection{ServerProxy Objects \label{serverproxy-objects}}
-A \class{Server} instance proxy object has a method corresponding to
+A \class{ServerProxy} instance has a method corresponding to
each remote procedure call accepted by the XML-RPC server. Calling
the method performs an RPC, dispatched by both name and argument
signature (e.g. the same method name can be overloaded with multiple
@@ -244,8 +247,8 @@ Trivially convert any Python string to a \class{Binary} object.
\begin{verbatim}
# simple test program (from the XML-RPC specification)
-# server = Server("http://localhost:8000") # local server
-server = Server("http://betty.userland.com")
+# server = ServerProxy("http://localhost:8000") # local server
+server = ServerProxy("http://betty.userland.com")
print server