From seam-commits at lists.jboss.org Wed Oct 13 06:14:22 2010
Content-Type: multipart/mixed; boundary="===============0289745917705797901=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r13837 -
 modules/persistence/trunk/docs/src/main/docbook/en-US.
Date: Wed, 13 Oct 2010 06:14:22 -0400
Message-ID: <201010131014.o9DAEMDg023958@svn01.web.mwc.hst.phx2.redhat.com>

--===============0289745917705797901==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: swd847
Date: 2010-10-13 06:14:22 -0400 (Wed, 13 Oct 2010)
New Revision: 13837

Modified:
   modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-genera=
l.xml
Log:
update documentation


Modified: modules/persistence/trunk/docs/src/main/docbook/en-US/persistence=
-general.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-gener=
al.xml	2010-10-13 08:26:08 UTC (rev 13836)
+++ modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-gener=
al.xml	2010-10-13 10:14:22 UTC (rev 13837)
@@ -79,6 +79,54 @@
     =

    </section>
    =

+   <section>
+      <title>Getting Started</title>
+      =

+      <para>
+         To get started with Seam persistence you need to add the
+         <literal>seam-persistence.jar </literal> and the =

+         <literal>weld-extensions.jar</literal> to you deployment. If you =
are in
+         a java SE environment you will probably also require =

+         <literal>seam-xml.jar</literal> as well for configuration purpose=
s. The
+         relevant maven configuration is as follows:
+      </para>
+<programlisting role=3D"XML><![CDATA[<dependency>
+  <groupId>org.jboss.seam.persistence</groupId>
+  <artifactId>seam-persistence-api</artifactId>
+  <version>${seam.persistence.version}</version>
+</dependency>
+
+<dependency>
+  <groupId>org.jboss.seam.persistence</groupId>
+  <artifactId>seam-persistence-impl</artifactId>
+  <version>${seam.persistence.version}</version>
+</dependency>
+
+<dependency>
+  <groupId>org.jboss.weld</groupId>
+  <artifactId>weld-extensions</artifactId>
+  <version>${weld.extensions.version}</version>
+</dependency>
+
+<dependency>
+  <groupId>org.jboss.seam.xml</groupId>
+  <artifactId>seam-xml-config</artifactId>
+  <version>${seam.xml.version}</version>
+</dependency>  =

+]]></programlisting>  =

+      =

+      <para>
+         You will also need to have a JPA provider on the classpath. If yo=
u are
+         using java EE this is taken care of for you. If not, we recommend=
 hibernate.
+      </para>
+
+<programlisting role=3D"XML><![CDATA[<dependency>
+  <groupId>org.hibernate</groupId>
+  <artifactId>hibernate-core</artifactId>
+  <version>3.5.1-Final</version>
+</dependency>]]></programlisting>      =

+   </section>
+   =

    <section id=3D"persistence.transactions" >
       <title>Transaction Management</title>
       =

@@ -92,11 +140,24 @@
       <section>
          <title>Configuration</title>
          <para>
-            If you are in an EE 6 environment then no configuration is nec=
essary, =

-            simply drop the seam-persistence jar into your app and you are=
 ready
-            to go.
+            In order to enable declarative transaction management for mana=
ged beans =

+            you need to list the transaction interceptor in beans.xml:
          </para>
+         <programlisting role=3D"XML"><![CDATA[<?xml version=3D"1.0" encod=
ing=3D"UTF-8"?>
+<beans xmlns=3D"http://java.sun.com/xml/ns/javaee"
+   xmlns:xsi=3D"http://www.w3.org/2001/XMLSchema-instance"
+   xsi:schemaLocation=3D"
+      http://java.sun.com/xml/ns/javaee =

+      http://docs.jboss.org/cdi/beans_1_0.xsd">
+   <interceptors>
+      <class>org.jboss.seam.persistence.transaction.TransactionInterceptor=
</class>
+   </interceptors>
+</beans>]]></programlisting>         =

          <para>
+            If you are in a Java EE 6 environment then you are good to go, =

+            no additional configuration is required. =

+         </para>
+         <para>
             If you are not in an EE environment you may need to configure =
some
             things with seam-xml. You may need the following entries in yo=
ur
             beans.xml file:


--===============0289745917705797901==--