soap11::SOAPClient Class Reference

Implements SOAP 1.1 messaging over a transport. More...

#include <xmltooling/soap/SOAPClient.h>

List of all members.

Public Member Functions

 SOAPClient (bool validate=false)
 Constructor.
void setValidating (bool validate=true)
 Controls schema validation of incoming XML messages.
virtual void send (const Envelope &env, const xmltooling::SOAPTransport::Address &addr)
 Sends the supplied envelope to the identified recipient/endpoint.
virtual Envelopereceive ()
 Returns the response message, if any.
virtual void reset ()
 Resets the object for another call.

Protected Member Functions

virtual void prepareTransport (xmltooling::SOAPTransport &transport)
 Allows client to supply transport-layer settings prior to sending message.
virtual bool handleFault (const soap11::Fault &fault)
 Handling of SOAP faults.

Protected Attributes

bool m_validate
 Flag controlling schema validation.
xmltooling::SOAPTransportm_transport
 Holds response until retrieved by caller.


Detailed Description

Implements SOAP 1.1 messaging over a transport.

In the abstract, this can be a one-way exchange, or use asynchronous transports, but this is mostly theoretical at this point.


Constructor & Destructor Documentation

soap11::SOAPClient::SOAPClient ( bool  validate = false  )  [inline]

Constructor.

Parameters:
validate true iff schema validation should be used


Member Function Documentation

virtual bool soap11::SOAPClient::handleFault ( const soap11::Fault fault  )  [protected, virtual]

Handling of SOAP faults.

Parameters:
fault SOAP Fault received by client
Returns:
true iff the Fault should be treated as a fatal error

virtual void soap11::SOAPClient::prepareTransport ( xmltooling::SOAPTransport transport  )  [inline, protected, virtual]

Allows client to supply transport-layer settings prior to sending message.

Parameters:
transport reference to transport layer

virtual Envelope* soap11::SOAPClient::receive (  )  [virtual]

Returns the response message, if any.

As long as a response is "expected" but not available, NULL will be returned. If no response will be forthcoming, an exception is raised.

The caller is responsible for freeing the returned envelope.

virtual void soap11::SOAPClient::send ( const Envelope env,
const xmltooling::SOAPTransport::Address addr 
) [virtual]

Sends the supplied envelope to the identified recipient/endpoint.

The client object will instantiate a transport layer object appropriate for the endpoint URL provided and supply it to the prepareTransport() method below.

To authenticate the server end, the transport layer object exposes a method to load a TrustEngine and CredentialResolver in a subclass-specific version of the prepareTransport() method.

Parameters:
env SOAP envelope to send
addr addressing information

void soap11::SOAPClient::setValidating ( bool  validate = true  )  [inline]

Controls schema validation of incoming XML messages.

This is separate from other forms of programmatic validation of objects, but can detect a much wider range of syntax errors.

Parameters:
validate true iff the client should use a validating XML parser


The documentation for this class was generated from the following file:
Generated on Mon Oct 19 14:18:34 2009 for xmltooling by  doxygen 1.4.7