Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 17873 invoked by uid 99); 3 Feb 2005 06:42:37 -0000 X-ASF-Spam-Status: No, hits=-9.2 required=10.0 tests=ALL_TRUSTED,HOT_NASTY,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from minotaur.apache.org (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.28) with SMTP; Wed, 02 Feb 2005 22:42:34 -0800 Received: (qmail 19846 invoked by uid 1968); 3 Feb 2005 06:42:33 -0000 Date: 3 Feb 2005 06:42:33 -0000 Message-ID: <20050203064233.19845.qmail@minotaur.apache.org> From: rangika@apache.org To: ws-axis-cvs@apache.org Subject: cvs commit: ws-axis/c/docs lininstall-guide.html lininstall-guide.pdf linuser-guide.html linuser-guide.pdf windev-guide.html wininstall-guide.html winuser-guide.html winuser-guide.pdf X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N rangika 2005/02/02 22:42:33 Modified: site/src/documentation/content/xdocs/cpp winuser-guide.ihtml wininstall-guide.ihtml windev-guide.ihtml linuser-guide.ihtml lininstall-guide.ihtml targets/axis/cpp lininstall-guide.html lininstall-guide.pdf linuser-guide.html linuser-guide.pdf windev-guide.html wininstall-guide.html winuser-guide.html winuser-guide.pdf c/docs lininstall-guide.html lininstall-guide.pdf linuser-guide.html linuser-guide.pdf windev-guide.html wininstall-guide.html winuser-guide.html winuser-guide.pdf Log: Removed the references about expat from the documentation Revision Changes Path 1.25 +3 -10 ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml Index: winuser-guide.ihtml =================================================================== RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml,v retrieving revision 1.24 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- winuser-guide.ihtml 16 Dec 2004 13:55:15 -0000 1.24 +++ winuser-guide.ihtml 3 Feb 2005 06:42:31 -0000 1.25 @@ -37,8 +37,7 @@

Note: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. +

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -298,15 +297,9 @@

Transport Library and Parser Library

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the Note at the top of the page. -

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.

Rename either AxisXMLParser_Expat.dll or AxisXMLParser_Xerces.dll to AxisXMLParser.dll (depending on the parser you use), - 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. -
-If you want to use Expat parser then libexpat.dll should be given in the path. -
-If you want to use the Xerces parser then xerces-c_2_2_0.dll should be given in the path. +

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. +
xerces-c_2_2_0.dll should be given in the path.

1.32 +15 -31 ws-axis/site/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml Index: wininstall-guide.ihtml =================================================================== RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/wininstall-guide.ihtml,v retrieving revision 1.31 retrieving revision 1.32 diff -u -r1.31 -r1.32 --- wininstall-guide.ihtml 8 Dec 2004 10:34:43 -0000 1.31 +++ wininstall-guide.ihtml 3 Feb 2005 06:42:31 -0000 1.32 @@ -25,12 +25,10 @@
6. Writing your web services and client applications using Axis C++.
-7. Installing the Expat Parser
-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

-8. Installing the Xerces Parser
@@ -70,18 +68,11 @@ 6. "samples" folder contains sources of all the server and client samples including interop tests.

Installing the Expat XML parser

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section. -

If you decide to use the Expat parser you need to install the Expat parser. Download the Expat-1.95.7 binary version from http://sourceforge.net/projects/expat/

-Extract the Expat binaries to a folder Called Expat ,we will refer to this folder as [Expat_Folder].

Installing the Xerces XML parser

If you decide to use the Xerces parser you need to install the Xerces parser. Download the Xerces-C 2.2.0 ( 32 bit binary release) from: +

Download the Xerces-C 2.2.0 ( 32 bit binary release) from: http://xml.apache.org/xerces-c/download.cgi

Extract the Xerces-C 2.2.0 binary version. We will refer to this folder as [Xerces_Folder].

@@ -125,18 +116,14 @@ 9. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib

-10.If you want to use the Expat parser with Axis C++, rename AxisXMLParser_Expat.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib
-Note:The Expat XML Parser module is not currently maintained and also contains some bugs.For more information refer the contents section. -

- -11.If you want to use the Xerces parser with Axis C++, rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

+10.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

Copy libexpat.dll file from [Expat_Folder]\Libs to [Axis_Folder]/lib/

Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin/ to [Axis_Folder]/lib/

Note: This could also be done by editing the axiscpp.conf.
-12. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

+11. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

LogPath:XXXX
WSDDFilePath:YYYY
@@ -159,7 +146,7 @@ Give the absolute path of the indicated webservice.dll in the "value" attribute

Rename axiscpp.conf_win which is in [Axis_Folder] to axiscpp.conf

-13. Restart the apache web server. If you have done correctly apache server will start without giving any error.

+12. Restart the apache web server. If you have done correctly apache server will start without giving any error.

apache 1.3.X :

@@ -178,7 +165,7 @@ It could happen with some other apache 2 versions or in different service packs. )

-14. Open an internet browser and check http://localhost/axis If the module has loaded properly then you will get the axis welcome page with a listing of deployed web services.

+13. Open an internet browser and check http://localhost/axis If the module has loaded properly then you will get the axis welcome page with a listing of deployed web services.

@@ -194,16 +181,13 @@ 6. Add [Axis_Folder]/lib to the PATH environment variable.

7. Copy the SimpleAxisServer.exe from Axis_Extract/bin to the Simple_Axis_Server_Folder.

8. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib

-9.If you want to use the Expat parser with Axis C++, rename AxisXMLParser_Expat.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib -
Note:The Expat XML Parser module is not currently maintained and also contains some bugs.For more information refer the contents section. -
-10.If you want to use the Xerces parser with Axis C++, rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

-11.If you are using Expat parser then copy libexpat.dll from [Expat_Folder]/Libs and paste it in [Axis_Folder]/lib.

-If you are using Xerces parser then copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.

+ +9.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

+10.Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.

Note: This could also be done by editing the axiscpp.conf.
-12. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

+10. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

LogPath:XXXX
WSDDFilePath:YYYY
@@ -223,7 +207,7 @@

-13. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)

+11. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)

Note:If SimpleAxisServer does not start then paste AxisClient.dll to the place where SimpleAxisServer.exe is.

@@ -231,7 +215,7 @@ Open server.wsdd for editing. server.wsdd is located at [Axis_Folder]\conf\ rename the wsdd file of your platform to server.wsdd. For each service element, locate the element "parameter name", which has the value "classname".
Give the absolute path of the indicated webservice.dll in the "value" attribute

-14. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will start without giving any error.
+12. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will start without giving any error.

@@ -253,7 +237,7 @@ In order to run these samples you should have AxisClient.dll in the PATH environment variable or in the same directory where the client .exe is located.

You can run the provided client programs to confirm whether the Axis cpp server and clients are working fine.

-To run these sample client applications you need to have the path to libexpat.dll in the "PATH" environment variable or libexpat.dll should be placed where the apache.exe is.(libexpat.dll can be found in [Expat_Folder]\libs)

+To run these sample client applications you need to have the path to xerces-c_2_2_0.dll in the "PATH" environment variable or xerces-c_2_2_0.dll should be placed where the apache.exe is.(xerces-c_2_2_0.dll can be found in [Xerces_Folder]\bin)

Note: These sample clients are compiled with the assumption that server is running at localhost port 80.

1.28 +16 -40 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.27 retrieving revision 1.28 diff -u -r1.27 -r1.28 --- windev-guide.ihtml 8 Dec 2004 10:34:43 -0000 1.27 +++ windev-guide.ihtml 3 Feb 2005 06:42:31 -0000 1.28 @@ -11,10 +11,10 @@ Getting a cvs checkout
-Getting necessary third party software +Getting necessary third party software
-Installing Apache and Expat +Installing Apache and Xerces
Setting up the build environment and building @@ -50,8 +50,7 @@

Before going through this guide, please go through the Windows User Guide and also be familiar with how to use binaries.

*Note: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. +

*Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -109,22 +108,15 @@ The checked out folder ws-axis will be referred to as [Checkout_Folder] from this point on.

Getting necessary third party software

Expat XML Parser

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page. -

- -

You can get expat binaries from the url http://sourceforge.net/projects/expat/ -
-This documentation was tested with the expat 1.95.7 which is -distributed as expat_win32bin_1_95_7.exe.

Xerces XML Parser

(Axis Cpp Developers can use either Xerces-c or the Expat XML Parsers to build the Axis Cpp. -The Source in CVS supports expat out of the box.)

Axis Cpp Developers can use Xerces-c XML Parser to build the Axis Cpp. +The Source in CVS supports Xerces out of the box.

Apache Web Server

@@ -134,9 +126,9 @@ Apache 2.0.44.

Installing Apache and Expat

Installing Apache and Xerces

Xerces

@@ -147,14 +139,6 @@
-

Expat

-
-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page. -

Run the file -expat_win32bin_1_95_7.exe . The folder to which Expat is unzipped will be -referred to as [Expat_Folder] from this point onwards.

Apache

@@ -171,14 +155,7 @@

Setting up the build environment and building Axis

For Expat Parser

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page. -

1) Copy [Expat_Folder]\source\lib\expat.h from expat binary distribution to [Checkout_Folder]\c\include\expat\ directory
-
-2) Copy [Expat_Folder]\lib\libexpat.lib to [Checkout_Folder]\c\lib\expat\ directory.

For Xerces Parser

1) Copy [Xerces_Folder]\lib\xerces-c_2.lib to [Checkout_Folder]\c\lib\xerces\ directory.

2) Copy [Xerces_Folder]\include\xercesc to [Checkout_Folder]\c\include\xerces\ directory.

@@ -240,12 +217,12 @@

Axis Transport Library

In VC++ distribution workspace build AxisTransport project.Then AxisTransport.dll will be built.

Xerces Parser Library and Expat Parser Library

In VC++ distribution workspace build either AxisXMLParserXerces project or AxisXMLParserExpat project. Then AxisXMLParser.dll will be built.

Xerces Parser Library

In VC++ distribution workspace build AxisXMLParserXerces project.Then AxisXMLParser.dll will be built.

Building AxisTransport.dll and AxisXMLParser.dll -
Build the AxisTransport and AxisXMLParser projects. Which will build the AxisTransport.dll and AxisXMLParser.dll in [Checkout_Folder]\c\bin.

+
Build the AxisTransport and AxisXMLParser project. Which will build the AxisTransport.dll and AxisXMLParser.dll in [Checkout_Folder]\c\bin.

(When the projects are built in Debug mode then the Dlls will appear as AxisTransport_D and AxisXMLParser_D.dll)

@@ -261,7 +238,7 @@

Axis
-|__ lib (Copy [Expat_Folder]\Libs\libexpat.dll or
[Xerces_Folder]\bin\xerces-c_2_2_0.dll and paste it inside)
+|__ lib (Copy [Xerces_Folder]\bin\xerces-c_2_2_0.dll and paste it inside)
|__ logs (log files are located here)
|__ conf (server.wsdd file is located here)
|__ webservices (The place to put webservice dlls)
@@ -331,7 +308,7 @@

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.

Note: Make sure that if you are using Expat that libexpat.dll ([Expat_Folder]\Libs\) file is pasted in %AXISCPP_DEPLOY%/lib/ and if you are using Xerces that xerces-c_2_2_0.dll ([Xerces_Folder]\bin) is pasted in %AXISCPP_DEPLOY%/lib/

Note:Make sure that xerces-c_2_2_0.dll ([Xerces_Folder]\bin) is pasted in %AXISCPP_DEPLOY%/lib/

6) Select start->programs->Apache HTTP server->Control Apache @@ -696,8 +673,7 @@
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 or AxisXMLParserExpat projects -of the "Distribution" VC workspace. +AxisClient.lib can be found in [Checkout_Folder]\c\bin once you build the AxisClient,AxisTransport,AxisXMLParserXerces projects of the "Distribution" VC workspace.

@@ -787,7 +763,7 @@

Note:Implement XMLParser.h interface according to the rules described in the header file.
-

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. +

When creating your own parser refer XMLParser.h header file for API. To see an example implementation refer SoapParserXerces.h and SoapParserXerces.cpp.

Axis loads the parser dynamic library through following export functions which you also have to implement.

CreateInstance() - Used by Axis to create an instance of your parser class
DestroyInstance() - Used by Axis to destroy the created parser class instance

1.21 +5 -1 ws-axis/site/src/documentation/content/xdocs/cpp/linuser-guide.ihtml Index: linuser-guide.ihtml =================================================================== RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/linuser-guide.ihtml,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- linuser-guide.ihtml 16 Dec 2004 13:55:15 -0000 1.20 +++ linuser-guide.ihtml 3 Feb 2005 06:42:31 -0000 1.21 @@ -93,6 +93,10 @@
+ +

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release. +

@@ -139,7 +143,7 @@

- Stability , Component oriented Deployment

- Transport Framework

- WSDL support

AxisC++ 1.1 supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++ 1.1. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to axis-user@xml.apache.org +

Axis C++ 1.1 supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++ 1.1. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to axis-user@xml.apache.org

1.26 +6 -14 ws-axis/site/src/documentation/content/xdocs/cpp/lininstall-guide.ihtml Index: lininstall-guide.ihtml =================================================================== RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/lininstall-guide.ihtml,v retrieving revision 1.25 retrieving revision 1.26 diff -u -r1.25 -r1.26 --- lininstall-guide.ihtml 20 Dec 2004 05:49:58 -0000 1.25 +++ lininstall-guide.ihtml 3 Feb 2005 06:42:31 -0000 1.26 @@ -22,8 +22,7 @@
-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -58,10 +57,8 @@
-

Expat (1.95.7) (Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.)

- -and/or

-Xerces C++ (2.2.0) XML parser(s)

+

+Xerces C++ (2.2.0) XML parser

Axis C++ needs an XML parser to parse SOAP messages and WSDD files. It has a parser abstraction layer that helps users to select/switch between @@ -83,11 +80,8 @@ 1.3.x use --enable-module=so; for Apache 2.0.x use --enable-so when configuring. See Apache web server documentation for more details)

2. Install Expat (1.95.7) and/or Xerces C++ (2.2.0)

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section. -

Select an XML parser depending on your parser preferences. See the respective parser's documentation for -installation instructions.

2. Install Xerces C++ (2.2.0)

See the Xerces parser's documentation for installation instructions.

3. Download Axis C++

@@ -230,9 +224,7 @@ To deploy with Apache 1.3.x

sh deploy_apache.sh
-

Note: please rename libaxis_xercesc.so (the default parser library) to libaxis_xmlparser.so.

if you need to use a different parser or want to switch parsers time to time, you need to edit the script and comment out the line: -

-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section. +

Note: please rename libaxis_xercesc.so (the default parser library) to libaxis_xmlparser.so.

1.35 +7 -16 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.34 retrieving revision 1.35 diff -u -r1.34 -r1.35 --- lininstall-guide.html 30 Dec 2004 03:05:31 -0000 1.34 +++ lininstall-guide.html 3 Feb 2005 06:42:32 -0000 1.35 @@ -214,7 +214,7 @@ Translation

-Japanese +Japanese (Unofficial)

@@ -299,7 +299,7 @@

-Note: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.

+Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -318,10 +318,8 @@
Axis C++ uses Apache web server to host services.

Expat (1.95.7) (Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.)
-
and/or
-
-Xerces C++ (2.2.0) XML parser(s)
+

+Xerces C++ (2.2.0) XML parser

Axis C++ needs an XML parser to parse SOAP messages and WSDD files. It has a parser abstraction layer that helps users to select/switch between parsers. However only one parser library could be used at a time. Currently Xerces parser is supported by Axis C++.

@@ -336,11 +334,9 @@

In case you have already installed Apache , make sure that 'so modules' are enabled.
This is because Axis C++ server engine is implemented as a 'so module'. (For Apache 1.3.x use --enable-module=so; for Apache 2.0.x use --enable-so when configuring. See Apache web server documentation for more details)

2. Install Expat (1.95.7) and/or Xerces C++ (2.2.0)

2. Install Xerces C++ (2.2.0)

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.

Select an XML parser depending on your parser preferences. See the respective parser's documentation for installation instructions.

See the Xerces parser's documentation for installation instructions.

3. Download Axis C++

@@ -442,12 +438,7 @@ sh deploy_apache.sh

-Note: please rename libaxis_xercesc.so (the default parser library) to libaxis_xmlparser.so.
-
if you need to use a different parser or want to switch parsers time to time, you need to edit the script and comment out the line:
-
-

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.

+Note: please rename libaxis_xercesc.so (the default parser library) to libaxis_xmlparser.so.

cp -f ${AXISCPP_DEPLOY}/lib/libaxis_xercesc.so ${AXISCPP_DEPLOY}/lib/libaxis_xmlparser.so

1.30 +238 -268 ws-site/targets/axis/cpp/lininstall-guide.pdf <> 1.29 +3 -1 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.28 retrieving revision 1.29 diff -u -r1.28 -r1.29 --- linuser-guide.html 30 Dec 2004 03:05:31 -0000 1.28 +++ linuser-guide.html 3 Feb 2005 06:42:32 -0000 1.29 @@ -365,6 +365,8 @@

+Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

Introduction

@@ -404,7 +406,7 @@

- Stability , Component oriented Deployment

- Transport Framework

- WSDL support

Axis C++ 1.1 supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++ 1.1. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to axis-user@xml.apache.org

1.25 +194 -188 ws-site/targets/axis/cpp/linuser-guide.pdf <> 1.34 +15 -36 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.33 retrieving revision 1.34 diff -u -r1.33 -r1.34 --- windev-guide.html 30 Dec 2004 03:05:31 -0000 1.33 +++ windev-guide.html 3 Feb 2005 06:42:32 -0000 1.34 @@ -286,9 +286,9 @@
Getting a cvs checkout
-Getting necessary third party software +Getting necessary third party software
-Installing Apache and Expat +Installing Apache and Xerces
Setting up the build environment and building Axis
@@ -320,7 +320,7 @@ Before going through this guide, please go through the Windows User Guide and also be familiar with how to use binaries.

-*Note: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.

+*Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -347,30 +347,25 @@
The checked out folder ws-axis will be referred to as [Checkout_Folder] from this point on.

- +

Getting necessary third party software

-Expat XML Parser +Xerces XML Parser

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page.

-
You can get expat binaries from the url http://sourceforge.net/projects/expat/
This documentation was tested with the expat 1.95.7 which is distributed as expat_win32bin_1_95_7.exe.
-

(Axis Cpp Developers can use either Xerces-c or the Expat XML Parsers to build the Axis Cpp. The Source in CVS supports expat out of the box.)

Axis Cpp Developers can use Xerces-c XML Parser to build the Axis Cpp. The Source in CVS supports Xerces out of the box.

Apache Web Server

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.

- +

Installing Apache and Expat

Installing Apache and Xerces

@@ -379,13 +374,6 @@

Run the file xerces-c2_2_0-win32.The folder to which Xerces is unzipped will be referred to as [Xerces_Folder] from this point onwards.

-Expat -

-
-

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page.

Run the file expat_win32bin_1_95_7.exe . The folder to which Expat is unzipped will be referred to as [Expat_Folder] from this point onwards.

Apache @@ -403,15 +391,6 @@

-For Expat Parser -

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the *Note:at the top of the page.

1) Copy [Expat_Folder]\source\lib\expat.h from expat binary distribution to [Checkout_Folder]\c\include\expat\ directory
-
2) Copy [Expat_Folder]\lib\libexpat.lib to [Checkout_Folder]\c\lib\expat\ directory.

-
-
-

For Xerces Parser

1) Copy [Xerces_Folder]\lib\xerces-c_2.lib to [Checkout_Folder]\c\lib\xerces\ directory.

@@ -449,13 +428,13 @@

In VC++ distribution workspace build AxisTransport project.Then AxisTransport.dll will be built.

-Xerces Parser Library and Expat Parser Library +Xerces Parser Library

In VC++ distribution workspace build either AxisXMLParserXerces project or AxisXMLParserExpat project. Then AxisXMLParser.dll will be built.

In VC++ distribution workspace build AxisXMLParserXerces project.Then AxisXMLParser.dll will be built.

Building AxisTransport.dll and AxisXMLParser.dll -
Build the AxisTransport and AxisXMLParser projects. Which will build the AxisTransport.dll and AxisXMLParser.dll in [Checkout_Folder]\c\bin.

+
Build the AxisTransport and AxisXMLParser project. Which will build the AxisTransport.dll and AxisXMLParser.dll in [Checkout_Folder]\c\bin.

(When the projects are built in Debug mode then the Dlls will appear as AxisTransport_D and AxisXMLParser_D.dll)

@@ -465,7 +444,7 @@

1) Create a directory structure called "Axis" inside [Apache_Folder] as follows.
(Instead, you can copy the folder [Checkout_Folder]\c\deploy to [Apache_Folder] and rename it to "Axis" and you will find some of the files that you are asked to create in this guide, already existing in that folder)
-
Axis
|__ lib (Copy [Expat_Folder]\Libs\libexpat.dll or
[Xerces_Folder]\bin\xerces-c_2_2_0.dll and paste it inside)
|__ logs (log files are located here)
|__ conf (server.wsdd file is located here)
|__ webservices (The place to put webservice dlls)
|__ wsdls (wsdl files of the deployed web services are located here)
+
Axis
|__ lib (Copy [Xerces_Folder]\bin\xerces-c_2_2_0.dll and paste it inside)
|__ logs (log files are located here)
|__ conf (server.wsdd file is located here)
|__ webservices (The place to put webservice dlls)
|__ wsdls (wsdl files of the deployed web services are located here)

2) Set an environment variable named AXISCPP_DEPLOY and give [Apache_Folder]\Axis as the value.

i)You will find AxisServer.dll and Apache_Module in [Checkout_Folder]\c\bin directory.
ii)Copy Apache_Module to [Apache_Folder]\modules directory of your apache installation.

@@ -485,7 +464,7 @@

-Note: Make sure that if you are using Expat that libexpat.dll ([Expat_Folder]\Libs\) file is pasted in %AXISCPP_DEPLOY%/lib/ and if you are using Xerces that xerces-c_2_2_0.dll ([Xerces_Folder]\bin) is pasted in %AXISCPP_DEPLOY%/lib/ +Note:Make sure that xerces-c_2_2_0.dll ([Xerces_Folder]\bin) is pasted in %AXISCPP_DEPLOY%/lib/

6) Select start->programs->Apache HTTP server->Control Apache Server->stop to stop the apache server
(This is because apache will be started automatically by the installation program)

Open up a DOS terminal and give the command "apache -k start" to start apache (If Apache 2.0 server does not respond when started this way, try "apache -X").
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.

@@ -627,7 +606,7 @@
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”.

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.
In the “Additional include directories” give [Checkout_Folder]c\include as the include path.

10) Click the “Link” tab and select “Input” from the “Category” Drop down list.
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 or AxisXMLParserExpat projects of the "Distribution" VC workspace.
+

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.

Add the following main method to Calculator.cpp
@@ -689,7 +668,7 @@ Note:Implement XMLParser.h interface according to the rules described in the header file.

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.

When creating your own parser refer XMLParser.h header file for API. To see an example implementation refer SoapParserXerces.h and SoapParserXerces.cpp.

Axis loads the parser dynamic library through following export functions which you also have to implement.

CreateInstance() - Used by Axis to create an instance of your parser class
DestroyInstance() - Used by Axis to destroy the created parser class instance

Compile your parser code and build a dynamic library. Add the name of your parser library to Axis configuration file (axiscpp.conf) so that Axis can find your library at runtime

1.40 +14 -33 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.39 retrieving revision 1.40 diff -u -r1.39 -r1.40 --- wininstall-guide.html 30 Dec 2004 03:05:31 -0000 1.39 +++ wininstall-guide.html 3 Feb 2005 06:42:32 -0000 1.40 @@ -298,13 +298,11 @@
Writing your web services and client applications using Axis C++.
-Installing the Expat Parser -
-

Installing the Xerces Parser

+Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -317,26 +315,13 @@
5. "lib" folder contains jars needed to use the wsdl2ws tool.

6. "samples" folder contains sources of all the server and client samples including interop tests.

- -

Installing the Expat XML parser

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section.

If you decide to use the Expat parser you need to install the Expat parser. Download the Expat-1.95.7 binary version from http://sourceforge.net/projects/expat/ -
-
Extract the Expat binaries to a folder Called Expat ,we will refer to this folder as [Expat_Folder].

-
-
-

Installing the Xerces XML parser

If you decide to use the Xerces parser you need to install the Xerces parser. Download the Xerces-C 2.2.0 ( 32 bit binary release) from: http://xml.apache.org/xerces-c/download.cgi +

Download the Xerces-C 2.2.0 ( 32 bit binary release) from: http://xml.apache.org/xerces-c/download.cgi

Extract the Xerces-C 2.2.0 binary version. We will refer to this folder as [Xerces_Folder].

@@ -357,12 +342,10 @@
[Axis_Module] is either mod_axis.dll for apache 1.3.X or mod_axis2.dll for apache 2.X.

8. Copy [Axis_Module] from Axis_Extract/bin folder to [Apache_Folder]/modules folder.

9. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib
-
10.If you want to use the Expat parser with Axis C++, rename AxisXMLParser_Expat.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib
-Note:The Expat XML Parser module is not currently maintained and also contains some bugs.For more information refer the contents section.
-
11.If you want to use the Xerces parser with Axis C++, rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

+
10.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin ) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib

Copy libexpat.dll file from [Expat_Folder]\Libs to [Axis_Folder]/lib/
Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin/ to [Axis_Folder]/lib/
@@ -370,7 +353,7 @@

+
12. Restart the apache web server. If you have done correctly apache server will start without giving any error.

apache 1.3.X : @@ -394,7 +377,7 @@
(However on a different machine, when I simply run the apache2 executable (version 2.0.49) without any arguments, as, "apache" on windows 2000 professional, service pack 5, with/without Axis C++ it seems to be working fine.

But in this machine the apache could not be started as "apache -k start" (i.e. as a service). It simply exists and does not start. The 98% CPU usage scenario cannot be reproduced in this machine.

It could happen with some other apache 2 versions or in different service packs. )
-
14. Open an internet browser and check http://localhost/axis If the module has loaded properly then you will get the axis welcome page with a listing of deployed web services.
+
13. Open an internet browser and check http://localhost/axis If the module has loaded properly then you will get the axis welcome page with a listing of deployed web services.

@@ -412,25 +395,23 @@
6. Add [Axis_Folder]/lib to the PATH environment variable.

7. Copy the SimpleAxisServer.exe from Axis_Extract/bin to the Simple_Axis_Server_Folder.

8. Copy AxisServer.dll and AxisTransport.dll from Axis_Extract/bin folder to [Axis_Folder]/lib
-
9.If you want to use the Expat parser with Axis C++, rename AxisXMLParser_Expat.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib
-Note:The Expat XML Parser module is not currently maintained and also contains some bugs.For more information refer the contents section.
10.If you want to use the Xerces parser with Axis C++, rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib
-
11.If you are using Expat parser then copy libexpat.dll from [Expat_Folder]/Libs and paste it in [Axis_Folder]/lib.
-
If you are using Xerces parser then copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.
+
9.Rename AxisXMLParser_Xerces.dll (which is located at Axis_Extract/bin) to AxisXMLParser.dll and copy it to [Axis_Folder]/lib
+
10.Copy xerces-c_2_2_0.dll from [Xerces_Folder]/bin and paste it in [Axis_Folder]/lib.

-Note: This could also be done by editing the axiscpp.conf.
12. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.
+Note: This could also be done by editing the axiscpp.conf.
10. Open the [Axis_Folder]/axiscpp.conf_win for editing. The contents of the file will look as follows.

LogPath:XXXX
WSDDFilePath:YYYY
XMLParser:ZZZZ
Transport_http:AAAA

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.

i.e.

LogPath: [Apache_Folder]\Axis\logs\AxisLog
WSDDFilePath: [Apache_Folder]\Axis\conf\server.wsdd
XMLParser:[Axis_Folder]\lib\AxisXMLParser.dll
Transport_http:[Axis_Folder]\lib\AxisTransport.dll

Rename axiscpp.conf_win to axiscpp.conf.
-
13. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)
+
11. Start the SimpleAxisServer by providing the port to which it operates.(eg: c:\SimpleAxisServer>SimpleAxisServer 80)

Note:If SimpleAxisServer does not start then paste AxisClient.dll to the place where SimpleAxisServer.exe is.

Also in order to run the provided samples do the following.

Open server.wsdd for editing. server.wsdd is located at [Axis_Folder]\conf\ rename the wsdd file of your platform to server.wsdd. For each service element, locate the element "parameter name", which has the value "classname".
Give the absolute path of the indicated webservice.dll in the "value" attribute
-
14. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will start without giving any error.
+
12. Restart the SimpleAxisServer.If you have done correctly then SimpleAxisServer will start without giving any error.

@@ -444,7 +425,7 @@
1.base.exe
2.cbase.exe
3.doclitbase.exe
4.doclitgroupB.exe
5.groupB.exe
6.cgroupB.exe

In order to run these samples you should have AxisClient.dll in the PATH environment variable or in the same directory where the client .exe is located.

You can run the provided client programs to confirm whether the Axis cpp server and clients are working fine.
-
To run these sample client applications you need to have the path to libexpat.dll in the "PATH" environment variable or libexpat.dll should be placed where the apache.exe is.(libexpat.dll can be found in [Expat_Folder]\libs)
+
To run these sample client applications you need to have the path to xerces-c_2_2_0.dll in the "PATH" environment variable or xerces-c_2_2_0.dll should be placed where the apache.exe is.(xerces-c_2_2_0.dll can be found in [Xerces_Folder]\bin)

Note: These sample clients are compiled with the assumption that server is running at localhost port 80.
1.34 +2 -4 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.33 retrieving revision 1.34 diff -u -r1.33 -r1.34 --- winuser-guide.html 30 Dec 2004 03:05:31 -0000 1.33 +++ winuser-guide.html 3 Feb 2005 06:42:32 -0000 1.34 @@ -312,7 +312,7 @@ Before you follow this guide, please make sure that you have followed the Windows Installation guide

+Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

Definitions:
Axis_Extract -> The folder to which the Axis c++ binary distribution is extracted
[Axis_Folder] -> The deploy folder of the binary distribution which is copied to the apache installation

@@ -433,10 +433,8 @@

Transport Library and Parser Library

-Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the Note at the top of the page.

Rename either AxisXMLParser_Expat.dll or AxisXMLParser_Xerces.dll to AxisXMLParser.dll (depending on the parser you use), 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.
If you want to use Expat parser then libexpat.dll should be given in the path.
If you want to use the Xerces parser then xerces-c_2_2_0.dll should be given in the path.
+

Axiscpp.conf file contains the following paths 1.30 +137 -137 ws-site/targets/axis/cpp/winuser-guide.pdf <> 1.8 +7 -15 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.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- lininstall-guide.html 16 Dec 2004 05:21:13 -0000 1.7 +++ lininstall-guide.html 3 Feb 2005 06:42:33 -0000 1.8 @@ -22,8 +22,7 @@
-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release.

@@ -58,10 +57,8 @@
-

2. Install Expat (1.95.7) and/or Xerces C++ (2.2.0)

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section. -

Select an XML parser depending on your parser preferences. See the respective parser's documentation for -installation instructions.

2. Install Xerces C++ (2.2.0)

See the Xerces parser's documentation for installation instructions.

3. Download Axis C++

@@ -230,9 +224,7 @@ To deploy with Apache 1.3.x

sh deploy_apache.sh
-

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. For more information refer the contents section. +

Note: please rename libaxis_xercesc.so (the default parser library) to libaxis_xmlparser.so.

@@ -284,4 +276,4 @@

- + \ No newline at end of file 1.4 +240 -210 ws-axis/c/docs/lininstall-guide.pdf <> 1.6 +96 -53 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.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- linuser-guide.html 16 Dec 2004 05:21:13 -0000 1.5 +++ linuser-guide.html 3 Feb 2005 06:42:33 -0000 1.6 @@ -12,6 +12,8 @@

+ + Introduction
@@ -49,6 +51,9 @@: SSL Client +; +Session Headers; @@ -88,6 +93,10 @@

+ +

Note:The Expat XML Parser module is not currently maintained and also contains some bugs. So it is removed from the 1.5 release. +

@@ -134,7 +143,7 @@

- Stability , Component oriented Deployment

- Transport Framework

- WSDL support

Axis C++ 1.1 supports the Web Service Description Language, version 1.1, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. We hope you enjoy using Axis c++ 1.1. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation. Let us know what you think! Please send feedback about the package to axis-user@xml.apache.org

@@ -198,8 +207,9 @@

There are two options to create the wsdl2ws.jar tool

1st Option is using ANT (This is more reliable)

In your PATH environment variable add path to <antinstall dir>/bin.
-$ cd $AXISCPP_HOME/src/wsdl/ -$ ant +$ cd $AXISCPP_HOME/src/wsdl/ +
+$ ant

2nd Option (Some users have experienced difficulties in using this option)

$ cd $AXISCPP_HOME/src/wsdl/ @@ -332,22 +342,15 @@ }

Then build by
-cd $AXISCPP_HOME/samples/client +cd $AXISCPP_HOME/samples/client/simple

-sh build.sh +g++ *.cpp -I$AXISCPP_HOME/include -L$AXISCPP_DEPLOY/lib -ldl -laxiscpp_client -ocalculator
Then to run the calculator sample

-$ cd AXISCPP_HOME/samples/simple -

-./calculator <server> <port> <command> <param1> <param2> -
-
Example:
-

-./calculator locathost 80 add 10 20 +./calculator add 10 5 http://locathost/axis/Calculator

@@ -362,7 +365,7 @@

Basically this will include all the Interoptest Samples and calculator sample.

-cd $AXISCPP_HOME/samples/server +cd $AXISCPP_HOME/samples

$ sh autogen.sh @@ -377,15 +380,7 @@ $ make install

-OR
- -

-$ sh build.sh
- -

Once you type the above command all the samples will be deployed in $AXIS_HOME/webservices folder.
you also have sample $AXIS_HOME/conf/server.wsdd_linux file which you should rename to server.wsdd,
which contain all the neccessary entries for these sevices.
+

Once you type the above command all the server samples will be deployed in $AXISCPP_DEPLOY/lib folder.
you also have sample $AXISCPP_DEPLOY/conf/server.wsdd_linux file which you should rename to server.wsdd,
which contain all the neccessary entries for these sevices. Sample clients will be installed in $AXISCPP_DEPLOY/bin

Restart Apache @@ -394,42 +389,21 @@

Building Client Side of the provided samples

+To run the samples +

+$ cd $AXISCPP_DEPLOY/bin

-cd $AXISCPP_HOME/samples/client -

-$ sh autogen.sh -

-$ sh runconfig -

-$ make -

-$ make install
- -

-OR
- -

-$ sh build.sh -
-
-

sample executables will be created in your current folder.
to run samples one by one

-$ ./base localhost 80 +$ ./base http://localhost/axis/base

to run all the samples at once
sh run_interoptests.sh (Note: local host and port 80 is assumed)

to run all the samples at once
sh run_interoptests.sh Note: local host and port 80 is assumed. + If you have different use.

+
+$ sh run_interoptests.sh -u http://yourserver:yourport/axis

@@ -571,6 +545,8 @@

+
+

SSL Client

To build the ssl channel library configure with
@@ -585,6 +561,73 @@ The API to write a new ssl channel library(using a library other than openssl) is in src/transport/SSLChannel.hpp

All openssl ssl related implementations are in src/transport/axis2/ssl folder +

+ +

Session Headers

The following text explains how to deploy and run the SOAP Header based sample client with Axis Java web service

+Deploying the Web Service

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)

+ + +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)

+ + +Put the following element in the section in the server-config.wsdd to enable SOAP header based +session handling for Axis Java

+<handler name="session" type="java:org.apache.axis.handlers.SimpleSessionHandler"/>

+ +The following should be put in the server-config.wsdd of Axis java for this service to behave as having session scope

+ +<service name="CounterService" provider="java:RPC">
+<parameter name="scope" value="session"/>
+<requestFlow>
+<handler type="session"/>
+</requestFlow>
+<responseFlow>
+<handler type="session"/>
+</responseFlow>
+ <parameter name="allowedMethods" value="*"/>
+ <parameter name="className" value="counters.CounterSoapBindingImpl"/>
+ <namespace>http://xml.apache.org/axis/wsdd/</namespace>
+</service>

+ +

+Since Axis c++ doesn't support multiref yet, Axis java multiref should be disabled by putting the element

+<parameter name="sendMultiRefs" value="false"/>
+under <globalConfiguration>

+ +Start Axis java (visit http://ws.apache.org/axis/java/index.html on how to achieve this)

+ +Generating the client stubs and building the client and running the client.

+ +

Compile the sessionhandler using the sources in c\samples\client\session\headers\sessionhandler

+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

+ +Compile the client application using the following command from within c\samples\client\session\headers\sessionclient

+ +g++ CounterClient.cpp gen_src/*.cpp -Igen_src
+I$AXISCPP_HOME/include -L$AXISCPP_DEPLOY/lib -ldl
+laxiscpp_client -oclient

+ +Host the service in Axis java (Check c/samples/server/session/headers/readme.txt on how to do this).

+ +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 )

+ +Run the tcpMonitor and configure it to check the conversation between the client and server

+ +Run the client in the following fashion

+sessionClient count 1 http://localhost:8080/axis/services/CounterService

+ + +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.
+

1.3 +253 -205 ws-axis/c/docs/linuser-guide.pdf <> 1.7 +19 -46 ws-axis/c/docs/windev-guide.html Index: windev-guide.html =================================================================== RCS file: /home/cvs/ws-axis/c/docs/windev-guide.html,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- windev-guide.html 8 Dec 2004 11:07:50 -0000 1.6 +++ windev-guide.html 3 Feb 2005 06:42:33 -0000 1.7 @@ -11,10 +11,10 @@ Getting a cvs checkout
-Getting necessary third party software +Getting necessary third party software
-Installing Apache and Expat +Installing Apache and Xerces
Setting up the build environment and building @@ -50,8 +50,7 @@