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

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: