[jboss-cvs] JBossAS SVN: r108234 - projects/jboss-jca/trunk/doc/userguide/en/modules.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Mon Sep 20 16:09:52 EDT 2010


Author: jesper.pedersen
Date: 2010-09-20 16:09:52 -0400 (Mon, 20 Sep 2010)
New Revision: 108234

Modified:
   projects/jboss-jca/trunk/doc/userguide/en/modules/codegenerator.xml
   projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml
   projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml
   projects/jboss-jca/trunk/doc/userguide/en/modules/validator.xml
Log:
User guide updates

Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/codegenerator.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/codegenerator.xml	2010-09-20 19:18:59 UTC (rev 108233)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/codegenerator.xml	2010-09-20 20:09:52 UTC (rev 108234)
@@ -336,7 +336,7 @@
                 </entry>
                 <entry>All</entry>
                 <entry>
-                  Create build environment, ant or ant+ivy or maven
+                  Type of build environment
                 </entry>
                 <entry></entry>
               </row>

Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml	2010-09-20 19:18:59 UTC (rev 108233)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml	2010-09-20 20:09:52 UTC (rev 108234)
@@ -180,6 +180,10 @@
                         <code>SimpleJndiStrategy</code>: A simple JNDI strategy 
                         which can bind/unbind a single connection factory
                       </listitem>
+                      <listitem>
+                        <code>ExplicitJndiStrategy</code>: A JNDI strategy 
+                        which can requires explicit JNDI names to bind/unbind a connection factory
+                      </listitem>
                     </itemizedlist>
                   </entry>
                 </row>
@@ -238,6 +242,57 @@
 
         </section>
 
+        <section id="jca_deployer_raxmldeployer">
+          <title>Resource adapter metadata deployer</title>
+
+          <para>The deployer for deploying our <code>-ra.xml</code> deployment descriptor is handled
+            by a <code>org.jboss.jca.deployers.fungal.RaXmlDeployer</code> bean.</para>
+          
+          <para>The deployment descriptor is defined by the <code>resource-adapters-1_0.xsd</code> schema.</para>
+
+          <programlisting>
+<![CDATA[
+<bean name="RaXmlDeployer"
+      interface="com.github.fungal.spi.deployers.Deployer" 
+      class="org.jboss.jca.deployers.fungal.RaXmlDeployer">
+  <property name="Configuration"><inject bean="DeployerConfiguration"/></property>
+  <property name="Kernel"><inject bean="Kernel"/></property>
+  <depends>BeanValidation</depends>
+  <depends>JBossStdioContextSelector</depends>
+</bean>
+ ]]>
+          </programlisting>
+
+          <para>This deployer will activate resource adapters based on the deployment information.</para>
+          
+
+          <table frame="all">
+            <title>Resource adapter metadata deployer</title>
+            <tgroup cols="3" align="left" colsep="1" rowsep="1">
+              <colspec colname="c1" colwidth="2*"/>
+              <colspec colname="c2"/>
+              <colspec colname="c3" colwidth="3*"/>
+              <thead>
+                <row>
+                  <entry align="left">Property</entry>
+                  <entry align="left">Type</entry>
+                  <entry align="left">Description</entry>
+                </row>
+              </thead>
+              <tbody>
+                <row>
+                  <entry><code>Configuration</code></entry>
+                  <entry><code>org.jboss.jca.deployers.fungal.RAConfiguration</code></entry>
+                  <entry>
+                    The configuration for the deployer
+                  </entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </table>
+
+        </section>
+
         <section id="jca_deployer_raactivator">
           <title>Resource adapter activator</title>
 
@@ -449,7 +504,7 @@
 
       <para>as well as the reference in <code>config/bootstrap/bootstrap.xml</code> to the file.</para>
 
-      <para>Furthermore all JDBC-*.RAR files in the <code>system/</code> directory should be removed too.</para>
+      <para>Furthermore all <code>jdbc-*.rar</code> files in the <code>system/</code> directory should be removed too.</para>
 
    </section>
 
@@ -466,6 +521,16 @@
 
       <para>file.</para>
 
+      <programlisting>
+<![CDATA[
+<bean name="WebServer" class="org.jboss.jca.web.WebServer">
+  <property name="Host">${iron.jacamar.bindaddress:localhost}</property>
+  <property name="Port">8080</property>
+  <property name="ExecutorService"><inject bean="Kernel" property="ExecutorService"/></property>
+</bean>
+]]>
+      </programlisting>
+
       <table frame="all">
         <title>Web server</title>
         <tgroup cols="3" align="left" colsep="1" rowsep="1">
@@ -481,6 +546,14 @@
           </thead>
           <tbody>
             <row>
+              <entry><code>Host</code></entry>
+              <entry><code>String</code></entry>
+              <entry>
+                Set the bind address for the web server
+                <para>Default: <code>localhost</code></para>
+              </entry>
+            </row>
+            <row>
               <entry><code>Port</code></entry>
               <entry><code>int</code></entry>
               <entry>
@@ -488,6 +561,14 @@
                 <para>Default: <code>8080</code></para>
               </entry>
             </row>
+            <row>
+              <entry><code>ExecutorService</code></entry>
+              <entry><code>java.util.concurrent.ExecutorService</code></entry>
+              <entry>
+                The thread pool for the web server
+                <para>Default: The kernel thread pool</para>
+              </entry>
+            </row>
           </tbody>
         </tgroup>
       </table>
@@ -499,7 +580,7 @@
 system/
       </programlisting>
 
-      <para>Furthermore all .WAR files in the same directory should be removed too.</para>
+      <para>Furthermore all <code>.war</code> files in the same directory should be removed too.</para>
 
       <para>All the Jetty libraries can be removed by deleting the</para>
 

Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml	2010-09-20 19:18:59 UTC (rev 108233)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml	2010-09-20 20:09:52 UTC (rev 108234)
@@ -12,6 +12,8 @@
         bundles all Java classes in JAR files, and optionally contains metadata, resources and native
         libraries.</para>
 
+      <para>A resource adapter archive name ends in the <code>.rar</code> extension.</para>
+
       <para>An example of a resource adapter archive could look like</para>
 
       <programlisting>

Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/validator.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/validator.xml	2010-09-20 19:18:59 UTC (rev 108233)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/validator.xml	2010-09-20 20:09:52 UTC (rev 108234)
@@ -12,7 +12,7 @@
         and checks them against the rules defined in the validator.</para>
 
       <para>The validator is used in the deployer chain of the JCA container, and is available 
-        as a standalone tool and an Apache Ant too.</para>
+        as a standalone tool, as an Apache Ant task and as a Apache Maven plugin too.</para>
    </section>
 
    <section id="validator_reports">



More information about the jboss-cvs-commits mailing list