Click here to Skip to main content
15,867,141 members
Articles / Programming Languages / C++

CurrencyConvertor - How to Use gSOAP and WebServices - Part 2 - Doing the First WS Client

Rate me:
Please Sign up or sign in to vote.
4.81/5 (32 votes)
9 Mar 2007CPOL2 min read 267.8K   1.9K   36   86
Part 2: How to use the classes generated with gSOAP

Introduction

This is the second of two articles where I explain building a web service client from wsdl file. In Part 1, I explained how to get the class from the wsdl file to be used in VC++ 6. In Part 2, I will show you how to use the classes generated with gSOAP in Part 1.

Using the Code

Usually, in the file soap*****************SoapProxy.h, we can find the class definition of generic WS. In this case, soapCurrencyConvertorSoapProxy.h, I have already included it in Part 1.

C++
//soapCurrencyConvertorSoapProxy.h

#ifndef soapCurrencyConvertorSoap_H
#define soapCurrencyConvertorSoap_H
#include "soapH.h"
class CurrencyConvertorSoap
{   public:
    struct soap *soap;
    const char *endpoint;
    CurrencyConvertorSoap()
    { soap = soap_new(); endpoint = 
        "http://www.webservicex.net/CurrencyConvertor.asmx";
        if (soap && !soap->namespaces) 
        { static const struct Namespace namespaces[] = 
{
    {"SOAP-ENV", "http://schemas.xmlsoap.org/soap/envelope/", 
        "http://www.w3.org/*/soap-envelope", NULL},
    {"SOAP-ENC", "http://schemas.xmlsoap.org/soap/encoding/", 
        "http://www.w3.org/*/soap-encoding", NULL},
    {"xsi", "http://www.w3.org/2001/XMLSchema-instance", 
        "http://www.w3.org/*/XMLSchema-instance", NULL},
    {"xsd", "http://www.w3.org/2001/XMLSchema", 
         "http://www.w3.org/*/XMLSchema", NULL},
    {"ns1", "http://www.webserviceX.NET/", NULL, NULL},
    {NULL, NULL, NULL, NULL}
};
    soap->namespaces = namespaces; } };
    virtual ~CurrencyConvertorSoap() { if (soap) { soap_destroy(soap); 
        soap_end(soap); soap_done(soap); soap_del(soap); } };
    virtual int __ns1__ConversionRate(_ns1__ConversionRate 
        *ns1__ConversionRate, _ns1__ConversionRateResponse     
        *ns1__ConversionRateResponse) 
        { return soap ? soap_call___ns1__ConversionRate(soap, 
            endpoint, NULL, ns1__ConversionRate, 
            ns1__ConversionRateResponse) : SOAP_EOM; };
};
#endif

In this case, the method is only one and it is __ns1__ConversionRate.

The class takes two params. The first is the input (the two currencies) and the second is the output (the result).

Before you use the class method of WS, you must instantiate the param with soap_instantiate(), and with soap, from your CurrencyConvertor example.

C++
pConversionRate = (_ns1__ConversionRate*) 
    soap_instantiate(m_pCurrencyConvertor->soap,
    SOAP_TYPE__ns1__ConversionRate,"",
    "",pConversionRateSize);
    
    and 

pConversionRateResponse = (_ns1__ConversionRateResponse*) 
    soap_instantiate(m_pCurrencyConvertor->soap, 
    SOAP_TYPE__ns1__ConversionRateResponse,\
        "","",pConversionRateResponseSize);

This returns an int that is SOAP_OK, if all is well. (Note: You can find all other definitions for errors in stdsopa2.h.)

If this did not return SOAP_OK, you can use soap_print_fault to get the error string.

In the file Soaph.h, you can find methods you can use, like soap_s2ns1__Currency or soap_ns1__Currency2s. Just as the name explains, they are used to convert the currency to string and vice versa.

Using the Code CMyCurrencyConvertor

For the test, I have develop a new class CMyCurrencyConvertor that replaces the methods of CurrencyConvertor.

The class CMyCurrencyConvertor instantiates all the created pointers itself.

I have made only a few public methods and I use them in the dialog.

Constructor

In the constructor, I dynamically allocate at run time the object CurrencyConvertorSoap.

C++
CMyCurrencyConvertor::CMyCurrencyConvertor()
{
    m_pCurrencyConvertor= new CurrencyConvertorSoap;    
}

Destructor

In the destructor, I delete the memory allocated for CurrencyConvertorSoap.

C++
CMyCurrencyConvertor::~CMyCurrencyConvertor()
{    
    delete m_pCurrencyConvertor;    
}

Instantiate

I have two instantiates for the params, InstantiateRate and InstantiateRateResponse.

C++
_ns1__ConversionRate * CMyCurrencyConvertor::InstantiateRate()
{    
    _ns1__ConversionRate *pConversionRate;
    size_t *pConversionRateSize = new size_t;
    *pConversionRateSize = sizeof(_ns1__ConversionRate);

    pConversionRate = (_ns1__ConversionRate*)
        soap_instantiate(m_pCurrencyConvertor->soap,
        SOAP_TYPE__ns1__ConversionRate,"","",
        pConversionRateSize);
    
    delete pConversionRateSize ;

    return pConversionRate;
}

_ns1__ConversionRateResponse * CMyCurrencyConvertor::InstantiateRateResponse()
{    
    _ns1__ConversionRateResponse *pConversionRateResponse;
    size_t *pConversionRateResponseSize = new size_t;
    *pConversionRateResponseSize = sizeof(_ns1__ConversionRateResponse);

    pConversionRateResponse = (_ns1__ConversionRateResponse*) 
        soap_instantiate(m_pCurrencyConvertor->soap , \
        SOAP_TYPE__ns1__ConversionRateResponse,"",
        "",pConversionRateResponseSize);
    
    delete pConversionRateResponseSize ;

    return pConversionRateResponse;
}

GetConversionRate

I take two methods, one takes the input of string Code for currency and the other takes the type of code for currency.

C++
bool CMyCurrencyConvertor::GetConversionRate(ns1__Currency oFromCurrencyCode,
    ns1__Currency oToCurrencyCode, double &dRate)
{
    int iRet = SOAP_ERR;
    
    _ns1__ConversionRate            *pConversionRate;
    _ns1__ConversionRateResponse    *pConversionRateResponse;
    
    pConversionRate = InstantiateRate();
    pConversionRateResponse = InstantiateRateResponse();

    pConversionRate->FromCurrency = oFromCurrencyCode;
    pConversionRate->ToCurrency = oToCurrencyCode;

    iRet = m_pCurrencyConvertor->__ns1__ConversionRate(pConversionRate,
         pConversionRateResponse);
    
    switch(iRet)
    {
    case SOAP_OK :
        {
            dRate = pConversionRateResponse->ConversionRateResult;
            return true;
        }
            /*
        case SOAP_CLI_FAULT            
        case SOAP_SVR_FAULT            
        case SOAP_TAG_MISMATCH        
        case SOAP_TYPE            
        case SOAP_SYNTAX_ERROR        
        case SOAP_NO_TAG            
        case SOAP_IOB            
        case SOAP_MUSTUNDERSTAND        
        ...
        */
    default:
        {
            Log(GetSoapError());              
        }
    }    
    return false;
}

I create the two param pointers and instantiate them. I set the two currency code and call the ConversionRate.

If all works fine, I return the conversion, otherwise I return an error.

C++
// Conversion from String code
bool CMyCurrencyConvertor::GetConversionRate(CString sFromCurrencyCode,
    CString sToCurrencyCode, double &dRate)
{
    ns1__Currency oFromCurrencyCode; 
    ns1__Currency oToCurrencyCode;

    int iRetFromCurrencyCode = soap_s2ns1__Currency
      (m_pCurrencyConvertor->soap,sFromCurrencyCode, 
      &oFromCurrencyCode);

    int iRetToCurrencyCode = soap_s2ns1__Currency
      (m_pCurrencyConvertor->soap,sToCurrencyCode, 
      &oToCurrencyCode);

    return GetConversionRate(oFromCurrencyCode,oToCurrencyCode,dRate);    
}

With this method, you can call the function without knowing the internal type. For the conversion, I use the function soap_s2ns1__Currency.

GetSoapError

I add another method for retrieving the error from soap to string.

C++
CString CMyCurrencyConvertor::GetSoapError()
{ 
    struct soap *pSoap = m_pCurrencyConvertor->soap;
    CString sError;
    if (soap_check_state(pSoap ))
        sError.Format("Error: soap struct not initialized\n");
    else
    {
        if (pSoap->error)
        { 
            const char *pFaultCode, *pFaultSubCode = NULL, *pFalutString, 
                **iFaultCode;
            iFaultCode = soap_faultcode(pSoap );
            if (!*iFaultCode)
                soap_set_fault(pSoap );
            pFaultCode = *iFaultCode;
            if (pSoap ->version == 2)
                pFaultSubCode = *soap_faultsubcode(pSoap );
            pFalutString = *soap_faultstring(pSoap );
            iFaultCode = soap_faultdetail(pSoap );
            sError.Format("%s%d fault: %s [%s]\"%s\"Detail: %s", 
                pSoap->version ? "SOAP 1." :\
            "Error ", pSoap->version ? (int)pSoap->version : pSoap->error, 
                pFaultCode, \
            pFaultSubCode ? pFaultSubCode : "no subcode", 
                pFalutString ? pFalutString : "[no reason]", \
            iFaultCode && *iFaultCode ? *iFaultCode : "[no detail]");
        }
    }
    return sError;
}

String2Currency, Currency2String

This is a useful function to convert currency to printable string and vice versa:

C++
bool CMyCurrencyConvertor::String2Currency(CString sCurrencyCode,
     ns1__Currency &oCurrencyCode)
{
    int iRet = soap_s2ns1__Currency(m_pCurrencyConvertor->soap,
        sCurrencyCode, &oCurrencyCode);

    switch(iRet)
    {
    case SOAP_OK :
        {            
            return true;
        }
            /*
        case SOAP_CLI_FAULT            
        case SOAP_SVR_FAULT            
        case SOAP_TAG_MISMATCH        
        case SOAP_TYPE            
        case SOAP_SYNTAX_ERROR        
        case SOAP_NO_TAG            
        case SOAP_IOB            
        case SOAP_MUSTUNDERSTAND        
        ...
        */
    default:
        {
            Log(GetSoapError());              
        }
    }    
    return false;
}

bool CMyCurrencyConvertor::Currency2String(ns1__Currency oCurrencyCode,
     CString &sCurrencyCode)
{
    const char* sName = 
        soap_ns1__Currency2s(m_pCurrencyConvertor->soap,oCurrencyCode);
    if (sName != NULL)
    {
        CString sTMP(sName);
        sCurrencyCode = sTMP;
        return true;
    }
    else
        Log(GetSoapError());                          
    return false;
}

Using the Code in Dialog

I created a dialog project and I use the methods I describe again.

I take a cycle for retrieval, and display the currency code, like this:

C++
CString sCodeName;
    for (int iDx=ns1__Currency__AFA; iDx <;ns1__Currency__TRY+1; iDx++)
    {
        m_oMyCurrencyConvertor.Currency2String((ns1__Currency) iDx,
            sCodeName);

        m_cboFromCurrency.AddString(sCodeName);    
        m_cboToCurrency.AddString(sCodeName);    
    }  

When you push a button, I retrieve the currency codes selected and use GetConversionRate to call WS. <brif>

C++
double dRate;
CString sFromCurrency,sToCurrency;

m_cboFromCurrency.GetWindowText(sFromCurrency);
m_cboToCurrency.GetWindowText(sToCurrency);

if (m_oMyCurrencyConvertor.GetConversionRate(sFromCurrency,
    sToCurrency,dRate))
{
    int iColumnCount = m_lstConversionRate.GetItemCount();
    CString sRate;
    sRate.Format("%f",dRate);
    m_lstConversionRate.InsertItem(iColumnCount,sFromCurrency);
    m_lstConversionRate.SetItemText(iColumnCount,iIDX_TO,sToCurrency);
    m_lstConversionRate.SetItemText(iColumnCount,iIDX_CONVERSION,sRate);
}

Use it however you wish.

History

  • 12/07/2006: First release

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer (Senior) Welcome Italia spa
Italy Italy
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionHow to pass header information to the soap header SOAP_ENV__Header, in c++ using gsoap Pin
Member 147055627-Sep-11 3:37
Member 147055627-Sep-11 3:37 
AnswerRe: How to pass header information to the soap header SOAP_ENV__Header, in c++ using gsoap Pin
Dr.Luiji27-Sep-11 11:10
professionalDr.Luiji27-Sep-11 11:10 
GeneralRe: How to pass header information to the soap header SOAP_ENV__Header, in c++ using gsoap Pin
Member 147055627-Sep-11 19:40
Member 147055627-Sep-11 19:40 
GeneralRe: How to pass header information to the soap header SOAP_ENV__Header, in c++ using gsoap Pin
Member 147055628-Sep-11 4:33
Member 147055628-Sep-11 4:33 
Questioncalling web service with complex parameters Pin
AmVal12-Jul-11 3:10
AmVal12-Jul-11 3:10 
AnswerRe: calling web service with complex parameters Pin
Dr.Luiji14-Jul-11 9:51
professionalDr.Luiji14-Jul-11 9:51 
GeneralRe: calling web service with complex parameters Pin
AmVal14-Jul-11 10:10
AmVal14-Jul-11 10:10 
GeneralRe: calling web service with complex parameters Pin
Dr.Luiji14-Jul-11 10:32
professionalDr.Luiji14-Jul-11 10:32 
GeneralRe: calling web service with complex parameters Pin
AmVal14-Jul-11 10:45
AmVal14-Jul-11 10:45 
GeneralRe: calling web service with complex parameters [modified] Pin
Dr.Luiji14-Jul-11 11:23
professionalDr.Luiji14-Jul-11 11:23 
probably, but everything looks good, and it is an error that I've never seen.

The last thing I would do is remove the dependency on the string serviceCallNumber inserting it directly into the class ns1__processServiceCallNumber. As next step, I would change the server with the new structure and regenerate the client. At this stage it should work.
Dr.Luiji

Trust and you'll be trusted.

My Blog : The Code Is Art

GeneralRe: calling web service with complex parameters Pin
AmVal15-Jul-11 9:13
AmVal15-Jul-11 9:13 
GeneralRe: calling web service with complex parameters Pin
AmVal15-Jul-11 9:43
AmVal15-Jul-11 9:43 
GeneralRe: calling web service with complex parameters Pin
Dr.Luiji15-Jul-11 20:40
professionalDr.Luiji15-Jul-11 20:40 
GeneralMy vote of 5 Pin
Absa28-Feb-11 23:34
Absa28-Feb-11 23:34 
GeneralRe: My vote of 5 Pin
Dr.Luiji14-Jul-11 9:53
professionalDr.Luiji14-Jul-11 9:53 
Questionmemory leak? Pin
laoheshang6-Aug-10 4:13
laoheshang6-Aug-10 4:13 
AnswerRe: memory leak? Pin
Dr.Luiji8-Sep-10 22:45
professionalDr.Luiji8-Sep-10 22:45 
GeneralDoubt regarding minOccurs [modified] Pin
naveen_naik2-Feb-09 21:41
naveen_naik2-Feb-09 21:41 
GeneralRe: Doubt regarding minOccurs Pin
Dr.Luiji5-Feb-09 2:17
professionalDr.Luiji5-Feb-09 2:17 
GeneralSilly doubt.. What is 'g' in gSOAP Pin
naveen_naik29-Jan-09 0:05
naveen_naik29-Jan-09 0:05 
JokeRe: Silly doubt.. What is 'g' in gSOAP Pin
Dr.Luiji29-Jan-09 1:59
professionalDr.Luiji29-Jan-09 1:59 
GeneralRe: Silly doubt.. What is 'g' in gSOAP Pin
Hashim Saleem17-Feb-10 22:58
Hashim Saleem17-Feb-10 22:58 
Questionwsdl2h complier Pin
naveen_naik28-Jan-09 19:30
naveen_naik28-Jan-09 19:30 
GeneralRe: wsdl2h complier [modified] Pin
Dr.Luiji29-Jan-09 2:13
professionalDr.Luiji29-Jan-09 2:13 
GeneralRe: wsdl2h complier Pin
naveen_naik29-Jan-09 19:16
naveen_naik29-Jan-09 19:16 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.