Start branch for 1.3.1, the only changes in this commit are for the version

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

1 files changed, 131 insertions, 0 deletions

diff --git a/branches/sca-java-1.3.1/samples/binding-notification-producer/README b/branches/sca-java-1.3.1/samples/binding-notification-producer/README
new file mode 100644
index 0000000000..58611f64bd
--- /dev/null
+++ b/branches/sca-java-1.3.1/samples/binding-notification-producer/README
@@ -0,0 +1,131 @@
+Notification Producer Binding Sample

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

+

+This sample illustrates the use of <binding.notification/> with a

+remote producer.

+

+The README in the samples directory (the directory above this) provides 

+general instructions about building and running samples. Take a look there 

+first. 

+

+Sample Overview

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

+

+This sample illustrates the use of a notification producer that is located in a

+separate (and remote) composite with respect to any consumers. As such, this sample

+is run in conjunction with the binding-notification-consumer sample, the

+binding-notification-broker sample, or both. Take a look at the composite file 

+or the .svg file which shows the composite file in pictorial form. The composite

+reference, referred to by the notification component, has a <binding.notification/>

+that handles the remote communication. This binding includes an 'ntm' attribute

+that refers to the notification type manager, which manages the connectivity of

+producers, consumers and brokers, and which (for this sample) is assumed to be

+running on http://localhost:8083. The ntm is a system component that is included in

+and runs as part of the binding-notification module.

+This sample also illustrates the use of a wsdl interface in the notification

+component's <implementation.notification/>. This allows messages sent and received

+via <binding.notification/> to be transported as literal xml over http.

+

+Building And Running The Sample Using Ant

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

+With the binary distribution the sample can be built and run using Ant as 

+follows

+

+cd binding-notification-producer

+ant compile

+ant run

+

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

+

+run:

+     [java] Sep 14, 2007 10:31:45 AM org.apache.tuscany.sca.http.jetty.JettyServer addServletMapping

+     [java] INFO: Added Servlet mapping: http://localhost:8083/ntm/trafficAdvisory

+     [java] Sep 14, 2007 10:31:45 AM org.apache.tuscany.sca.http.jetty.JettyServer addServletMapping

+     [java] INFO: Added Servlet mapping: http://localhost:8083/producer/trafficAdvisory

+     

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

+

+cd binding-notification-producer

+mvn

+

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

+

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

+ T E S T S

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

+Running notification.producer.TrafficAdvisoryTestCase

+Only instantiating and closing domain ...

+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.252 sec

+

+Results :

+

+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

+

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

+

+Sample Usage

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

+

+This sample is run using the tuscany binary distribution. To run it, first set the

+following environment variables:

+

+set TUSCANY_BIN_DISTRO=<Directory where the distro was extracted, e.g. \Devt\tuscany-sca-distr\tuscany-sca>

+set TUSCANY_SCA_MANIFEST_JAR=%TUSCANY_BIN_DISTRO%\lib\tuscany-sca-manifest.jar

+

+Then navigate to this sample directory and do:

+

+java -Dnotification.httpPort=8083 -cp "target\sample-binding-notification-producer.jar;%TUSCANY_SCA_MANIFEST_JAR%" notification.producer.TrafficAdvisoryServer

+

+this should bring up the following prompt:

+

+Send a report value, ^C or <end> to end

+

+at this point you should be able to type a message to send, for instance:

+

+Traffic congestion

+

+Notice that before you try to send any message, you should bring up the

+consumer sample or the broker sample. When you have finished using this

+sample, type 'end' or ^C to end.

+

+Also notice that '-Dnotification.httpPort=8083' is used in the java command.

+This indicates the port the sample should use. This also says that this server

+is going to play the role of ntm, given our previous assumption. It is important

+that the first one of the producer, consumer or broker sample that is run be the

+one that uses '-Dnotification.httpPort=8083', otherwise there is no ntm to talk

+to and an exception will be thrown.

+

+Sample directory structure:

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

+

+binding-notification-producer/

+  src/

+    main/

+      java/

+        notification.producer/

+          TestCaseProducer.java                    - interface for the producer component

+          TrafficAdvisory.java                     - remote interface referred to by the producer component

+          TrafficAdvisoryProducer.java             - implementation for the producer component

+          TrafficAdvisoryServer.java               - server class including main entry point

+      resources/

+        wsdl/

+          TrafficAdvisory.wsdl                     - remote interface for the notification component

+        TrafficAdvisoryNotification.componentType  - the component type referred to by

+                                                     <implementation.notification/>

+        TrafficAdvisoryNotification.composite      - the main composite including producer and

+                                                     notification components, and composite reference

+    test/

+      java/

+        notification.producer/

+          TrafficAdvisoryTestCase.java             - JUnit test case

+      resources/

+        wsdl/

+          TrafficAdvisory.wsdl                     - remote interface for the notification component

+        TrafficAdvisoryNotification.componentType  - the component type referred to by

+                                                     <implementation.notification/>

+        TrafficAdvisoryNotification.composite      - the main composite including producer and

+                                                     notification components, and composite reference

+  pom.xml                                          - the Maven build file