[seam-commits] Seam SVN: r7543 - trunk/doc/reference/en/modules.

[seam-commits at lists.jboss.org]

Author: pete.muir at jboss.org
Date: 2008-03-12 07:51:38 -0400 (Wed, 12 Mar 2008)
New Revision: 7543

Modified:
   trunk/doc/reference/en/modules/testing.xml
Log:
JBSEAM-2234

Modified: trunk/doc/reference/en/modules/testing.xml
===================================================================
--- trunk/doc/reference/en/modules/testing.xml	2008-03-12 11:16:15 UTC (rev 7542)
+++ trunk/doc/reference/en/modules/testing.xml	2008-03-12 11:51:38 UTC (rev 7543)
@@ -456,6 +456,14 @@
               must put a <literal>seam.properties</literal> in each resource.
            </para>
            
+           <para>
+              By default, a generated project will use the 
+              <literal>java:/DefaultDS</literal> (a built in HSQL datasource in
+              Embedded JBoss) for testing. If you want to use another datasource
+              place the <literal>foo-ds.xml</literal> into 
+              <literal>bootstrap/deploy</literal> directory.
+           </para>
+           
          </section>
          
         <section>
@@ -567,10 +575,34 @@
            setting a TestNG test parameter named <literal>datasourceJndiName</literal>:
          </para>
          
-         <programlisting>
-   <![CDATA[<parameter name="datasourceJndiName" value="java:/seamdiscsDatasource"/>]]>
-         </programlisting> 
+         <programlisting><![CDATA[<parameter name="datasourceJndiName" value="java:/seamdiscsDatasource"/>]]></programlisting>
+         
+         <para>
+            DBUnitSeamTest has support for MySQL and HSQL - you need to tell it
+            which database is being used:
+         </para>
+         
+         <programlisting><![CDATA[<parameter name="database" value="HSQL" />]]></programlisting>
+         
+         <para>
+            It also allows you to insert binary data into the test data set (n.b.
+            this is untested on Windows). You need to tell it where to locate
+            these resources:
+         </para>
+         
+         <programlisting><![CDATA[<parameter name="binaryDir" value="images/" />]]></programlisting> 
           
+         <para>
+            You <emphasis>must</emphasis> specify these three parameters in your
+            <literal>testng.xml</literal>.
+         </para>
+         
+         <para>
+            If you want to use DBUnitSeamTest with another database, you'll need
+            to implement some methods. Read the javadoc of 
+            <literal>AbstractDBUnitSeamTest</literal> for more.
+         </para>
+          
         </section>
         
         <section id="testing.mail">