Tidy up readme, doc all the ways of running it, tidy up dependencies

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

2 files changed, 30 insertions, 5 deletions

diff --git a/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/README b/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/README
index 2bbda2cd15..0a2cd93390 100644
--- a/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/README
+++ b/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/README
@@ -5,15 +5,23 @@ This sample demonstrates using the OASIS SCAClient API to invoke a service in a
 

 See the README in the top-level samples folder for general information on the Tuscany samples.

 

-This project has a Java class with a main method which uses the SCAClient API to invoke a Helloworld

-service in a remote SCA domain.

+This project has a plain Java SE class with a main method which uses the OASIS SCAClient API to 

+invoke a Helloworld service in a remote SCA domain.

 

 Before running this sample you must have a helloworld service running in a SCA domain somewhere,

-for example, you may do using a separate command prompt and running the Tuscany 

-"Getting Started - Helloworld Sample" with the command "mvn tuscany:run -DdomainURI=uri:default".

+for example, you can do that by using a separate command prompt to run the Tuscany 

+"Getting Started - Helloworld Sample" with the command 

 

+   mvn tuscany:run -DdomainURI=uri:default

+

+(including that domainURI parameter activates the Tuscany distributed domain) 

+ 

 You can then run this SCAClient sample with the Maven command: 

 

+   mvn tuscany:run

+

+As this sample uses a standard Java SE main class you can also run it with the maven exec java plugin:

+

    mvn exec:java

 

 You should see the following oputput:

diff --git a/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/pom.xml b/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/pom.xml
index f10cb6d343..2a7a452777 100644
--- a/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/pom.xml
+++ b/sca-java-2.x/trunk/samples/getting-started/helloworld-scaclient/pom.xml
@@ -57,12 +57,15 @@
          <groupId>org.apache.tuscany.sca</groupId>
          <artifactId>tuscany-base-runtime</artifactId>
          <version>${tuscany.version}</version>
+         <scope>test</scope>
       </dependency>
       
+      <!-- this is for the Tuscany distributed domain support -->
       <dependency>
          <groupId>org.apache.tuscany.sca</groupId>
          <artifactId>tuscany-domain-hazelcast</artifactId>
          <version>${tuscany.version}</version>
+         <scope>test</scope>
       </dependency>
 
    </dependencies>
@@ -70,6 +73,18 @@
    <build>
 
       <plugins>
+
+         <!-- to support running the application with mvn tuscany:run -->
+         <plugin>
+            <groupId>org.apache.tuscany.maven.plugins</groupId>
+            <artifactId>maven-tuscany-plugin</artifactId>
+            <version>${tuscany.version}</version>
+            <configuration>
+              <mainClass>sample.HelloworldSCAClient</mainClass>
+            </configuration>
+         </plugin>
+
+         <!-- to support running the application with mvn exec:java -->
          <plugin>
             <groupId>org.codehaus.mojo</groupId>
             <artifactId>exec-maven-plugin</artifactId>
@@ -83,8 +98,10 @@
             </executions>
             <configuration>
               <mainClass>sample.HelloworldSCAClient</mainClass>
+              <classpathScope>test</classpathScope>
             </configuration>
-          </plugin>
+         </plugin>
+
       </plugins>
     </build>
 </project>