CurrencyConvertor - How use gSOAP and WebServices - Part 1 Get ready with VC++ 6 from WSDL file
Introduction
In this article, I explain how to build a web service client
from a wsdl file. I am releasing this project to help those who won't
begin to use a web Service with gSOAP. I won't, however, be explaining
about XML Serialization, Transient Types, Memory Management, etc.
I split the article into two parts for easier learning, and
better understanding. In Part One I will explain how to get the class
from the wsdl file to be used in VC++ 6. In Part Two, I show you how to
use the classes generated with gSOAP.
To begin you will want:
- gSoap Toolkit - Download gSoap Toolkit for windows
and unzip it in a directory. You can download it form various sites. I
used the site SourceForge
and I downloaded the last release: gsoap_win32_2.7.8c.zip - WSDL - Download the "WSDL Schema Location"
and save it with a wsdl extension. I used this WSDL, you can use another like CryptoService, DotGetLocator etc.)
After downloading the file, you have to build a C++ class
(from the wsdl file). Go to gSoap dir and open bin sub-folder
(something like this: D:/gsoap-win32-2.7/bin). Here you find two
executable files:
- wsdl2h.exe
: Allows you do bindings in a C/C++ header file(.h) from the wsdl file you downloaded before. (intermediate header) - soapcpp2.exe
: Allows you to build a class with C++ formatting from the intermediate header.
Wsdl importer : Generates the file with C++ bindings
Copy the wdsl to this directory and run wsdl2h.exe
like this:
wsdl2h -o WSCurrencyConv.h CurrencyConvertor.wsdl
In the shell you'll see some warning (ignore this) and at
the end "To complete the process.compile with: soapcpp2
WSCurrencyConv.h". If all works fine you'll see a new file in the
directory that will be WSCurrencyConv.h
(or the name you write at the command line).
N.B. You shouldn't have problems, but if you do, check the name and path you entered and try again.
gSOAP compiler: generate the proxy and XML serialization routines in source-code format
Run soapcpp2.exe like this:
soapcpp2 -ID:/gsoap-win32-2.7/Import WSCurrencyConv.h
To run this executable you need to set the path for the
gSOAP import (something like this: D:/gsoap-win32-2.7/import). This is
similar to what I did before with -ID:/gsoap-win32-2.7/Import. The
second param is the file .h you entered the first time with wsdl2h. If
it works you'll see in the last line "Compilation successful". Now in
the directory you'll see a few new files.
N.B. You shouldn't have problems but if you do, check that
the path for the import file exists. Otherwise you can copy all the
files in the import directory to the bin directory and try again.
The new files will be:
- CurrencyConvertorSoap.ConversionRate.req.xml
- CurrencyConvertorSoap.ConversionRate.res.xml
- CurrencyConvertorSoap.nsmap
- soapC.cpp
- soapClient.cpp
- soapClientLib.cpp
- soapCurrencyConvertorSoapObject.h
- soapCurrencyConvertorSoapProxy.h
- soapH.h
- soapServer.cpp
- soapServerLib.cpp
- soapStub.h
Using the VC++
Now you have all you want to begin deploying your application with VC++.
Include self-generated code into VC++ project:
- You need to include in your app the files below:
- soapC.cpp
- soapH.h
- soapClient.cpp
- soapStub.h
- CurrencyConvertorSoap.nsmap
- soapCurrencyConvertorSoapProxy.h
- stdsoap2.h
(This file is in the D:/gsoap-win32-2.7/import is the same for all the SW) - stdsoap2.cpp
(This file is in the D:/gsoap-win32-2.7/import is the same for all the SW)
- Set the no precompiler header for the cpp files before.
- Go to Project Settings (Alt-F7)
- Change the Settings for: All configurations
- Select the cpp file before adding to the project.
- Go to the C++ tab, select the category "Precompiled headers" and select the radio button "Not using precompiled headers".
- Set the Namespace select the file stdafx.cpp
and include the file CurrencyConvertorSoap.nsmap
with this line- #include "CurrencyConvertorSoap.nsmap"
- Link the Ws2_32.lib
to the project for use the Windows Sockets 2 API.- Go to Project Settings (Alt-F7)
- Change the Settings for: All configurations
- Go to tab Link, category General, add Ws2_32.lib to Objcet/Library modules
The Project is ready to communicate with the WS. You have all the classes you need to begin.
N.B You could get this warning (shown below) but don't worry
and go ahead. This warning is derived from the self-generated class
with gSOAP; gSOAP doesn't check the maximum characters.
Points of Interest
I read many books online. I find there are numerous
mistakes, and that all the examples are unusable. These books may have
all you want to know in order to pass a university test, but there is
too much information to begin a project. Irritated, I did this project
to let you to begin to write a WS client.
History
- 12/07/2006: First release
About Dr.Luiji
 |
Bertoneri Luigi, alias Dr.Luiji Bachelor of Science in Computer science, year 2000 - University of Pisa (Italy). I currently live in Italy. Music I listen to: Slipknot, Type O Negative, Tool, Mushroomhead, Dry Kill Logic, System of a Down, White Zombie, RA, Slayer. Click here |