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...
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: