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>