Move Tuscany from Incubator to top level.

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 152 insertions, 0 deletions

diff --git a/java/sca/samples/helloworld-ws-service-secure/README b/java/sca/samples/helloworld-ws-service-secure/README
new file mode 100644
index 0000000000..f32eb08b05
--- /dev/null
+++ b/java/sca/samples/helloworld-ws-service-secure/README
@@ -0,0 +1,152 @@
+Hello World Secure Web Service Service Sample

+=============================================

+This sample demonstrates an SCA service that uses a web service binding that is enabled for simple

+authentication using UseridToken and PasswordText

+

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

+

+Now the server is started you can use the helloworld-ws-reference-secure sample to 

+exercise it. 

+

+Sample Overview

+---------------

+The sample provides a single component that is wired to a service with a 

+web service binding.  The service specifies a policy intent named 'authentication' 

+which is fulfilled by a suitable policyset that is defined for the SCA Domain.  Over 

+the helloworld-ws-service 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-service-secure/

+  src/

+    main/

+      java/

+        helloworld/

+          HelloWorldService.java          - interface description for 

+                                            HelloWorldServiceComponent

+          HelloWorldImpl.java             - component implementation

+          HelloWorldServer.java           - starts the SCA Runtime and 

+                                            deploys the helloworldws

+                                            .composite and then waits for the

+                                            service to be called via web services

+		  ServerPWCBHandler.java		  - callback handler to authenticate client userid and password.  

+		  									The handle(Callback[] callbacks) method of this class typically contains

+          									code for accessing user registries and retrieving passwords 

+          									for user identifiers sent by the client and verifying them 

+          									against the password sent by the client.  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 describes

+                                            the exposed service

+        helloworldws.composite            - the SCA assembly for this sample

+        definitions.xml					  - the SCA Definitions file that contains intents and policysets 

+        									defined for the SCA Domain

+    

+  helloworld-ws-service-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 using the 

+following commands

+

+cd helloworld-ws-service-secure

+ant compile

+ant run

+

+You should see the following output from the run target.

+

+run:

+     [java] 14-Jan-2008 14:22:07 org.apache.tuscany.sca.http.jetty.JettyServer a

+ddServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:8085/HelloWorldService

+     [java] 14-Jan-2008 14:22:07 org.apache.tuscany.sca.http.jetty.JettyServer a

+ddServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:8085/HelloWorldWsPolicyS

+ervice

+     [java] HelloWorld server started (press enter to shutdown)

+     

+As this point the SCA service is exposed as a web service by a web server 

+started automatically by the SCA runtime. The webservice requires clients to 

+have security headers that carry userid tonken and password text.

+

+To stop the server just press enter.

+

+To exercise the service run up the helloworld-ws-reference-secure sample. Take a look at 

+the README in that sample and you will see you need the following commands

+

+cd helloworld-ws-reference-secure

+ant run

+

+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-reference-secure sample as Maven includes a simple ping test to make sure that the

+service is available

+

+cd helloworld-ws-service-secure

+mvn

+

+You should see the following output from the test phase.

+

+-------------------------------------------------------

+ T E S T S

+-------------------------------------------------------

+Running helloworld.HelloWorldServerTestCase

+14-Jan-2008 14:23:20 org.apache.catalina.core.StandardEngine start

+INFO: Starting Servlet Engine: Apache Tomcat/6.0.10

+14-Jan-2008 14:23:20 org.apache.catalina.startup.ContextConfig defaultWebConfig

+INFO: No default web.xml

+14-Jan-2008 14:23:20 org.apache.catalina.startup.DigesterFactory register

+WARNING: Could not get url for /javax/servlet/jsp/resources/jsp_2_0.xsd

+14-Jan-2008 14:23:20 org.apache.catalina.startup.DigesterFactory register

+WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_1_

+1.dtd

+14-Jan-2008 14:23:20 org.apache.catalina.startup.DigesterFactory register

+WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_1_

+2.dtd

+14-Jan-2008 14:23:20 org.apache.catalina.startup.DigesterFactory register

+WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_2_

+0.xsd

+14-Jan-2008 14:23:20 org.apache.catalina.startup.DigesterFactory register

+WARNING: Could not get url for /javax/servlet/resources/j2ee_web_services_1_1.xs

+d

+14-Jan-2008 14:23:21 org.apache.coyote.http11.Http11Protocol init

+INFO: Initializing Coyote HTTP/1.1 on http-8085

+14-Jan-2008 14:23:21 org.apache.coyote.http11.Http11Protocol start

+INFO: Starting Coyote HTTP/1.1 on http-8085

+14-Jan-2008 14:23:21 org.apache.tuscany.sca.http.tomcat.TomcatServer addServletM

+apping

+INFO: Added Servlet mapping: http://L3AW203:8085/HelloWorldService

+14-Jan-2008 14:23:21 org.apache.tuscany.sca.http.tomcat.TomcatServer addServletM

+apping

+INFO: Added Servlet mapping: http://L3AW203:8085/HelloWorldWsPolicyService

+14-Jan-2008 14:23:21 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: 5.734 sec

+

+This shows that the Junit test cases have run successfully.