You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by na...@apache.org on 2010/10/25 13:51:55 UTC
svn commit: r1027078 -
/tuscany/sca-java-1.x/trunk/samples/domain-management/README
Author: nash
Date: Mon Oct 25 11:51:55 2010
New Revision: 1027078
URL: http://svn.apache.org/viewvc?rev=1027078&view=rev
Log:
Merge r1000571 TUSCANY-3684: Update README file to describe building and running the sample using ant
Modified:
tuscany/sca-java-1.x/trunk/samples/domain-management/README
Modified: tuscany/sca-java-1.x/trunk/samples/domain-management/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-1.x/trunk/samples/domain-management/README?rev=1027078&r1=1027077&r2=1027078&view=diff
==============================================================================
--- tuscany/sca-java-1.x/trunk/samples/domain-management/README (original)
+++ tuscany/sca-java-1.x/trunk/samples/domain-management/README Mon Oct 25 11:51:55 2010
@@ -6,82 +6,33 @@ analyze and resolve contribution depende
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 demonstrates how to use some of the APIs for processing the contributions.
-These APIs are currently used under the cover in the domain manager.
-
-domain-management/
- src/
- main/
- java/
- manager/
- DistributeAndRunComponents.java
- DistributeComponents.java
- ListComponents.java
- ListDependencies.java
- ListDeployables.java
- WireComponents.java
- resources/
- test/
- java/
- services/
- Cart.java
- Item.java
- ShoppingCartClientImpl.java
- ShoppingCartImpl.java
- resources/
- assembly/
- assets.xml
- client.xml
- store.xml
- assets/
- META-INF/
- sca-contribution.xml
- client/
- META-INF/
- client.composite
- store/
- META-INF/
- sca-contribution.xml
- store.composite
- build.xml
- pom.xml
- README
-
-Building the Sample Using Maven
--------------------------------------------
-
-cd domain-management
-mvn
-
-** Please note that the mvn command will just build the sample and will install the required jar files into the Maven repository.
-** In order to run the sample, please see the instructions - "Running the Sample"
+If you want to run this sample to see what happens, open a command prompt, navigate
+to this sample directory and run any of the sample domain management tasks
+as follows:
Running the Sample
------------------
-** Please make sure that sample is built using above build command(s).
-
-This sample implements following sample domain management tasks:
-
1. List deployables in a contribution:
------------------------------------
- This sample reads the SCA metadata for two sample contributions and prints the names of their deployable composites.
- Use the following command to run the sample:
-
- On windows do:
- java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListDeployables
- On *nix do:
- java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListDeployables
+ ant runListDeployables
+
+ - OR if you don't have ant,
+
+ On windows do:
+ java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListDeployables
+
+ On *nix do:
+ java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListDeployables
- You should see the following output:
-
- Deployable: {http://store}store
+
+ Deployable: {http://store}store
2. List contribution dependencies:
--------------------------------
@@ -90,19 +41,23 @@ This sample implements following sample
- Use the following command to run the sample:
- On windows do:
- java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListDependencies
-
- On *nix do:
- java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListDependencies
+ ant runListDependencies
+
+ - OR if you don't have ant,
+
+ On windows do:
+ java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListDependencies
+
+ On *nix do:
+ java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListDependencies
- You should see the following output:
- Contribution: store
- dependency: assets
- dependency: store
- Contribution: assets
- dependency: assets
+ Contribution: store
+ dependency: assets
+ dependency: store
+ Contribution: assets
+ dependency: assets
3. Add deployables to a domain composite and wire them:
-----------------------------------------------------
@@ -115,56 +70,132 @@ This sample implements following sample
- Use the following command to run the sample:
- On windows do:
- java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.WireComponents
+ ant runWireComponents
+
+ - OR if you don't have ant,
+
+ On windows do:
+ java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.WireComponents
- On *nix do:
- java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.WireComponents
+ On *nix do:
+ java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.WireComponents
- You should see the following output:
-
- <?xml version="1.0" encoding="UTF-8"?>
- <composite name="domain" targetNamespace="http://sample"
- xmlns="http://www.osoa.org/xmlns/sca/1.0" xmlns:ns1="http://www.osoa.org/xmlns/sca/1.0">
- <component name="ShoppingCart" uri="ShoppingCart">
- <implementation.java class="services.ShoppingCartImpl"/>
- <service name="Cart">
- <ns2:binding.atom name="Cart" uri="/ShoppingCart/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
- </service>
- </component>
- <component name="ShoppingCartClient" uri="ShoppingCartClient">
- <implementation.java class="services.ShoppingCartClientImpl"/>
- <service name="Cart">
- <ns2:binding.atom name="Cart" uri="/ShoppingCartClient/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
- </service>
- <reference name="cart">
- <ns2:binding.atom name="cart#ShoppingCart/Cart"
- uri="/ShoppingCart/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
- </reference>
- </component>
- </composite>
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <composite name="domain" targetNamespace="http://sample"
+ xmlns="http://www.osoa.org/xmlns/sca/1.0" xmlns:ns1="http://www.osoa.org/xmlns/sca/1.0">
+ <component name="ShoppingCart" uri="ShoppingCart">
+ <implementation.java class="services.ShoppingCartImpl"/>
+ <service name="Cart">
+ <ns2:binding.atom name="Cart" uri="/ShoppingCart/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
+ </service>
+ </component>
+ <component name="ShoppingCartClient" uri="ShoppingCartClient">
+ <implementation.java class="services.ShoppingCartClientImpl"/>
+ <service name="Cart">
+ <ns2:binding.atom name="Cart" uri="/ShoppingCartClient/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
+ </service>
+ <reference name="cart">
+ <ns2:binding.atom name="cart#ShoppingCart/Cart"
+ uri="/ShoppingCart/Cart" xmlns:ns2="http://tuscany.apache.org/xmlns/sca/1.0"/>
+ </reference>
+ </component>
+ </composite>
4. List Components:
-----------------
-
+
- This sample reads the SCA metadata for two sample contributions, and displays their dependencies, reads and resolve
the artifacts contained in the contributions, and finally prints the deployables composites and the components
they declare as well as their main characteristics (showing that their interfaces and implementations are actually resolved).
- Use the following command to run the sample:
- On windows do:
- java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListComponents
+ ant runListComponents
+
+ - OR if you don't have ant,
+
+ On windows do:
+ java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-domain-management.jar manager.ListComponents
- On *nix do:
- java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListComponents
+ On *nix do:
+ java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-domain-management.jar manager.ListComponents
- You should see the following output:
- Deployable: {http://store}store
- component: ShoppingCart
- componentService: Cart
- binding: class org.apache.tuscany.sca.binding.atom.impl.AtomBindingImpl - /ShoppingCart/Cart
- implementation: services.ShoppingCartImpl
- service: Cart
- interface: services.Cart
+ Deployable: {http://store}store
+ component: ShoppingCart
+ componentService: Cart
+ binding: class org.apache.tuscany.sca.binding.atom.impl.AtomBindingImpl - /ShoppingCart/Cart
+ implementation: services.ShoppingCartImpl
+ service: Cart
+ interface: services.Cart
+
+
+Sample Overview
+---------------
+
+This sample demonstrates how to use some of the APIs for processing contributions.
+These APIs are currently used under the covers in the domain manager.
+
+domain-management/
+ src/
+ main/
+ java/
+ manager/
+ DistributeAndRunComponents.java
+ DistributeComponents.java
+ ListComponents.java
+ ListDependencies.java
+ ListDeployables.java
+ WireComponents.java
+ resources/
+ test/
+ java/
+ services/
+ Cart.java
+ Item.java
+ ShoppingCartClientImpl.java
+ ShoppingCartImpl.java
+ resources/
+ assembly/
+ assets.xml
+ client.xml
+ store.xml
+ assets/
+ META-INF/
+ sca-contribution.xml
+ client/
+ META-INF/
+ client.composite
+ store/
+ META-INF/
+ sca-contribution.xml
+ store.composite
+ build.xml
+ pom.xml
+ README
+
+
+Building And Running The Sample Using Ant
+-----------------------------------------
+With the binary distribution the sample can be built and run using Ant as
+follows:
+
+cd domain-management
+ant compile
+ant runListDeployables
+ant runListDependencies
+ant runWireComponents
+ant runListComponents
+
+
+Building the Sample Using Maven
+-------------------------------
+
+cd domain-management
+mvn
+
+** Please note that the mvn command will just build the sample and will install the required jar files into the Maven repository.
+** In order to run the sample, please see the instructions - "Running the Sample"