Merge r1023849 TUSCANY-3730: Add "ant setup" command to create database files needed by store tutorial
git-svn-id: https://svn.apache.org/repos/asf/tuscany/sca-java-1.x/trunk@1027633 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/tutorials/store/README b/tutorials/store/README
index b53d97a..adec067 100644
--- a/tutorials/store/README
+++ b/tutorials/store/README
@@ -2,7 +2,7 @@
==============
This tutorial that shows how to use SCA and Tuscany to build multiple
-variations of an online Store application. The variations demostrate the
+variations of an online Store application. The variations demonstrate the
evolution of the Store as it goes through the following stages:
1 - Initial online fruit store
@@ -17,7 +17,18 @@
Running The Tutorial Application
--------------------------------
-First start the SCA Domain Manager:
+If you're running the Store tutorial application for the first time since
+downloading the Tuscany SCA Java binary distribution, you need to start by
+running a setup step from the top-level store directory:
+
+ cd store
+ ant setup
+
+You only need to do this once. It creates some database files that are used
+by the tutorial application. If you forget to do it, you'll get errors when
+running some of the scenarios.
+
+Next, start the SCA Domain Manager:
cd domain
ant run
@@ -160,6 +171,9 @@
http://localhost:8102/ui/
+If you see an error at this stage, this probably means you haven't done the
+database setup mentioned in the section "Running The Tutorial Application".
+
This looks the same as the scenario 2 store but this time a database is used
for storing items put into the shopping cart. When you add items you
will see messages on the console indicating that items are added to the
@@ -315,8 +329,11 @@
With the binary distribution the complete store tutorial can be built using Ant
as follows:
-cd store
-ant compile
+ cd store
+ ant compile
+
+This also creates the database files that were mentioned in the section
+"Running The Tutorial Application".
Building the Store Tutorial Using Maven
@@ -324,5 +341,8 @@
With either the binary or source distribution the complete store tutorial can
be built using Maven as follows:
-cd store
-mvn
+ cd store
+ mvn
+
+This also creates the database files that were mentioned in the section
+"Running The Tutorial Application".
diff --git a/tutorials/store/build.xml b/tutorials/store/build.xml
index 7796d30..4f4ba66 100644
--- a/tutorials/store/build.xml
+++ b/tutorials/store/build.xml
@@ -31,6 +31,12 @@
</antcall>
</target>
+ <target name="setup">
+ <ant dir="store-db" target="create-db"/>
+ <ant dir="store-eu" target="create-db"/>
+ <ant dir="store-supplier" target="create-db"/>
+ </target>
+
<target name="allsubdirs">
<ant dir="domain" target="${target}"/>
<ant dir="assets" target="${target}"/>
diff --git a/tutorials/store/store-db/build.xml b/tutorials/store/store-db/build.xml
index 94cc0ba..bbfd09f 100644
--- a/tutorials/store/store-db/build.xml
+++ b/tutorials/store/store-db/build.xml
@@ -28,7 +28,10 @@
<manifest>
</manifest>
</jar>
+ <antcall target="create-db"/>
+ </target>
+ <target name="create-db">
<!--
Create the example database.
-->
diff --git a/tutorials/store/store-eu/build.xml b/tutorials/store/store-eu/build.xml
index deef28d..a061a75 100644
--- a/tutorials/store/store-eu/build.xml
+++ b/tutorials/store/store-eu/build.xml
@@ -28,7 +28,10 @@
<manifest>
</manifest>
</jar>
+ <antcall target="create-db"/>
+ </target>
+ <target name="create-db">
<!--
Create the example database.
-->
diff --git a/tutorials/store/store-supplier/build.xml b/tutorials/store/store-supplier/build.xml
index 2338125..813486e 100644
--- a/tutorials/store/store-supplier/build.xml
+++ b/tutorials/store/store-supplier/build.xml
@@ -28,7 +28,10 @@
<manifest>
</manifest>
</jar>
+ <antcall target="create-db"/>
+ </target>
+ <target name="create-db">
<!--
Create the example database. This database is needed by the unit test
in ../store-test.
