Documentação da transação JDBC

Cleverson Sacramento
1 parent 114731e3
Showing 1 changed file with 52 additions and 31 deletions Show diff stats
documentation/reference/pt-BR/transacao.xml
@@ -93,7 +93,7 @@ public class AbacaxiException {
 		</para>
 		<para>
 			Você também pode optar por não utilizar controle de transação. Neste caso, basta não utilizar a anotação <literal>@Transactional</literal>. Contudo,
-			caso você a utilize, você poderá escolher entre as estratégias JPA, JTA (ambas fornecidas pelo <literal>Framework</literal>) e uma estratégia que você
+			caso você a utilize, você poderá escolher entre as estratégias JPA, JDBC, JTA (ambas fornecidas pelo <literal>Framework</literal>) e uma estratégia que você
 			pode criar ou importar para seu projeto.
 		</para>
 		<para>
@@ -103,28 +103,46 @@ public class AbacaxiException {
 	</section>
 	<section>
+		<title>Estratégia JDBC</title>
+		<para>
+			Esta estratégia, que está disponível na extensão <literal>demoiselle-jdbc</literal>, delega o
+			controle das transações para o <literal>java.sql.Connection</literal> da
+			especificação JDBC. Você deve escolher esta estratégia quando estiver persistindo dados
+			com JDBC e utilizando apenas uma base de dados em sua aplicação. Como um <literal>Connection</literal>
+			acessa apenas uma base de dados, não há como fazer o controle transacional de base de dados distintas.
+		</para>
+		<para>
+			A transação JDBC é simples de configurar e não exige nenhum recurso externo à sua aplicação.
+			Para utilizá-la basta que seu projeto adicione no arquivo pom.xml dependência à extensão <literal>demoiselle-jdbc</literal>, que o 
+			Demoiselle fará a seleção por essa estratégia de forma automática.
+		</para>
+
+	<tip><para>Para utilizar a estratégia de transação JDBC, inclua a dependência para extensão JDBC 
+	no arquivo pom.xml.</para>  
+	 <programlisting role="XML"><![CDATA[<dependency>
+	<groupId>br.gov.frameworkdemoiselle</groupId>
+	<artifactId>demoiselle-jdbc</artifactId>
+	<scope>compile</scope>
+</dependency>]]></programlisting></tip>
+	</section>
+
+	<section>
 		<title>Estratégia JPA</title>
 		<para>
 			Esta estratégia, que está disponível na extensão <literal>demoiselle-jpa</literal>, delega o
-			controle de transações para o <literal>javax.persistence.EntityManager</literal> da
-			especificação JPA. Você deve escolher esta estratégia quando você estiver fazendo a persistência
+			controle das transações para o <literal>javax.persistence.EntityManager</literal> da
+			especificação JPA. Você deve escolher esta estratégia quando estiver persisteindo dados
 			com JPA e utilizando apenas uma base de dados em sua aplicação. Como um <literal>EntityManager</literal>
 			acessa apenas uma unidade de persistência, não há como fazer o controle transacional de unidades distintas.
 		</para>
 		<para>
 			A transação JPA é simples de configurar e não exige nenhum recurso externo à sua aplicação.
-			Para utilizá-la basta que seu projeto adicione no arquivo POM.XML dependência à extensão <literal>demoiselle-jpa</literal>, que o 
+			Para utilizá-la basta que seu projeto adicione no arquivo pom.xml dependência à extensão <literal>demoiselle-jpa</literal>, que o 
 			Demoiselle fará a seleção por essa estratégia de forma automática.
-<!-- 		Basta definir no arquivo <filename>demoiselle.properties</filename> a seguinte configuração: -->
 		</para>
-		<!--  
-		<programlisting>
-			frameworkdemoiselle.transaction.class=br.gov.frameworkdemoiselle.transaction.JPATransaction
-		</programlisting>
-		-->
-	<tip><para> Caso não esteja utilizando o arquétipo JSF-JPA fornecidos pelo Demoiselle, confira se a dependência para a 
-	extensão está indicada corretamente no arquivo POM.XML.</para>  
+	<tip><para>Caso não esteja utilizando o arquétipo JSF-JPA fornecidos pelo Demoiselle, confira se a dependência para a 
+	extensão está indicada corretamente no arquivo pom.xml.</para>  
 	 <programlisting role="XML"><![CDATA[<dependency>
 	<groupId>br.gov.frameworkdemoiselle</groupId>
 	<artifactId>demoiselle-jpa</artifactId>
@@ -143,9 +161,9 @@ public class AbacaxiException {
 		<para>
 			A estratégia JTA não serve apenas para persistência em banco de dados, serve também para integrar com
 			tecnologias que façam acesso ao contexto JTA, como é o caso do EJB. Para ativar esta estratégia basta 
-			que seu projeto adicione no arquivo POM.XML a dependência à extensão <literal>demoiselle-jta</literal>, que o 
+			que seu projeto adicione no arquivo pom.xml a dependência à extensão <literal>demoiselle-jta</literal>, que o 
 			Demoiselle fará a seleção por essa estratégia de forma automática, pois essa estratégia tem prioridade em relação
-			à estratégia JPA. 
+			à estratégia JPA e JDBC. 
 		</para>				
 		<!-- 
 			defina no
@@ -160,8 +178,9 @@ public class AbacaxiException {
 			você precisa de um container JEE ou de um servidor JTA qualquer.
 		</para>
 		<para>
-			É preciso também informar no arquivo <filename>persistence.xml</filename> o endereço da conexão
-			JTA gerenciada. Veja um exemplo utilizando o servidor de aplicações JBoss-AS6 e com o provider Hibernate (embutido no JBoss-AS) como implementação JPA:
+			Caso você esteja persistindo os dados com JPA, é preciso também informar no arquivo <filename>persistence.xml</filename>
+			o endereço da conexão JTA gerenciada. Veja um exemplo utilizando o servidor de aplicações JBoss AS7 e com o
+			provider Hibernate (embutido no JBoss AS) como implementação JPA:
 		</para>
 <programlisting role="XML"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
 <persistence version="2.0" 
@@ -176,22 +195,28 @@ public class AbacaxiException {
 		<property name="hibernate.show_sql" value="true" />
 		<property name="hibernate.format_sql" value="false" />
 		<property name="hibernate.hbm2ddl.auto" value="update" />
-		<property name="hibernate.transaction.jta.platform" 
-		value="org.hibernate.service.jta.platform.internal.JBossAppServerJtaPlatform" />
+		<property name="hibernate.transaction.jta.platform"
+			value="org.hibernate.service.jta.platform.internal.JBossAppServerJtaPlatform" />
 	</properties>
 	</persistence-unit>
 </persistence>]]></programlisting>
-	<tip><para> Caso não esteja utilizando o arquétipo JSF-JPA fornecidos pelo Demoiselle, confira se a dependência para a 
-	extensão está indicada corretamente, no arquivo POM.XML.</para>  
+	<tip><para>Caso não esteja utilizando o arquétipo JSF-JPA fornecidos pelo Demoiselle, confira se a dependência para a 
+	extensão está indicada corretamente, no arquivo pom.xml.</para>  
 	<programlisting role="XML"><![CDATA[<dependency>
 	<groupId>br.gov.frameworkdemoiselle</groupId>
 	<artifactId>demoiselle-jta</artifactId>
 	<scope>compile</scope>
 </dependency>]]></programlisting></tip>
+		<para>
+			Caso você esteja persistindo os dados com JDBC, é preciso também informar no arquivo <filename>demoiselle.properties</filename>
+			o endereço da conexão JTA gerenciada. Veja um exemplo utilizando o servidor de aplicações JBoss AS7:
+		</para>
+		
+<programlisting role="XML"><![CDATA[frameworkdemoiselle.persistence.jndi.name=java:jboss/datasources/ExampleDS]]></programlisting>
 	</section>
-
+		
 	<section>
 		<title>Crie a sua estratégia</title>
 		<para>
@@ -222,15 +247,9 @@ public class MegaTransaction implements Transaction {
 }]]></programlisting>
 		<para>
 			Pronto, é só isso! Agora, os métodos anotados com <literal>@Transactional</literal> irão utilizar a estratégia criada em seu projeto de forma automática,
-			mesmo que as extensões <literal>demoiselle-jpa</literal> e <literal>demoiselle-jta</literal> sejam adicionadas ao projeto, pois o framework dá prioridade
-			máxima à estratégia criada no projeto.
-		</para>
-<!-- 	<para>
-			Basta agora definir no arquivo <filename>demoiselle.properties</filename> a sua estratégia:
+			mesmo que as extensões <literal>demoiselle-jdbc</literal>, <literal>demoiselle-jpa</literal> e <literal>demoiselle-jta</literal> sejam adicionadas ao
+			projeto, pois o framework dá prioridade máxima à estratégia criada no projeto.
 		</para>
-		<programlisting>
-			frameworkdemoiselle.transaction.class=projeto.MegaTransaction
-		</programlisting>-->
 	</section> 
 	<section>
@@ -239,11 +258,13 @@ public class MegaTransaction implements Transaction {
 			Existem alguns casos nos quais você vai ter que definir a estratégia manualmente. Um exemplo é quando seu projeto implementa mais do que uma estratégia
 			de transação. Outra situação pode acontecer em casos de teste, nos quais você queira utilizar estratégia diferente. Nesses casos você deve definir no 
 			arquivo <filename>demoiselle.properties</filename> qual estratégia será utilizada. Veja alguns exemplos de definição de estratégias própria,
-			<literal>JTATransaction</literal> e <literal>JPATransaction</literal> (importante notar que apenas uma estratégia pode estar ativa por vez):
+			<literal>JDBCTransaction</literal>, <literal>JPATransaction</literal> e <literal>JTATransaction</literal>. É importante notar que apenas uma estratégia
+			pode estar ativa por vez:
 		</para>
 		<programlisting>frameworkdemoiselle.transaction.class=projeto.MyTransaction</programlisting>
-		<programlisting>frameworkdemoiselle.transaction.class=br.gov.frameworkdemoiselle.transaction.JTATransaction</programlisting>
+		<programlisting>frameworkdemoiselle.transaction.class=br.gov.frameworkdemoiselle.transaction.JDBCTransaction</programlisting>
 		<programlisting>frameworkdemoiselle.transaction.class=br.gov.frameworkdemoiselle.transaction.JPATransaction</programlisting>
+		<programlisting>frameworkdemoiselle.transaction.class=br.gov.frameworkdemoiselle.transaction.JTATransaction</programlisting>
 	</section>
 </chapter>