axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ros...@apache.org
Subject cvs commit: ws-axis/site/src/documentation/content/xdocs/cpp windev-guide.ihtml
Date Thu, 01 Jul 2004 10:24:36 GMT
roshan      2004/07/01 03:24:36

  Modified:    site/src/documentation/content/xdocs/cpp windev-guide.ihtml
  Log:
  Removed some grammatical mistakes in Windows Dev Guide and made it more user friendly.Changed
by Rangika
  
  Revision  Changes    Path
  1.13      +52 -59    ws-axis/site/src/documentation/content/xdocs/cpp/windev-guide.ihtml
  
  Index: windev-guide.ihtml
  ===================================================================
  RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/windev-guide.ihtml,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- windev-guide.ihtml	16 Jun 2004 05:41:38 -0000	1.12
  +++ windev-guide.ihtml	1 Jul 2004 10:24:36 -0000	1.13
  @@ -49,12 +49,13 @@
   <a href="#parser">Creating and Building your own parser</a>
   
   </p>
  -<p> <b>Before you follow this guide, make sure that you have followed the </b><a
href="winuser-guide.html"><b>Windows User Guide</b></a> <b>also
knows how to use binaries.</b></p>
  +<p> <b>Before going through this guide, please go through the </b><a
href="winuser-guide.html"><b>Windows User Guide</b></a> <b> and
also be familiar with how to use binaries.</b></p>
   
   <p>
   <a name="buildaxis"></a></p>
   
  -<h1>Building and Deploying Axis C++</h1>
  +<h1>
  + Axis C++</h1>
   
   <p>
   <a name="cvscheckout"></a></p>
  @@ -64,10 +65,10 @@
   
   
   <p>Visit <a href="#http://ws.apache.org/">http://ws.apache.org/</a> Click
on “axis” and then on “CVS Repository”
  -to find details on accessing the CVS Repository. It will have instructions
  +to find details on how to access the CVS Repository. It will have instructions
   similar to the following.<br>
   <br>
  -“Anyone can checkout source code from our anonymous CVS server. To do so,
  +“Anyone can checkout the source code from our anonymous CVS server. To do so,
   simply use the following commands (if you are using a GUI CVS client,
   configure it appropriately): <br>
   
  @@ -78,15 +79,15 @@
   <br>
   cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout ws-axis<br>
   <br>
  -The examples given below will be based on these lines of instructions.<br>
  +The examples given below are based on these lines of instructions.<br>
   <br>
   To use the command line cvs client go to http://www.cvshome.org, click on the
  -"CVS Downloads" link. In the resulting page there will be a link named
  -"historical download pages", under the heading "CVS downloads", where you can
  +"CVS Downloads" link.In the resulting page under the heading "CVS downloads",there will
be a link named
  +"historical download pages", where you can
   download the cvs binaries for Windows. Download the Windows cvs binaries.
  -Extract the cvs binaries from the downloaded zip file. There will be a
  -“cvs.exe” file when this is extracted. Set the PATH environment variable to
  -where “cvs.exe” is.<br>
  +Extract the cvs binaries from the downloaded zip file.When this is extracted there will
be a
  +“cvs.exe” file . Set the PATH environment variable to
  + “cvs.exe” <br> <br>
   You would have to do the following to get a checkout from the command line
   cvs client.<br>
   <br>
  @@ -101,7 +102,7 @@
   The checkout of the repository will be created in the current directory in a
   folder named “ws-axis”<br>
   <br>
  -The checked out folder ws-axis will be referred to as [CHECKOUT_HOME] from
  +The checked out folder ws-axis will be referred as [CHECKOUT_HOME] from
   this point on.<br></p>
   
   <p><a name="getapacheexpat"></a></p>
  @@ -137,14 +138,14 @@
   <br>
   <p>Run the file
   expat_win32bin_1_95_7.exe . The folder to which Expat is unzipped will be
  -referred to as [EXPAT_EXTRACT] from this point onwards.</p>
  +referred as [EXPAT_EXTRACT] from this point onwards.</p>
   
   <br>
   <p><b>Apache</b></p>
   <br>
   <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". These locations will be referred to as [APACHE_HOME]
  +Files\Apache Group\Apache2". These locations will be referred  as [APACHE_HOME]
   from this point onwards.</p>
   
   
  @@ -188,7 +189,7 @@
   <p><b>Building the AxisServer and AxisClient dlls </b> </p>
   
   <p>Build the AxisServer and AxisClient projects.(Click on file in Visual C++ ,open
Visual C++ Distribution workspace (Distribution.dsw) at [CHECKOUT_HOME]\c\vc\.
  -In the workspace window, File View, right click on  the AxisServer project and AxisClient
project ).Which will build the AxisServer_D.dll and AxisClient_D.dll </p>
  +In the workspace window, File View, right click on  the AxisServer project and AxisClient
project ).Which will build the AxisServer.dll and AxisClient.dll </p>
   
   <p><b>Building Apache Modules (Apache 1.3.X and Apache 2.X) </b> </p>
   <p>
  @@ -203,14 +204,14 @@
   "Apache2_0Module" 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.(To build a Apache Module AxisServer.lib
should be in the settings Link tab ) </p>
  +[APACHE_HOME]\modules\mod_axis.dll and click OK.(To build a Apache Module, AxisServer.lib
should be in the settings Link tab ) </p>
   
   <p>Build either Apache1_3Module or Apache2_0Module project.
   In Visual C++ right click on either the project "Apache1_3Module" or
   "Apache2_0Module" in the workspace window, File View and click "build (selection only)"
   to build mod_axis.dll for Apache1_3Module or mod_axis2.dll for Apache2_0Module.
   <br><br>
  -(From here onwards we will refer to these modules as APACHE_MODULE. Replace it 
  +(From here onwards we refer to these modules as APACHE_MODULE. Replace it 
   with the correct module for the Apache server version that you have installed). Then build
SimpleAxisServer.  
   
   &nbsp;</p>
  @@ -220,9 +221,9 @@
   <p><b>Xerces Parser Library and Expat Parser Library</b></p>
   <p>In VC++ distribution workspace build either AxisXMLParserXerces project or AxisXMLParserExpat
project. Then AxisXMLParser.dll will be built.</p>  
   
  -<p><b> Building AxisTransport_D.dll  and AxisXMLParser_D.dll</b>
  -<br>Build the AxisTransport and AxisXMLParser projects. Which will build the AxisTransport_D.dll
and AxisXMLParser_D.dll in [CHECKOUT_HOME]\c\bin. </p>
  -
  +<p><b> Building AxisTransport.dll  and AxisXMLParser.dll</b>
  +<br>Build the AxisTransport and AxisXMLParser projects. Which will build the AxisTransport.dll
and AxisXMLParser.dll in [CHECKOUT_HOME]\c\bin. </p>
  +<p>(When the projects are built in Debug mode then the Dlls will appear as AxisTransport_D
and AxisXMLParser_D.dll)</p> 
   <p><a name="deployaxis"></a></p>
   
   
  @@ -253,25 +254,18 @@
   <br>
   ii)Copy APACHE_MODULE to [APACHE_HOME]\modules directory of your apache installation.
   <br>
  -iii)Copy AxisServer_D.dll  to any location specified by your PATH environment variable

  -<br>
  -iv)Copy AxisTransport_D.dll to any location specified by your PATH environment variable

  -<br>
  -v)Copy AxisXMLParser_D.dll to any location specified by your PATH environment variable

  -<p>
  -<b>NOTE:</b>Usually it is a best practice to copy AxisServer_D.dll ,AxisTransport_D.dll
and AxisXMLParser_D.dll  to [AXIS_HOME]\libs\ directory and add that directory to your PATH
environment variable.
  -
  +<p>Copy AxisServer.dll ,AxisTransport.dll and AxisXMLParser.dll to [AXIS_HOME]\libs\
directory and add that directory to your PATH environment variable.Or to any location specified
by your PATH environment variable.</p>    
   
   <br> <br>
  -2) Set the "PATH" environment variable to the following directories.
  +<p>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>
  +3)Include the following lines at the bottom of the apache configuration file [APACHE_HOME]\conf\httpd.conf

  +<br>
   
   
   <br>
  @@ -301,17 +295,17 @@
   
   <br>
   Where XXXX will be the path to a file named AxisLog (The log file)and YYYY
  -will be the path to the server.wsdd file.ZZZZ will be the path to AxisTransport_D.dll if
it's a HTTP(if the selected transport is SMTP then should give that path.WWWW will be the
path to AxisXMLParser_D.dll<br>
  +will be the path to the server.wsdd file.ZZZZ will be the path to AxisTransport.dll if
it's a HTTP(if the selected transport is SMTP then should give that path.WWWW will be the
path to AxisXMLParser.dll<br>
   <br>
   i.e.<br>
   LogPath:[APACHE_HOME]\Axis\logs\AxisLog.log  
   
   <br>
   WSDDFilePath:[APACHE_HOME]\Axis\conf\server.wsdd <br>
  -Transport_http:[APACHE_HOME]\Axis\libs\AxisTransport_D.dll <br>
  -XMLParser:[APACHE_HOME]\Axis\libs\AxisXMLParser_D.dll <br>
  +Transport_http:[APACHE_HOME]\Axis\libs\AxisTransport.dll <br>
  +XMLParser:[APACHE_HOME]\Axis\libs\AxisXMLParser.dll</p>  
   
  -<p><b>Note:If the AxisTransport_D.dll and AxisXMLParser_D.dll paths are not
given in axiscpp.conf then the hardcoded values will be used.For that set the path of these
two in the PATH environment variable or copy them to the same location as the Client.exe.</b></p>
  +<p><b>Note:If the AxisTransport.dll and AxisXMLParser.dll paths are not given
in axiscpp.conf then the hardcoded values will be used.For that set the path of these two
in the PATH environment variable or copy them to the same location as the Client.exe.</b></p>
   <br>
   <p>6)Select start-&gt;programs-&gt;Apache HTTP server-&gt;Control Apache
   Server-&gt;stop to stop the apache server
  @@ -322,7 +316,7 @@
   <br>
   <br>
   Open up a DOS terminal and give the command "apache -k start" to start
  -apache (If Apache 2.0 server does not seem to respond when started this way, try "apache
-X").
  +apache (If Apache 2.0 server does not respond when started this way, try "apache -X").
   
   
   <br>
  @@ -374,7 +368,7 @@
   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>
  +referred as [SKELSTUB_HOME] from this point onwards. Click "Next".<br>
   
   
   <br>
  @@ -390,7 +384,7 @@
   <br>
   Click “Libraries” in the “New” dialog. Click “Add External JARs…”. In the
   “JAR Selection” dialog that appears browse to [CHECKOUT_HOME]\
  -\lib\axisjava and select the following JARs.<br>
  +lib\axisjava and select the following JARs.<br>
   
   
   <br>
  @@ -422,7 +416,7 @@
   
   <br>
   For this demonstration we will use a Calculator web service and the WSDL file
  -for that web service is located at [CHECKOUT_HOME]\c\samples\server\simple.<br>
  +the web service is located at [CHECKOUT_HOME]\c\samples\server\simple.<br>
   
   <br>
   Copy the Calculator.wsdl to [SKELSTUB_HOME]<br>
  @@ -482,8 +476,8 @@
   <p>For building WSDL2Ws java tool on the command line you require jdk1.4 or
   above.<br>
   <br>
  -To build WSDL2Ws java tool you should set the CLASSPATH Environment Variable
  -to point to the following jar files.Create a New Folder called wsdl2wsTool\lib and put
those jars in it. You can find 
  +To build WSDL2Ws java tool set the CLASSPATH Environment Variable
  +to point to the following jar files.Create a New Folder called wsdl2wsTool\lib and put
the above mentioned jars in it. You can find 
   these jars in [CHECKOUT_HOME]\lib\axisjava.
   
   <br>
  @@ -523,7 +517,7 @@
   <br>
   Java -classpath .;%classpath% org.apache.axis.wsdl.wsdl2ws.WSDL2Ws Calculator.wsdl -o./ServerOut
-lc++ -sserver<br>
   <br>
  -You must give the class path exactly as above in that order.
  +Give the class path exactly in the same order as given above. 
   <br><br>
   If the tool is successful the tool will display the files it has
   generated. The skeletons and stubs will be generated in
  @@ -542,7 +536,7 @@
   
   <h2>Building and Deploying the web service</h2>
   
  - <p>1) If you have followed the above instructions you should have been able to generate
the Server 
  + <p>1) If you have followed the above instructions correctly you would have been
able to generate the Server 
   side Skeletons and Wrappers for the Calculator.wsdl
   <br><br> 2) Start Visual C++.<br>
   
  @@ -554,7 +548,7 @@
   <br>
   5) Select “Win 32 Dynamic-Link Library”.<br>
   <br>
  -6) Give a project name (e.g. ws1), give some folder (say "deployws") as the "location"
for the project, select the "create new workspace" radio button, and click “OK”.When this
procedure is followed the "ws1" project files are created in a folder named "ws1" inside the
"deployws" folder. <br>
  +6) Give a project name (e.g. ws1), give a folder (say "deployws") as the "location" of
the project, select the "create new workspace" radio button, and click “OK”.When this procedure
is followed the "ws1" project files are created in a folder named "ws1" inside the "deployws"
folder. <br>
   
   <br>
   7) In the dialog that appears select “An empty DLL project” click “Finish” and then “OK”.<br>
  @@ -569,11 +563,10 @@
   Add Axis include directory [CHECKOUT_HOME]c\include\ to the project In the 
   “Additional include directories”<br>
   
  -<br>10)Now business logic should be
  -added to the generated Skeletons. The Skeletons in this case are Calculator.h
  +<br>10)Now add the business logic to the generated Skeletons. The Skeletons in this
case are Calculator.h
   and Calculator.cpp
   <br><br>
  -11) We shall implement two methods available in Calculator.cpp as follows.
  +11) We will implement two methods that are in Calculator.cpp as follows.
   <br>
   int Calculator::add(int Value0, int Value1)<br>
   {<br>
  @@ -590,7 +583,7 @@
   13) The ws1.dll will be built in "ws1\Debug" by Visual
   C++<br><br>
   14) Place the built ws1.dll file in [APACHE_HOME]\Axis\webservices<br><br>
  -15) In addition to this you have to create sever.wsdd file in
  +15) In addition to this create sever.wsdd file in
   [APACHE_HOME]\Axis\conf<br>
   <br>
   The server.wsdd file for this example is
  @@ -605,11 +598,11 @@
   &lt;/service&gt;
   &lt;/deployment&gt;</pre>
   
  -<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
  +<p>In this file [APACHE_HOME] has to be replaced with the actual value of
  +[APACHE_HOME] (i.e. In 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>
  +<b>Description of the server.wsdd file</b><br>
   <br>
   The service element specifies the service name.<br>
   &lt;service name="Calculator"&gt;<br>
  @@ -642,7 +635,7 @@
   
   
   
  -<p>1) If you have followed the above instructions you should have been able to generate
the Server 
  +<p>1) If you have followed the above instructions you would have been able to generate
the Server 
   side Skeletons and Wrappers for the Calculator.wsdl.
   
   <br> 2) Start Visual C++.<br>
  @@ -653,7 +646,7 @@
   <br>
   6) Give a project name (e.g. calclient) and click “OK”. 
   
  -Give a project name (e.g. calclient), give some folder (say "wsclient") as the "location"
for the project, select the "create new workspace" radio button, and click “OK”.When this
procedure is followed the "calclient" project files are created in a folder named "calclient"
inside the "wsclient" folder. <br>
  +Give a project name (e.g. calclient), give a folder ( For e.g: "wsclient") as the "location"
of the project, select the "create new workspace" radio button, and click “OK”.When this procedure
is followed the "calclient" project files are created in a folder named "calclient" inside
the "wsclient" folder. <br>
   
   
   </p>
  @@ -703,7 +696,7 @@
   <p>It is better to have the path to your AxisXMLParser.dll and AxisTransport.dll
in axiscpp.conf or have the dlls where the client exe is.</p>
   <p>Right click on the project and click “Build” on the menu that appears.
   
  -<p>When the XMLParser is running these steps occur.<br>
  +<p>When the XMLParser is running these steps would occur.<br>
   1. Locate Parser dll.<br>
   2. Create Parser instance by CreateInstance() method.<br>
   3. Give the stream to parser by setInputStream() method.<br>
  @@ -711,16 +704,16 @@
   5. getStatus() to see if the streams are properly passed.<br>
   6. Destroy parser object by DestroyInstance().<br>
   </p>
  -<p>If Visual C++ complains about missing libs go to Build-&gt;Rebuild All (Do
  +<p>If Visual C++ complains about missing libs go to Build-&gt;Rebuild All (Please
   make sure that the apache server is stopped). Now the client exe is built.<br>
   
   Start the Apache server by typing apache -k start and run the exe from Visual C++ by
  -going to Build-&gt;Execute calclient.exe. If all went well now you should see the SOAP
Request,
  +going to Build-&gt;Execute calclient.exe. If all goes well, now you would see the SOAP
Request,
   SOAP Response and the result printed by calclient.exe.</p>
   
   
   <P><a name="providedservices"></a></p>
  -<h2>Building and deploying the provided interop web services samples</h2>
  +<h2>Building and deploying the provided samples of interop web services</h2>
   <p>
   <br>1) Open the Visual C++ workspace (interoptests.dsw) at [CHECKOUT_HOME]\c\vc\samples\server\interoptests\
 and do a batch build of all projects.
   <br>2) You will find the built dynamic libraries at [CHECKOUT_HOME]\c\bin directory.
Following are the built DLLs.
  @@ -734,7 +727,7 @@
   <br>4)Add the required entries to the server.wsdd file in [APACHE_HOME]\Axis\conf
to deploy these
   interop services.
   You can find the required entries in the [CHECKOUT_HOME]\c\deploy\conf\server.wsdd_win
file.
  -You will need to modify the "value" of the "classname" parameter of each service to to
point to
  +You will need to modify the "value" of the "classname" parameter of each service to point
to
   the relevant web service dll given above in [APACHE_HOME]\Axis\webservices.
   </p>
   
  @@ -742,7 +735,7 @@
   <h2>Building and running the provided interop client applications</h2>
   <p>
   <br>1) Open the Visual C++ workspace (interoptests.dsw) at [CHECKOUT_HOME]\c\vc\samples\client\interoptests\
and do a batch build of all projects.
  -<br>2) You need to build the AxisClient project in the "Distribution" workspace at
[CHECKOUT_HOME]\c\vc\, because you need the AxisClient.lib to complile client applications
and AxisClient.dll to run them.
  +<br>2) You need to build the AxisClient project in the "Distribution" workspace at
[CHECKOUT_HOME]\c\vc\, because you need the AxisClient.lib to compile client applications
and AxisClient.dll to run them.
   <br>3) You will find the built console applications and AxisClient.dll at [CHECKOUT_HOME]\c\bin
directory. Following are the built .exe files.
   	base.exe
   	cbase.exe
  @@ -768,7 +761,7 @@
   <h2>Creating and Building your own parser</h2>
   <img border="0" src="images/c/parserd/parser.jpg">
    
  -<p><b>Note:Implement XMLParser.h interface according to rules described there.</b><br>
  +<p><b>Note:Implement XMLParser.h interface according to the rules described
in the header file.</b><br>
   <p>When creating your own parser refer  XMLParser.h header file for API. To see an
example implementation refer SoapParserExpat.h,SoapParserExpat.cpp, SoapParserXerces.h and
SoapParserXerces.cpp.
   <p>Axis loads the parser dynamic library through following export functions which
you also have to implement.</p>
   <p>CreateInstance() - Used by Axis to create an instance of your parser class<br>
  
  
  

Mime
View raw message