ws-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sanj...@apache.org
Subject cvs commit: ws-site/targets/axis/cpp winuser-guide.html wininstall-guide.html windev-guide.html who.html linuser-guide.html lininstall-guide.html index.html download.html documentation.html
Date Tue, 02 Dec 2003 13:23:15 GMT
sanjaya     2003/12/02 05:23:15

  Modified:    targets/axis/cpp winuser-guide.html wininstall-guide.html
                        windev-guide.html who.html linuser-guide.html
                        lininstall-guide.html index.html download.html
                        documentation.html
  Log:
  changes for axis-c beta release
  
  Revision  Changes    Path
  1.2       +16 -16    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.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- winuser-guide.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ winuser-guide.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  @@ -293,7 +293,7 @@
   <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.<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 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>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>
  +<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>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>
   <p>
   <a name="wsdl2ws"></a>
   </p>
  @@ -304,15 +304,15 @@
   <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>
  -<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>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>
   <br>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.<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.<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>
  +<br>The generated client stubs will be in [WSDL2WS_FOLDER]\ClientOut</p>
   <p>
   <a name="deploy"></a>
   </p>
  @@ -320,8 +320,9 @@
   <h4>Deploying your web service</h4>
   </div>
   <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>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="Axis\webservices\Calculator.dll"/&gt;<br>&lt;parameter name="allowedMethods" value="add subtract "/&gt;<br>&lt;/service&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>
   <p>
   <a name="client"></a>
  @@ -331,18 +332,17 @@
   </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>
  -<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>
  +<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"
   int main()
   { 
  -    Calculator c; 
  -    int result = c.add(40, 20);
  -    printf("result = %d", result);
  -    return 0;
  -}
  -</pre>
  +        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>
  @@ -351,7 +351,7 @@
   <h4>Running your sample</h4>
   </div>
   <p>1) Restart Apache.<br>2) Run the Client.exe<br>
  -<br> SUCCESS ! If you get the result, you are done.</p>
  +<br>SUCCESS ! If you get the result, you are done.</p>
   <div id="pdf" align="right">
   <a href="winuser-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  
  
  
  1.2       +20 -14    ws-site/targets/axis/cpp/wininstall-guide.html
  
  Index: wininstall-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/wininstall-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- wininstall-guide.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ wininstall-guide.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  @@ -271,7 +271,7 @@
   </div>
   <a href="#dist">What binary distribution contains</a>
   <br>
  -<a href="#apache">Installation with Apache 1.3.27 web server</a>
  +<a href="#apache">Installation with Apache 1.3.x/2.x web server</a>
   <br>
   <a href="#simpleaxis">Installation with Simple Axis Server</a>
   <br>
  @@ -290,7 +290,8 @@
   <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>-&gt; deploy<br>-&gt; docs<br>-&gt; include<br>-&gt; lib<br>-&gt; samples<br>
   <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>-&gt; groupB.exe (soap client for Interop groupB tests)<br>-&gt; wcg.exe (wrapper class generation tool)<br>-&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>DLL's<br>-&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>- testhandler1.dll(sample global handler)<br>- testhandler2.dll(sample transport handler)<br>
   <br>-&gt; libs - Contains following dll which are needed by axis.<br>- xerces-c_2_2_0.dll<br>
   <br>-&gt; logs - Log file used by loghandler handler<br>- LogAccessCountFile<br>
  @@ -300,20 +301,29 @@
   <a name="apache"></a>
   </p>
   <div class="h3">
  -<h3>Installation with Apache 1.3.27 web server</h3>
  +<h3>Installation with Apache 1.3.X/2.X web server</h3>
   </div>
   <p>STEPS:</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>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>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>&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.</p>
  +<br>LoadModule axis_module modules/AXISMODULE<br>&lt;Location /axis&gt;<br>SetHandler axis<br>&lt;/Location&gt;<br>
  +<br>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>
  +<strong>apache 1.3.X :</strong>
  +</p>
  +<p>It is recommended that apache 1.3.X be started as "apache -k start" on the command line</p>
  +<p>
  +<strong>apache 2.X :</strong>
  +</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>
  @@ -336,20 +346,16 @@
   <p>
   <a name="samples"></a>
   </p>
  -<br>
  -<br>
   <div class="h3">
   <h3>Running provided samples</h3>
   </div>
   <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>
  +<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>
  -<br>
  -<br>
   <div class="h3">
   <h3>Using Visual C++ to play with provided samples.</h3>
   </div>
  
  
  
  1.2       +33 -20    ws-site/targets/axis/cpp/windev-guide.html
  
  Index: windev-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/windev-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- windev-guide.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ windev-guide.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  @@ -326,14 +326,14 @@
   <br>Download the Xerces-C ( 32 bit binary release)from: http://xml.apache.org/xerces-c/download.cgi<br>
   <br>
   <strong>Apache web server</strong>
  -<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>
  +<br>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>
   <div class="h4">
   <h4>Installing Apache and extracting Xerces-C</h4>
   </div>
  -<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] from this point onwards.</p>
  +<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>This documentation was tested with the xerces version 2.3.0 which is distributed as xerces-c_2_3_0-win32.zip . Unzip the file xerces-c_2_3_0-win32.zip. The folder to which xerces is unzipped will be referred to as [XERCES_EXTRACT] from this point onwards.<br>&nbsp;</p>
   <p>
  @@ -342,31 +342,44 @@
   <div class="h4">
   <h4>Setting up the build environment</h4>
   </div>
  -<p>1)copy the contents inside the "[XERCES_EXTRACT] \include\xercesc &ldquo;<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 &ldquo;[XERCES_EXTRACT] \lib&rdquo; to &ldquo;[CHECKOUT_HOME]\c\lib\win32\xercesc&rdquo;<br>4) Copy the lib files from the &ldquo;[APACHE_HOME] \libexec&rdquo; to &ldquo;[CHECKOUT_HOME]\c\lib\win32\apache1_3&rdquo;<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 &ldquo;File View&rdquo;, right click on the project Apache1_3 and click on the &ldquo;Set as Active Project&rdquo; to make it the Active Project.<br>6) Again in Visual C++ right click on the project Apache1_3 in the workspace window &ldquo;File View&rdquo; and then click on &ldquo;Settings&hellip;&rdquo; on the popup menu. Select the &ldquo;link&rdquo; tab. Select &ldquo;General&rdquo; from the Category drop down list. In the &ldquo;Output file name&rdquo; text box put the value &ldquo;[APACHE_HOME]\modules\mod_axis.dll&rdquo; and click &ldquo;OK&rdquo;.</p>
  +<p>1)copy the contents inside the "[XERCES_EXTRACT] \include\xercesc"<br>to [CHECKOUT_HOME]\c\include\xercesc<br>2) Copy the include files.</p>
  +<p>
  +<strong>For apache 1.3.X:</strong>
  +</p>
  +<p>Copy the include files in "[APACHE_HOME]\include" directory to</p>
  +<p>"[CHECKOUT_HOME] \c\include\apache1_3\"</p>
  +<p>
  +<strong>For apache 2.X:</strong>
  +</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>
  +<strong>For apache 1.3.X:</strong> copy the ApacheCore.lib file from [APACHE_HOME] \libexec to [CHECKOUT_HOME]\c\lib\win32\apache1_3.</p>
  +<p>
  +<strong>For apache 2.X:</strong> 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 alt="" src="images/c/mod_axis.jpg"></p>
  -<p>7) In Visual C++ Go to &ldquo;Build -&gt; Rebuild All &ldquo; to build mod_axis.dll<br>&nbsp;</p>
  +<p>7) In Visual C++ Go to "Build -&gt; Rebuild All"&ldquo; to build mod_axis.dll<br>&nbsp;</p>
   <p>
   <a name="deployaxis"></a>
   </p>
   <div class="h4">
   <h4>Deploying Axis in Apache</h4>
   </div>
  -<p>1) Create a directory structure called &ldquo;Axis&rdquo; inside [APACHE_HOME] as follows<br>
  +<p>1) Create a directory structure called "Axis" inside [APACHE_HOME] as follows<br>
   <br>Axis<br>|__ libs ( Copy the two dll file from xerces-c-x.x-win32/bin and paste it inside)<br>|__ logs (log files are located here)<br>|__ conf (server.wsdd file is located here)<br>|__ webservices (The place to put webservice dlls)<br>|__ wsdls (The directory for the wsdl files of the deployed web services)<br>
   <br>NOTE: If you copy xerces dll files to [APACHE_HOME]\Axis\libs from a version 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 &ldquo;PATH&rdquo; environment variable to the following directories.<br>[APACHE_HOME]<br>[APACHE_HOME]\Axis\libs<br>
  +<br>2) Set the "PATH" environment variable to the following directories.<br>[APACHE_HOME]<br>[APACHE_HOME]\Axis\libs<br>
   <br>3) Change the apache configuration file [APACHE_HOME]\conf\httpd.conf to include the following lines at the bottom.<br>
   <br>LoadModule axis_module modules/mod_axis.dll<br>&lt;Location /axis&gt;<br>SetHandler axis<br>&lt;/Location&gt;<br>
   <br>
  -<br>4)create a file in [APACHE_HOME]\Axis named &ldquo;axiscpp.conf &ldquo; which should contain the following lines.<br>
  +<br>4)create a file in [APACHE_HOME]\Axis named "axiscpp.conf" which should contain the following lines.<br>
   <br>AXISLOGPATH:XXXX<br>WSDDFILEPATH:YYYY<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>AXISLOGPATH: [APACHE_HOME]\Axis\logs\AxisLog //<br>WSDDFILEPATH: [APACHE_HOME]\Axis\conf\server.wsdd //<br>
  +<br>i.e.<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>
   <br>6)Select start-&gt;programs-&gt;Apache HTTP server-&gt;Control Apache Server-&gt;stop to stop the apache server<br>(This is because apache will be started automatically by the installation program)<br>
   <br>Open up a DOS terminal and give the command "apache -k start" to start apache<br>(IT IS IMPORTANT TO START APACHE THIS WAY.)<br>
  -<br>(NOTE:If a 126 error occurs check whether the &ldquo;path&rdquo; 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>
  +<br>(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>
   <br>open a browser and verify whether you can browse http://localhost/ (or give the machines ip as http://xxx.xxx.xxx.xxx/). If apache is running you will see the Apache start page in the browser.&nbsp;</p>
   <p>
   <a name="deploywebservice"></a>
  @@ -386,11 +399,11 @@
   <div class="h2">
   <h2>Using eclipse to build and run WSDL2Ws</h2>
   </div>
  -<p>In the checked out source code there is a tool &ldquo;wsdl2ws&rdquo; (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>To build and run the java tool this section uses the eclipse platform. For this documentation eclipse 2.1.0 was used and the jdk version used was j2sdk1.4.1_01. You will not be able to build the java tool with jdk versions below 1.4.0.<br>
  +<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>To build and run the java tool this section uses the eclipse platform. For this documentation eclipse 2.1.0 was used and the jdk version used was j2sdk1.4.1_01. You will not be able to build the java tool with jdk versions below 1.4.0.<br>
   <br>1)Start the eclipse platform IDE.<br>Go to File-&gt;New-&gt;Project.<br>
  -<br>Select java in the &ldquo;New Project&rdquo; dialog and click &ldquo;Next&rdquo;.<br>
  -<br>In the &ldquo;New&rdquo; dialog that appears give a project Name (e.g. test). In the &ldquo;New dialog&rdquo; keep the &ldquo;use default&rdquo; Tick Box checked.<br>Note down the path in the &ldquo;Directory&rdquo; Text Box. This location will be referred to as [SKELSTUB_HOME] from this point onwards. Click &ldquo;Next&rdquo;.<br>
  -<br>Another dialog named &ldquo;New&rdquo; will appear. Select the &ldquo;Source&rdquo; tab. Select the project that you created (i.e. test).<br>Click on &ldquo;Add Folder&hellip;&rdquo;. In the &ldquo;Source Folder Selection&rdquo; dialog that appears select the project that you created (i.e. test) and click &ldquo;Create New Folder&hellip;&rdquo;. In the &ldquo;New Folder&rdquo; dialog that appears give a folder name as &ldquo;src&rdquo; and click &ldquo;OK&rdquo;. Click &ldquo;OK&rdquo; in the &ldquo;Source Folder Selection&rdquo; dialog. Click &ldquo;Yes&rdquo; on the confirmation message box that pops up.<br>
  +<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>
  +<br>Another dialog named "New&rdquo; will appear. Select the &ldquo;Source&rdquo; tab. Select the project that you created (i.e. test).<br>Click on &ldquo;Add Folder&hellip;&rdquo;. In the &ldquo;Source Folder Selection&rdquo; dialog that appears select the project that you created (i.e. test) and click &ldquo;Create New Folder&hellip;&rdquo;. In the &ldquo;New Folder&rdquo; dialog that appears give a folder name as &ldquo;src&rdquo; and click &ldquo;OK&rdquo;. Click &ldquo;OK&rdquo; in the &ldquo;Source Folder Selection&rdquo; dialog. Click &ldquo;Yes&rdquo; on the confirmation message box that pops up.<br>
   <br>Click &ldquo;Libraries&rdquo; in the &ldquo;New&rdquo; dialog. Click &ldquo;Add External JARs&hellip;&rdquo;. In the &ldquo;JAR Selection&rdquo; dialog that appears browse to [CHECKOUT_HOME]\ contrib\wss4j\lib and select the following JARs.<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>
   <br>Click &ldquo;Open&rdquo;.<br>
  @@ -406,7 +419,7 @@
   <p>&ldquo;Calculator.wsdl -o./ServerOut -lc++ -sserver&rdquo;.</p>
   <p>
   <img alt="" src="images/c/argument.jpg"></p>
  -<p>NOTE: These are the arguments for the java tool WSDL2Ws. The usage of the WSDL2Ws is as follows.<br>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. &ndash;o, -l).<br>
  +<p>NOTE: These are the arguments for the java tool WSDL2Ws. The usage of the WSDL2Ws is as follows.<br>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>
   <br>Click &ldquo;Run&rdquo;.<br>Now the Skeletons/Wrappers will be generated and you will see messages in the eclipse console displaying the generated files. The generated Skeletons/Wrappers will be created in a folder named [SKELSTUB_HOME]\ServerOut as given in the arguments when the tool was run.<br>
   <br>Similarly to generate the client stubs use the following arguments in eclipse and run.<br>&ldquo;Calculator.wsdl -o./ClientOut -lc++ -sclient&rdquo;.<br>The generated Stubs will be created in a folder named [SKELSTUB_HOME]\ClientOut.<br>&nbsp;</p>
   <p>
  @@ -436,7 +449,7 @@
   <p>1) Start Visual C++.<br>2) Go to File-&gt;Open and open the workspace file &ldquo;Axis.dsw&rdquo; in [CHECKOUT_HOME]\ \c\vc.<br>3) Go to Project-&gt;Add To Project-&gt;New&hellip;<br>4) Select the &ldquo;Projects&rdquo; tab<br>5) Select &ldquo;Win 32 Dynamic-Link Library&rdquo;<br>6) Give a project name (e.g. ws1) and click &ldquo;OK&rdquo;.<br>7) In the dialog that appears select &ldquo;An empty DLL project&rdquo; click &ldquo;Finish&rdquo; and then &ldquo;OK&rdquo;.<br>8) When this procedure is followed the ws1 project files are created in [CHECKOUT_HOME]\c\vc\ws1.<br>9) Right click on the project that you created (i.e. ws1) and click &ldquo;Add Files to Project&hellip;&rdquo; on the menu that appears. In the &ldquo;Insert Files into Project&rdquo; dialog select the generated .cpp and .h files in [SKELSTUB_HOME]\ServerOut and click &ldquo;OK&rdquo;.<br>10) Right click on the project (i.e. ws1)again and click on &ldquo;Settings&hellip;&rdquo; on the menu that appears. Click the C/C++ tab and select &ldquo;Preprocessor&rdquo; from the &ldquo;Category&rdquo; Drop down list.<br>In the &ldquo;Additional include directories&rdquo; give &ldquo;../../include&rdquo;<br>
   </p>
   <img alt="" src="images/c/new_config_include.jpg"><p>11) Now business logic should be added to the generated Skeletons. The Skeletons in this case are Calculator.h and Calculator.cpp<br>12) Two methods are available for implementation in Calculator.cpp we shall implement them as follows.<br>int Calculator::add(int Value0, int Value1)<br>{<br>return Value0+Value1; //business logic<br>}<br>int Calculator::subtract(int Value0, int Value1)<br>{<br>return Value0-Value1; //business logic<br>}<br>13) Right click on the project (i.e. ws1) and click &ldquo;Build&rdquo; on the menu that appears. Visual C++ should be able to build the project without any errors now.<br>
  -<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>16) In addition to this you have to create sever.wsdd file in [APACHE_HOME]\Axis\conf<br>
  +<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>16) In addition to this you have to create sever.wsdd file in [APACHE_HOME]\Axis\conf<br>
   <br>The <a href="../cfiles/server.wsdd">server.wsdd</a> file for this example is given below</p>
   <br>
   <pre>&lt;deployment&gt;
  @@ -447,14 +460,14 @@
   &lt;/service&gt;
   &lt;/deployment&gt;</pre>
   <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>The service element specifies the service name.<br>&lt;service name="Calculator"&gt;<br>
   <br>In this parameter element we specify the parameter className and it&rsquo;s value, the location of the webservice dll.<br>&lt;parameter name="className" value="C:\Program Files\Apache Group\Apache\Axis\webservices\ws1.dll"/&gt;<br>
   <br>In this parameter element we specify the parameter allowedMethods and its value, the methods exposed by the web service (i.e. subtract and add).<br>
   <strong>Note: A trailing space should be put after every allowed method.</strong>
   <br>&lt;parameter name="allowedMethods" value="subtract add "/&gt;<br>
  -<br>17) Now start the apache web server by typing &ldquo;apache &ndash;k start&rdquo;. If it is running type &ldquo;apache &ndash;k restart&rdquo;<br>
  +<br>17) Now start the apache web server by typing &ldquo;apache -k start&rdquo;. If it is running type &ldquo;apache -k restart&rdquo;<br>
   <br>18) Now type http://localhost/axis/ in a browser and you will see the &ldquo;Welcome to Axis C++&rdquo; page with a listing of deployed services (In this case the Calculator service only).<br>&nbsp;</p>
   <p>
   <a name="consumews"></a>
  @@ -468,7 +481,7 @@
   <div class="h4">
   <h4>Coding and Running the client</h4>
   </div>
  -<p>1) Start Visual C++. 2) Go to File-&gt;Open and open the workspace file &ldquo;Axis.dsw&rdquo; in [CHECKOUT_HOME]\ \c\vc.<br> 3) Go to Project-&gt;Add To Project-&gt;New&hellip;<br> 4) Select the &ldquo;Projects&rdquo; tab<br> 5) Select &ldquo;Win 32 Console Application&rdquo;<br> 6) Give a project name (e.g. calclient) and click &ldquo;OK&rdquo;.</p>
  +<p>1) Start Visual C++. 2) Go to File-&gt;Open and open the workspace file &ldquo;Axis.dsw&rdquo; in [CHECKOUT_HOME]\ \c\vc.<br>3) Go to Project-&gt;Add To Project-&gt;New&hellip;<br>4) Select the &ldquo;Projects&rdquo; tab<br>5) Select &ldquo;Win 32 Console Application&rdquo;<br>6) Give a project name (e.g. calclient) and click &ldquo;OK&rdquo;.</p>
   <p>
   <img alt="" src="images/c/new_config_clientEXE.jpg"></p>
   <p>7) In the dialog that appears select &ldquo;An empty project&rdquo; click &ldquo;Finish&rdquo; and then &ldquo;OK&rdquo;.<br>
  @@ -493,7 +506,7 @@
   printf("The result is : %d", result);
   }</pre>
   <br>
  -<p>Right click on the project and click &ldquo;Build&rdquo; 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 &ndash;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>
  +<p>Right click on the project and click &ldquo;Build&rdquo; 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 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>
   <div id="pdf" align="right">
   <a href="windev-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
             PDF</a>
  
  
  
  1.4       +1 -1      ws-site/targets/axis/cpp/who.html
  
  Index: who.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/who.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- who.html	15 Nov 2003 10:48:58 -0000	1.3
  +++ who.html	2 Dec 2003 13:23:15 -0000	1.4
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  
  
  
  1.3       +7 -7      ws-site/targets/axis/cpp/linuser-guide.html
  
  Index: linuser-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/linuser-guide.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- linuser-guide.html	3 Nov 2003 13:15:18 -0000	1.2
  +++ linuser-guide.html	2 Dec 2003 13:23:15 -0000	1.3
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  @@ -436,7 +436,7 @@
   </p>
   <p>Now</p>
   <p>
  -<strong>$ cd $AXISCPP_HOME/c/src/wsdl/</strong>
  +<strong>$ cd $AXISCPP_HOME/src/wsdl/</strong>
   </p>
   <p>
   <strong>$ mkdir temp</strong>
  @@ -730,9 +730,9 @@
   <div class="h3">
   <h3>Deploying the Service</h3>
   </div>
  -<p>The Folder called deploy in the <strong>/home/axisuser/projects/axis_c/</strong> should be copied to apache root folder .Rename the deploy folder as <strong>"Axis"</strong>. Give all permissions to this folder.</p>
  +<p>The Folder called deploy in the <strong>$AXISCPP_HOME/</strong> should be copied to apache root folder .Rename the deploy folder as <strong>"Axis"</strong>. Give all permissions to this folder.</p>
   <p>
  -<strong>$ cp &ndash;rf /home/axisuser/projects/axis_c/deloy /usr/local/apache</strong>
  +<strong>$ cp &ndash;rf $AXISCPP_HOME/deloy /usr/local/apache</strong>
   </p>
   <p>
   <strong>$ cd /usr/local/apache</strong>
  @@ -1255,7 +1255,7 @@
   </div>
   <p>If you want to test handlers go into the <strong>$AXISCPP_HOME/src/server/handlers</strong> folder where example handlers are included (If you use the binary download sample handler libraries are included in <strong>$(AXIS_HOME)/handlers</strong> folder(assuming that you created this folder as described in installation guide). Several sample handlers are included there covering the concepts of service specific, global and transport handlers. We will show you the detail of running a service specific handler named loghandler. The task of this handler is writing to a file the number of times the service is accessed.</p>
   <p>
  -<strong>cd /home/axisuser/projects/axis_c/src/server/handlers/custom/loghandler</strong>
  +<strong>cd $AXISCPP_HOME/src/server/handlers/custom/loghandler</strong>
   </p>
   <p>
   <strong>$sh autogen.sh</strong>
  @@ -1624,9 +1624,9 @@
   <div class="h3">
   <h3>Deploying the Services</h3>
   </div>
  -<p>The Folder called deploy in the <strong>/home/axisuser/projects/axis_c/</strong> should be copied to apache root folder .Rename the deploy folder as <strong>"Axis"</strong>. Give all permissions to this folder.</p>
  +<p>The Folder called deploy in the <strong>$AXISCPP_HOME/</strong> should be copied to apache root folder .Rename the deploy folder as <strong>"Axis"</strong>. Give all permissions to this folder.</p>
   <p>
  -<strong>$ cp &ndash;rf /home/axisuser/projects/axis_c/deloy /usr/local/apache</strong>
  +<strong>$ cp &ndash;rf $AXISCPP_HOME/deloy /usr/local/apache</strong>
   </p>
   <p>
   <strong>$ cd /usr/local/apache</strong>
  
  
  
  1.2       +1 -1      ws-site/targets/axis/cpp/lininstall-guide.html
  
  Index: lininstall-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/lininstall-guide.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- lininstall-guide.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ lininstall-guide.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  
  
  
  1.3       +5 -4      ws-site/targets/axis/cpp/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/index.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.html	15 Nov 2003 10:50:33 -0000	1.2
  +++ index.html	2 Dec 2003 13:23:15 -0000	1.3
  @@ -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++ alpha Released!</title>
  +<title>Axis C++ Beta Released!</title>
   </head>
   <body bgcolor="white" class="composite">
   <!--================= start Banner ==================-->
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<span class="menuSelected">Axis C++ alpha released!</span>
  +<span class="menuSelected">Axis C++ Beta released!</span>
   </div>
     
   <div class="menuItem">
  @@ -259,12 +259,13 @@
   <div id="bodycol">
   <div class="app">
   <div align="center">
  -<h1>Axis C++ alpha Released!</h1>
  +<h1>Axis C++ Beta Released!</h1>
   </div>
   <div class="h3">
   <div class="h3">
  -<h3>Axis C++ is released (Alpha)!</h3>
  +<h3>Axis C++ Beta released !</h3>
   </div>
  +<p>(December 01, 2003)</p>
   <p>
   <br>
   </p>
  
  
  
  1.2       +1 -1      ws-site/targets/axis/cpp/download.html
  
  Index: download.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/download.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- download.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ download.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  
  
  
  1.2       +1 -1      ws-site/targets/axis/cpp/documentation.html
  
  Index: documentation.html
  ===================================================================
  RCS file: /home/cvs/ws-site/targets/axis/cpp/documentation.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- documentation.html	31 Oct 2003 21:16:15 -0000	1.1
  +++ documentation.html	2 Dec 2003 13:23:15 -0000	1.2
  @@ -168,7 +168,7 @@
   <span class="menuLabel">Axis (C++)</span>
     
   <div class="menuItem">
  -<a href="../cpp/index.html">Axis C++ alpha released!</a>
  +<a href="../cpp/index.html">Axis C++ Beta released!</a>
   </div>
     
   <div class="menuItem">
  
  
  

Mime
View raw message