You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by ra...@apache.org on 2005/02/03 14:13:05 UTC
cvs commit: ws-site/targets/axis/cpp winuser-guide.pdf winuser-guide.html wininstall-guide.pdf wininstall-guide.html windev-guide.html lininstall-guide.pdf lininstall-guide.html
rangika 2005/02/03 05:13:05
Modified: targets/axis/cpp winuser-guide.pdf winuser-guide.html
wininstall-guide.pdf wininstall-guide.html
windev-guide.html lininstall-guide.pdf
lininstall-guide.html
Log:
Changed the default transport in the doc.
Revision Changes Path
1.31 +235 -216 ws-site/targets/axis/cpp/winuser-guide.pdf
<<Binary file>>
1.35 +9 -5 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.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- winuser-guide.html 3 Feb 2005 06:42:32 -0000 1.34
+++ winuser-guide.html 3 Feb 2005 13:13:04 -0000 1.35
@@ -95,7 +95,7 @@
<div class="menuItem">
-<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
</div>
<div class="menu">
@@ -214,7 +214,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/jp/">Japanese (Unofficial)</a>
</div>
</div>
@@ -309,6 +309,10 @@
<br>
<br>
<br>
+<a href="#axis3">Axis 3 Transport</a>
+<br>
+<br>
+<br>
<strong>Before you follow this guide, please make sure that you have followed the</strong> <a href="wininstall-guide.html"><strong>Windows Installation guide</strong></a>
</p>
<p>
@@ -433,15 +437,15 @@
<div class="h4">
<h4>Transport Library and Parser Library</h4>
</div>
-<p>AxisTransport.dll (Which can be found at Axis_Extract/bin) should be placed in the path, and should be specified as the value to the key "Transport_http" in axiscpp.conf [Axis_Folder]/axiscpp.conf Or in the same place as the client.exe.</p>
+<p>HTTPTransport.dll and HTTPChannel.dll (Which can be found at Axis_Extract/bin) should be placed in the path, and should be specified as the value to the keys "Transport_http" and "Channel_HTTP" respectively in axiscpp.conf [Axis_Folder]/axiscpp.conf Or in the same place as the client.exe.</p>
<p>Rename AxisXMLParser_Xerces.dll to AxisXMLParser.dll and give the path of the AxisXMLParser.dll as the value of the key XMLParser in axiscpp.conf Or in the same place as the client.exe.<br> xerces-c_2_2_0.dll should be given in the path.<br>
</p>
<p>
<strong>Axiscpp.conf file contains the following paths</strong>
<br>
-<br>LogPath:XXXX<br>WSDDFilePath:YYYY<br>Transport_http:ZZZZ (Not necessary)<br>XMLParser:WWWW<br>
+<br>LogPath:XXXX<br>WSDDFilePath:YYYY<br>Transport_http:ZZZZ<br>Channel_HTTP:BBBB<br>XMLParser:WWWW<br>
<br>XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file.<br>
-<br>i.e.<br>LogPath:[Apache_Folder]\Axis\logs\AxisLog.log<br>WSDDFilePath:[Apache_Folder]\Axis\conf\server.wsdd<br>Transport_http:[Apache_Folder]\Axis\libs\AxisTransport_D.dll<br>XMLParser:[Apache_Folder]\Axis\libs\AxisXMLParser_D.dll<br>
+<br>i.e.<br>LogPath:[Apache_Folder]\Axis\logs\AxisLog.log<br>WSDDFilePath:[Apache_Folder]\Axis\conf\server.wsdd<br>Transport_http:[Apache_Folder]\Axis\libs\HTTPTransport.dll<br>Channel_HTTP:[Apache_Folder]\Axis\libs\HTTPChannel.dll<br>XMLParser:[Apache_Folder]\Axis\libs\AxisXMLParser.dll<br>
</p>
<p>
<a name="handlers"></a>
1.33 +169 -211 ws-site/targets/axis/cpp/wininstall-guide.pdf
<<Binary file>>
1.41 +10 -10 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.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- wininstall-guide.html 3 Feb 2005 06:42:32 -0000 1.40
+++ wininstall-guide.html 3 Feb 2005 13:13:05 -0000 1.41
@@ -95,7 +95,7 @@
<div class="menuItem">
-<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
</div>
<div class="menu">
@@ -214,7 +214,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/jp/">Japanese (Unofficial)</a>
</div>
</div>
@@ -341,7 +341,7 @@
<br>LoadModule axis_module modules/[Axis_Module]<br><Location /axis><br>SetHandler axis<br></Location><br>
<br> [Axis_Module] is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for apache 2.X.<br>
<br> 8. Copy [Axis_Module] from Axis_Extract/bin folder to [Apache_Folder]/modules folder.<br>
-<br> 9. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib<br>
+<br> 9. Copy AxisServer.dll,HTTPTransport.dll and HTTPChannel.dll from Axis_Extract/bin folder to [Axis_Folder]/lib<br>
<br> 10.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib</p>
<br>
<p></p>
@@ -354,10 +354,10 @@
</ul>
<p>
<strong>Note:</strong> This could also be done by editing the axiscpp.conf.<br> 11. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.<br>
-<br> LogPath:XXXX<br>WSDDFilePath:YYYY<br>XMLParser:ZZZZ<br>Transport_http:AAAA<br>
-<br> XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.ZZZZ is the path to the XMLParser and AAAA is the path to the Transport used.<br>
+<br> LogPath:XXXX<br>WSDDFilePath:YYYY<br>XMLParser:ZZZZ<br>Transport_http:AAAA<br>Channel_HTTP:BBBB<br>
+<br> XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.ZZZZ is the path to the XMLParser and AAAA is the path to the Transport used and BBBB is the path to the Channel used.<br>
<br> i.e.<br>
-<br> LogPath: [Apache_Folder]\Axis\logs\AxisLog<br>WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd<br>XMLParser:[Apache_Folder]\Axis\lib\AxisXMLParser.dll<br>Transport_http:[Apache_Folder]\Axis\lib\AxisTransport.dll<br>
+<br> LogPath: [Apache_Folder]\Axis\logs\AxisLog<br>WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd<br>XMLParser:[Apache_Folder]\Axis\lib\AxisXMLParser.dll<br>Transport_http:[Apache_Folder]\Axis\lib\HTTPTransport.dll<br>Channel_HTTP:[Apache_Folder]\Axis\lib\HTTPChannel.dll<br>
<br> server.wsdd is located at [Apache_Folder]\Axis\conf\ for Apache 1.3 and Apache 2. (There will be three wsdd files in the [Apache_Folder]\Axis\conf\ rename the relevant wsdd file of your platform to server.wsdd).<br>
<br> Also in order to run the provided samples do the following.<br>
<br>Open server.wsdd for editing. For each service element, locate the element "parameter name", which has the value "classname".<br>Give the absolute path of the indicated webservice.dll in the "value" attribute<br>
@@ -394,17 +394,17 @@
<br>5. Set environment variable AXISCPP_DEPLOY to point to above [Axis_Folder].<br>
<br>6. Add [Axis_Folder]/lib to the PATH environment variable.<br>
<br>7. Copy the SimpleAxisServer.exe from Axis_Extract/bin to the Simple_Axis_Server_Folder.<br>
-<br>8. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib<br>
+<br>8. Copy AxisServer.dll,HTTPTransport.dll and HTTPChannel.dll from Axis_Extract/bin folder to [Axis_Folder]/lib<br>
<br> 9.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib<br>
<br>10.Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.<br>
<br>
</p>
<p>
<strong>Note:</strong> This could also be done by editing the axiscpp.conf.<br> 10. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.<br>
-<br> LogPath:XXXX<br>WSDDFilePath:YYYY<br>XMLParser:ZZZZ<br>Transport_http:AAAA<br>
-<br> XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.ZZZZ is the path to the XMLParser and AAAA is the path to the used Transport.<br>
+<br> LogPath:XXXX<br>WSDDFilePath:YYYY<br>XMLParser:ZZZZ<br>Transport_http:AAAA<br>Channel_HTTP:BBBB<br>
+<br> XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file. Give the appropriate values for XXXX and YYYY as follows.ZZZZ is the path to the XMLParser and AAAA is the path to the used Transport and BBBB is the path to the Channel used.<br>
<br> i.e.<br>
-<br> LogPath: [Apache_Folder]\Axis\logs\AxisLog<br>WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd<br>XMLParser:[Axis_Folder]\lib\AxisXMLParser.dll<br>Transport_http:[Axis_Folder]\lib\AxisTransport.dll<br>
+<br> LogPath: [Apache_Folder]\Axis\logs\AxisLog<br>WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd<br>XMLParser:[Axis_Folder]\lib\AxisXMLParser.dll<br>Transport_http:[Apache_Folder]\Axis\lib\HTTPTransport.dll<br>Channel_HTTP:[Apache_Folder]\Axis\lib\HTTPChannel.dll<br>
<br> Rename axiscpp.conf_win to axiscpp.conf.<br>
<br> 11. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)<br>
<br>
1.35 +14 -13 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.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- windev-guide.html 3 Feb 2005 06:42:32 -0000 1.34
+++ windev-guide.html 3 Feb 2005 13:13:05 -0000 1.35
@@ -95,7 +95,7 @@
<div class="menuItem">
-<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
</div>
<div class="menu">
@@ -214,7 +214,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/jp/">Japanese (Unofficial)</a>
</div>
</div>
@@ -423,9 +423,9 @@
<br>(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. </p>
<br>
<p>
-<strong>Axis Transport Library</strong>
+<strong>Axis HTTPTransport Library and Axis HTTPChannel Library</strong>
</p>
-<p>In VC++ distribution workspace build AxisTransport project.Then AxisTransport.dll will be built.</p>
+<p>In VC++ Axis3 workspace build AxisHTTPTransport project and in HTTPChannel workspace build AxisHTTPChannel project.Then HTTPTransport.dll and HTTPChannel.dll will be built.</p>
<br>
<p>
<strong>Xerces Parser Library</strong>
@@ -433,8 +433,8 @@
<p>In VC++ distribution workspace build AxisXMLParserXerces project.Then AxisXMLParser.dll will be built.</p>
<br>
<p>
-<strong>Building AxisTransport.dll and AxisXMLParser.dll</strong>
-<br>Build the AxisTransport and AxisXMLParser project. Which will build the AxisTransport.dll and AxisXMLParser.dll in [Checkout_Folder]\c\bin.</p>
+<strong>Building HTTPTransport.dll,HTTPChannel.dll and AxisXMLParser.dll</strong>
+<br>Build the AxisHTTPTransport project AxisHTTPChannel project, and AxisXMLParser project. Which will build the HTTPTransport.dll ,HTTPChannel.dll and AxisXMLParser.dll in [Checkout_Folder]\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>
@@ -448,18 +448,19 @@
<br>2) Set an environment variable named AXISCPP_DEPLOY and give [Apache_Folder]\Axis as the value.<br>
<br>i)You will find AxisServer.dll and Apache_Module in [Checkout_Folder]\c\bin directory.<br>ii)Copy Apache_Module to [Apache_Folder]\modules directory of your apache installation.<br>
</p>
-<p>Copy AxisServer.dll ,AxisTransport.dll and AxisXMLParser.dll to [AXISCPP_DEPLOY]\lib\ directory and add that directory to your PATH environment variable.Or to any location specified by your PATH environment variable.</p>
+<p>Copy AxisServer.dll ,HTTPTransport.dll,HTTPChannel.dll and AxisXMLParser.dll to [AXISCPP_DEPLOY]\lib\ directory and add that directory to your PATH environment variable.Or to any location specified by your PATH environment variable.</p>
<br>
<br>
<p>3) Set the "PATH" environment variable to the following directories.<br>[Apache_Folder]<br>[Apache_Folder]\Axis\lib<br>
<br> 4) Include the following lines at the bottom of the apache configuration file [Apache_Folder]\conf\httpd.conf<br>
<br>LoadModule axis_module modules/Apache_Module<br><Location /axis><br>SetHandler axis<br></Location><br>
<br>5) Create a file in [Apache_Folder]\Axis named "axiscpp.conf" which should contain the following lines.<br>
-<br>LogPath:XXXX<br>WSDDFilePath:YYYY<br>Transport_http:ZZZZ (Not necessary)<br>XMLParser:WWWW<br>
-<br>XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file.ZZZZ is the path to AxisTransport.dll if it's a HTTP(if the selected transport is SMTP then should give that path.)WWWW is the path to AxisXMLParser.dll<br>
-<br>i.e.<br>LogPath:[Apache_Folder]\Axis\logs\AxisLog.log<br>WSDDFilePath:[Apache_Folder]\Axis\conf\server.wsdd<br>Transport_http:[Apache_Folder]\Axis\lib\AxisTransport.dll<br>XMLParser:[Apache_Folder]\Axis\lib\AxisXMLParser.dll</p>
+<br>LogPath:XXXX<br>WSDDFilePath:YYYY<br>XMLParser:ZZZZ<br>Transport_http:AAAA<br>Channel_HTTP:BBBB<br>
+<br>XXXX is the path to a file named AxisLog (The log file)and YYYY is the path to the server.wsdd file.ZZZZ is the path to AxisTransport.dll if it's a HTTP(if the selected transport is SMTP then should give that path.)WWWW is the path to AxisXMLParser.dll. AAAA is the path to the used Transport and BBBB is the path to the Channel used<br>
+<br>i.e.<br>LogPath:[Apache_Folder]\Axis\logs\AxisLog.log<br>WSDDFilePath:[Apache_Folder]\Axis\conf\server.wsdd<br>Transport_http:[Apache_Folder]\Axis\lib\HTTPTransport.dll<br>Channel_HTTP:[Apache_Folder]\Axis\lib\HTTPChannel.dll<br>
+<br>XMLParser:[Apache_Folder]\Axis\lib\AxisXMLParser.dll</p>
<p>
-<strong>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.</strong>
+<strong>Note:If the HTTPTransport.dll, HTTPChannel.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.</strong>
</p>
<br>
<br>
@@ -606,7 +607,7 @@
<br>8) Right click on the project that you created (i.e. ws1) and click “Add Files to Project…” on the menu that appears.Then Add the generated .cpp and .h files from the [Skelstub_Folder]\ClientOut to the project and click “OK”.<br>
<br>9) Right click on the project (i.e. calclient) 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 [Checkout_Folder]c\include as the include path.<br>
</p>
-<p>10) Click the “Link” tab and select “Input” from the “Category” Drop down list.<br>Add AxisClient.lib to the “Object/library modules” and in the “Additional library path” give the path. AxisClient.lib can be found in [Checkout_Folder]\c\bin once you build the AxisClient,AxisTransport,AxisXMLParserXerces projects of the "Distribution" VC workspace.<br>
+<p>10) Click the “Link” tab and select “Input” from the “Category” Drop down list.<br>Add AxisClient.lib to the “Object/library modules” and in the “Additional library path” give the path. AxisClient.lib can be found in [Checkout_Folder]\c\bin once you build the AxisClient and AxisXMLParserXerces projects of the "Distribution" VC workspace and build AxisHTTPTransport project and AxisHTTPChannel project in VC++ Axis3 workspace and HTTPChannel workspace.<br>
<br> </p>
<p>Now the client should be coded. Basically this will be a main method. We will write the main method in the file Calculator.cpp of the VC project "calclient". This is the stub generated by the java tool in the stub generation step.<br>
<br>Add the following main method to Calculator.cpp<br>
@@ -618,7 +619,7 @@
printf("The result is : %d", result);
}</pre>
<br>
-<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>It is better to have the path to your AxisXMLParser.dll , HTTPTransport.dll and HTTPChannel.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>
<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>4. Call next() method multiple times.<br>5. getStatus() to see if the streams are properly passed.<br>6. Destroy parser object by DestroyInstance().<br>
</p>
1.31 +74 -74 ws-site/targets/axis/cpp/lininstall-guide.pdf
<<Binary file>>
1.36 +6 -4 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.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- lininstall-guide.html 3 Feb 2005 06:42:32 -0000 1.35
+++ lininstall-guide.html 3 Feb 2005 13:13:05 -0000 1.36
@@ -95,7 +95,7 @@
<div class="menuItem">
-<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
</div>
<div class="menu">
@@ -367,7 +367,7 @@
<strong>cd $AXISCPP_HOME</strong>
<br>
<br>
-<strong>./configure --prefix=$AXISCPP_DEPLOY --with-apache2=/path/to/Apache2 \ --with-xercesc=/path/to/xerces-c</strong>
+<strong>./configure --prefix=$AXISCPP_DEPLOY --with-apache2=/path/to/Apache2 \ --with-xercesc=/path/to/xerces-c --enable-axis3=yes</strong>
<br>
<strong>make</strong>
<br>
@@ -411,14 +411,16 @@
<br> Configuration file has the following <strong>Syntax:</strong>
</p>
<br>
-<p>The comment character is '#'<br>WSDDFilePath - Path to the server wsdd file<br>ClientWSDDFilePath - Path to the client wsdd<br>LogPath - Path to the Axis C++ server log<br> ClientLogPath - Path to the Axis C++ client log<br>Transport_http - HTTP transport library<br>XMLParser - XML parser library</p>
+<p>The comment character is '#'<br>WSDDFilePath - Path to the server wsdd file<br>ClientWSDDFilePath - Path to the client wsdd<br>LogPath - Path to the Axis C++ server log<br> ClientLogPath - Path to the Axis C++ client log<br>Transport_http - HTTP transport library<br>Channel_HTTP - Channel transport library<br>XMLParser - XML parser library</p>
<br>
<p>A sample <strong>axiscpp.conf</strong> file:</p>
<pre>LogPath:/usr/local/axiscpp_deploy/log/AxisLog
WSDDFilePath:/usr/local/axiscpp_deploy/etc/server.wsdd
ClientLogPath:/usr/local/axiscpp_deploy/log/AxisClientLog
XMLParser:/usr/local/axiscpp_deploy/lib/libaxis_xercesc.so
-Transport_http:/usr/local/axiscpp_deploy/lib/libaxis2_transport.so
+Transport_http:/usr/local/axiscpp_deploy/lib/libaxis3_transport.so
+Channel_HTTP:/usr/local/axiscpp_deploy/lib/libaxis3_transport_channel.so
+
</pre>
<div class="h4">
<h4>9. Deploying with Apache Web Server</h4>