Hello World Secure Web Service References Sample
================================================
This sample demonstrates an SCA reference that uses a web service binding. 

The README in the samples directory (the directory above this) provides 
general instructions about building and running samples. Take a look there 
first. 

If you just want to run it to see what happens you need to run the server first 
so open a command prompt, navigate to the helloworld-ws-service sample directory 
and do 

ant run

OR if you don't have ant, on Windows do

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-helloworld-ws-service-secure.jar helloworld.HelloWorldServer

and on *nix do

java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-helloworld-ws-service-secure.jar helloworld.HelloWorldServer


Once the server is running open a command prompt, navigate to this sample 
directory and do:

ant run

OR if you don't have ant, on Windows do

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-helloworld-ws-reference-secure.jar helloworld.HelloWorldClient

and on *nix do

java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-helloworld-ws-reference-secure.jar helloworld.HelloWorldClient


Sample Overview
---------------
The sample provides a single component that is wired to a reference with a 
web service binding. The binding refers to WSDL that identifies the service
exposed by the helloworld-ws-service-secure sample. This sample invokes a
secure web-serivce and hence specifies a policy intent named 'authentication' 
which is fulfilled by a suitable policyset that is defined for the SCA Domain.  
Over the helloworld-ws-reference sample, this sample demonstrate generally 
the use of policy intents and policy sets in Tuscany taking the specific instance 
of a security policy.

Note :
------
The policies mentioned and supported are instances of Tuscany specified policies and 
not instnaces of WS-Policy.

helloworld-ws-reference-secure/
  src/
    main/
      java/
        helloworld/
          HelloWorldService.java          - interface description for 
                                            HelloWorldServiceComponent
          HelloWorldServiceComponent.java - component implementation
          HelloWorldClient.java           - starts the SCA Runtime and 
                                            deploys the helloworldwsclient
                                            .composite. It then calls the 
                                            HelloWorldServiceComponent
          ClientPWCBHandler.java		  - Callback handler class to provide client password.  The 
          									handle(Callback[] callbacks) method of this class is where
          									code for accessing user registries and retrieving passwords 
          									for given user identifiers can be encapsulated.  For example
          									here is where one could access LDAP registries to obtain or
          									compare user identities and passwords.
         
      resources/
        wsdl
          helloworld.wsdl                 - the service description that the 
                                            SCA reference uses to bind to 
        helloworldwsclient.composite      - the SCA assembly for this sample
        logging.properties                - log4j configuration file
        definitions.xml					  - the SCA Definitions file that contains intents and policysets 
        									defined for the SCA Domain
    test/
      java/
        helloworld/
          HelloWorldClientTestCase.java   - JUnit test case
          HelloWorldServerTest.java       - starts the Web service
  helloworld-ws-reference-secure.png             - a pictorial representation of the 
                                            sample .composite file
  build.xml                               - the Ant build file
  pom.xml                                 - the Maven build file        

Building And Running The Sample Using Ant
-----------------------------------------
With the binary distribution the sample can be built and run using Ant. Before
you do this start up the service that the reference will talk to. To do this
run up the helloworld-ws-service-secure test. Take a look at the README in that sample
and you will see you need the following commands

cd helloworld-ws-service-secure
ant run

Once done you can now compile and run this sample using the following commands;

cd helloworld-ws-reference-secure
ant compile
ant run

You should see the following output from the run target.

run:
     [java] log4j:WARN No appenders could be found for logger (org.apache.axiom.
om.util.StAXUtils).
     [java] log4j:WARN Please initialize the log4j system properly.
     [java] Injected helloWorldService
     [java] Called getGreetings
     [java] *** Calling Client UserId/Password Handler ....
     [java] Hello World

Building And Running The Sample Using Maven 
-------------------------------------------
With either the binary or source distributions the sample can be built and run 
using Maven as follows. When using Maven you don't need to run the helloworld-
ws-service-secure sample first as Maven does this for you. 

cd helloworld-ws-reference-secure
mvn

You should see the following output from the test phase.

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running helloworld.HelloWorldClientTestCase
log4j:WARN No appenders could be found for logger (org.apache.axiom.om.util.StAX
Utils).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN No appenders could be found for logger (org.apache.axiom.om.util.StAX
Utils).
log4j:WARN Please initialize the log4j system properly.
10-May-2007 13:40:34 org.apache.catalina.core.StandardEngine start
INFO: Starting Servlet Engine: Apache Tomcat/6.0.10
10-May-2007 13:40:35 org.apache.catalina.startup.ContextConfig defaultWebConfig
INFO: No default web.xml
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/resources/j2ee_1_4.xsd
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/resources/xml.xsd
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/jsp/resources/jsp_2_0.xsd
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_2_
0.xsd
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/resources/web-app_2_4.xsd
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/resources/j2ee_web_services_1_1.xs
d
10-May-2007 13:40:35 org.apache.catalina.startup.DigesterFactory register
WARNING: Could not get url for /javax/servlet/resources/j2ee_web_services_client
_1_1.xsd
10-May-2007 13:40:35 org.apache.coyote.http11.Http11Protocol init
INFO: Initializing Coyote HTTP/1.1 on http-8085
10-May-2007 13:40:35 org.apache.coyote.http11.Http11Protocol start
INFO: Starting Coyote HTTP/1.1 on http-8085
Injected helloWorldService
Called getGreetings
*** Calling Client UserId/Password Handler ....
*** Calling Server User/Passwd Handler....
10-May-2007 13:40:36 org.apache.coyote.http11.Http11Protocol destroy
INFO: Stopping Coyote HTTP/1.1 on http-8085
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 6.349 sec

Results :


This shows that the Junit test cases have run successfully. Also note that the client side and server side
callback handlers for authentication have been called.