client
index
/home/groups/p/py/pywebsvcs/src/ZSI/client.py

# $Header$
#
# Copyright (c) 2001 Zolera Systems.  All rights reserved.

 
Modules
       
Cookie
ZSI.TC
base64
httplib
time
types
urlparse

 
Classes
       
_Binding
Binding
NamedParamBinding

 
class Binding(_Binding)
    Object that represents a binding (connection) to a SOAP server.  
Can be used in the "name overloading" style.
 
class attr:
    gettypecode -- funcion that returns typecode from typesmodule,
        can be set so can use whatever mapping you desire.
 
  Methods defined here:
Receive(self, replytype, **kw)
Parse message, create Python object.
 
KeyWord data:
    faults   -- list of WSDL operation.fault typecodes
    wsaction -- If using WS-Address, must specify Action value we expect to
        receive.
__getattr__(self, name)
Return a callable object that will invoke the RPC method
named by the attribute.
__init__(self, url, namespace=None, typesmodule=None, **kw)
Parameters:
    url -- location of service
    namespace -- optional root element namespace
    typesmodule -- optional response only. dict(name=typecode), 
        lookup for all children of root element.

Static methods defined here:
gettypecode lambda mod, e

Data and other attributes defined here:
logger = <ZSI.wstools.logging.BasicLogger instance>

Methods inherited from _Binding:
AddHeader(self, header, value)
Add a header to send.
IsAFault(self)
Get a SOAP message, see if it has a fault.
IsSOAP(self)
RPC(self, url, opname, obj, replytype=None, **kw)
Send a request, return the reply.  See Send() and Recieve()
docstrings for details.
ReceiveFault(self, **kw)
Parse incoming message as a fault. Raise TypeError if no
fault found.
ReceiveRaw(self, **kw)
Read a server reply, unconverted to any format and return it.
ReceiveSOAP(self, readerclass=None, **kw)
Get back a SOAP message.
ResetCookies(self)
Empty the list of cookies.
ResetHeaders(self)
Empty the list of additional headers.
Send(self, url, opname, obj, nsdict={}, soapaction=None, wsaction=None, endPointReference=None, soapheaders=(), **kw)
Send a message.  If url is None, use the value from the
constructor (else error). obj is the object (data) to send.
Data may be described with a requesttypecode keyword, the default 
is the class's typecode (if there is one), else Any.
 
Try to serialize as a Struct, if this is not possible serialize an Array.  If 
data is a sequence of built-in python data types, it will be serialized as an
Array, unless requesttypecode is specified.
 
arguments:
    url -- 
    opname -- struct wrapper
    obj -- python instance
 
key word arguments:
    nsdict -- 
    soapaction --
    wsaction -- WS-Address Action, goes in SOAP Header.
    endPointReference --  set by calling party, must be an 
        EndPointReference type instance.
    soapheaders -- list of pyobj, typically w/typecode attribute.
        serialized in the SOAP:Header.
    requesttypecode --
SendSOAPData(self, soapdata, url, soapaction, headers={}, **kw)
SendSOAPDataHTTPDigestAuth(self, response, soapdata, url, request_uri, soapaction, **kw)
Resend the initial request w/http digest authorization headers.
The SOAP server has requested authorization.  Fetch the challenge, 
generate the authdict for building a response.
SetAuth(self, style, user=None, password=None)
Change auth style, return object to user.
SetURL(self, url)
Set the URL we post to.
__repr__(self)

Data and other attributes inherited from _Binding:
defaultHttpTransport = <class httplib.HTTPConnection>
defaultHttpsTransport = <class httplib.HTTPSConnection>
This class allows communication via SSL.

 
class NamedParamBinding(Binding)
    Like Binding, except the argument list for invocation is
named parameters.
 
 
Method resolution order:
NamedParamBinding
Binding
_Binding

Methods defined here:
__getattr__(self, name)
Return a callable object that will invoke the RPC method
named by the attribute.

Data and other attributes defined here:
logger = <ZSI.wstools.logging.BasicLogger instance>

Methods inherited from Binding:
Receive(self, replytype, **kw)
Parse message, create Python object.
 
KeyWord data:
    faults   -- list of WSDL operation.fault typecodes
    wsaction -- If using WS-Address, must specify Action value we expect to
        receive.
__init__(self, url, namespace=None, typesmodule=None, **kw)
Parameters:
    url -- location of service
    namespace -- optional root element namespace
    typesmodule -- optional response only. dict(name=typecode), 
        lookup for all children of root element.

Static methods inherited from Binding:
gettypecode lambda mod, e

Methods inherited from _Binding:
AddHeader(self, header, value)
Add a header to send.
IsAFault(self)
Get a SOAP message, see if it has a fault.
IsSOAP(self)
RPC(self, url, opname, obj, replytype=None, **kw)
Send a request, return the reply.  See Send() and Recieve()
docstrings for details.
ReceiveFault(self, **kw)
Parse incoming message as a fault. Raise TypeError if no
fault found.
ReceiveRaw(self, **kw)
Read a server reply, unconverted to any format and return it.
ReceiveSOAP(self, readerclass=None, **kw)
Get back a SOAP message.
ResetCookies(self)
Empty the list of cookies.
ResetHeaders(self)
Empty the list of additional headers.
Send(self, url, opname, obj, nsdict={}, soapaction=None, wsaction=None, endPointReference=None, soapheaders=(), **kw)
Send a message.  If url is None, use the value from the
constructor (else error). obj is the object (data) to send.
Data may be described with a requesttypecode keyword, the default 
is the class's typecode (if there is one), else Any.
 
Try to serialize as a Struct, if this is not possible serialize an Array.  If 
data is a sequence of built-in python data types, it will be serialized as an
Array, unless requesttypecode is specified.
 
arguments:
    url -- 
    opname -- struct wrapper
    obj -- python instance
 
key word arguments:
    nsdict -- 
    soapaction --
    wsaction -- WS-Address Action, goes in SOAP Header.
    endPointReference --  set by calling party, must be an 
        EndPointReference type instance.
    soapheaders -- list of pyobj, typically w/typecode attribute.
        serialized in the SOAP:Header.
    requesttypecode --
SendSOAPData(self, soapdata, url, soapaction, headers={}, **kw)
SendSOAPDataHTTPDigestAuth(self, response, soapdata, url, request_uri, soapaction, **kw)
Resend the initial request w/http digest authorization headers.
The SOAP server has requested authorization.  Fetch the challenge, 
generate the authdict for building a response.
SetAuth(self, style, user=None, password=None)
Change auth style, return object to user.
SetURL(self, url)
Set the URL we post to.
__repr__(self)

Data and other attributes inherited from _Binding:
defaultHttpTransport = <class httplib.HTTPConnection>
defaultHttpsTransport = <class httplib.HTTPSConnection>
This class allows communication via SSL.

 
Data
        UNICODE_ENCODING = 'utf-8'
ZSI_SCHEMA_URI = 'http://www.zolera.com/schemas/ZSI/'