You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by ra...@apache.org on 2004/12/16 15:03:51 UTC
cvs commit: ws-axis/c/docs winuser-guide.pdf winuser-guide.html linuser-guide.pdf linuser-guide.html lininstall-guide.pdf lininstall-guide.html
rangika 2004/12/16 06:03:51
Modified: c/docs Tag: release1-4-final-branch winuser-guide.pdf
winuser-guide.html linuser-guide.pdf
linuser-guide.html lininstall-guide.pdf
lininstall-guide.html
Log:
Added ssl client details, session header details and IPV6 transport details to the docs.
Revision Changes Path
No revision
No revision
1.5.2.1 +371 -196 ws-axis/c/docs/winuser-guide.pdf
<<Binary file>>
1.6.2.1 +104 -7 ws-axis/c/docs/winuser-guide.html
Index: winuser-guide.html
===================================================================
RCS file: /home/cvs/ws-axis/c/docs/winuser-guide.html,v
retrieving revision 1.6
retrieving revision 1.6.2.1
diff -u -r1.6 -r1.6.2.1
--- winuser-guide.html 8 Dec 2004 11:07:50 -0000 1.6
+++ winuser-guide.html 16 Dec 2004 14:03:51 -0000 1.6.2.1
@@ -24,19 +24,24 @@
<a href="#transport">Axis Transport and Parser Library</a><br>
-<a href="#handlers">Handlers</a><br><br>
-</p>
-<p>
+<a href="#handlers">Handlers</a><br>
+
+<a href="#ssl">SSL Client</a><br>
+
+<a href="#session">Session Headers</a><br>
+
+<a href="#IPV6"> IPV6</a> <br> <br> <br>
+
<b>Before you follow this guide, please make sure that you have followed the</b> <a
-href="wininstall-guide.html"><b>Windows Installation guide</b> </a>
+href="wininstall-guide.html"><b>Windows Installation guide</b>
</p>
+
<p><b>Note:</b>The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.4 release. Please ignore any references to the Expat parser
in the documentation. The documentation will be updated regarding this later.
</p>
-
<p>
-
+</a>
<b>Definitions:</b> <br>
Axis_Extract -> The folder to which the Axis c++ binary distribution is extracted <br>
[Axis_Folder] -> The deploy folder of the binary distribution which is copied to the apache installation
@@ -410,8 +415,100 @@
a. echoStringHeaderHandler (Axis_Extract/samples/server/echoStringHeaderHandler)
<br>
b. testHandler
-(Axis_Extract/samples/client/testHandler)
+(Axis_Extract/samples/client/testHandler)</p>
+<p>
+<a name="ssl"> </a> </p>
+<h2>SSL Client</h2>
+<p>
+This section describes how to use an Axis C++ SSL secure client to access web services hosted on a secure web service. <br> <br>
+The SSL implementation for the client in Axis C++ uses the openssl opensource library. <br> <br>
+To aid to compile the secure channel dll <br> <br>
+1. Install the openssl 0.9.7e binary distribution. <br>
+2. Copy the include files from the openssl installation to c\include\openssl in your distribution<br>
+3. Copy libs found in \lib\VC of the openssl installation to c\lib\openssl <br> <br>
+
+Now use the vc project in c\vc\transport\Axis2\Axis2SSLChannel to compile the Secure channel dll. <br> <br>
+
+Paste this dll where the Axis C++ client can load it (i.e %PATH%) OR specify the path to it in the axiscpp.conf
+under the key "Channel_ssl" (e.g Channel_ssl:c:\Axis2SSLChannel.dll) <br> <br>
+
+Now when you run any client using a url of the form https://...... the client will use SSL to connect to the relevant secure service specified by the url. The client request must be directed at a "secure webserver" which has the relevant
+web service hosted.</p>
+
+<br> <br>
+
+<p><a name="session"> </a></p>
+<h2>Session Headers</h2>
+<p>The following text explains how to deploy and run the SOAP Header based sample client with Axis Java web service <br> <br>
+<b>Deploying the Web Service</b> <br> <br> </p>
+<p>c\samples\server\session\headers folder contains the sources (inside the counters folder, which is the package of these classes) needed to build the Axis java service needed to run the soap header based session client
+(These server side skeletons were generated from the Counter.wsdl) <br> <br>
+
+
+Compile these java source files and deploy them in Axis java (visit http://ws.apache.org/axis/java/index.html on how to
+achieve this) <br> <br>
+
+
+Put the following element in the <globalConfiguration> section in the server-config.wsdd to enable SOAP header based
+session handling for Axis Java <br> <br>
+<b><handler name="session" type="java:org.apache.axis.handlers.SimpleSessionHandler"/> </b> <br> <br>
+
+The following should be put in the server-config.wsdd of Axis java for this service to behave as having session scope <br> <br>
+
+<service name="CounterService" provider="java:RPC"> <br>
+<parameter name="scope" value="session"/><br>
+<requestFlow> <br>
+<handler type="session"/><br>
+</requestFlow> <br>
+<responseFlow> <br>
+<handler type="session"/> <br>
+</responseFlow> <br>
+ <parameter name="allowedMethods" value="*"/> <br>
+ <parameter name="className" value="counters.CounterSoapBindingImpl"/> <br>
+ <namespace>http://xml.apache.org/axis/wsdd/</namespace> <br>
+</service> <br> <br> </p>
+
+<p>
+Since Axis c++ doesn't support multiref yet, Axis java multiref should be disabled by putting the element <br> <br>
+<parameter name="sendMultiRefs" value="false"/> <br>
+under <globalConfiguration> <br> <br>
+
+Start Axis java (visit http://ws.apache.org/axis/java/index.html on how to achieve this)<br> <br>
+
+Generating the client stubs and building the client and running the client. <br> <br> </p>
+
+<p>Use the vc workspace \c\vc\samples\client\session\Headers\Headers.dsw to compile the client side handler for this sample <br> <br>
+
+Run the command java org.apache.axis.wsdl.wsdl2ws.WSDL2Ws ../Counter.wsdl -o./gen_src -lc++ -sclient
+from within c\samples\client\session\headers\sessionclient to generate the client stubs <br> <br>
+
+Compile the client application using the vc workspace at <br>
+\c\vc\samples\client\session\Headers\Headers.dsw <br> <br>
+
+Host the service in Axis java (Check c/samples/server/session/headers/readme.txt on how to do this). <br> <br>
+
+Configure the client to use the provided client.wsdd from axiscpp.conf (make appropriate changes if necessary
+in the client.wsdd to the absolute path of the handler )<br> <br>
+
+Run the tcpMonitor and configure it to check the conversation between the client and server <br> <br>
+
+Run the client in the following fashion <br> <br>
+sessionClient count 1 http://localhost:8080/axis/services/CounterService <br> <br>
+
+
+Inspect the SOAP messages in tcpMonitor to see the values returned by the server incremented by 1 each
+time (as done throught the client). Counting starts at the value 97, which is set at the server side web service. <br>
+</p>
+
+<br>
+<p><a name="IPV6"> </a></p>
+<h2>IPV6</h2>
+<p>The source is in src/transport/axis2/ipv6/ </p> <br>
+<p>We need the 2 additional headers that comes with the IPv6Kit. <br> <br>
+Can be downloaded from <a href="http://msdn.microsoft.com/downloads/sdks/platform/tpipv6.asp">http://msdn.microsoft.com/downloads/sdks/platform/tpipv6.asp </a> <br> <br>
+Extract the package and copy the tpipv6.h and wspiapi.h headers in inc folder to $AXISCPP_HOME/include. <br> <br>
+ That would compile the axis2ipv6 VC++ project.
<div id="pdf" align="right">
<a href="winuser-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
1.1.2.2 +215 -173 ws-axis/c/docs/linuser-guide.pdf
<<Binary file>>
1.4.4.3 +74 -0 ws-axis/c/docs/linuser-guide.html
Index: linuser-guide.html
===================================================================
RCS file: /home/cvs/ws-axis/c/docs/linuser-guide.html,v
retrieving revision 1.4.4.2
retrieving revision 1.4.4.3
diff -u -r1.4.4.2 -r1.4.4.3
--- linuser-guide.html 16 Dec 2004 12:12:10 -0000 1.4.4.2
+++ linuser-guide.html 16 Dec 2004 14:03:51 -0000 1.4.4.3
@@ -12,6 +12,8 @@
</div>
<dl>
<dt>
+
+<br>
<a href="#Introducti">Introduction </a>
</dt>
<dt>
@@ -49,6 +51,9 @@
</dd>
<dd>
<a href="#ssl">SSL Client</a>
+</dd>
+<dd>
+<a href="#session">Session Headers</a>
<br>
</dd>
<dd>
@@ -536,6 +541,8 @@
</p>
<br>
+<br>
+
<p><a name="ssl"></a> </p>
<h3>SSL Client </h3>
<p>To build the ssl channel library configure with <br>
@@ -549,6 +556,73 @@
Currently I use openssl libraries for ssh tunnelling. <br> <br>
The API to write a new ssl channel library(using a library other than openssl) is in <b>src/transport/SSLChannel.hpp </b> <br> <br>
All openssl ssl related implementations are in <b>src/transport/axis2/ssl folder</b>
+
+<br> <br>
+
+<p><a name="session"></a> </p>
+<h3>Session Headers</h3>
+<p>The following text explains how to deploy and run the SOAP Header based sample client with Axis Java web service <br> <br>
+<b>Deploying the Web Service</b> <br> <br> </p>
+<p>c\samples\server\session\headers folder contains the sources (inside the counters folder, which is the package of these classes) needed to build the Axis java service needed to run the soap header based session client
+(These server side skeletons were generated from the Counter.wsdl) <br> <br>
+
+
+Compile these java source files and deploy them in Axis java (visit http://ws.apache.org/axis/java/index.html on how to
+achieve this) <br> <br>
+
+
+Put the following element in the <globalConfiguration> section in the server-config.wsdd to enable SOAP header based
+session handling for Axis Java <br> <br>
+<b><handler name="session" type="java:org.apache.axis.handlers.SimpleSessionHandler"/> </b> <br> <br>
+
+The following should be put in the server-config.wsdd of Axis java for this service to behave as having session scope <br> <br>
+
+<service name="CounterService" provider="java:RPC"> <br>
+<parameter name="scope" value="session"/><br>
+<requestFlow> <br>
+<handler type="session"/><br>
+</requestFlow> <br>
+<responseFlow> <br>
+<handler type="session"/> <br>
+</responseFlow> <br>
+ <parameter name="allowedMethods" value="*"/> <br>
+ <parameter name="className" value="counters.CounterSoapBindingImpl"/> <br>
+ <namespace>http://xml.apache.org/axis/wsdd/</namespace> <br>
+</service> <br> <br> </p>
+
+<p>
+Since Axis c++ doesn't support multiref yet, Axis java multiref should be disabled by putting the element <br> <br>
+<parameter name="sendMultiRefs" value="false"/> <br>
+under <globalConfiguration> <br> <br>
+
+Start Axis java (visit http://ws.apache.org/axis/java/index.html on how to achieve this)<br> <br>
+
+Generating the client stubs and building the client and running the client. <br> <br> </p>
+
+<p>Compile the sessionhandler using the sources in c\samples\client\session\headers\sessionhandler <br> <br>
+Run the command java org.apache.axis.wsdl.wsdl2ws.WSDL2Ws ../Counter.wsdl -o./gen_src -lc++ -sclient
+from within c\samples\client\session\headers\sessionclient to generate the client stubs <br> <br>
+
+Compile the client application using the following command from within c\samples\client\session\headers\sessionclient <br> <br>
+
+g++ CounterClient.cpp gen_src/*.cpp -Igen_src <br>
+I$AXISCPP_HOME/include -L$AXISCPP_DEPLOY/lib -ldl <br>
+laxiscpp_client -oclient <br> <br>
+
+Host the service in Axis java (Check c/samples/server/session/headers/readme.txt on how to do this). <br> <br>
+
+Configure the client to use the provided client.wsdd from axiscpp.conf (make appropriate changes if necessary
+in the client.wsdd to the absolute path of the handler )<br> <br>
+
+Run the tcpMonitor and configure it to check the conversation between the client and server <br> <br>
+
+Run the client in the following fashion <br> <br>
+sessionClient count 1 http://localhost:8080/axis/services/CounterService <br> <br>
+
+
+Inspect the SOAP messages in tcpMonitor to see the values returned by the server incremented by 1 each
+time (as done throught the client). Counting starts at the value 97, which is set at the server side web service. <br>
+</p>
<br>
<div id="pdf" align="right">
1.2.4.1 +63 -288 ws-axis/c/docs/lininstall-guide.pdf
<<Binary file>>
1.6.4.2 +9 -317 ws-axis/c/docs/lininstall-guide.html
Index: lininstall-guide.html
===================================================================
RCS file: /home/cvs/ws-axis/c/docs/lininstall-guide.html,v
retrieving revision 1.6.4.1
retrieving revision 1.6.4.2
diff -u -r1.6.4.1 -r1.6.4.2
--- lininstall-guide.html 16 Dec 2004 12:24:52 -0000 1.6.4.1
+++ lininstall-guide.html 16 Dec 2004 14:03:51 -0000 1.6.4.2
@@ -1,287 +1,16 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
-<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<!--*** This is a generated file. Do not edit. ***-->
-<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
-<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++ Linux Installation Guide</title>
+ <meta http-equiv="Content-Type" content="text/html">
+ <title>Axis C++ Linux Installation Guide</title>
</head>
-<body bgcolor="white" class="composite">
-<!--================= start Banner ==================-->
-<div id="banner">
-<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
-<tbody>
-<tr>
-<!--================= start Group Logo ==================-->
-<td align="left">
-<div class="groupLogo">
-<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
-</div>
-</td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td align="right">
-<div class="projectLogo">
-<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
-</div>
-</td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
-<form target="_blank" action="http://www.google.com/search" method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
-<br>
- Search WS</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
-</tr>
-<tr>
-<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= end Search ==================-->
-</tr>
-</tbody>
-</table>
-</div>
-<!--================= end Banner ==================-->
-<!--================= start Main ==================-->
-<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
-<tbody>
-<!--================= start Status ==================-->
-<tr class="status">
-<td>
-<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
-<!--================= end BreadCrumb ==================--></td><td id="tabs">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
-</div>
-<!--================= end Tabs ==================-->
-</td>
-</tr>
-</tbody>
-</table>
-<!--================= end Status ==================-->
-<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
-<tbody>
-<tr valign="top">
-<!--================= start Menu ==================-->
-<td id="leftcol">
-<div id="navcolumn">
-<div class="menuBar">
-<div class="menu">
-<span class="menuLabel">Axis</span>
-
-<div class="menuItem">
-<a href="../index.html">Introduction</a>
-</div>
-
-<div class="menuItem">
-<a href="../news.html">News</a>
-</div>
-
-
-<div class="menuItem">
-<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
-</div>
-
-<div class="menu">
-<span class="menuLabel">Get Involved</span>
-
-<div class="menuItem">
-<a href="../overview.html">Overview</a>
-</div>
-
-<div class="menuItem">
-<a href="../cvs.html">CVS Repository</a>
-</div>
-
-<div class="menuItem">
-<a href="../mail.html">Mailing Lists</a>
-</div>
-
-<div class="menuItem">
-<a href="../ref.html">Reference Library</a>
-</div>
-
-<div class="menuItem">
-<a href="../bugs.html">Bugs</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Axis (Java)</span>
-
-<div class="menuItem">
-<a href="../java/index.html">Documentation</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/install.html">Installation</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/user-guide.html">User's Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/developers-guide.html">Developer's Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/integration-guide.html">Integration Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/architecture-guide.html">Architecture Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/reference.html">Reference Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/reading.html">Reading Guide</a>
-</div>
-
-<div class="menuItem">
-<a href="../java/requirements.html">Requirements</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Axis (C++)</span>
-
-<div class="menuItem">
-<a href="../cpp/index.html">Latest Axis C++ Release!</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/documentation.html">Documentation</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/download.html">Download</a>
-</div>
-
-<div class="menuItem">
-<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisCPPProjectPages">Wiki Pages</a>
-</div>
-
-<div class="menuItem">
-<a href="../cpp/who.html">Who we are</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Downloads</span>
-
-<div class="menuItem">
-<a href="../releases.html">Releases</a>
-</div>
-
-<div class="menuItem">
-<a href="../interim.html">Interim Drops</a>
-</div>
-
-<div class="menuItem">
-<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Translation</span>
-
-<div class="menuItem">
-<a href="http://ws.apache.org/~toshi/jp-site/axis/index.html">Japanese (Unofficial)</a>
-</div>
-</div>
-
-<div class="menu">
-<span class="menuLabel">Related Projects</span>
-
-<div class="menuItem">
-<a href="http://ws.apache.org/wsif/">WSIF</a>
-</div>
-
-<div class="menuItem">
-<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
-</div>
-
-<div class="menuItem">
-<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
-</div>
-
-<div class="menuItem">
-<a href="http://www.uddi4j.org/">UDDI4J</a>
-</div>
-
-</div>
-
-<div class="menu">
-<span class="menuLabel">Misc</span>
-
-<div class="menuItem">
-<a href="../site.html">Whole Site</a>
-</div>
-
-<div class="menuItem">
-<a href="../who.html">Who We Are</a>
-</div>
-
-<div class="menuItem">
-<a href="../contact.html">Contact</a>
-</div>
-
-<div class="menuItem">
-<a href="../legal.html">Legal</a>
-</div>
+<body>
+<h1>Axis C++ Linux Installation Guide</h1>
-
-<div class="menuItem">
-<a href="../docs.html">Notes/Docs</a>
-</div>
+<p><strong>Contents</strong></p>
-</div>
-</div>
-</div>
-</div>
-</td>
-<!--================= end Menu ==================-->
-<!--================= start Content ==================--><td>
-<div id="bodycol">
-<div class="app">
-<div align="center">
-<h1>Axis C++ Linux Installation Guide</h1>
-</div>
-<div class="h3">
-<div class="h3">
-<h3>Axis C++ Linux Installation Guide</h3>
-</div>
-<p>
-<strong>Contents</strong>
-</p>
-<ul>
<li>
<a href="#Introducti">Introduction</a>
</li>
@@ -467,49 +196,12 @@
<p>
<strong>./base http://localhost:9090/axis/base</strong>
</p>
-<p>Similarly you could run the other samples.</p>
+<p>Similarly you could run the other samples.
+
<div id="pdf" align="right">
<a href="lininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
-</div>
-</div>
-</div>
-</div>
-</td>
-<!--================= end Content ==================-->
-</tr>
-</tbody>
-</table>
-<!--================= end Main ==================-->
-<!--================= start Footer ==================-->
-<div id="footer">
-<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
-<tbody>
-<tr>
-<!--================= start Copyright ==================-->
-<td colspan="2">
-<div align="center">
-<div class="copyright">
- Copyright © 2000-2004 The Apache Software Foundation. All rights reserved.
- </div>
-</div>
-</td>
-<!--================= end Copyright ==================-->
-</tr>
-<tr>
-<td align="left">
-<!--================= start Host ==================-->
-<!--================= end Host ==================--></td><td align="right">
-<!--================= start Credits ==================-->
-<div align="right">
-<div class="credit"></div>
-</div>
-<!--================= end Credits ==================-->
-</td>
-</tr>
-</tbody>
-</table>
-</div>
-<!--================= end Footer ==================-->
+
+</p>
</body>
</html>