axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sanj...@apache.org
Subject cvs commit: ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp winuser-guide.ihtml wininstall-guide.ihtml windev-guide.ihtml index.ihtml
Date Tue, 02 Dec 2003 13:01:03 GMT
sanjaya     2003/12/02 05:01:03

  Modified:    contrib/axisdocs/src/documentation/content/xdocs/cpp
                        winuser-guide.ihtml wininstall-guide.ihtml
                        windev-guide.ihtml index.ihtml
  Log:
  changes for axis-c beta release
  
  Revision  Changes    Path
  1.2       +125 -142  ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/winuser-guide.ihtml
  
  Index: winuser-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/winuser-guide.ihtml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- winuser-guide.ihtml	31 Oct 2003 20:41:55 -0000	1.1
  +++ winuser-guide.ihtml	2 Dec 2003 13:01:03 -0000	1.2
  @@ -1,209 +1,192 @@
   <html>
  +<head>
  +  <meta http-equiv="Content-Type" content="text/html">
  +  <title></title>
  +</head>
  +
   <body>
   <h1>Axis C++ windows user guide</h1>
   
   <h2>Creating And Deploying your own Web Service</h2>
  -<p>
  -<a href="#create">Creating the web service</a><br>
  +
  +<p><a href="#create">Creating the web service</a><br>
   <a href="#wsdl2ws">How to use the WSDL2WS tool on the command line</a><br>
   <a href="#deploy">Deploying your web service</a><br>
   <a href="#client">Writing the client</a><br>
   <a href="#sample">Running your sample</a><br>
   <br>
  -<b>Before you follow this guide, make sure that you have followed the</b>
  -<a href="wininstall-guide.html"><b>Windows Installation guide</b></a>
  -</p>
  +<b>Before you follow this guide, make sure that you have followed the</b> <a
  +href="wininstall-guide.html"><b>Windows Installation guide</b></a></p>
   
   <p><a name="create"></a></p>
  -<h2>Creating the web service</h2><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 apporach where you start with a pre-written web service.
   
  +<h2>Creating the web service</h2>
   <br>
  -<br>
  -Here we discuss the first apporach since the tool to support Method 2 (i.e wcg.exe) is
still at its primitive stage in this Alpaha Release.
   
  -<br>
  -Here the document is written with the idea that the user uses Visual C++ (VC). But user
could use this guide with a different IDE of his choice.
   
  +<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 apporach where you start with a pre-written web
  +service. <br>
   <br>
  -<b>Method 1</b> <br>
  -
  -This method assums that the user has written the wsdl of the service which he needs to
deploy. In this methods user will start with this wsdl and the tool will generate the web
service skeleton and other required files.
  -
  +Here we discuss the first apporach since the tool to support Method 2 (i.e
  +wcg.exe) is still at its primitive stage in this Alpaha Release. <br>
  +Here the document is written with the idea that the user uses Visual C++
  +(VC). But user could use this guide with a different IDE of his choice. <br>
   <br>
  +<b>Method 1</b> <br>
  +This method assums that the user has written the wsdl of the service which he
  +needs to deploy. In this methods user will start with this wsdl and the tool
  +will generate the web service skeleton and other required files. <br>
   1) Get your wsdl (eg:<a href="../cfiles/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. Here the idea is 
  -<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>
  +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. Here the idea is <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) to the library modules of this project.
  -<br>
  -13) Build and create the DLL. (Calculator.dll)
  -</p>
  +12) Add the above created lib (Calculator.lib) to the library modules of this
  +project. <br>
  +13) Build and create the DLL. (Calculator.dll)</p>
  +
   <p><a name="wsdl2ws"></a></p>
  -<h2>How to use the WSDL2WS tool on the command line</h2><br>
  -<p>
  -For using WSDL2Ws java tool on the command line you require jdk1.4 or above.
   
  +<h2>How to use the WSDL2WS tool on the command line</h2>
   <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.
   
  +
  +<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>
  +wsdl4j.jar <br>
   xml-apis.jar <br>
   <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>
  -Open a command window.
  -
  -Change directory to AXIS_EXTRACT\lib\axis. 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>
  +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>
  -Now run the following command to generate the server side skeletons and wrappers.
  -
  +Open a command window. Change directory to AXIS_EXTRACT\lib\axis. 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>
   <br>
  -Java -classpath %classpath%;.\wsdl2ws.jar org.apache.axis.wsdl.wsdl2ws.WSDL2Ws Calculator.wsdl
-o./ServerOut -lc++ -sserver
  +Now 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 tools is successful the tool will display the files the it has generated. The skeletons
and 
  -wrappers will be generated in [WSDL2WS_FOLDER]\ServerOut.
  -
  +If the tools 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>
  +Run the following command to generate the client stubs. <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>
  +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>
   
  -The generated client stubs will be in [WSDL2WS_FOLDER]\ClientOut
  -</p>
   <p><a name="deploy"></a></p>
  -<h2>Deploying your web service</h2><br>
  -<p>
  -Currently the AdminClient tool is having some known bugs. So this section shows you how
to deploy your Web Service manually, without using the AdminClient tool.
   
  +<h2>Deploying your web service</h2>
   <br>
  -1) Copy the above Calculator.dll to the folder APACHE_FOLDER/Axis/webservices.
  -<br>
  -2) Go and add the following in the server.wsdd at the service level. Make sure you add
these line at the correct place, i.e at service level. (APACHE_FOLDER/Axis/conf/server.wsdd)
   
  -<br>
  -<br>
  -&lt;service name=&quot;Calculator&quot; provider=&quot;C:RPC&quot;
description=&quot;Calculator Web 
  -Service&quot;&gt;<br>
  -&lt;parameter name=&quot;className&quot; value=&quot;Axis\webservices\Calculator.dll&quot;/&gt;<br>
  -&lt;parameter name=&quot;allowedMethods&quot; value=&quot;add subtract
&quot;/&gt;<br>
  +
  +<p>Currently the AdminClient tool is having some known bugs. So this section
  +shows you how to deploy your Web Service manually, without using the
  +AdminClient tool.<br>
  +Say the apache installation folder is APACHE_FOLDER.<br>
  +(For the default installation this is "C:\Program Files\Apache Group\Apache"
  +for apache 1.3.X and "C:\Program Files\Apache Group\Apache2" for apache
  +2.X).<br>
  +<br>
  +1) Copy the above Calculator.dll to the folder
  +APACHE_FOLDER/Axis/webservices. <br>
  +2) Go and add the following in the server.wsdd at the service level. Make
  +sure you add these line at the correct place, i.e at service level.
  +(APACHE_FOLDER/Axis/conf/server.wsdd) <br>
  +<br>
  +&lt;service name="Calculator" provider="C:RPC" description="Calculator Web
  +Service"&gt;<br>
  +&lt;parameter name="className"
  +value="APACHE_FOLDER\Axis\webservices\Calculator.dll"/&gt;<br>
  +&lt;parameter name="allowedMethods" value="add subtract "/&gt;<br>
   &lt;/service&gt; <br>
   <br>
  -SUCCESS ! Now you have deployed your web service
  -</p>
  +SUCCESS ! Now you have deployed your web service</p>
  +
   <p><a name="client"></a></p>
  -<h2>Writing the client</h2><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>
  -<br>
  -AXIS_EXTRACT/lib/axis/
  -		<br>
  -client.lib <br>
  -		Common.lib <br>
  -		engine.lib <br>
  -		Soap.lib <br>
  -		WSDD.lib <br>
  -		XML.lib <br>
  +<h2>Writing the client</h2>
   <br>
   
  -	AXIS_EXTRACT/lib/xerces-c
  -		<br>
  -xerces-c_2.lib 
   
  -	<br>
  -wsock32.lib
  +<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>
  -6) Create a file with the main method which looks similar to the following and add this
file to this project.
  +5) Add the following libs to the library modules path of this project. <br>
   <br>
  +AXIS_EXTRACT/lib/axis/ <br>
  +client.lib <br>
  +Common.lib <br>
  +engine.lib <br>
  +Soap.lib <br>
  +WSDD.lib <br>
  +XML.lib <br>
  +<br>
  +AXIS_EXTRACT/lib/xerces-c <br>
  +xerces-c_2.lib <br>
  +wsock32.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"
  +<pre>#include "Calculator.h"
   int main()
   { 
  -	Calculator c; 
  -	int result = c.add(40, 20);
  -	printf("result = %d", result);
  -	return 0;
  -}
  -</pre>
  -<p>
  -7) Now build and create the Client.exe
  -</p>
  +        Calculator c; 
  +        int result = c.add(40, 20);
  +        printf("result = %d", result);
  +        return 0;
  +}</pre>
  +
  +<p>7) Now build and create the Client.exe</p>
   
   <p><a name="sample"></a></p>
  +
   <h2>Running your sample</h2>
  -<p>
  -1) Restart Apache.
  -<br>
  +
  +<p>1) Restart Apache. <br>
   2) Run the Client.exe <br>
   <br>
  -
  -SUCCESS ! If you get the result, you are done.
  -</p>
  +SUCCESS ! If you get the result, you are done.</p>
   </body>
  -</html>
  \ No newline at end of file
  +</html>
  
  
  
  1.2       +138 -89   ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml
  
  Index: wininstall-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- wininstall-guide.ihtml	31 Oct 2003 20:41:55 -0000	1.1
  +++ wininstall-guide.ihtml	2 Dec 2003 13:01:03 -0000	1.2
  @@ -1,24 +1,35 @@
   <html>
  +<head>
  +  <meta http-equiv="Content-Type" content="text/html">
  +  <title></title>
  +</head>
  +
   <body>
   <h1>Windows Installation guide for Axis C++ (Alpha Release)</h1>
  -<p>
  -This document contains how to use the binary distribution of Axis C++. These binaries
  -have been tested on following Microsoft platforms,<br>
  +
  +<p>This document contains how to use the binary distribution of Axis C++.
  +These binaries have been tested on following Microsoft platforms,<br>
   Windows 2000 Professional<br>
  -Windows XP 2002 Professional
  -<p>
  +Windows XP 2002 Professional</p>
  +
  +<p></p>
  +
   <h1>Contents</h1>
   1. <a href="#dist">What binary distribution contains</a><br>
  -2. <a href="#apache">Installation with Apache 1.3.27 web server</a><br>
  +2. <a href="#apache">Installation with Apache 1.3.x/2.x web server</a><br>
   3. <a href="#simpleaxis">Installation with Simple Axis Server</a><br>
   4. <a href="#samples">Running provided samples</a><br>
  -5. <a href="#playsamples">Using Visual C++ to play with provided samples. </a><br>
  -6. <a href="#writews">Writing your web services and client applications using Axis
C++.</a><br>
  +5. <a href="#playsamples">Using Visual C++ to play with provided samples.
  +</a><br>
  +6. <a href="#writews">Writing your web services and client applications using
  +Axis C++.</a><br>
  +
   
   <p><a name="dist"></a></p>
  +
   <h1>What binary distribution contains</h1>
  -<p>
  -1. There is a folder called &quot;binary&quot;.<br>
  +
  +<p>1. There is a folder called "binary".<br>
   <br>
   2. In side this there are several folders named as follows, <br>
   -&gt; bin<br>
  @@ -28,7 +39,7 @@
   -&gt; lib<br>
   -&gt; samples<br>
   <br>
  -3. The folder &quot;bin&quot; contains following executables and dll's<br>
  +3. The folder "bin" contains following executables and dll's<br>
   Executables<br>
   -&gt; AdminClient.exe (soap client to Deploy or Undeploy a web service)<br>
   -&gt; base.exe (soap client for Interop base tests)<br>
  @@ -37,10 +48,12 @@
   -&gt; SimpleAxisServer.exe (axis with a simple http server)<br>
   <br>
   DLL's<br>
  --&gt; mod_axis.dll (axis module for apache http server)<br>
  -<br>
  -4. In side the &quot;deploy&quot; folder follwing sub folders are exists <br>
  --&gt; conf - This includes the server.wsdd, which contains service names and 
  +-&gt; mod_axis.dll (axis module for apache 1.3.x http server)<br>
  +-&gt; mod_axis2.dll (axis module for apache 2.x http server)</p>
  +
  +<p><br>
  +4. In side the "deploy" folder follwing sub folders are exists <br>
  +-&gt; conf - This includes the server.wsdd, which contains service names and
   methods.<br>
   -&gt; handlers - This includes following DLL's,<br>
   - loghandler.dll(sample handler for logging number of requests)<br>
  @@ -61,104 +74,140 @@
   -&gt; wsdl - Contains the wsdl files used for interop testing.<br>
   - InteropBase<br>
   - InteropGroupB<br>
  -5. The &quot;include&quot; folder contains all the include files which are necessary
for 
  -this binary to work.<br>
  -6. &quot;lib&quot; folder contains all the lib files for xercess-c and axisjava.<br>
  -7. &quot;samples&quot; folder contains all the server and client samples for interop

  -tests.
  -</p>
  +5. The "include" folder contains all the include files which are necessary
  +for this binary to work.<br>
  +6. "lib" folder contains all the lib files for xercess-c and axisjava.<br>
  +7. "samples" folder contains all the server and client samples for interop
  +tests.</p>
  +
   <p><a name="apache"></a></p>
  -<h1>Installation with Apache 1.3.27 web server</h1>
  +
  +<h1>Installation with Apache 1.3.X/2.X web server</h1>
  +
   <p>STEPS:</p>
   
  +<p>1. Install apache web server and locate the installation folder(For the
  +defalt installation this is "C:\Program Files\Apache Group\Apache" for apache
  +1.3.X and "C:\Program Files\Apache Group\Apache2" for apache 2.X). Let say
  +this folder to be APACHE_FOLDER.</p>
  +
  +<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this
  +folder AXIS_EXTRACT.</p>
  +
  +<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called
  +deploy. Copy whole deploy folder to APACHE_FOLDER.</p>
  +
  +<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be
  +AXIS_FOLDER.</p>
  +
  +<p>5. Set environment variable AXIS_HOME to point to above folder.</p>
  +
  +<p>6. Add AXIS_FOLDER/libs to the PATH environment variable.</p>
   
  -<p>1. Install apache 1.3.27 and locate the installation folder(folder where Apache.exe
is). 
  -   Let say this folder to be APACHE_FOLDER.
  -</p>
  -<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this folder AXIS_EXTRACT.
  -</p>
  -<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called deploy.
Copy 
  -   whole deploy folder to APACHE_FOLDER.
  -</p>
  -<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be AXIS_FOLDER.

  -</p>
  -<p>5. Set environment variable AXIS_HOME to point to above folder.
  -</p>
  -<p>6. Add AXIS_FOLDER/libs to the PATH environment variable.
  -</p>
  -<p>7. Edit Apache configuration file httpd.conf located in APACHE_FOLDER/conf and
add following 
  -   lines at the end. <br>
  +<p>7. Edit Apache configuration file httpd.conf located in APACHE_FOLDER/conf
  +and add following lines at the end. <br>
   <br>
  -LoadModule axis_module modules/mod_axis.dll<br>
  +LoadModule axis_module modules/AXISMODULE<br>
   &lt;Location /axis&gt;<br>
   SetHandler axis<br>
   &lt;/Location&gt;<br>
   <br>
  -8. Copy mod_axis.dll from the AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules folder.
  -</p>
  -<p>9. Restart apache web server. If you have done correctly apache server should
start without 
  -   giving any error.
  -</p>
  -<p>10. Open a internet browser and check http://localhost/axis. If you get the Axis
C++ welcome 
  -   page you are done. 
  +Where AXISMODULE is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for
  +apache 2.X.<br>
  +<br>
  +8. Copy AXISMODULEfrom the AXIS_EXTRACT/bin folder to APACHE_FOLDER/modules
  +folder.</p>
  +
  +<p>9. Restart apache web server. If you have done correctly apache server
  +should start without giving any error.<br>
  +<br>
  +<b>apache 1.3.X :</b></p>
  +
  +<p>It is recommended that apache 1.3.X be started as "apache -k start" on the
  +command line</p>
  +
  +<p><b>apache 2.X :</b></p>
  +
  +<p>While testing the apache 2 module a problem was noted with the apache 2
  +web server, in that the webserver takes up about 98% of CPU time and the
  +server does not even serve the startup page. The workaround for this is to
  +start the apache web server as "apache -X" to make it run single threaded.
  +While this is sufficient to test the apache 2 module this problem needs to be
  +investigated further.</p>
  +
  +<p>10. Open a internet browser and check http://localhost/axis. If the module
  +has loaded properly then you should get the axis welcome page with a listing
  +of deployed web services.</p>
   
   <p><a name="simpleaxis"></a></p>
  +
   <h1>Installation with Simple Axis Server</h1>
  -<p>
  -<b>(For the Alpha release we recommend installing Axis with the Apache web 
  -server. The simple Axis Server is still under development and presented here for 
  -testing purposes.)</b></p>
  +
  +<p><b>(For the Alpha release we recommend installing Axis with the Apache web
  +server. The simple Axis Server is still under development and presented here
  +for testing purposes.)</b></p>
   <br>
   
  +
   <p>STEPS:</p>
   
  +<p>1. Create a folder of your choice. We will call this folder as
  +SIMPLE_AXIS_SERVER_FOLDER.</p>
  +
  +<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this
  +folder AXIS_EXTRACT.</p>
  +
  +<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called
  +deploy. Copy whole deploy folder to SIMPLE_AXIS_SERVER_FOLDER.</p>
  +
  +<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be
  +AXIS_FOLDER.</p>
  +
  +<p>5. Set environment variable AXIS_HOME to point to above folder.</p>
  +
  +<p>6. Copy the exe SimpleAxisServer.exe from AXIS_EXTRACT/bin to the
  +SIMPLE_AXIS_SERVER_FOLDER.</p>
  +
  +<p>7. Copy the content of AXIS_FOLDER/libs to the
  +SIMPLE_AXIS_SERVER_FOLDER.</p>
   
  -<p>1. Create a folder of your choice. We will call this folder as SIMPLE_AXIS_SERVER_FOLDER.
  -</p>
  -<p>2. Unzip axis-c-alpha-win32.zip to a folder of your choice. Say this folder AXIS_EXTRACT.
  -</p>
  -<p>3. Inside the extracted folder AXIS_EXTRACT you have a sub folder called deploy.
Copy 
  -   whole deploy folder to SIMPLE_AXIS_SERVER_FOLDER.
  -</p>
  -<p>4. Rename copied "deploy" folder to "Axis". Lets say this folder to be AXIS_FOLDER.

  -</p>
  -<p>5. Set environment variable AXIS_HOME to point to above folder.
  -</p>
  -<p>6. Copy the exe SimpleAxisServer.exe from AXIS_EXTRACT/bin to the SIMPLE_AXIS_SERVER_FOLDER.
  -</p>
  -<p>7. Copy the content of AXIS_FOLDER/libs to the SIMPLE_AXIS_SERVER_FOLDER.
  -</p>
  -<p>8. Start the SimpleAxisServer by providing the port to which operate. (eg: c:\SimpleAxisServer>SimpleAxisServer
80)
  +<p>8. Start the SimpleAxisServer by providing the port to which operate. (eg:
  +c:\SimpleAxisServer&gt;SimpleAxisServer 80)</p>
   
   <p><a name="samples"></a></p>
  -</p>
  +
   <h1>Running provided samples</h1>
  -<p>
  -If Axis installation is a complete success, following sample web services and handlers
have 
  -already been installed successfully.
  -</p>	
  +
  +<p>If Axis installation is a complete success, following sample web services
  +and handlers have already been installed successfully.</p>
  +
   <p>1. InteropBase service</p>
  -<p>&nbsp;2. InteropGroupB service
  -</p>
  -<p>You can run the provided client programs to confirm whether they are working fine.
The two
  -corresponding client applications are located in your AXIS_EXTRACT/bin as base.exe and
groupB.exe.
  -to run this sample client applications you need to have the xerces-c_2_2_0.dll in the DLLPATH
or 
  -current folder.
   
  -Note: These sample clients are compiled with assumption that server is running at localhost

  -port 80.
  +<p>&nbsp;2. InteropGroupB service </p>
  +
  +<p>You can run the provided client programs to confirm whether they are
  +working fine. The two corresponding client applications are located in your
  +AXIS_EXTRACT/bin as base.exe and groupB.exe. To run this sample client
  +applications you need to have the path to xerces-c_2_2_0.dll in the "DLLPATH"
  +environment variable or xerces-c_2_2_0.dll should be placed where the
  +apache.exe is. Note: These sample clients are compiled with assumption that
  +server is running at localhost port 80.</p>
  +
   <p><a name="playsamples"></a></p>
  -</p>
  +
   <h1>Using Visual C++ to play with provided samples.</h1>
  -<p>
  -In your  AXIS_EXTRACT/samples folder you have the samples. If you are using Visual C++
you can 
  -open the workspace file AXIS_EXTRACT/samples/projects/vc6/interoptests/interoptests.dsw.
There
  -are four projects in the workspace. Out of them "base" and "GroupB" are client applications
and other two are web services.
  -</p>
  +
  +<p>In your  AXIS_EXTRACT/samples folder you have the samples. If you are
  +using Visual C++ you can open the workspace file
  +AXIS_EXTRACT/samples/projects/vc6/interoptests/interoptests.dsw. There are
  +four projects in the workspace. Out of them "base" and "GroupB" are client
  +applications and other two are web services.</p>
  +
   <p><a name="writews"></a></p>
  +
   <h1>Writing your web services and client applications using Axis C++.</h1>
  -<p>
  -For writing your own web services and client applications see the <a href="winuser-guide.html">windows
user guide</a>.
  -</p>
  +
  +<p>For writing your own web services and client applications see the <a
  +href="winuser-guide.html">windows user guide</a>.</p>
   </body>
  -</html>
  \ No newline at end of file
  +</html>
  
  
  
  1.2       +78 -66    ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/windev-guide.ihtml
  
  Index: windev-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/windev-guide.ihtml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- windev-guide.ihtml	31 Oct 2003 20:41:55 -0000	1.1
  +++ windev-guide.ihtml	2 Dec 2003 13:01:03 -0000	1.2
  @@ -27,11 +27,11 @@
   
   <p><a name="buildaxis"></a></p>
   
  -<h1>Building and Deploying Axis C++</a></h1>
  +<h1>Building and Deploying Axis C++</h1>
   
   <p><a name="cvscheckout"></a></p>
   
  -<h2>Getting a cvs checkout</a></h2>
  +<h2>Getting a cvs checkout</h2>
   
   <p>Visit http://ws.apache.org/ click on “axis” and then on “CVS Repository”
   to find details on accessing the CVS Repository. It will have instructions
  @@ -82,17 +82,17 @@
   http://xml.apache.org/xerces-c/download.cgi<br>
   <br>
   <b>Apache web server</b><br>
  -Download the Apache web server from www.apache.org. Currently Axis
  -supports apache 1.3.x Web server and not versions 2.0 or above. This
  -documentation was tested with Apache1.3.28 and it is recommended that you
  -download this version.</p>
  +Download the Apache web server from www.apache.org. Currently Axis supports
  +apache 1.3.x and 2.X. This documentation was tested with Apache 1.3.28 and
  +Apache 2.0.44.</p>
   
   <p><a name="installapachexerces"></a></p>
   
   <h2>Installing Apache and extracting Xerces-C</h2>
   
  -<p>Install Apache1.3.28.By default Apache is installed in C:\Program
  -Files\Apache Group\Apache. This location will be referred as [APACHE_HOME]
  +<p>Install the Apache web server. By default Apache 1.3.X is installed in
  +"C:\Program Files\Apache Group\Apache" and Apache 2.X in "C:\Program
  +Files\Apache Group\Apache2". This location will be referred as [APACHE_HOME]
   from this point onwards.</p>
   
   <p><br>
  @@ -106,34 +106,50 @@
   
   <h2>Setting up the build environment</h2>
   
  -<p>1)copy the contents inside the "[XERCES_EXTRACT] \include\xercesc “ <br>
  +<p>1)copy the contents inside the "[XERCES_EXTRACT] \include\xercesc" <br>
   to [CHECKOUT_HOME]\c\include\xercesc<br>
  -2) Copy the content of the [APACHE_HOME] \ include directory to
  -[CHECKOUT_HOME] \c\include\apache1_3\<br>
  -3) Copy the lib files from “[XERCES_EXTRACT] \lib” to
  -“[CHECKOUT_HOME]\c\lib\win32\xercesc”<br>
  -4) Copy the lib files from the “[APACHE_HOME] \libexec” to
  -“[CHECKOUT_HOME]\c\lib\win32\apache1_3”<br>
  -5) In Visual C++ (The version used for this documentation was Visual C++
  -6.0)open the file Axis.dsw which is in [CHECKOUT_HOME]\ws-axis \c\ vc. In the
  -workspace window “File View”, right click on the project Apache1_3 and click
  -on the “Set as Active Project” to make it the Active Project.<br>
  -6) Again in Visual C++ right click on the project Apache1_3 in the workspace
  -window “File View” and then click on “Settings…” on the popup menu. Select
  -the “link” tab. Select “General” from the Category drop down list. In the
  -“Output file name” text box put the value
  -“[APACHE_HOME]\modules\mod_axis.dll” and click “OK”.</p>
  +2) Copy the include files.</p>
  +
  +<p><b>For apache 1.3.X:</b></p>
  +
  +<p>Copy the include files in "[APACHE_HOME]\include" directory to</p>
  +
  +<p>"[CHECKOUT_HOME] \c\include\apache1_3\"</p>
  +
  +<p><b>For apache 2.X:</b></p>
  +
  +<p>Copy the include files in "[APACHE_HOME]\include" directory to
  +"[CHECKOUT_HOME] \c\include\apache2_0\"<br>
  +3) Copy the lib files from "[XERCES_EXTRACT] \lib" to
  +"[CHECKOUT_HOME]\c\lib\win32\xercesc"<br>
  +4) Copy the lib files.</p>
  +
  +<p><b>For apache 1.3.X:</b> copy the ApacheCore.lib file from [APACHE_HOME]
  +\libexec to [CHECKOUT_HOME]\c\lib\win32\apache1_3.</p>
  +
  +<p><b>For apache 2.X:</b> copy libapr.lib, libhttpd.lib files from
  +"[APACHE_HOME]\lib" to "[CHECKOUT_HOME]\c\lib\win32\apache2_0".<br>
  +5) In Visual C++ (The version used for this documentation was Visual C++ 6.0)
  +open the file Axis.dsw which is in "[CHECKOUT_HOME]\ws-axis \c\ vc". In the
  +workspace window File View, right click on either the project "Apache1_3" or
  +"Apache2_0" and click on the "Set as Active Project" to make it the Active
  +Project.<br>
  +6) Again in Visual C++ right click on either the project "Apache1_3" or
  +"Apache2_0" in the workspace window File View and then click on Settings on
  +the popup menu. Select the link tab. Select General from the Category drop
  +down list. In the Output file name text box put the value
  +[APACHE_HOME]\modules\mod_axis.dll and click OK.</p>
   
   <p><img border="0" src="images/c/mod_axis.jpg" width="577" height="372"></p>
   
  -<p>7) In Visual C++ Go to “Build -&gt; Rebuild All “ to build mod_axis.dll<br>
  +<p>7) In Visual C++ Go to "Build -&gt; Rebuild All"“ to build mod_axis.dll<br>
   &nbsp;</p>
   
   <p><a name="deployaxis"></a></p>
   
   <h2>Deploying Axis in Apache</h2>
   
  -<p>1) Create a directory structure called “Axis” inside [APACHE_HOME] as
  +<p>1) Create a directory structure called "Axis" inside [APACHE_HOME] as
   follows<br>
   <br>
   Axis<br>
  @@ -148,7 +164,7 @@
   other than the one you used to build the Axis source with, you may have
   trouble starting up the Apache web server.<br>
   <br>
  -2) Set the “PATH” environment variable to the following directories.<br>
  +2) Set the "PATH" environment variable to the following directories.<br>
   [APACHE_HOME]<br>
   [APACHE_HOME]\Axis\libs<br>
   <br>
  @@ -161,7 +177,7 @@
   &lt;/Location&gt;<br>
   <br>
   <br>
  -4)create a file in [APACHE_HOME]\Axis named “axiscpp.conf “ which should
  +4)create a file in [APACHE_HOME]\Axis named "axiscpp.conf" which should
   contain the following lines.<br>
   <br>
   AXISLOGPATH:XXXX<br>
  @@ -171,8 +187,8 @@
   will be the path to the server.wsdd file.<br>
   <br>
   i.e.<br>
  -AXISLOGPATH: [APACHE_HOME]\Axis\logs\AxisLog // <br>
  -WSDDFILEPATH: [APACHE_HOME]\Axis\conf\server.wsdd // <br>
  +AXISLOGPATH: [APACHE_HOME]\Axis\logs\AxisLog <br>
  +WSDDFILEPATH: [APACHE_HOME]\Axis\conf\server.wsdd <br>
   <br>
   5)Set an environment variable named AXIS_HOME and give [APACHE_HOME]\Axis as
   the value.<br>
  @@ -186,7 +202,7 @@
   apache<br>
   (IT IS IMPORTANT TO START APACHE THIS WAY.)<br>
   <br>
  -(NOTE:If a 126 error occurs check whether the “path” variable has been set
  +(NOTE:If a 126 error occurs check whether the "path" variable has been set
   correctly as mentioned <br>
   before and whether the correct versions of the xerces dlls have been copied
   as instructed before)<br>
  @@ -196,6 +212,7 @@
   see the Apache start page in the browser.&nbsp;</p>
   
   <p><a name="deploywebservice"></a></p>
  +
   <h1>Deploying a web service in Axis C++</h1>
   
   <p><a name="generatefiles"></a></p>
  @@ -206,7 +223,7 @@
   
   <h3>Using eclipse to build and run WSDL2Ws</h3>
   
  -<p>In the checked out source code there is a tool “wsdl2ws” (i.e. wsdl-to-web
  +<p>In the checked out source code there is a tool "wsdl2ws" (i.e. wsdl-to-web
   services) written in java that generates server side Skeletons/wrappers and
   client side stubs using a given WSDL file. This Section describes how this is
   done.<br>
  @@ -218,14 +235,14 @@
   1)Start the eclipse platform IDE.<br>
   Go to File-&gt;New-&gt;Project.<br>
   <br>
  -Select java in the “New Project” dialog and click “Next”.<br>
  +Select java in the "New Project" dialog and click "Next".<br>
   <br>
  -In the “New” dialog that appears give a project Name (e.g. test). In the “New
  -dialog” keep the “use default” Tick Box checked.<br>
  -Note down the path in the “Directory” Text Box. This location will be
  -referred to as [SKELSTUB_HOME] from this point onwards. Click “Next”.<br>
  +In the "New" dialog that appears give a project Name (e.g. test). In the "New
  +dialog" keep the "use default" Tick Box checked.<br>
  +Note down the path in the "Directory" Text Box. This location will be
  +referred to as [SKELSTUB_HOME] from this point onwards. Click "Next".<br>
   <br>
  -Another dialog named “New” will appear. Select the “Source” tab. Select the
  +Another dialog named "New” will appear. Select the “Source” tab. Select the
   project that you created (i.e. test).<br>
   Click on “Add Folder…”. In the “Source Folder Selection” dialog that appears
   select the project that you created (i.e. test) and click “Create New
  @@ -287,7 +304,7 @@
   Java org.apache.axis.wsdl.wsdl2ws.WSDL2Ws &lt;wsdl file&gt; -o&lt;output
   directory&gt; <br>
   -l&lt;c|c++&gt; -s&lt;(server|client)&gt;.<br>
  -Also note that there cannot be any spaces after a switch (i.e. –o, -l).<br>
  +Also note that there cannot be any spaces after a switch (i.e. -o, -l).<br>
   <br>
   Click “Run”.<br>
   Now the Skeletons/Wrappers will be generated and you will see messages in the
  @@ -354,9 +371,10 @@
   &nbsp;</p>
   
   <p><a name="builddeployws"></a></p>
  +
   <h2>Building and Deploying the web service</h2>
  -<p>
  -1) Start Visual C++.<br>
  +
  +<p>1) Start Visual C++.<br>
   2) Go to File-&gt;Open and open the workspace file “Axis.dsw” in
   [CHECKOUT_HOME]\ \c\vc.<br>
   3) Go to Project-&gt;Add To Project-&gt;New…<br>
  @@ -374,7 +392,8 @@
   10) Right click on the project (i.e. ws1)again and click on “Settings…” on
   the menu that appears. Click the C/C++ tab and select “Preprocessor” from the
   “Category” Drop down list.<br>
  -In the “Additional include directories” give “../../include”<br></p>
  +In the “Additional include directories” give “../../include”<br>
  +</p>
   <img border="0" src="images/c/new_config_include.jpg" width="577"
   height="372">
   
  @@ -397,7 +416,7 @@
   <br>
   14) The ws1.dll will be build in [CHECKOUT_HOME]\c\vc\ws1\Debug by Visual
   C++<br>
  -15) Place the built ws1.dll file in [APACHE_HOME] \ Axis \webservices<br>
  +15) Place the built ws1.dll file in [APACHE_HOME]\Axis \webservices<br>
   16) In addition to this you have to create sever.wsdd file in
   [APACHE_HOME]\Axis\conf<br>
   <br>
  @@ -415,9 +434,9 @@
   <br>
   
   
  -<p>In this file [APACHE_HOME] should
  -be replaced with the actual value of [APACHE_HOME] (i.e. For this case
  -C:\Program Files\Apache Group\Apache )<br>
  +<p>In this file [APACHE_HOME] should be replaced with the actual value of
  +[APACHE_HOME] (i.e. For this case "C:\Program Files\Apache Group\Apache" for
  +apache 1.3.x and "C:\Program Files\Apache Group\Apache2" for apache 2.x)<br>
   <br>
   Description of the server.wsdd file<br>
   <br>
  @@ -434,8 +453,8 @@
   <b>Note: A trailing space should be put after every allowed method.</b><br>
   &lt;parameter name="allowedMethods" value="subtract add "/&gt;<br>
   <br>
  -17) Now start the apache web server by typing “apache –k start”. If it is
  -running type “apache –k restart”<br>
  +17) Now start the apache web server by typing “apache -k start”. If it is
  +running type “apache -k restart”<br>
   <br>
   18) Now type http://localhost/axis/ in a browser and you will see the
   “Welcome to Axis C++” page with a listing of deployed services (In this case
  @@ -449,24 +468,17 @@
   <p><a name="runclient"></a></p>
   
   <h2>Coding and Running the client</h2>
  -<p>
  -1) Start Visual C++. 2) Go to File-&gt;Open and open the workspace file
  -“Axis.dsw” in [CHECKOUT_HOME]\ \c\vc.<br>
  -
  -3) Go to Project-&gt;Add To
  -Project-&gt;New…<br>
   
  +<p>1) Start Visual C++. 2) Go to File-&gt;Open and open the workspace file
  +“Axis.dsw” in [CHECKOUT_HOME]\ \c\vc.<br>
  +3) Go to Project-&gt;Add To Project-&gt;New…<br>
   4) Select the “Projects” tab<br>
  -
   5) Select “Win 32 Console Application”<br>
  -
  -6) Give a project
  -name (e.g. calclient) and click “OK”.
  -</p>
  +6) Give a project name (e.g. calclient) and click “OK”. </p>
   
   <p><img src="images/c/new_config_clientEXE.jpg"></p>
  -<p>
  -7) In the dialog that appears select “An empty project” click “Finish” and
  +
  +<p>7) In the dialog that appears select “An empty project” click “Finish” and
   then “OK”.<br>
   <br>
   8) When this procedure is followed the calclient project files are created in
  @@ -484,8 +496,7 @@
   <p><img border="0" src="images/c/new_config_client_include.jpg" width="577"
   height="372"></p>
   
  -<p>
  -11) Click the “Link” tab and select “Input” from the “Category” Drop down
  +<p>11) Click the “Link” tab and select “Input” from the “Category” Drop down
   list. <br>
   Remove the contents of the “Object/library modules” and add the following
   libs to it.<br>
  @@ -517,11 +528,12 @@
   printf("The result is : %d", result);
   }</pre>
   <br>
  -<p>
  -Right click on the project and click “Build” on the menu that appears.<br>
  +
  +
  +<p>Right click on the project and click “Build” on the menu that appears.<br>
   If Visual C++ complains about missing libs go to Build-&gt;Rebuild All (Do
   make sure that the apache server is stopped). Now the client exe is built.<br>
  -Start the apache by typing apache –k start and run the exe from Visual C++ by
  +Start the apache by typing apache -k start and run the exe from Visual C++ by
   going to Build-&gt;Execute calclient.exe. Now you will see the SOAP Request,
   SOAP Response and the result printed by the main method that we coded.</p>
   </body>
  
  
  
  1.3       +4 -2      ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/index.ihtml
  
  Index: index.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/contrib/axisdocs/src/documentation/content/xdocs/cpp/index.ihtml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.ihtml	15 Nov 2003 10:39:25 -0000	1.2
  +++ index.ihtml	2 Dec 2003 13:01:03 -0000	1.3
  @@ -1,11 +1,13 @@
   <html>
   <head>
     <meta http-equiv="Content-Type" content="text/html">
  -  <title>Axis C++ alpha Released!</title>
  +  <title>Axis C++ Beta Released!</title>
   </head>
   
   <body>
  -<h1>Axis C++ is released (Alpha)!</h1>
  +<h1>Axis C++ Beta released !</h1>
  +
  +<p>(December 01, 2003)</p>
   
   <p><br>
   </p>
  
  
  

Mime
View raw message