##############################################################################

This folder contains auto build script for Axis C++ and basic regression test cases for the C/C++
Client Web Services Stack (CWSS). 

##############################################################################

DIRECTORY STRUCTURE
-------------------

testcases/platform/
 Contains the scripts for test framework.

testcases/wsdls/
 Contains the WSDL for the test cases.

testcases/client/
 Contains the C and C++ invocation clients.
 NOTES: Each client must have the same basename as the WSDL file
        plus Client.
        Example: SimpleTypeArray.wsdl -> SimpleTypeArrayClient.c[pp] 

testcases/output/
 Contains the output of the client invocation expected result.

testcases/server/
 Contains the server implementation of the binding (WAS 5.0.2). And
 the ear file. 

##############################################################################

ENVIRONMENT VARIABLES
---------------------

The easiest way of configuring the test framework is to set some environment
variables.

------------------------------------------------------------------------------
Variable          | Description
------------------------------------------------------------------------------
AXISCPP_HOME      | Axis C++ build directory
-----------------------------------------------------------------------------
AXISCPP_DEPLOY    | Axis C++ deployed here. Server and Client libraries
                  | are taken from here
------------------------------------------------------------------------------
AXISTEST_HOME     | This specifies the location of the testcase framework with
                  | the directory structure specified above. Path is
                  | upto(including) testcases folder
------------------------------------------------------------------------------
JAVA_HOME         | Path to the java installation
------------------------------------------------------------------------------
ANT_HOME          | Path to the ant installation
------------------------------------------------------------------------------
AXIS_JARS_HOME    | Path to the axis jars
##############################################################################

SCRIPTS
-------
autoBuildCVS.sh

 Checkout Axis C++ from cvs and build it and run all the test cases.

runAllTests.[sh|bat] [lang]

  Run all the test cases present in the client folders for the specified
  language, default c++. The test will only be run if there is a matching
  client source file and wsdl

runTest.[sh|bat] wsdls\<wsdl> [lang]

  Run the client test for the specified WSDL file and the specified language,
  default c++. If there is not a matching client source file for the WSDL file
  then nothing is done.


##############################################################################

Example of using the test framework
-----------------------------------

Linux
-----

When you want to add a new test please be aware of the following simple steps.

1. Write the cpp file containing your main method of access and put
   it in $AXISCPP_HOME/tests/auto-build/testcases/client/cpp
    NOTES: Each client cpp file must have the same basename as the 
    WSDL  file plus Client.
    Example: SimpleTypeArray.wsdl -> SimpleTypeArrayClient.c[pp]

2. Put the wsdl you hope to test in
   testcases/wsdls

3. Add the server and port running the webservice in 
   testcases/platform/linux/test.config file. The format is
   <wsdl file name (without .wsdl part)>:host=<your host>
   <wsdl file name (without .wsdl part)>:port=<your port>

4. cd to auto_build and run autoBuildCVS.sh
   This will first checkout from cvs and then build the source.
   Then generate samples from each wsdl.
   You will have a new folder creaed in testcases/build folder with the 
   same name as the client cpp file name.
   First time you should get run FAIL message. That's because you still
   does not have a .out file indicating your expected result. We will
   create this in the next step

5. in testcases/build/<automaticall creaed your client folder> you will
   see a file named <Your client file name>.cpp.out
   Copy this file into testcases/output

6. Next time you should get your test passed
   with SUCCESS.
   This time the build/<Your client file name>.cpp.out matchs correctly
   with the pre created output in testcases/output