#######################################################
#                   Web Services Tests                #
#######################################################

General description : 
--------------------

This application is made of : 

- 2 Web service endpoints :
    - AdressBook service : a JAX-RPC endpoint ( a class running on a web container) 
    providing operations to enter and find adresses. ==> adressbook.war
    - Ordering service : a Stateless Session Bean providing operations to submit and get
     an order. ==> ordering.ear

- for each endpoints : 
    - 2 Web service clients implemented by EJB : 
        - one using generated classes (AXIS) to encapsulate Web Service Call object.
        - the other using a Dynamic Invocation Interface (Call object).
    - 2 Web service clients implemented by classes, using Stub (generated classes) and DII too.

Many different architectures are possible :

- 1 jonas server with all components (Web service endpoints, clients ...),
- 1 jonas server for each Web service endpoints, one other for Web service clients.
(all server on the same host because "localhost" is hardcoded)
-  ...


WARNING:
To compile or/and run the tests, the JONAS_ROOT must contains 
a JOnAS-Tomcat or a JOnAS-jetty package.


How to compile and to run the test:
-----------------------------------

You must follow some simple rules in order tu run successfully this TestSuite :

1. You must have an environment variable named HTTP_PORT containing the port
    where your webcontainer is listening
2. The tests are running on localhost
3. The JOnAS Server must be named jonas (same as for conformance tests)
4. You must have the "web" service (tomcat or jetty) launched

Steps :
-------

1. Launch a JOnAS server in a terminal
jonas start

2. Open another terminal

3. Set the HTTP_PORT variable (see your $JONAS_BASE/conf/server.xml)
export HTTP_PORT=9000

4. Compile the tests
cd $PROJ_BASE/jonas_tests/ws
ant install

5. Launch the suite
cd $PROJ_BASE/jonas_tests/ws
ant report

