X-Git-Url: http://www.project-moonshot.org/gitweb/?a=blobdiff_plain;f=xmltooling%2Fsoap%2FSOAPClient.h;h=27f262267bf8f7ec45e39361123b12c5c5dab4dd;hb=a0d768778a8f5f539b909baf5b115e70ea765f0f;hp=cc13587e0fd17b5c9c4fd494792da2121b478197;hpb=28e2077c02f1bb4196730a88aa81aa72de9798e1;p=shibboleth%2Fcpp-xmltooling.git diff --git a/xmltooling/soap/SOAPClient.h b/xmltooling/soap/SOAPClient.h index cc13587..27f2622 100644 --- a/xmltooling/soap/SOAPClient.h +++ b/xmltooling/soap/SOAPClient.h @@ -1,5 +1,5 @@ /* - * Copyright 2001-2006 Internet2 + * Copyright 2001-2010 Internet2 * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -23,7 +23,6 @@ #ifndef __xmltooling_soap11client_h__ #define __xmltooling_soap11client_h__ -#include #include namespace soap11 { @@ -46,7 +45,7 @@ namespace soap11 { * * @param validate true iff schema validation should be used */ - SOAPClient(bool validate=false) : m_validate(validate), m_transport(NULL) {} + SOAPClient(bool validate=false); virtual ~SOAPClient(); @@ -57,26 +56,27 @@ namespace soap11 { * * @param validate true iff the client should use a validating XML parser */ - void setValidating(bool validate=true) { - m_validate = validate; - } + void setValidating(bool validate=true); /** * 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. * - * @param env SOAP envelope to send - * @param peer peer to send message to, expressed in TrustEngine terms - * @param endpoint URL of endpoint to recieve message + *

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. + * + * @param env SOAP envelope to send + * @param addr addressing information */ - virtual void send(const Envelope* env, const xmltooling::KeyInfoSource& peer, const char* endpoint); + virtual void send(const Envelope& env, const xmltooling::SOAPTransport::Address& addr); /** * Returns the response message, if any. As long as a response is - * "expected" but not available, NULL will be returned. If no response + * "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. @@ -94,7 +94,7 @@ namespace soap11 { * * @param transport reference to transport layer */ - virtual void prepareTransport(const xmltooling::SOAPTransport& transport) {} + virtual void prepareTransport(xmltooling::SOAPTransport& transport); /** * Handling of SOAP faults.