roshan 2004/05/17 03:37:33
Modified: targets/axis/cpp winuser-guide.pdf winuser-guide.html
Log:
Corrected some spelling mistakes in the win user guide doc
Revision Changes Path
1.10 +74 -74 ws-site/targets/axis/cpp/winuser-guide.pdf
<<Binary file>>
1.11 +15 -11 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.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- winuser-guide.html 7 May 2004 06:08:27 -0000 1.10
+++ winuser-guide.html 17 May 2004 10:37:32 -0000 1.11
@@ -7,7 +7,7 @@
<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
<link rel="stylesheet" href="../skin/site.css" type="text/css">
<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
-<title>Axis C++ windows user guide</title>
+<title>Axis C++ Windows User Guide</title>
</head>
<body bgcolor="white" class="composite">
<!--================= start Banner ==================-->
@@ -168,7 +168,7 @@
<span class="menuLabel">Axis (C++)</span>
<div class="menuItem">
-<a href="../cpp/index.html">Axis C++ 1.1 released!</a>
+<a href="../cpp/index.html">Latest Axis C++ Release!</a>
</div>
<div class="menuItem">
@@ -180,6 +180,10 @@
</div>
<div class="menuItem">
+<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisCPPProjectPages";>Wiki
Pages</a>
+</div>
+
+<div class="menuItem">
<a href="../cpp/who.html">Who we are</a>
</div>
@@ -259,11 +263,11 @@
<div id="bodycol">
<div class="app">
<div align="center">
-<h1>Axis C++ windows user guide</h1>
+<h1>Axis C++ Windows User Guide</h1>
</div>
<div class="h3">
<div class="h3">
-<h3>Axis C++ windows user guide</h3>
+<h3>Axis C++ Windows User Guide</h3>
</div>
<div class="h4">
<h4>Creating And Deploying your own Web Service</h4>
@@ -275,7 +279,7 @@
<br>
<a href="#deploy">Deploying your web service</a>
<br>
-<a href="#deploy">Deploying your web service Using AdminClient Tool</a>
+<a href="#deploy">Deploying your web service using AdminClient Tool</a>
<br>
<a href="#client">Coding the client</a>
<br>
@@ -294,10 +298,10 @@
</div>
<br>
<p>Currently axis supports two methods to create and deploy a Web
Service.<br>Method 1) A top down approach where you start with a WSDL.<br>Method 2) A
bottom up approach where you start with a pre-written web service.<br>
-<br>Here we discuss the first apporach since the tool to support Method 2 (i.e
wcg.exe) is in a primitive and frozen state.<br>Here the document is written with the
idea that the user uses Visual C++ (VC). But the user could use this guide with a
different IDE of his choice.<br>
+<br>Here we discuss the first approach since the tool to support Method 2 (i.e
wcg.exe) is in a primitive and frozen state.<br>Here the document is written with the
idea that the user uses Visual C++ (VC). But the user could use this guide with a
different IDE of his choice.<br>
<br>
<strong>Method 1</strong>
-<br>This method assums that the user has written the wsdl of the service which he
needs to deploy. In this method user will start with this wsdl and the tool will
generate the web service skeleton and other required files.<br>1) There is a folder
called "simple" inside the samples/server folder in your axiscpp binary distribution.
Inside this you can find the relevant wsdl for the calculator sample .Get the wsdl
(eg:<a href="../sample/server/simple/Calculator.wsdl">Calculator.wsdl</a>)<br>2) Run
the WSDL2WS tool (refer the section below 'How to use the WSDL2WS tool on the command
line') and generate the server side skeletons and wrappers. These files will be in two
new folder which are gentrated from the tool called 'ServerOut' and 'ClientOut'.<br>3)
Create a VC workspace.<br>4) Create a 'Win32 Static Library' project in this
workspace.<br>5) Add the following files to this project, from the generated
'ServerOut' folder. Calculator.cpp Calculator.h<br>6) Set the include path to the
include directory of the binary distribution (These include files are in
AXIS_EXTRACT/include/).<br>7) Fill the empty methods of the generated skelitons.<br>8)
Generate the lib (eg: MyCalculator.lib)<br>9) Now create a 'Win32 Dynamic-Link
Library' project.<br>10) Add the following files to this project, from the generated
'ServerOut' folder. CalculatorService.cpp CalculatorWrapper.cpp
CalculatorWrapper.h<br>11) Set the include path to the include directory of the binary
distribution.<br>12) Add the above created lib (Calculator.lib) as the input libraries
of this project.<br>13) Build and create the DLL. (Calculator.dll)</p>
+<br>This method assums that the user has written the wsdl of the service which he
needs to deploy. In this method user will start with this wsdl and the tool will
generate the web service skeleton and other required files.<br>1) There is a folder
called "simple" inside the samples/server folder in your axiscpp binary distribution.
Inside this you can find the relevant wsdl for the calculator sample .Get the wsdl
(eg:<a href="../sample/server/simple/Calculator.wsdl">Calculator.wsdl</a>)<br>2) Run
the WSDL2WS tool (refer the section below 'How to use the WSDL2WS tool on the command
line') and generate the server side skeletons and wrappers. These files will be in two
new folders which are generated from the tool called 'ServerOut' and
'ClientOut'.<br>3) Create a VC workspace.<br>4) Create a 'Win32 Static Library'
project in this workspace.<br>5) Add the following files to this project, from the
generated 'ServerOut' folder. Calculator.cpp Calculator.h<br>6) Set the include path
to the include directory of the binary distribution (These include files are in
AXIS_EXTRACT/include/).<br>7) Fill the empty methods of the generated skeletons.<br>8)
Generate the lib (eg: MyCalculator.lib)<br>9) Now create a 'Win32 Dynamic-Link
Library' project.<br>10) Add the following files to this project, from the generated
'ServerOut' folder. CalculatorService.cpp CalculatorWrapper.cpp
CalculatorWrapper.h<br>11) Set the include path to the include directory of the binary
distribution.<br>12) Add the above created lib (Calculator.lib) as the input libraries
of this project.<br>13) Build and create the DLL. (Calculator.dll)</p>
<p>
<a name="wsdl2ws"></a>
</p>
@@ -307,12 +311,12 @@
<br>
<p>For using WSDL2Ws java tool on the command line you require jdk1.4 or above.<br>
<br>To use WSDL2Ws java tool you should set the CLASSPATH Environment Variable to
point to the following jar files in AXIS_EXTRACT\lib\axisjava.<br>
-<br>axis.jar<br>commons-discovery.jar<br>commons-logging.jar<br>jaxrpc.jar<br>saaj.jar<br>wsdl4j.jar<br>xml-apis.jar<br>The
CLASSPATH Environment Variabe should have the absolute paths of the jars (including
the jar file name) given as a semicolon separated list.<br>
+<br>axis.jar<br>commons-discovery.jar<br>commons-logging.jar<br>jaxrpc.jar<br>saaj.jar<br>wsdl4j.jar<br>xml-apis.jar<br>The
CLASSPATH Environment Variable should have the absolute paths of the jars (including
the jar file name) given as a semicolon separated list.<br>
<br>
<br>Open a command window. Change directory to AXIS_EXTRACT\lib\axis. Create a
folder of your choice and we will call this folder as WSDL2WS_FOLDER.<br>
<br>Now copy the wsdl file (eg.Calculator.wsdl) which you use to the folder
WSDL2WS_FOLDER.<br>Copy the file wsdl2ws.jar from AXIS_EXTRACT\bin to
WSDL2WS_FOLDER<br>Now change the directory to WSDL2WS_FOLDER and run the following
command to generate the server side skeletons and wrappers.<br>
<br>Java -classpath %classpath%;.\wsdl2ws.jar org.apache.axis.wsdl.wsdl2ws.WSDL2Ws
Calculator.wsdl -o./ServerOut -lc++ -sserver<br>
-<br>If the file generation is successful the tool will display the files the it has
generated. The skeletons and wrappers will be generated in
[WSDL2WS_FOLDER]\ServerOut.<br>
+<br>If the file generation is successful the tool will display the files that it
has generated. The skeletons and wrappers will be generated in
[WSDL2WS_FOLDER]\ServerOut.<br>
<br>Run the following command to generate the client stubs.<br>
<br>Java -classpath %classpath%;.\wsdl2ws.jar org.apache.axis.wsdl.wsdl2ws.WSDL2Ws
Calculator.wsdl -o./ClientOut -lc++ -sclient<br>
<br>The generated client stubs will be in [WSDL2WS_FOLDER]\ClientOut</p>
@@ -333,7 +337,7 @@
<div class="h4">
<h4>Deploying your web service Using AdminClient Tool</h4>
</div>
-<p>The wsdl2ws Tool generates the deploy.wsdd and the undeploy.wsdd files needed
for the AdminClient. Once we have these files, we have to deploy the web service (in
this case the calculator service) with the AdminClietn. We do this with the
AdminClient.exe which comes with axiscpp binary distribution. A typical invocation of
the AdminClient looks like this.</p>
+<p>The wsdl2ws Tool generates the deploy.wsdd and the undeploy.wsdd files needed
for the AdminClient. Once we have these files, we have to deploy the web service (in
this case the calculator service) with the AdminClient. We do this with the
AdminClient.exe which comes with axiscpp binary distribution. A typical invocation of
the AdminClient looks like this.</p>
<p>
<strong>AdminClient <server> <Port> <wsddfile></strong>
</p>
@@ -348,7 +352,7 @@
<h4>Coding the client</h4>
</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 a 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>
+<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>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"
