<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<meta http-equiv="cache-control" content="no-cache">
<title>Genivia - The iOS Plugin</title>
<link href="genivia_tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="genivia_content.css" rel="stylesheet" type="text/css">
</head>
<body>
<div id="top">
<div id="titlearea">
<table height="72px" width="100%" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="10%"> </td>
<td width="175px"><a href="https://www.genivia.com"><img alt="Genivia" src="GeniviaLogo2_trans_noslogan.png"/></a></td>
<td class="tab_home"><a href="https://www.genivia.com">Home</a></td>
<td class="tab_home"><a href="https://www.genivia.com/docs.html">Documentation</a></td>
<td>
<div style="float: right; font-size: 18px; font-weight: bold;">The iOS Plugin</div>
<br>
<div style="float: right; font-size: 10px;">updated Sun Sep 3 2017 by Robert van Engelen</div>
</td>
<td width="10%"> </td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li class="current"><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">The iOS Plugin </div> </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#title">The iOS Plugin</a></li>
<li class="level1"><a href="#ios_overview">Overview</a></li>
<li class="level1"><a href="#ios_start">Getting Started</a></li>
<li class="level1"><a href="#ios_cache_policy">Specifying the Cache Policy</a></li>
<li class="level1"><a href="#ios_timeout_interval">Specifying a Timeout Interval</a></li>
<li class="level1"><a href="#ios_http_auth">HTTP Authentication</a></li>
<li class="level1"><a href="#ios_example">Examples</a><ul><li class="level2"><a href="#ios_example_calc">Simple Calculator Example (C++)</a><ul><li class="level3"><a href="#ios_calc_step_1">Step 1: Generating stubs for C++ API</a></li>
<li class="level3"><a href="#ios_calc_step_2">Step 2: Creating Xcode project for iPhone</a></li>
<li class="level3"><a href="#ios_calc_step_3">Step 3: Adding generated source stubs to the Xcode project</a></li>
<li class="level3"><a href="#ios_calc_step_4">Step 4: Implementing the Logic by calling the soap service</a></li>
</ul>
</li>
<li class="level2"><a href="#ios_example_geoip">GeoIPService Example (C++)</a><ul><li class="level3"><a href="#ios_geoip_step_1">Step 1: Generating stubs for C++ Proxy</a></li>
<li class="level3"><a href="#ios_geoip_step_2">Step 2: Creating an Xcode project for iPhone</a></li>
<li class="level3"><a href="#ios_geoip_step_3">Step 3: Adding generated source stubs to the Xcode project</a></li>
<li class="level3"><a href="#ios_geoip_step_4">Step 4: Implementing the Logic by calling the soap service</a></li>
</ul>
</li>
<li class="level2"><a href="#ios_example_weather">Weather Example (C++)</a><ul><li class="level3"><a href="#ios_weather_step_1">Step 1: Generating stubs for C++ Proxy</a></li>
<li class="level3"><a href="#ios_weather_step_2">Step 2: Creating an Xcode project for iPhone</a></li>
<li class="level3"><a href="#ios_weather_step_3">Step 3: Adding generated source stubs to the Xcode project</a></li>
<li class="level3"><a href="#ios_weather_step_4">Step 4: Implementing the Logic by calling the soap service</a></li>
</ul>
</li>
<li class="level2"><a href="#ios_example_air">Air Example (C++)</a><ul><li class="level3"><a href="#ios_air_step_1">Step 1: Generating stubs for C++ Proxy</a></li>
<li class="level3"><a href="#ios_air_step_2">Step 2: Creating an Xcode project for iPhone</a></li>
<li class="level3"><a href="#ios_air_step_3">Step 3: Adding generated source stubs to the Xcode project</a></li>
<li class="level3"><a href="#ios_air_step_4">Step 4: Implementing the Logic by calling the soap service</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="textblock"><h1><a class="anchor" id="title"></a>
The iOS Plugin</h1>
<p>By Bethany Sanders, Robert van Engelen, Ning Xie, and Wei Zhang</p>
<h1><a class="anchor" id="ios_overview"></a>
Overview</h1>
<p>Consuming Web services on iOS (iPhone and iPad) platforms is increasingly in demand today. Xcode does not offer built-in tools that make consuming XML Web services easy. This means that detailed knowledge of XML processing is required to send SOAP/XML and XML REST requests to the Web services and parse the XML response. By contrast, the gSOAP toolkit offers an automated XML data binding toolkit for C and C++ to develop SOAP/XML Web services and clients. You can also use the iOS plugin to consume XML-RPC and JSON Web services with the <a href="https://www.genivia.com/doc/xml-rpc-json/html/index.html">XML-RPC & JSON/JSON-Path</a> plugin for gSOAP. The plugin makes it easy to consume Web services on iOS platforms, such as iPhone and iPad. Moreover, the plugin takes advantage of iOS network connectivity by supporting 3G/4G/LTE and wifi.</p>
<p>To use the iOS plugin for development of client applications on iOS platforms, register the plugin with the gSOAP engine context as follows:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "gsoapios.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> struct soap *soap = soap_new(); // new engine context</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> soap_register_plugin(soap, soap_ios); // register the iOS plugin</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> ...</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> </div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> soap_destroy(soap); // clean up deserialized data</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> soap_end(soap); // clean up temporaries</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> soap_free(soap); // free the context</div></div><!-- fragment --><p>When coding in C++, it is recommended to generate C++ proxy classes with soapcpp2 option -j which are then used to instantiate proxy objects that manage the gSOAP engine context to register with the plugin as follows:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "gsoapios.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> Proxy proxy;</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> soap_register_plugin(proxy.soap, soap_ios);</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> ...</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> </div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> proxy.destroy();</div></div><!-- fragment --><p>There are no other plugin API calls necessary to make a Web service client application work with iOS. This means that you can develop iOS apps that consume complex SOAP/XML, XML REST, and JSON Web services.</p>
<h1><a class="anchor" id="ios_start"></a>
Getting Started</h1>
<p>To start building Web services client applications for iPhone and/or iPad with gSOAP, you will need:</p>
<ul>
<li>The <a href="http://www.genivia.com/Products/downloads.html">gSOAP toolkit</a> version 2.8.50 or greater;</li>
<li>Xcode with the iOS SDK installed.</li>
</ul>
<p>Developing Web services client applications on iOS is no different than developing these applications on another OS with gSOAP when you use this iOS Plugin.</p>
<p>The steps to create a client application on iOS:</p>
<ul>
<li>Use wsdl2h and soapcpp2 to generate C++ code with client stubs or client proxy classes (soapcpp2 option -j) from WSDL and XSD files;</li>
<li>Create an iOS application project in Xcode;</li>
<li>Add stdsoap2.cpp and stdsoap2.h from the gSOAP package to your iOS project;</li>
<li>Add <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a> that are part of the iOS plugin files to your iOS project;</li>
<li>In your client code create an engine context and register the iOS plugin;</li>
<li>In your client code add the Web service methods invocations that you want, see the wsdl2h-generated header file (first step above) with interface declarations for instructions on how to invoke services.</li>
</ul>
<p>All of the source code files should be of type Objective C++ source. Mixing C files with C++ files will cause errors. Rename .c files to .cpp files as necessary.</p>
<h1><a class="anchor" id="ios_cache_policy"></a>
Specifying the Cache Policy</h1>
<p>The interaction between the client and the Web serviceserver can be controlled by specifying the cache policy. To specify the cache policy, use the API function <code><a class="el" href="gsoapios_8mm.html#a0dd8ddc18b78e14e9978a1369f02d97c" title="Sets cache policy The constants used to specify interaction with the cached responses are: ...">soap_ios_setcachepolicy(struct soap *soap, unsigned int policy)</a></code>. This API function cannot be called before the plugin is registered.</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "gsoapios.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> struct soap *soap = soap_new();</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> soap_register_plugin(soap, soap_ios);</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> // Specify the cache policy for the request</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> soap_ios_setchacepolicy(soap, NSURLRequestReturnCacheDataElseLoad);</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> ...</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> </div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> soap_destroy(soap); // clean up deserialized data</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> soap_end(soap); // clean up temporaries</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> soap_free(soap); // free the context</div></div><!-- fragment --><p>The available cache policies that can be specified are:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> enum {</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span>  NSURLRequestUseProtocolCachePolicy = 0,</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span>  NSURLRequestReloadIgnoringLocalCacheData = 1,</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span>  NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData,</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span>  NSURLRequestReturnCacheDataElseLoad = 2,</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  NSURLRequestReturnCacheDataDontLoad = 3,</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>  NSURLRequestReloadIgnoringLocalAndRemoteCacheData =4,</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  NSURLRequestReloadRevalidatingCacheData = 5</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> }</div></div><!-- fragment --><p>The default cache policy is <code>NSURLRequestUseProtocolCachePolicy</code>.</p>
<h1><a class="anchor" id="ios_timeout_interval"></a>
Specifying a Timeout Interval</h1>
<p>The timeout of a network connection can be specified using the API function <code><a class="el" href="gsoapios_8mm.html#a733a36a9b2649b17ba7693fc7cb25325" title="Sets timeout interval. ">soap_ios_settimeoutinterval(struct soap *soap, double seconds)</a></code>:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "gsoapios.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> struct soap *soap = soap_new();</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> soap_register_plugin(soap, soap_ios);</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> // Specify the timout interval as 30 seconds</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> soap_ios_settimeoutinterval(soap, 30.0);</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> ...</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> </div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> soap_destroy(soap); // clean up deserialized data</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> soap_end(soap); // clean up temporaries</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> soap_free(soap); // free the context</div></div><!-- fragment --><p>The default timeout is 60 seconds.</p>
<h1><a class="anchor" id="ios_http_auth"></a>
HTTP Authentication</h1>
<p>To support authentication when access is denied (HTTP 401 error) when the client tries to connect, enable HTTP authentication as follows.</p>
<p>Basic authentication is simply enabled at the client-side by setting the <code>soap.userid</code> and <code>soap.passwd</code> strings to a username and password, respectively:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> struct soap *soap = soap_new();</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> soap->userid = "someone";</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> soap->passwd = "somepass";</div></div><!-- fragment --><p>When using a generated C++ proxy class:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> Proxy proxy;</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> porxy.soap->userid = "someone";</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> porxy.soap->passwd = "somepass";</div></div><!-- fragment --><p>Make sure to <b>never use Basic authentication without HTTPS</b>. HTTPS must be used to ensure that Basic authentication is secure.</p>
<h1><a class="anchor" id="ios_example"></a>
Examples</h1>
<p>This section introduces four examples to demonstrate the development of client applications consuming Web services on iOS platforms, such as iPhone and iPad, by using the gSOAP tools and the iOS plugin.</p>
<p>The first example <a class="el" href="index.html#ios_example_calc">Simple Calculator Example (C++)</a> is a basic calculator client app. The second example <a class="el" href="index.html#ios_example_geoip">GeoIPService Example (C++)</a> is a web service that locates the country of a certain IP Adress. The third example <a class="el" href="index.html#ios_example_weather">Weather Example (C++)</a> returns weather results for well-known US cities, and the fourth example <a class="el" href="index.html#ios_example_air">Air Example (C++)</a> shows information on every airport within a given country.</p>
<p>We assume you already have had some experience developing applications for iPhone and iPad using Xcode with iOS SDK installed. Experience is not required to read on, but helpful in case you get lost in the details of the Xcode iOS SDK.</p>
<p>General recommendations:</p>
<ul>
<li>Rename .m files to .mm files;</li>
<li>Generate a C++ proxy class using soapcpp2 -j, which produces the source code you will need to access the Web service;</li>
<li>Add stdsoap2.cpp and stdsoap2.h from the gSOAP source code tree to your iOS project;</li>
<li>Add <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a> that are part of the iOS plugin files to your iOS project;</li>
<li>In your client code register the iOS plugin.</li>
</ul>
<h2><a class="anchor" id="ios_example_calc"></a>
Simple Calculator Example (C++)</h2>
<p>This example shows you how to develop a client application in C++ using gSOAP and the ios plugin, which consumes a simple calculator service on iOS using gSOAP. The simple calculator service was developed and deployed as a demo to <a href="http://www.genivia.com/dev.html">get started with gSOAP</a>. The gSOAP Calculator Service provides several operations such as add, sub, mul, div etc. In this example, we use the operation add as a demo. Other operations are applied in a similar way. The wsdl file for this service can be obtained at the following link: </p><pre class="fragment">http://www.genivia.com/calc.wsdl
</pre><p>The Xcode project for this example can be found in gsoap/ios_plugin/examples/calc.</p>
<h3><a class="anchor" id="ios_calc_step_1"></a>
Step 1: Generating stubs for C++ API</h3>
<p>The gsoap/ios_plugin/examples/calc directory already contains calc.h so you can skip this step.</p>
<p>To generate codes for the calculator Web service, we first run the wsdl2h tool from the command line on the URL of the WSDL and use option -o to specify the output file (Alternatively, you can download the calc.wsdl and use the local file instead of the URL): </p><pre class="fragment">wsdl2h -o calc.h http://www.genivia.com/calc.wsdl
</pre><p>This generates the calc.h service definition header file with service operation definitions and types for the operation's data. By default, gSOAP assumes you will use C++ with STL.</p>
<p>We have not yet generated the stubs for the API. To do so, run the soapcpp2 compiler: </p><pre class="fragment">soapcpp2 -CL -I$GSOAP_HOME/import calc.h
</pre><p>Option -CL indicates client-side only files (soapcpp2 generates both client and server stubs and skeletons by default). This generates a number of source files for client application development. We do not have to generate a proxy class in this example because it does not use a Proxy class.</p>
<h3><a class="anchor" id="ios_calc_step_2"></a>
Step 2: Creating Xcode project for iPhone</h3>
<p>Launch Xcode, create a Single View-based Application project and name it Calc. Open the ViewController.xib (main storyboard) file in the Interface Builder. Double-click on the View item and populate it with the views listed below and shown in Figure 1:</p>
<ul>
<li>Two Labels ("+" and "A Simple Calculator")</li>
<li>Two Text Fields (operand1 and operand2)</li>
<li>One Button ("Add" button)</li>
</ul>
<div class="image">
<img src="calc-view.png" alt="calc-view.png"/>
<div class="caption">
Figure 1. View of the Calculator Web Service Client App</div></div>
<p> In Xcode, edit the file ViewController.h to make it look like the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: ViewController.h</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> @interface ViewController : UIViewController {</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  UITextField *op1; // operand1</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>  UITextField *op2; // operand2</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> }</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> @property (nonatomic, retain) IBOutlet UITextField *op1; // this code is generated when you link the text fields</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> @property (nonatomic, retain) IBOutlet UITextField *op2; // this code is generated when you link the text fields</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> - (IBAction) buttonPressed;</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> @end</div></div><!-- fragment --><p>Link the op1 and op2 to the two Text Fields and delegate the button action to method buttonPressed.</p>
<p>In Xcode, edit the file info.plist to make it look like the following: </p><pre class="fragment"><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>armv7</string>
</array>
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
</dict>
</plist>
</pre><p>These changes ensure that you can access the web services despite the added layer of protection (App Transport Security).</p>
<h3><a class="anchor" id="ios_calc_step_3"></a>
Step 3: Adding generated source stubs to the Xcode project</h3>
<p>Add the source files soapC.cpp, soapClient.cpp, soapH.h, and soapStub.h generated in Step 1 of this tutorial to the project. Also add files stdsoap2.h and stdsoap2.cpp to the project from gSOAP package as well as the iOS plugin files <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>.</p>
<p>Once all of your files have been added to the project, ensure they are all of type "Objective C++ Source". This ensures that there will be no issues with mixing Objective C and C++ code.</p>
<h3><a class="anchor" id="ios_calc_step_4"></a>
Step 4: Implementing the Logic by calling the soap service</h3>
<p>Firstly, edit file main.mm to import the file calc.nsmap. Link errors may arise without importing this XML namespace mapping table.</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: main.mm</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "../../calc.nsmap"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> int main(int argc, char * argv[]) {</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>  @autoreleasepool {</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>  }</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> }</div></div><!-- fragment --><p>Then, implement the source file ViewController.mm as the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "ViewController.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> #import "soapStub.h"</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import "gsoapios.h"</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> @implementation ViewController</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> @synthesize op1; // Set or get operand1</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> @synthesize op2; // Set or get operand2</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> - (IBAction) buttonPressed {</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span>  double x = [op1.text doubleValue];</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span>  double y = [op2.text doubleValue];</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> </div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>  struct soap *soap = soap_new1(SOAP_IO_DEFAULT|SOAP_IO_KEEPALIVE|SOAP_XML_INDENT|SOAP_XML_STRICT);</div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> </div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  if (soap_register_plugin(soap, soap_ios) == SOAP_OK)</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  {</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  // Specify the timeout interval (optional) to 45 seconds instead of</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  // the default 60 seconds</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  soap_ios_settimeoutinterval(soap, 45.0);</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  double result;</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  // Call Web service operation add</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  int status = soap_call_ns2__add(soap, NULL, NULL,x, y, result);</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  soap_free_temp(soap); // Cleanup temporary resources</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  // Check soap response status</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  if (status == SOAP_OK)</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  {</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  NSString *resultString;</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  NSString *titleString;</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  resultString = [NSString stringWithFormat:@"%f",result];</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  titleString = [NSString stringWithFormat:@"%f + %f =",x, y];</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  // Show the result in an alert</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  UIAlertController * alert = [UIAlertController</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  alertControllerWithTitle:titleString</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  message:resultString</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  preferredStyle:UIAlertControllerStyleAlert];</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  UIAlertAction* cancelButton = [UIAlertAction</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  actionWithTitle:@"OK"</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  style:UIAlertActionStyleDefault</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  handler:^(UIAlertAction * action){}];</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  [alert addAction: cancelButton];</div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  [self presentViewController:alert animated:YES completion:nil];</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  }</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  else</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  soap_print_fault(soap,stderr); // Print soap error in console</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  }</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  soap_destroy(soap);</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  soap_end(soap);</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  soap_free(soap);</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> }</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> @end</div></div><!-- fragment --><p>A screen snapshot of the client is shown in Figure 2.</p>
<div class="image">
<img src="calc-result.png" alt="calc-result.png"/>
<div class="caption">
Figure 2: Snapshot of the CalcViewService result</div></div>
<h2><a class="anchor" id="ios_example_geoip"></a>
GeoIPService Example (C++)</h2>
<p><a href="http://www.webservicex.net/geoipservice.asmx?op=GetGeoIP">GeoIPService</a> is a live SOAP Web service that enables you to look up countries by IP address or by Context.</p>
<p>This example shows you how to develop a client application in C++ using gSOAP and the ios plugin, which consumes the GeoIPService on iOS using gSOAP. The WSDL file for this service can be downloaded at the following link: </p><pre class="fragment">http://www.webservicex.net/geoipservice.asmx?WSDL
</pre><p>It is crucial to follow these directions in order for your app to work:</p>
<ul>
<li>Rename the .m files to .mm files. The iOS plugin implementation file gsoapios.m must be renamed to <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>. The main.m must be renamed to main.mm. Other files such as your ViewController must also be renamed with .mm.</li>
<li>Generate C++ proxy using proper options with wsdl2h and soapcpp2.</li>
<li>Use stdsoap2.cpp from the gSOAP package in your iOS project.</li>
</ul>
<p>The Xcode project for this example can be found in gsoap/ios_plugin/examples/GeoIPService.</p>
<h3><a class="anchor" id="ios_geoip_step_1"></a>
Step 1: Generating stubs for C++ Proxy</h3>
<p>To generate codes for the GeoIPService Web service, we first run the wsdl2h tool from the command line on the URL of the WSDL and use option -o to specify the output file (alternatively, you can download the GeoIPService.wsdl file and use the local file instead of the URL): </p><pre class="fragment">wsdl2h -o GeoIPService.h -Ngeoip 'http://www.webservicex.net/geoipservice.asmx?WSDL'
</pre><p>This generates the GeoIPService.h service interface header file with service operation definitions and types for the operation's data. By default, gSOAP assumes you will use C++ with STL.</p>
<p>To generate the stubs for the C++ proxy classes, run the soapcpp2: </p><pre class="fragment">soapcpp2 -j -CL -I$GSOAP_HOME/import GeoIPService.h
</pre><p>Option -j tells the compiler to generate the C++ proxy class and option -CL indicates client-side only files (soapcpp2 generates both client and server stubs and skeletons by default). Option -I is needed to import the stlvector.h file from the import directory in the gSOAP package to support serialization of STL vectors.</p>
<h3><a class="anchor" id="ios_geoip_step_2"></a>
Step 2: Creating an Xcode project for iPhone</h3>
<p>Create a Single View-based Application project and name it GeoIPService.Open the ViewController.xib (main storyboard) file in the Interface Builder. Double-click on the View item and populate it with the views listed below and shown in Figure 3:</p>
<ul>
<li>A Label ("Enter IP Address")</li>
<li>A Text Field</li>
<li>One Round Rect Button ("Find Country" button)</li>
</ul>
<div class="image">
<img src="geoip-view.png" alt="geoip-view.png"/>
<div class="caption">
Figure 3. View of the GeoIPService Client</div></div>
<p> In Xcode, edit the file ViewController.h to make it look like the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: ViewController.h</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> @interface ViewController : UIViewController {</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  UITextField* IPAddress;</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> }</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> @property (strong, nonatomic) IBOutlet UITextField *IPAddress; // this code generated when you link the text</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> //field to IPAddress</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> - (IBAction) buttonPressed;</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> @end</div></div><!-- fragment --><p>Set the ipAddress outlet and the buttonFindCountry:(id)sender method to delegate action of the button.</p>
<p>In Xcode, edit the file info.plist to make it look like the following: </p><pre class="fragment"><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>armv7</string>
</array>
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
</dict>
</plist>
</pre><p>These changes ensure that you can access the web services despite the added layer of protection of App Transport Security).</p>
<h3><a class="anchor" id="ios_geoip_step_3"></a>
Step 3: Adding generated source stubs to the Xcode project</h3>
<p>Add the source files soapC.cpp, soapGeoIPServiceSoapProxy.cpp, soapGeoIPServiceSoapProxy.h, soapH.h, and soapStub.h generated in Step 1 of this tutorial to the project. Also add files stdsoap2.h and stdsoap2.cpp to the project from the gSOAP package and the iOS plugin files <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>.</p>
<p>Once all of your files have been added to the project, ensure they are all of type "Objective C++ Source". This ensures that there will be no issues with mixing Objective C and C++ code.</p>
<h3><a class="anchor" id="ios_geoip_step_4"></a>
Step 4: Implementing the Logic by calling the soap service</h3>
<p>Firstly, edit file main.mm to import the file GeoIPService.nsmap. Linking errors would arise without importing this XML namespace mapping table.</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: main.mm</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "AppDelegate.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> #include "../../GeoIPServiceSoap.nsmap"</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> int main(int argc, char * argv[]) {</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  @autoreleasepool {</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>  return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>  }</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> }</div></div><!-- fragment --><p>Then, implement the source file ViewController.mm as the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "ViewController.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> #include "soapGeoIPServiceSoapProxy.h"</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import "soapStub.h"</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "gsoapios.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> using namespace std;</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> typedef struct _ns1__GetGeoIP RequestStruct;</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> typedef struct _ns1__GetGeoIPResponse ResponseStruct;</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> @implementation ViewController</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> @synthesize IPAddress;</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> </div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> - (IBAction)buttonPressed:(id)sender {</div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  RequestStruct ip;</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  ResponseStruct response;</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  //creates proxy</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  GeoIPServiceSoapProxy service(SOAP_IO_DEFAULT|SOAP_IO_KEEPALIVE|SOAP_XML_INDENT|SOAP_XML_STRICT);</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  soap_init(service.soap);</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  //sets IPAddress from input</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  std::string ipAdd = std::string((char *)[IPAddress.text UTF8String]);</div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  ip.IPAddress = &ipAdd;</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  // ----- register plugin for callbacks ------</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  soap_register_plugin(service.soap, soap_ios);</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  // Optional: timeout internal, the default is 60.0 seconds</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  soap_ios_settimeoutinterval(service.soap, 30.0);</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  //call web service</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  int status = service.GetGeoIP(&ip, response);</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  string* result;</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  string err_msg = "Invalid IP address";</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  if (status == SOAP_OK)</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  {</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  NSString *soapResult;</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  NSString *titleMsg;</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  if (response.GetGeoIPResult && response.GetGeoIPResult->CountryName)</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  result = response.GetGeoIPResult->CountryName;</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  else</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  result = &err_msg;</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  soapResult = [NSString stringWithUTF8String:result->c_str()];</div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  titleMsg = [NSString stringWithFormat: @"%@", @"Country Found"];</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> </div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  //show result as an alert</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  UIAlertController * alert = [UIAlertController</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  alertControllerWithTitle:titleMsg</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  message:soapResult</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  preferredStyle:UIAlertControllerStyleAlert];</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  UIAlertAction* cancelButton = [UIAlertAction</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  actionWithTitle:@"OK"</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  style:UIAlertActionStyleDefault</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  handler:^(UIAlertAction * action){}];</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  [alert addAction: cancelButton];</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  [self presentViewController:alert animated:YES completion:nil];</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  }</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  else</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  service.soap_stream_fault(std::cerr);</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  service.destroy();</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> }</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> // Override to allow orientations other than the default portrait orientation.</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> - (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  // Return YES for supported orientations</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  return (interfaceOrientation == UIInterfaceOrientationPortrait ||</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  interfaceOrientation == UIInterfaceOrientationPortraitUpsideDown ||</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  interfaceOrientation == UIInterfaceOrientationLandscapeLeft ||</div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  interfaceOrientation == UIInterfaceOrientationLandscapeRight);</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> }</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> </div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> - (void)didReceiveMemoryWarning {</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  // Releases the view if it doesn't have a superview.</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  [super didReceiveMemoryWarning];</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  // Release any cached data, images, etc that aren't in use.</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> }</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span> </div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> - (void)viewDidUnload {</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  // Release any retained subviews of the main view.</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  // e.g. self.myOutlet = nil;</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> }</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span> </div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> - (void)dealloc {</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  // [ipAddress release];</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  // [super dealloc];</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> }</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span> @end</div></div><!-- fragment --><p>An image of the app is shown in Figure 4.</p>
<div class="image">
<img src="geoip-result.png" alt="geoip-result.png"/>
<div class="caption">
Figure 4: Snapshot of the GeoIPServiceViewService result</div></div>
<h2><a class="anchor" id="ios_example_weather"></a>
Weather Example (C++)</h2>
<p>GlobalWeather is a live SOAP Web service that enables you to look up the Weather in popular cities around the world. For simplicity, this example is limited to cities in the United States. For some reason, some very popular cities are not supported by this web service. For example, no results for New York City will be returned. There is an error message within the app that shows whenever one of these cities is entered. Know that the error message is not an issue with the app you just built, but something that the web service itself does not provide.</p>
<p>This example shows how to develop a client application in C++ using gSOAP and the ios plugin, which consumes the Weather service on iOS using gSOAP. The WSDL file for this service can be downloaded at the following link: </p><pre class="fragment">http://www.webservicex.net/globalweather.asmx?WSDL
</pre><p>It is crucial to follow these directions in order for your app to work:</p>
<ul>
<li>Rename the .m files to .mm files. The iOS plugin implementation file gsoapios.m must be renamed to <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>. The main.m must be renamed to main.mm. Other files such as your ViewController must also be renamed with .mm.</li>
<li>Generate C++ proxy using proper options with wsdl2h and soapcpp2.</li>
<li>Use stdsoap2.cpp from the gSOAP package in your iOS project.</li>
</ul>
<p>The Xcode project for this example can be found in gsoap/ios_plugin/examples/Weather.</p>
<h3><a class="anchor" id="ios_weather_step_1"></a>
Step 1: Generating stubs for C++ Proxy</h3>
<p>To generate codes for the GeoIPService Web service, we first run the wsdl2h tool from the command line on the URL of the WSDL and use option -o to specify the output file (Alternatively, you can download the GlobalWeather.wsdl file and use the local file instead of the URL): </p><pre class="fragment">wsdl2h -o weather.h 'http://www.webservicex.net/globalweather.asmx?WSDL'
</pre><p>This generates the weather.h service definition header file with service operation definitions and types for the operation's data. By default, gSOAP assumes you will use C++ with STL.</p>
<p>To generate the stubs for the C++ proxy classes, run the soapcpp2 tool: </p><pre class="fragment">soapcpp2 -j -CL -I$GSOAP_HOME/import weather.h
</pre><p>Option -j tells soapcpp2 to generate the C++ proxy class and option -CL indicates client-side only files (soapcpp2 generates both client and server stubs and skeletons by default). Option -I is needed to import the stlvector.h file from the import directory in the gSOAP package to support serialization of STL vectors.</p>
<h3><a class="anchor" id="ios_weather_step_2"></a>
Step 2: Creating an Xcode project for iPhone</h3>
<p>Create a Single View-based Application project and name it Weather. Open the ViewController.xib(main storyboard) file in the Interface Builder.Double-click on the View item and populate it with the views listed below and shown in Figure 3:</p>
<ul>
<li>A Label ("Enter US City")</li>
<li>A Text Field</li>
<li>One Round Rect Button ("Get Weather Results" button)</li>
</ul>
<p>In Xcode, edit the file ViewController.h to make it look like the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> @interface ViewController : UIViewController {</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span>  UITextField* inputcity;</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> }</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> @property (strong, nonatomic) IBOutlet UITextField *inputcity;</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> </div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> - (IBAction) buttonPressed;</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> @end</div></div><!-- fragment --><p>Set the inputcity outlet and the buttonFindCountry:(id)sender method to delegate action of the button.</p>
<p>In Xcode, edit the file info.plist to make it look like the following: </p><pre class="fragment"> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>armv7</string>
</array>
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
</dict>
</plist>
</pre><p>These changes ensure that you can access the web services despite the added layer of protection of App Transport Security).</p>
<h3><a class="anchor" id="ios_weather_step_3"></a>
Step 3: Adding generated source stubs to the Xcode project</h3>
<p>Add the source files soapC.cpp, soapGloabalWeatherSoapProxy.cpp, soapGloabalWeatherSoapProxy.h, soapH.h, and soapStub.h generated in Step 1 of this tutorial to the project. Also add files stdsoap2.h and stdsoap2.cpp to the project from gsoap package and the iOS plugin files <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>.</p>
<p>Once all of your files have been added to the project, ensure they are all of type "Objective C++ Source". This ensures that there will be no issues with mixing Objective C and C++ code.</p>
<h3><a class="anchor" id="ios_weather_step_4"></a>
Step 4: Implementing the Logic by calling the soap service</h3>
<p>Firstly, edit file main.mm to import the file GlobalWeatherSoap.nsmap. Linking errors would arise without importing this XML namespace mapping table.</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: main.mm</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "AppDelegate.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> #include "../../GlobalWeatherSoap.nsmap"</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> int main(int argc, char * argv[]) {</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  @autoreleasepool {</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>  return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>  }</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> }</div></div><!-- fragment --><p>Then, implement the source file ViewController.mm as the following, where we used the <a href="http://www.genivia.com/doc/dom/html">gSOAP domcpp</a> tool with option -i on an example weather XML data file to produce DOM code to extract the XML data (see further below):</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "ViewController.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> #include "soapGlobalWeatherSoapProxy.h"</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import "soapStub.h"</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "gsoapios.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> #include <fstream></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> typedef struct _ns__GetWeather RequestStruct;</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> typedef struct _ns__GetWeatherResponse ResponseStruct;</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> @implementation ViewController</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> @synthesize inputcity;</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> - (IBAction)buttonPressed:(id)sender {</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>  RequestStruct sending;</div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  ResponseStruct receiving;</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  std::string result = "";</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  GlobalWeatherSoapProxy service;</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  soap_init(service.soap);</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> </div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  // ----- register plugin for callbacks ------</div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  soap_register_plugin(service.soap, soap_ios);</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  std::string cname= std::string((char *)[inputcity.text UTF8String]);</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  sending.CityName = &cname;</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  std::string USA = "United States";</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  sending.CountryName = &USA;</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  if (service.GetWeather(&sending, receiving) == SOAP_OK)</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  {</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  std::ofstream xmlwrite("/Users/bethanysanders/Documents/work/Weather/Weather/message.txt");</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  std::ifstream xmlread("/Users/bethanysanders/Documents/work/Weather/Weather/message.txt");</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  if(xmlwrite.is_open())</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  {</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  xmlwrite << *(receiving.GetWeatherResult);</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  xmlwrite.close();</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  struct soap *ctx = soap_new1(SOAP_C_UTFSTRING | SOAP_XML_INDENT | SOAP_DOM_TREE);</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  ctx->double_format = "%lG";</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> </div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  xsd__anyType dom(ctx);</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  if (xmlread.is_open())</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  xmlread >> dom;</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  if (dom.soap->error)</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  result = "Error: Try a different city";</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  xsd__anyAttribute *att;</div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  xsd__anyType *elt;</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> </div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  if ((elt = dom.elt_get("Wind")))</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  {</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  xsd__anyType& dom_Wind = *elt;</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  if (dom_Wind.get_text())</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  {</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  result += "Wind = ";</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  result += dom_Wind.get_text();</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  }</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  }</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  if ((elt = dom.elt_get("Visibility")))</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  {</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  xsd__anyType& dom_Visibility = *elt;</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  if(dom_Visibility.get_text())</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  {</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  result += "\nVisibility = ";</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  result += dom_Visibility.get_text();</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  }</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> </div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  }</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  if ((elt = dom.elt_get("SkyConditions")))</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  {</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  xsd__anyType& dom_SkyConditions = *elt;</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  if (dom_SkyConditions.get_text())</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  {</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  result += "\nSky Conditions = ";</div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  result += dom_SkyConditions.get_text();</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  }</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  }</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  if ((elt = dom.elt_get("Temperature")))</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  {</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  xsd__anyType& dom_Temperature = *elt;</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  if (dom_Temperature.get_text())</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  {</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  result += "\nTemperature = ";</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  result += dom_Temperature.get_text();</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  }</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  }</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  if ((elt = dom.elt_get("DewPoint")))</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  {</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  xsd__anyType& dom_DewPoint = *elt;</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  if (dom_DewPoint.get_text())</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  {</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  result += "\nDew Point = ";</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  result += dom_DewPoint.get_text();</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  }</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  }</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  if ((elt = dom.elt_get("RelativeHumidity")))</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  {</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  xsd__anyType& dom_RelativeHumidity = *elt;</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  if (dom_RelativeHumidity.get_text())</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  {</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  result += "\nRelative Humidity = ";</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  result += dom_RelativeHumidity.get_text();</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  }</div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  }</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  if ((elt = dom.elt_get("Pressure")))</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  {</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  xsd__anyType& dom_Pressure = *elt;</div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  if (dom_Pressure.get_text())</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  {</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  result += "\nPressure = ";</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  result += dom_Pressure.get_text();</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  }</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  }</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  xmlread.close();</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  soap_destroy(ctx); // delete objects</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  soap_end(ctx); // delete DOM data</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  soap_free(ctx); // free context</div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  }</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  }</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  NSString *titleMsg;</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  NSString *Weather;</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  titleMsg = [NSString stringWithFormat: @"%@", @"Weather Results"];</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  Weather = [NSString stringWithUTF8String:result.c_str()];</div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span> </div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  //show result as an alert</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  UIAlertController * alert = [UIAlertController</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  alertControllerWithTitle:titleMsg</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  message:Weather</div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  preferredStyle:UIAlertControllerStyleAlert];</div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  UIAlertAction* cancelButton = [UIAlertAction</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  actionWithTitle:@"OK"</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  style:UIAlertActionStyleDefault</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  handler:^(UIAlertAction * action){}];</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  [alert addAction: cancelButton];</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  [self presentViewController:alert animated:YES completion:nil];</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> </div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  service.destroy();</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> }</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> - (void)viewDidLoad {</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  [super viewDidLoad];</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  // Do any additional setup after loading the view, typically from a nib.</div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span> }</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span> </div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> - (void)didReceiveMemoryWarning {</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  [super didReceiveMemoryWarning];</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  // Dispose of any resources that can be recreated.</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> }</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span> </div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> @end</div></div><!-- fragment --><p>You will notice there is much more code in this example's ViewController.mm. This is because this web service stores the whole XML response within a string instead of appropriate variables. The dom parser can fix this situation so that you can still access your results without having to parse the XML yourself. The dom code in this example was generated via command line in UNIX. To do so, once you have dom executable in your working directory, just execute the command </p><pre class="fragment">./domcpp -i weather.xml
</pre><p>where weather.xml is a file that stores an example xml response. Option -i tells the domcpp tool to generate the code you need to parse your result. To obtain an example XML response, test the web service on <a href="http://www.webservicex.net/New/Home/ServiceDetail/56">http://www.webservicex.net/New/Home/ServiceDetail/56</a>.</p>
<p>The domcpp tool is found in gsoap/samples/dom and should be built in that directory with: </p><pre class="fragment">make domcpp
</pre><p>Then move or copy the domcpp executable to use it for your projects.</p>
<p>For more information about domcpp, read <a href="https://www.genivia.com/doc/dom/html/index.html">XML DOM and XPath</a> of the gSOAP documentation.</p>
<h2><a class="anchor" id="ios_example_air"></a>
Air Example (C++)</h2>
<p>Airport Information Web Service is a live SOAP Web service that enables you to look up Airport Information of countries around the world. For some reason, some very well known countries are not supported by this web service. For example, no results for Russia will be returned. There is an error message within the app that shows whenever one of these countries is entered. Know that the error message is not an issue with the app you just built, but information that the web service itself does not provide.</p>
<p>This example shows how to develop a client application in C++ using gSOAP and the ios plugin, which consumes the Weather service on iOS using gSOAP. The WSDL file for this service can be downloaded at the following link: <a href="http://www.webservicex.net/airport.asmx?WSDL">http://www.webservicex.net/airport.asmx?WSDL</a></p>
<p>It is crucial to follow these directions in order for your app to work:</p>
<ul>
<li>Rename the .m files to .mm files. The iOS plugin implementation file gsoapios.m must be renamed to <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>. The main.m must be renamed to main.mm. Other files such as your ViewController must also be renamed with .mm.</li>
<li>Generate C++ proxy using proper options with wsdl2h and soapcpp2.</li>
<li>Use the stdsoap2.cpp instead of stdsoap2.c from the gSOAP package in your iOS project.</li>
</ul>
<p>The Xcode project for this example can be found in gsoap/ios_plugin/examples/Air.</p>
<h3><a class="anchor" id="ios_air_step_1"></a>
Step 1: Generating stubs for C++ Proxy</h3>
<p>To generate codes for the GeoIPService Web service, we first run the wsdl2h tool from the command line on the URL of the WSDL and use option -o to specify the output file (Alternatively, you can download the airport.wsdl file and use the local file instead of the URL): </p><pre class="fragment">wsdl2h -o airport.h 'http://www.webservicex.net/airport.asmx?WSDL'
</pre><p>This generates the airport.h service definition header file with service operation definitions and types for the operation's data. By default, gSOAP assumes you will use C++ with STL.</p>
<p>To generate the stubs for the C++ proxy classes, run the soapcpp2. compiler: </p><pre class="fragment">soapcpp2 -j -CL -I$GSOAP_HOME/import airport.h
</pre><p>Option -j tells the compiler to generate the C++ proxy class and option -CL indicates client-side only files (soapcpp2 generates both client and server stubs and skeletons by default). Option -I is needed to import the stlvector.h file from the import directory in the gSOAP package to support serialization of STL vectors.</p>
<h3><a class="anchor" id="ios_air_step_2"></a>
Step 2: Creating an Xcode project for iPhone</h3>
<p>Create a Single View-based Application project and name it Air. Open the ViewController.xib(main storyboard) file in the Interface Builder.Double-click on the View item and populate it with the views listed below and shown in Figure 3:</p>
<ul>
<li>A Label ("Enter Country")</li>
<li>A Text Field</li>
<li>One Round Rect Button ("Get Airport Information" button)</li>
<li>One Text View (to show the results)</li>
</ul>
<p>In Xcode, edit the file ViewController.h to make it look like the following:</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> @interface ViewController : UIViewController {</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span>  UITextField* country_name;</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span>  UITextView* showResults;</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> }</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> @property (strong, nonatomic) IBOutlet UITextField *country_name;</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> @property (strong, nonatomic) IBOutlet UITextView *showResults;</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> </div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> -(IBAction) buttonPressed;</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> @end</div></div><!-- fragment --><p>Set the <code>country_name</code> and <code>showResults</code> outlets and the <code>buttonFindCountry:(id)sender</code> method to delegate action of the button.</p>
<p>In Xcode, edit the file info.plist to make it look like the following: </p><pre class="fragment"><?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSRequiresIPhoneOS</key>
<true/>
<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>
<key>UIMainStoryboardFile</key>
<string>Main</string>
<key>UIRequiredDeviceCapabilities</key>
<array>
<string>armv7</string>
</array>
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
</array>
</dict>
</plist>
</pre><p>These changes ensure that you can access the web services despite the added layer of protection of App Transport Security).</p>
<h3><a class="anchor" id="ios_air_step_3"></a>
Step 3: Adding generated source stubs to the Xcode project</h3>
<p>Add the source files soapC.cpp, soapairportSoapProxy.cpp, soapairportSoapProxy.h, soapH.h, and soapStub.h generated in Step 1 of this tutorial to the project. Also add files stdsoap2.h and stdsoap2.cpp to the project from the gSOAP package and the iOS plugin files <a class="el" href="gsoapios_8h.html">gsoapios.h</a> and <a class="el" href="gsoapios_8mm.html">gsoapios.mm</a>.</p>
<p>Once all of your files have been added to the project, ensure they are all of type "Objective C++ Source". This ensures that there will be no issues with mixing Objective C and C++ code.</p>
<h3><a class="anchor" id="ios_air_step_4"></a>
Step 4: Implementing the Logic by calling the soap service</h3>
<p>Firstly, edit file main.mm to import the file airportSoap.nsmap. Linking errors would arise without importing this XML namespace mapping table.</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> // File: main.mm</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import <UIKit/UIKit.h></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "AppDelegate.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> #include "../../airportSoap.nsmap"</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> int main(int argc, char * argv[]) {</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  @autoreleasepool {</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>  return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>  }</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> }</div></div><!-- fragment --><p>Then, we implement the source file ViewController.mm as the following, where we used the <a href="http://www.genivia.com/doc/dom/html">gSOAP domcpp</a> tool with option -i on an example weather XML data file to produce DOM code to extract the XML data (see further below)</p>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> #import "ViewController.h"</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> #include "soapairportSoapProxy.h"</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> #import "soapStub.h"</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> #import "gsoapios.h"</div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> #include <fstream></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> @interface ViewController ()</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> @end</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> </div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> @implementation ViewController</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> @synthesize country_name;</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> @synthesize showResults;</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> </div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> - (IBAction)buttonPressed:(id)sender {</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  _ns1__GetAirportInformationByCountry sending;</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  _ns1__GetAirportInformationByCountryResponse receiving;</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  std::string result = ""; //stores resulting data</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  bool webserviceresult = true; //keeps track of if the web service returns a readable result</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> </div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  airportSoapProxy service;</div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  soap_init(service.soap);</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  // ----- register plugin for callbacks ------</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  soap_register_plugin(service.soap, soap_ios);</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  std::string countryname = std::string((char*)[country_name.text UTF8String]);</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  sending.country = &countryname;</div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> </div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  std::ofstream out("/Users/bethanysanders/Documents/work/Air/Air/xmlmessage.txt");</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  std::ifstream in("/Users/bethanysanders/Documents/work/Air/Air/xmlmessage.txt");</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  if (service.GetAirportInformationByCountry(&sending,receiving) == SOAP_OK)</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  if (out.is_open())</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  out << *(receiving.GetAirportInformationByCountryResult);</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  out.close();</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  struct soap *ctx = soap_new1(SOAP_C_UTFSTRING | SOAP_XML_INDENT | SOAP_DOM_TREE);</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  ctx->double_format = "%lG";</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> </div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  xsd__anyType dom(ctx);</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  if (in.is_open())</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  in >> dom;</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  if (dom.soap->error)</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  webserviceresult = false;</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  xsd__anyType *elt;</div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  for (xsd__anyType *it = dom.elt_get("Table"); it; it = it->get_next())</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  {</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  xsd__anyType& dom_Table = *it;</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  if ((elt = dom_Table.elt_get("AirportCode")))</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  {</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  xsd__anyType& dom_Table_AirportCode = *elt;</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  if (dom_Table_AirportCode.get_text())</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  {</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  result += "\n\nAirport Code = ";</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  result += dom_Table_AirportCode.get_text();</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  }</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  }</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  if ((elt = dom_Table.elt_get("CityOrAirportName")))</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  {</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  xsd__anyType& dom_Table_CityOrAirportName = *elt;</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  if (dom_Table_CityOrAirportName.get_text())</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  {</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  result += "\nCity or Airport Name = ";</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  result += dom_Table_CityOrAirportName.get_text();</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  }</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  }</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  if ((elt = dom_Table.elt_get("Country")))</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  {</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  xsd__anyType& dom_Table_Country = *elt;</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  if (dom_Table_Country.get_text())</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  {</div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  result += "\nCountry = ";</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  result += dom_Table_Country.get_text();</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  }</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  }</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  if ((elt = dom_Table.elt_get("CountryAbbrviation")))</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  {</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  xsd__anyType& dom_Table_CountryAbbrviation = *elt;</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  if (dom_Table_CountryAbbrviation.get_text())</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  {</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  result += "\nCountry Abbreviation = ";</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  result += dom_Table_CountryAbbrviation.get_text();</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  }</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  }</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  if ((elt = dom_Table.elt_get("CountryCode")))</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  {</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  xsd__anyType& dom_Table_CountryCode = *elt;</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  if (dom_Table_CountryCode.get_text())</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  {</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  result += "\nCountry Code = ";</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  result += dom_Table_CountryCode.get_text();</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  }</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  }</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  if ((elt = dom_Table.elt_get("GMTOffset")))</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  {</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  xsd__anyType& dom_Table_GMTOffset = *elt;</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  if (dom_Table_GMTOffset.get_text())</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  {</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  result += "\nGMT Offset = ";</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  result += dom_Table_GMTOffset.get_text();</div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  }</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  }</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  if ((elt = dom_Table.elt_get("RunwayLengthFeet")))</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  {</div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  xsd__anyType& dom_Table_RunwayLengthFeet = *elt;</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  if (dom_Table_RunwayLengthFeet.get_text())</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  {</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  result += "\nRunway Length (feet) = ";</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  result += dom_Table_RunwayLengthFeet.get_text();</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  }</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  }</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  if ((elt = dom_Table.elt_get("RunwayElevationFeet")))</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  {</div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  xsd__anyType& dom_Table_RunwayElevationFeet = *elt;</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  if (dom_Table_RunwayElevationFeet.get_text())</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  {</div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  result += "\nRunway Elevation (feet) = ";</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  result += dom_Table_RunwayElevationFeet.get_text();</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  }</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  }</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  if ((elt = dom_Table.elt_get("LatitudeDegree")))</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  {</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  xsd__anyType& dom_Table_LatitudeDegree = *elt;</div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  if (dom_Table_LatitudeDegree.get_text())</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  {</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  result += "\nLatitude Degree = ";</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  result += dom_Table_LatitudeDegree.get_text();</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  }</div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  }</div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  if ((elt = dom_Table.elt_get("LatitudeMinute")))</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  {</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  xsd__anyType& dom_Table_LatitudeMinute = *elt;</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  if (dom_Table_LatitudeMinute.get_text())</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  {</div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  result += "\nLatitude Minute = ";</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  result += dom_Table_LatitudeMinute.get_text();</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  }</div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  }</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  if ((elt = dom_Table.elt_get("LatitudeSecond")))</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  {</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  xsd__anyType& dom_Table_LatitudeSecond = *elt;</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  if (dom_Table_LatitudeSecond.get_text())</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  {</div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  result += "\nLatitude Second = ";</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  result += dom_Table_LatitudeSecond.get_text();</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  }</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  }</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  if ((elt = dom_Table.elt_get("LatitudeNpeerS")))</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  {</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  xsd__anyType& dom_Table_LatitudeNpeerS = *elt;</div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  if (dom_Table_LatitudeNpeerS.get_text())</div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  {</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  result += "\nLatitude N or S = ";</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  result += dom_Table_LatitudeNpeerS.get_text();</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  }</div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  }</div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  if ((elt = dom_Table.elt_get("LongitudeDegree")))</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  {</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  xsd__anyType& dom_Table_LongitudeDegree = *elt;</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  if (dom_Table_LongitudeDegree.get_text())</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  {</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  result += "\nLongitude Degree = ";</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  result += dom_Table_LongitudeDegree.get_text();</div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  }</div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  }</div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  if ((elt = dom_Table.elt_get("LongitudeMinute")))</div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  {</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  xsd__anyType& dom_Table_LongitudeMinute = *elt;</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  if (dom_Table_LongitudeMinute.get_text())</div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  {</div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  result += "\nLongitude Minute = ";</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  result += dom_Table_LongitudeMinute.get_text();</div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  }</div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  }</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  if ((elt = dom_Table.elt_get("LongitudeSeconds")))</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  {</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  xsd__anyType& dom_Table_LongitudeSeconds = *elt;</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  if (dom_Table_LongitudeSeconds.get_text())</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  {</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  result += "\nLongitude Second = ";</div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  result += dom_Table_LongitudeSeconds.get_text();</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  }</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  }</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  if ((elt = dom_Table.elt_get("LongitudeEperW")))</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  {</div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  xsd__anyType& dom_Table_LongitudeEperW = *elt;</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  if (dom_Table_LongitudeEperW.get_text())</div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  {</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  result += "\nLongitude E or W = ";</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  result += dom_Table_LongitudeEperW.get_text();</div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  }</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  }</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  }</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span> </div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  NSString *airPorts = [NSString stringWithUTF8String:result.c_str()];</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  if (result == "" || !webserviceresult)</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  airPorts = [NSString stringWithFormat: @"%@", @"Error: no know information. Try a different country."];</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  showResults.editable = NO;</div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  showResults.showsVerticalScrollIndicator = YES;</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  showResults.text = airPorts;</div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span> </div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  soap_destroy(ctx); // delete objects</div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  soap_end(ctx); // delete DOM data</div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  soap_free(ctx); // free context</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span> </div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  service.destroy();</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span> }</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span> - (void)viewDidLoad {</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  [super viewDidLoad];</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  // Do any additional setup after loading the view, typically from a nib.</div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span> }</div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> </div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span> - (void)didReceiveMemoryWarning {</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  [super didReceiveMemoryWarning];</div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  // Dispose of any resources that can be recreated.</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span> }</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> @end</div></div><!-- fragment --><p>You will notice there is much more code in this example's ViewController.mm. This is because this web service stores the whole XML response within a string instead of appropriate variables. The dom parser can fix this situation so that you can still access your results without having to parse the XML yourself. The dom code in this example was generated via command line in UNIX. To do so, once you have dom executable in your working directory, just execute the command </p><pre class="fragment">./domcpp -i airPorts.xml
</pre><p>where airPorts.xml is a file that stores an example xml response. The option -i is what tells the dom tool to generate the code you need to parse your result. To obtain an example XML response, test the web service on <a href="http://www.webservicex.net/New/Home/ServiceDetail/20">http://www.webservicex.net/New/Home/ServiceDetail/20</a>.</p>
<p>The domcpp tool is found in gsoap/samples/dom and should be built in that directory with: </p><pre class="fragment">make domcpp
</pre><p>Then move or copy the domcpp executable to use it for your projects.</p>
<p>For more information about domcpp, read <a href="https://www.genivia.com/doc/dom/html/index.html">XML DOM and XPath</a> of the gSOAP documentation. </p>
</div></div><!-- contents -->
<hr class="footer">
<address class="footer">
Copyright (C) 2017, Robert van Engelen, Genivia Inc., All Rights Reserved.
</address>
<address class="footer"><small>
Converted on Sun Sep 3 2017 10:05:34 by <a target="_blank" href="http://www.doxygen.org/index.html">Doxygen</a> 1.8.11</small></address>
<br>
<div style="height: 246px; background: #DBDBDB;">
</body>
</html>
