4:17 a.m.
Author: swd847
Date: 2010-10-07 05:17:23 -0400 (Thu, 07 Oct 2010)
New Revision: 13806
Added:
modules/persistence/trunk/docs/
modules/persistence/trunk/docs/pom.xml
modules/persistence/trunk/docs/src/
modules/persistence/trunk/docs/src/main/
modules/persistence/trunk/docs/src/main/docbook/
modules/persistence/trunk/docs/src/main/docbook/en-US/
modules/persistence/trunk/docs/src/main/docbook/en-US/master.xml
modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-general.xml
Log:
Add docs folder
Property changes on: modules/persistence/trunk/docs
___________________________________________________________________
Name: svn:ignore
+ target
.project
.classpath
.settings
Added: modules/persistence/trunk/docs/pom.xml
===================================================================
--- modules/persistence/trunk/docs/pom.xml (rev 0)
+++ modules/persistence/trunk/docs/pom.xml 2010-10-07 09:17:23 UTC (rev 13806)
@@ -0,0 +1,82 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.jboss.seam.persistence</groupId>
+ <artifactId>seam-persistence-parent</artifactId>
+ <version>3.0.0-SNAPSHOT</version>
+ <relativePath>../pom.xml</relativePath>
+ </parent>
+
+ <groupId>org.jboss.seam.persistence</groupId>
+ <artifactId>seam-persistence-reference-guide</artifactId>
+ <version>3.0.0-SNAPSHOT</version>
+ <packaging>jdocbook</packaging>
+ <name>Seam Persistence Reference Guide</name>
+
+ <properties>
+ <pdf.name>persistence-reference.pdf</pdf.name>
+ <weld.docbook.version>1.1.1-Beta5</weld.docbook.version>
+ </properties>
+
+ <build>
+ <defaultGoal>process-classes</defaultGoal>
+ <plugins>
+
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ </plugin>
+
+ <!-- Attach docs as a war so dist can retrieve them -->
+ <plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>build-helper-maven-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>attach-zip</id>
+ <phase>package</phase>
+ <goals>
+ <goal>attach-artifact</goal>
+ </goals>
+ <configuration>
+ <artifacts>
+ <artifact>
+
<file>${project.build.outputDirectory}/${project.artifactId}-${project.version}.war</file>
+ <type>war</type>
+ </artifact>
+ </artifacts>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+
+ <profiles>
+ <profile>
+ <id>distribution</id>
+ <activation>
+ <property>
+ <name>release</name>
+ </property>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-assembly-plugin</artifactId>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+ </profiles>
+
+
+ <scm>
+
<connection>scm:svn:http://anonsvn.jboss.org/repos/seam/modules/xml/tru...
+
<developerConnection>scm:svn:https://svn.jboss.org/repos/seam/modules/x...
+ <url>http://fisheye.jboss.org/browse/seam/modules/xml/docs</url>
+ </scm>
+</project>
Added: modules/persistence/trunk/docs/src/main/docbook/en-US/master.xml
===================================================================
--- modules/persistence/trunk/docs/src/main/docbook/en-US/master.xml
(rev 0)
+++ modules/persistence/trunk/docs/src/main/docbook/en-US/master.xml 2010-10-07 09:17:23
UTC (rev 13806)
@@ -0,0 +1,11 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.35//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]>
+<book lang="en">
+
+ <toc/>
+
+ <title>Seam Persistence</title>
+ <xi:include href="persistence-introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</book>
\ No newline at end of file
Added: modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-general.xml
===================================================================
--- modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-general.xml
(rev 0)
+++
modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-general.xml 2010-10-07
09:17:23 UTC (rev 13806)
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<chapter id="persistence">
+ <title>Seam Persistence Reference</title>
+
+ <section>
+ <title>The Seam Managed Persistence Context</title>
+ <para>
+ The seam managed persistence context is an EntityManager that has its lifecycle
managed by Seam. You configure one as follows:
+ </para>
+
+ <programlisting role="java">
+@SeamManaged
+@Produces
+@PersistenceUnit
+@ConversationScoped
+EntityManagerFactory producerField;
+ </programlisting>
+ <para>
+ This is just an ordinary resource producer field as defined by the CDI
specification, however the presence of the <literal>@SeamManaged</literal>
+ annotation tells seam to create a seam managed persistence context from this
<literal>EntityManagerFactory</literal>. This managed
+ persistence context can be injected normally, and has the same scope and qualifiers
that are specified on the resource producer field.
+ </para>
+ <note>
+ <para>
+ The more eagle eyed among you may have noticed that the resource producer field
appears to be conversation scoped, which the CDI
+ specification does not require containers to support. This is in fact not the
case, as the @ConversationScoped annotation is removed
+ by the seam persistence portable extension. It only specifies the scope of the
created SMPC, not the EntityManagerFactory.
+ </para>
+ </note>
+ <programlisting role="java">
+@Inject
+EntityManager smpc;
+ </programlisting>
+ <para>
+ The seam managed persistence context provides the following features:
+ </para>
+ <itemizedlist>
+ <listitem>Automatic enrollment in the active transaction</listitem>
+ <listitem>The ability to use EL in JPA queries</listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>Seam Transactions</title>
+ <para>Seam provides a lightweight UserTransaction wrapper called
SeamTransaction.</para>
+ <para>Seam also provides a transaction intercepter. In EE environments the
normal <literal>@TransactionAttribute</literal> annotation
+ can be used to demarcate transaction boundaries on managed beans, not just
EJB's.</para>
+
+ </section>
+</chapter>
Property changes on:
modules/persistence/trunk/docs/src/main/docbook/en-US/persistence-general.xml
___________________________________________________________________
Name: svn:executable
+ *