[jboss-svn-commits] JBL Code SVN: r5708 - in labs/jbossesb/trunk/qa: . junit

[jboss-svn-commits at lists.jboss.org]

Author: tfennelly
Date: 2006-08-10 12:29:19 -0400 (Thu, 10 Aug 2006)
New Revision: 5708

Added:
   labs/jbossesb/trunk/qa/README.TXT
Removed:
   labs/jbossesb/trunk/qa/junit/readme.txt
Log:
added the readme

Added: labs/jbossesb/trunk/qa/README.TXT
===================================================================
--- labs/jbossesb/trunk/qa/README.TXT	2006-08-10 15:44:44 UTC (rev 5707)
+++ labs/jbossesb/trunk/qa/README.TXT	2006-08-10 16:29:19 UTC (rev 5708)
@@ -0,0 +1,28 @@
+OVERVIEW
+=============
+This file hierarchy contains QA tests.  Note that the JUnit based tests here are NOT "Unit Tests", we're simply utilising the
+Ant and JUnit frameworks for running QA level tests.  
+
+These tests depend on a running JBoss AS, installed JBoss ESB (and whatever it depends on - DB etc), configured
+JMS Queues etc.  Each test should outline whatever its dependencies.
+
+RUNNING THE TESTS
+====================
+1. Run the "earinstr" ant build target from the "product" folder.
+2. Run the "test" ant build target from the "qa" folder.
+
+Note that because these tests are QA based tests (with filesystem dependencies etc), it is not recommended to run the
+JUnit based tests from within your IDE.
+
+ADDING JUNIT TESTS
+=====================
+Simply add the tests to the junit/src tree making sure that all "TestCase" files have the "Test" suffix.  Use and add to
+the utility classes (in the org.jboss.soa.esb.util package) as much as possible.  Always run the tests through the ant 
+scripts i.e. not through your IDE (as outlined above).
+
+Notes on Listener Configurations:
+1. 	All Listener configurations must be located in the src folder (just put them in the same package as your TestCase class).
+2.  When specifying directory URI attributes on the Listener configurations (e.g. DirectoryPoller input dirs), be sure
+    not to commit absolute URIs relative to your file system.  Instead, use "@qa.build@" tokens in conjunction with the
+    ListenerUtils and FileUtils classes.  See the org.jboss.soa.esb.listeners.SimpleListenersTest and 
+    org.jboss.soa.esb.listeners.SimpleListenerConfig.xml files as examples.
\ No newline at end of file

Deleted: labs/jbossesb/trunk/qa/junit/readme.txt
===================================================================
--- labs/jbossesb/trunk/qa/junit/readme.txt	2006-08-10 15:44:44 UTC (rev 5707)
+++ labs/jbossesb/trunk/qa/junit/readme.txt	2006-08-10 16:29:19 UTC (rev 5708)
@@ -1,6 +0,0 @@
-
-This file hierarchy contains JUnit based QA tests.  Note these tests are NOT "Unit Tests", we're simply utilising the
-Ant and JUnit frameworks for running QA level tests.  
-
-These tests depend on a running JBoss AS, installed JBoss ESB (and whatever it depends on - DB etc), configured
-JMS Queues etc.  Each test should outline whatever its dependencies.
\ No newline at end of file