roshan 2004/06/16 21:37:19
Modified: targets/axis/cpp winuser-guide.pdf winuser-guide.html
Log:
Modified the windows user guide.Changed by Sevwandi
Revision Changes Path
1.17 +189 -183 ws-site/targets/axis/cpp/winuser-guide.pdf
<<Binary file>>
1.18 +12 -9 ws-site/targets/axis/cpp/winuser-guide.html
Index: winuser-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/winuser-guide.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- winuser-guide.html 16 Jun 2004 10:51:40 -0000 1.17
+++ winuser-guide.html 17 Jun 2004 04:37:19 -0000 1.18
@@ -292,6 +292,7 @@
<br>
<strong>Before you follow this guide, make sure that you have followed the</strong>
<a href="wininstall-guide.html"><strong>Windows Installation guide</strong></a>
</p>
+<p>Definitions:<br>AXIS_EXTRACT -> The folder to which the Axis c++ binary
distribution is extracted<br>AXIS_FOLDER -> The deploy folder from the binary
distribution copied to the apache installation</p>
<p>
<a name="create"></a>
</p>
@@ -355,7 +356,8 @@
</div>
<br>
<p>With the WSDL2WS tool you have almost developed your client. What you have to do
next is write a file which has a main method and create an object of the stub and
invoke your methods on that.<br>1) Create a vc workspace.<br>2) Create a 'Win32
Console Application'.<br>3) Add files to this project from the above generated
'ClientOut' folder.<br>4) Set the include path to the include directory of the binary
distribution.<br>5) Add the following libs to the library modules path of this
project.<br>
-<br>AXIS_EXTRACT/lib/axis/<br>Axisclient.lib<br>AxisServer.lib<br>AxisTransport.lib<br>AxisXMLParser.lib<br>6)
Create a file with the main method which looks similar to the following and add this
file to this project.<br>
+<br>AXIS_EXTRACT/lib/axis/<br>Axisclient.lib<br>
+<br>6) Create a file with the main method which looks similar to the following and
add this file to this project.<br>
</p>
<pre>#include "Calculator.h"
int main()
@@ -384,13 +386,14 @@
<div class="h4">
<h4>Transport Library and Parser Library</h4>
</div>
-<p>AxisTransport.dll should be placed in the path that's specified by axiscpp.conf
(AXIS_FOLDER/axiscpp.conf).Or with the client.exe.AxisTransport.lib is in [CHECKOUT_
HOME]\c\vc\transport\axis\Release</p>
-<p>AxisXMLParser.dll should be placed in the path that's specified by
axiscpp.conf.Or with the client.exe.AxisXMLParser libs (libexpat.lib and
xerces-c_2.lib(Release) or xerces-c_2D.lib (Debug)) should be in [CHECKOUT_
HOME]\c\lib</p>
+<p>AxisTransport.dll (Which can be found at AXIS_EXTRACT/bin) should be placed in
the path, and be specified as the value to the key "Transport_http" in axiscpp.conf
(AXIS_FOLDER/axiscpp.conf) Or in the same place as the client.exe.</p>
+<p>AxisXMLParser.dll ( Either one of AxisXMLParser_Expat.dll or
AxisXMLParser_Xerces.dll should be renamed to AxisXMLParse.dll depending on which
parser you want to user) should be placed in the path and given specified as the value
to the key XMLParser in axiscpp.conf Or in the same place as the client.exe.<br>If you
choose to use Expat parser the dll, libexpat.dll should be in the path.<br>If you
choose to use the Xerces parser the dll, xerces-c_2_2_0.dll should be in the path.<br>
+</p>
<p>
<strong>Axiscpp.conf file contains the following paths</strong>
-<br>AXISLOGPATH:XXXX<br>WSDDFILEPATH:YYYY<br>AXISTRANSPORT_HTTP:ZZZZ (Not
necessary)<br>AXISXMLPARSER:WWWW<br>
-<br>Where XXXX will be the path to a file named AxisLog (The log file)and YYYY will
be the path to the server.wsdd file.ZZZZ will be the path to AxisTransport_D.dll if
it's a HTTP(if the selected transport is SMTP then should give that path.WWWW will be
the path to AxisXMLParser_D.dll<br>
-<br>i.e.<br>AXISLOGPATH:[APACHE_HOME]\Axis\logs\AxisLog.log<br>WSDDFILEPATH:[APACHE_HOME]\Axis\conf\server.wsdd<br>AXISTRANSPORT_HTTP:[APACHE_HOME]\Axis\libs\AxisTransport_D.dll<br>AXISXMLPARSER:[APACHE_HOME]\Axis\libs\AxisXMLParser_D.dll<br>
+<br>LogPath:XXXX<br>WSDDFilePath:YYYY<br>Transport_http:ZZZZ (Not
necessary)<br>XMLParser:WWWW<br>
+<br>Where XXXX will be the path to a file named AxisLog (The log file)and YYYY will
be the path to the server.wsdd file.<br>
+<br>i.e.<br>LogPath:[APACHE_HOME]\Axis\logs\AxisLog.log<br>WSDDFilePath:[APACHE_HOME]\Axis\conf\server.wsdd<br>Transport_http:[APACHE_HOME]\Axis\libs\AxisTransport_D.dll<br>XMLParser:[APACHE_HOME]\Axis\libs\AxisXMLParser_D.dll<br>
</p>
<p>
<a name="handlers"></a>
@@ -402,9 +405,9 @@
<p>
<strong>Note: If you are using Client side Handlers you need to enter the following
entry in the AXIS_FOLDER/axiscpp.conf configuration file.</strong>
</p>
-<p>CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<p>ClientWSDDFilePath:Axis\conf\client.wsdd</p>
<p>After entering this entry to your AXIS_FOLDER/axiscpp.conf configuration file
will look like:</p>
-<p>AXISLOGPATH:Axis\logs\AxisLog.txt<br>WSDDFILEPATH:Axis\conf\server.wsdd<br>CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<p>LogPath:Axis\logs\AxisLog.txt<br>WSDDFilePath:Axis\conf\server.wsdd<br>ClientWSDDFilePath:Axis\conf\client.wsdd</p>
<strong>Testing the sample Handlers</strong>
<p>We have included the following sample Handlers for your reference.</p>
<p>1) echoStringHeaderHandler (A server side handler sample) This sample handler
will simply echo (i.e send back) the string which you send in the SOAP
request.<br>2)testHandler (A client side handler sample)</p>
@@ -451,7 +454,7 @@
</p>
<p>Now you are almost done to run your client side handler.</p>
<p>
-<strong>Note: If you are using Client side Handlers you need to enter the
CLIENTWSDDFILEPATH entry in the AXIS_FOLDER/axiscpp.conf configuration file. (See
above)</strong>
+<strong>Note: If you are using Client side Handlers you need to enter the
ClientWSDDFilePath entry in the AXIS_FOLDER/axiscpp.conf configuration file. (See
above)</strong>
</p>
<p>
<strong>Running the Handler</strong>