SOAPonHTTP.h

Go to the documentation of this file.

// SOAPonHTTP.h: interface for the SOAPonHTTP class.
// Class Description: Handles sending and receiving messages using
//      the HTTP protocol.  This is based off of the information found
//      in the SOAP v1.1 draft.

/*
#if !defined(SOAPONHTTP_H)
    #include "SOAPonHTTP.h"    
#endif // !defined(SOAPONHTTP_H)
*/

#if !defined(SOAPONHTTP_H)
#define SOAPONHTTP_H

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#if !defined(SOAPonProtocol_H)
    #include "SOAPonProtocol.h"    
#endif // !defined(SOAPonProtocol_H)

#ifndef _MAP_
    #include <map>
#endif // _MAP_

#ifndef SOCKETADDRESS_H_
    #include "SocketAddress.h"
#endif // SOCKETADDRESS_H_

class SOAPElement;
class SOAPMethod;

class SOAPonHTTP : SOAPonProtocol
{
public:
    // Constructor/Destructor
    SOAPonHTTP();
    virtual ~SOAPonHTTP();
    
    // getMethodDetails
    // Description: See base class
    // Arguments: See base class
    // Return value: See base class
    virtual bool getMethodDetails( const std::string& KszMessage, 
        std::string& szObjectName, std::string& szMethodName, 
        SOAPElement& theCall );
    
    // setHostAndPort
    // Description: Sets the host and port of the destination SOAP
    //  server.  This method should only be called by SOAP clients
    //  (or servers acting as clients).
    // Arguments:
    //  szHost: Name of the machine.  Can be numeric or character.
    // Return value: N/A
    void setHostAndPort( std::string szHost, long nPort = 80 );
    
    // getSendableResponse
    // Description: See base class
    // Arguments: See base class
    // Return value: See base class
    virtual std::string getSendableResponse( 
        const std::string& szSOAPMessage, bool bIsFault = false );
    
    // send
    // Description: See base class
    // Arguments: See base class
    // Return value: See base class
    virtual std::string send( 
        const std::string& szClassName, SOAPMethod& aMethod );
    
protected:
    
    // getSendableMessage
    // Description: Called by send to generate a message that
    //  is suitable for sending over HTTP.
    // Arguments:
    //  szSOAPMessage: The message being sent.
    //  szClassName: Name of the class being called.
    //  szMethodName: Name of the method being called.
    // Return value:
    virtual std::string getSendableMessage( 
        const std::string& szSOAPMessage, 
        const std::string& szClassName,
        const std::string& szMethodName );
    
private:
    // SocketAddress 
    // Description: Contains the address (IP and Port) of the 
    //  server.  Should only be filled in for SOAP clients.
    SocketAddress m_socketAddress;
};

#endif // !defined(SOAPONHTTP_H)

---