From ed2c77d3b720f56161f94875eb30add421e5065b Mon Sep 17 00:00:00 2001 From: nash Date: Mon, 25 Oct 2010 11:51:55 +0000 Subject: Merge r1000571 TUSCANY-3684: Update README file to describe building and running the sample using ant git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1027078 13f79535-47bb-0310-9956-ffa450edef68 --- .../trunk/samples/domain-management/README | 251 ++++++++++++--------- 1 file changed, 141 insertions(+), 110 deletions(-) (limited to 'sca-java-1.x/trunk/samples/domain-management') diff --git a/sca-java-1.x/trunk/samples/domain-management/README b/sca-java-1.x/trunk/samples/domain-management/README index 540cbc3bc0..eb31bb07ad 100644 --- a/sca-java-1.x/trunk/samples/domain-management/README +++ b/sca-java-1.x/trunk/samples/domain-management/README @@ -6,82 +6,33 @@ analyze and resolve contribution dependencies given a set of available contribut 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 domain management tasks: - 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 domain management tasks: - 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: - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + 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" -- cgit v1.2.3