[seam-commits] Seam SVN: r15312 - branches/enterprise/WFK-2_1/examples.

[seam-commits at lists.jboss.org]

Author: manaRH
Date: 2012-10-23 08:21:25 -0400 (Tue, 23 Oct 2012)
New Revision: 15312

Modified:
   branches/enterprise/WFK-2_1/examples/readme.txt
Log:
bz 866924 customizing content of examples readme for WFK

Modified: branches/enterprise/WFK-2_1/examples/readme.txt
===================================================================
--- branches/enterprise/WFK-2_1/examples/readme.txt	2012-10-19 14:04:00 UTC (rev 15311)
+++ branches/enterprise/WFK-2_1/examples/readme.txt	2012-10-23 12:21:25 UTC (rev 15312)
@@ -1,48 +1,37 @@
 Seam Example EE6 Applications
-=========================
+=============================
 This directory contains the Seam example applications, which have all been
-tested on the latest release of JBoss AS 7.1.1. Consult the readme.txt file in each of 
+tested on the latest release of JBoss EAP 6.0. Consult the readme.txt file in each of 
 the examples to see details.
 
-Below is a list of examples with a brief description. The name of the example,
-refered to later as ${example.name}, is equivalent to the name of the folder
-unless the folder name begins with seam, in which case the prefix "seam" is
-omitted (i.e. seamspace -> space).
-
-----------------------------------------------------------------------
-
-booking/              The Seam Booking demo application for EJB 3.
-
-
-
 Deploying and Testing an Example Application
 ============================================
 
 These are general instructions for deploying Seam examples. Take a look at the 
 readme.txt in the example to see if there are any specific instructions.
 
-How to Build and Deploy an Example on JBoss AS
-----------------------------------------------
+How to Build and Deploy an Example on JBoss EAP 6
+-------------------------------------------------
 
-1. Download and unzip JBoss AS 7.1.1 from:
+1. Download and unzip JBoss EAP 6
    
-   http://jboss.org/jbossas/downloads
+   https://access.redhat.com/downloads
 
-2. Make sure you have an up to date version of Seam: 
+2. Make sure you have set up WFK and EAP 6 Maven repositories. 
+   More details how to do that, you can read in JBoss Web Framework Kit documentation book called Maven
+   Repository Guide.  
 
-   http://seamframework.org/Download
-
 3. Build the example by running the following command from the Seam
    "examples/${example.name}" directory:
    
-   mvn clean install   
+   mvn clean install
 
    NOTE: Firstly, this command will also run unit tests on that example. To skip the tests add 
    -Dmaven.test.skip=true to the maven call. Secondly, there is an option to deploy an "exploded"
    archive. For this purpose, use -Pexploded maven profile.
 
-4. Deploy the example by calling g JBOSS_HOME property and running the 
-   following command from the Seam "examples/${example.name}/{example.name}-ear" directory:
+4. Deploy the example by running the following command from "examples/${example.name}/{example.name}-ear" directory if
+that is EAR packaged type example or from "examples/${example.name}/{example.name}-war" if that is WAR packaged type example:
 
    mvn jboss-as:deploy
     
@@ -66,25 +55,35 @@
    The WAR examples are:
    spring, jpa, hibernate, groovybooking 
 
-NOTE: The examples use the H2 database embedded in JBoss AS
+NOTE: The examples use the H2 default database embedded in JBoss EAP 6
 
    
 Running The Integration Tests
-------------------------
+-----------------------------
 
 Integration tests are executed during building of the application using:
 
-   mvn clean install -Darquillian=jbossas-{managed,remote}-7
+   mvn clean install -Darquillian=jbossas-remote-7
 
 
 Running integration test(s) in Eclipse
-------------------------
+--------------------------------------
+Right click on the project and select Properties. Select the Maven property sheet and in the first form field,
+enter jbossas-remote-7 profile.
+Click OK and accept the project changes. Before we execute tests, make sure that Eclipse has properly processed all 
+the resource files by running a full build on the project by selecting Clean from Project menu. 
+Now you are ready to execute tests. Right click on a test class and select Run As... > JUnit Test
+
 Detail guide is at http://docs.jboss.org/arquillian/reference/1.0.0.Alpha1/en-US/html_single/#d0e552
 
 
 Debugging of integration test(s) in Eclipse
------------------------
-http://docs.jboss.org/arquillian/reference/1.0.0.Alpha1/en-US/html_single/#d0e974
+-------------------------------------------
+If you set a break point and execute the test in debug mode using a remote container, your break point won't be hit.
+That's because when you debug an in-container test, you're actually debugging the container. 
+The test runner and the test are executing in different JVMs. Therefore, to setup debugging,
+ you must first attach the IDE debugger to the container, then execute the test in debug mode (i.e., debug as test).
+That puts the debugger on both sides of the fence, so to speak, and allows the break point to be discovered. 
 
 
 Running functional tests on an example
@@ -93,7 +92,7 @@
 The following steps describe executing of functional tests in general. If particular example
 does not contain certain profile, it is simply ignored during the maven call.
 
-* Start JBoss AS 7
+* Start JBoss EAP 6 Server
 * Set JBOSS_HOME environment property, respectively
 
 To run functional tests: