xmltooling
1.6.4
|
Implements SOAP 1.1 messaging over a transport. More...
#include <xmltooling/soap/SOAPClient.h>
Public Member Functions | |
SOAPClient (bool validate=false) | |
Constructor. More... | |
void | setValidating (bool validate=true) |
Controls schema validation of incoming XML messages. More... | |
virtual void | send (const Envelope &env, const xmltooling::SOAPTransport::Address &addr) |
Sends the supplied envelope to the identified recipient/endpoint. More... | |
virtual Envelope * | receive () |
Returns the response message, if any. More... | |
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. More... | |
virtual bool | handleFault (const soap11::Fault &fault) |
Handling of SOAP faults. More... | |
Protected Attributes | |
bool | m_validate |
Flag controlling schema validation. More... | |
xmltooling::SOAPTransport * | m_transport |
Holds response until retrieved by caller. More... | |
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.
soap11::SOAPClient::SOAPClient | ( | bool | validate = false | ) |
Constructor.
validate | true iff schema validation should be used |
|
protectedvirtual |
Handling of SOAP faults.
fault | SOAP Fault received by client |
|
protectedvirtual |
Allows client to supply transport-layer settings prior to sending message.
transport | reference to transport layer |
|
virtual |
Returns the response message, if any.
As long as a response is "expected" but not available, nullptr will be returned. If no response will be forthcoming, an exception is raised.
The caller is responsible for freeing the returned envelope.
|
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.
env | SOAP envelope to send |
addr | addressing information |
void soap11::SOAPClient::setValidating | ( | bool | validate = true | ) |
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.
validate | true iff the client should use a validating XML parser |
|
protected |
Holds response until retrieved by caller.
|
protected |
Flag controlling schema validation.