[jboss-cvs] JBossAS SVN: r107057 - projects/jboss-jca/trunk/doc/userguide/en/modules.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Fri Jul 23 11:33:44 EDT 2010
Author: jesper.pedersen
Date: 2010-07-23 11:33:43 -0400 (Fri, 23 Jul 2010)
New Revision: 107057
Modified:
projects/jboss-jca/trunk/doc/userguide/en/modules/community.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/download.xml
projects/jboss-jca/trunk/doc/userguide/en/modules/embedded.xml
projects/jboss-jca/trunk/doc/userguide/en/modules/troubleshooting.xml
Log:
User guide updates
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/community.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/community.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/community.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -16,7 +16,7 @@
<para>The user forum is where we discuss matters about the usage of the IronJacamar project.</para>
- <para>Our forum is located at <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=136">http://www.jboss.org/index.html?module=bb&op=viewforum&f=136</ulink></para>
+ <para>Our forum is located at <ulink url="http://community.jboss.org/en/jbossas/jca">http://community.jboss.org/en/jbossas/jca</ulink></para>
</section>
@@ -28,7 +28,7 @@
<para>User questions doesn't belong here - they should go in the user forum instead.</para>
- <para>The forum is located at <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=165">http://www.jboss.org/index.html?module=bb&op=viewforum&f=165</ulink></para>
+ <para>The forum is located at <ulink url="http://community.jboss.org/en/jbossas/jca/dev">http://community.jboss.org/en/jbossas/jca/dev</ulink></para>
</section>
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/configuration.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -54,12 +54,22 @@
<para>file, as the</para>
<programlisting>
-<bean name="RADeployer"
+<![CDATA[
+<bean name="RADeployer"
interface="com.github.fungal.spi.deployers.Deployer"
- class="org.jboss.jca.deployers.fungal.RADeployer">
- <depends>BeanValidation</depends>
- <depends>WorkManager</depends>
-</bean>
+ class="org.jboss.jca.deployers.fungal.RADeployer">
+ <property name="ArchiveValidation">true</property>
+ <property name="ArchiveValidationFailOnWarn">false</property>
+ <property name="ArchiveValidationFailOnError">true</property>
+ <property name="BeanValidation">true</property>
+ <property name="PrintStream"><inject bean="JBossStdioContext" property="Out"/></property>
+ <property name="DefaultBootstrapContext"><inject bean="DefaultBootstrapContext"/></property>
+ <property name="JndiStrategy"><inject bean="JNDIStrategy"/></property>
+ <property name="TransactionManager"><inject bean="RealTransactionManager"/></property>
+ <depends>BeanValidation</depends>
+ <depends>JBossStdioContextSelector</depends>
+</bean>
+ ]]>
</programlisting>
<para>bean.</para>
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/deployment.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -5,10 +5,36 @@
<para>The IronJacamar distribution contains a deploy/ directory where all deployments
should be deployed to.</para>
+ <section id="packagingrequirements">
+ <title>Packaging requirements</title>
+
+ <para>A resource adapter archive is a structured Java Archive (JAR) file, which
+ bundles all Java classes in JAR files, and optionally contains metadata, resources and native
+ libraries.</para>
+
+ <para>An example of a resource adapter archive could look like</para>
+
+ <programlisting>
+<![CDATA[
+[jpederse at localhost]$ jar tf ra.rar
+META-INF/ra.xml
+readme.html
+ra.jar
+images/icon.jpg
+win.dll
+linux.so
+ ]]>
+ </programlisting>
+
+ <para>See the Java EE Connector Architecture 1.6 specification chapter 20 for further
+ requirements.</para>
+
+ </section>
+
<section id="deployingrar">
<title>Deploying resource adapters</title>
- <para>Resource adapters (.rar) are deployed by copying the resource adapters into the
+ <para>Resource adapters (.rar) are deployed by copying the resource adapter into the
deploy/ directory</para>
<programlisting>
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/download.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/download.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/download.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -31,7 +31,7 @@
Identifier: The identifier. Identifies the level of the quality of the release.
<itemizedlist spacing="compact">
<listitem>
- None / GA: Stable release
+ None / Final: Stable release
</listitem>
<listitem>
CR: Candidate for Release quality. The implementation is functional complete.
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/embedded.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/embedded.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/embedded.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -22,18 +22,23 @@
<para>Especially the ability to unit test your resource adapter archives before deploying them
into a testing or a production environment will benefit developers.</para>
+ <para>In order to enhance the experience with working with the embedded configuration the container
+ integrates with the <ulink url="http://www.jboss.org/community/wiki/ShrinkWrap">ShrinkWrap</ulink>
+ and <ulink url="http://community.jboss.org/en/arquillian">Arquillian</ulink> frameworks.</para>
+
</section>
<section id="embedded_deployment">
<title>Deployment</title>
- <para>Currently you will need all the JAR files located in the</para>
+ <para>You will need all the JAR files located in the</para>
<programlisting>
-$JBOSS_JCA_HOME/lib
+$IRON_JACAMAR_HOME/lib
+$IRON_JACAMAR_HOME/lib/embedded
</programlisting>
- <para>directory as well as sub-directories on your application class loader - f.ex.</para>
+ <para>directories on your application class loader - f.ex.</para>
<programlisting>
java -classpath allthejarfiles.jar yourapp
@@ -41,6 +46,18 @@
<para>in order to use the embedded configuration.</para>
+ <para>If you want integration with the Arquillian framework you need to add the JAR files located
+ in the</para>
+
+ <programlisting>
+$IRON_JACAMAR_HOME/lib/embedded/arquillian
+ </programlisting>
+
+ <para>directory as well.</para>
+
+ <para>The code generator will generate a test suite based on the Arquillian functionality, so
+ that environment can be used as a starting point for your own integration.</para>
+
</section>
<section id="embedded_usage">
Modified: projects/jboss-jca/trunk/doc/userguide/en/modules/troubleshooting.xml
===================================================================
--- projects/jboss-jca/trunk/doc/userguide/en/modules/troubleshooting.xml 2010-07-23 15:09:27 UTC (rev 107056)
+++ projects/jboss-jca/trunk/doc/userguide/en/modules/troubleshooting.xml 2010-07-23 15:33:43 UTC (rev 107057)
@@ -7,7 +7,7 @@
<para>If you think you have found a bug you should verify this by posting to our forum first.</para>
- <para>Our forum is located at <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=136">http://www.jboss.org/index.html?module=bb&op=viewforum&f=136</ulink></para>
+ <para>Our forum is located at <ulink url="http://community.jboss.org/en/jbossas/jca">http://community.jboss.org/en/jbossas/jca</ulink></para>
<para>You can also search our issue tracking system located at <ulink url="https://jira.jboss.org/jira/browse/JBJCA">https://jira.jboss.org/jira/browse/JBJCA</ulink></para>
@@ -65,7 +65,7 @@
<para>We can't cover every single issue in this guide, so feel free to drop by our forums to see if a solution
has already been provided. Otherwise feel free to ask your question there.</para>
- <para>Our forum is located at <ulink url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=136">http://www.jboss.org/index.html?module=bb&op=viewforum&f=136</ulink></para>
+ <para>Our forum is located at <ulink url="http://community.jboss.org/en/jbossas/jca">http://community.jboss.org/en/jbossas/jca</ulink></para>
</section>
More information about the jboss-cvs-commits
mailing list