Simplificação no texto da documentação de referência

Cleverson Sacramento
1 parent 6e0e58db
Showing 4 changed files with 21 additions and 20 deletions Show diff stats
documentation/reference/pt-BR/arquitetura.xml
documentation/reference/pt-BR/excecao.xml
documentation/reference/pt-BR/security.xml
documentation/reference/pt-BR/transacao.xml
@@ -41,10 +41,8 @@
 		<para>
 			As boas práticas de programação nos alertam para que nunca sejamos dependentes de implementações, mas sempre de
 			interfaces ou, como alguns costumam dizer, <quote>depender de contratos</quote>.
-			As interfaces existem para isto: definem um contrato, enquanto as implementações deste contrato ficam à parte, de
-			preferência, distante do programador da aplicação. O mecanismo de injeção de dependência fortalece ainda mais esta
-			ideia. Sua aplicação precisará apenas depender das interfaces que o Demoiselle provê. A implementação específica será
-			injetada automaticamente pelo CDI.
+			Portanto a sua aplicação precisará apenas depender das interfaces que o Demoiselle provê. As implementações específicas
+			e internas do Framework serão injetadas automaticamente pelo CDI.
 		</para>
 		<tip>
 			<para>
@@ -53,14 +51,13 @@
 		</tip>
 		<para>
 			Qual o motivo de toda esta explicação? Os programadores mais curiosos irão encontrar classes do framework que estão
-			inseridas no pacote <literal>internal</literal>. 
-			Cabe alertar que as classes aí contidas não devem ser usadas diretamente pela aplicação, caso contrário, você
-			estará acoplando-a com a implementação interna do framework, que pode sofrer mudanças sem aviso prévio. A equipe do
+			inseridas no pacote <literal>br.gov.frameworkdemoiselle.internal</literal>. 
+			As classes deste pacote não devem ser usadas diretamente pela sua aplicação, caso contrário você
+			estará acoplando-a com a implementação interna do Framework. A equipe do
 			Demoiselle possui atenção especial quanto às suas interfaces (contratos) e não irá modificá-las sem antes tornar
-			públicas as mudanças. Contudo, tudo que consta no pacote
-			<literal>internal</literal>
-			pode sofrer mudanças repentinas. Isto significa que sua aplicação pode deixar de funcionar de uma versão para outra
-			caso você esteja usando diretamente classes internas.
+			públicas as mudanças. Contudo, tudo que consta no pacote <literal>br.gov.frameworkdemoiselle.internal</literal>
+			pode sofrer mudanças repentinas. Se você referenciar tais classes internas, a sua aplicação pode deixar
+			de funcionar ao atualizar a versão do Demoiselle.
 		</para>
 	</section>
@@ -77,14 +74,14 @@
 			apresentação, regras de negócio e persistência. O Demoiselle já fornece estereótipos que visam tornar esta 
 			separação mais clara, respectivamente:
 			<literal>@ViewController</literal>, <literal>@BusinessController</literal> e <literal>@PersistenceController</literal>. 
-			Maiores detalhes sobre cada anotação desta serão dados no decorrer desta documentação.
+			Maiores detalhes sobre cada anotação serão dados no decorrer desta documentação.
 		</para>
 		<!-- TODO: explicar melhor cada um dos estereótipos, se possível exemplificando com códigos -->
 		<para>
-			Cabe destacar que estamos falando de uma macro-visão arquitetural. Cada camada desta pode ser organizada
+			Cabe destacar que estamos falando de uma macro-visão arquitetural. Cada camada pode ser organizada
 			internamente da melhor forma possível, ou conforme os padrões vigentes no mercado. Para uma aplicação Swing, por
 			exemplo, o padrão de projeto <emphasis>Presentation Model</emphasis>
-			é bastante indicado e pode ser adotado em aplicações nesta plataforma. Para aplicações Web, os frameworks
+			é bastante indicado. Para aplicações Web, os frameworks
 			especialistas geralmente aplicam o padrão MVC (Model/View/Controller).
 		</para>
 	</section>
@@ -22,7 +22,7 @@ xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
 			        http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">
 	<interceptors>
-		<class>br.gov.frameworkdemoiselle.internal.interceptor.ExceptionHandlerInterceptor</class>
+		<class>br.gov.frameworkdemoiselle.exception.ExceptionHandlerInterceptor</class>
 	</interceptors>
 </beans>]]></programlisting>
     </section>
@@ -27,8 +27,8 @@ xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
 			        http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">
 	<interceptors>
-		<class>br.gov.frameworkdemoiselle.internal.interceptor.RequiredPermissionInterceptor</class>
-		<class>br.gov.frameworkdemoiselle.internal.interceptor.RequiredRoleInterceptor</class>
+		<class>br.gov.frameworkdemoiselle.security.RequiredPermissionInterceptor</class>
+		<class>br.gov.frameworkdemoiselle.security.RequiredRoleInterceptor</class>
 	</interceptors>
 </beans>]]></programlisting>
     </section> 
@@ -34,7 +34,7 @@
 			               http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">
 	   <interceptors>
-	   		<class>br.gov.frameworkdemoiselle.internal.interceptor.TransactionalInterceptor</class>
+	   		<class>br.gov.frameworkdemoiselle.transaction.TransactionalInterceptor</class>
 	   </interceptors>
 </beans>]]></programlisting>
     </section>
@@ -77,11 +77,15 @@ public class AbacaxiException {
 	<section>
 		<title>O objeto Transaction</title>
 		<para>
-			Para ter acesso à instância da transação corrente, basta injetá-la em sua classe.
+			Para ter acesso à instância da transação corrente, basta injetar <literal>TransactionContext</literal> em sua classe e obter a transação corrente.
 		</para>
 		<programlisting role="JAVA"><![CDATA[public class Simples {
 	@Inject
-	private Transaction transaction;
+	private TransactionContext transactionContext;
+
+	public void experimento() {
+		Transaction transaction = transactionContext.getCurrentTransaction();
+	}
 }]]></programlisting>
 	</section>
	@@ -22,7 +22,7 @@ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"		@@ -22,7 +22,7 @@ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
22	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee	22	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
23	http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">	23	http://java.sun.com/xml/ns/javaee/beans_1_0.xsd">
24	<interceptors>	24	<interceptors>
25	- <class>br.gov.frameworkdemoiselle.internal.interceptor.ExceptionHandlerInterceptor</class>	25	+ <class>br.gov.frameworkdemoiselle.exception.ExceptionHandlerInterceptor</class>
26	</interceptors>	26	</interceptors>
27	</beans>]]></programlisting>	27	</beans>]]></programlisting>
28	</section>	28	</section>