From a6fdf536a990cd6b7ab81c5caa6acdcfcaa9e11f Mon Sep 17 00:00:00 2001 From: Cleverson Sacramento Date: Tue, 9 Apr 2013 08:47:00 -0300 Subject: [PATCH] Simplificação no texto da documentação de referência --- documentation/reference/pt-BR/arquitetura.xml | 25 +++++++++++-------------- documentation/reference/pt-BR/excecao.xml | 2 +- documentation/reference/pt-BR/security.xml | 4 ++-- documentation/reference/pt-BR/transacao.xml | 10 +++++++--- 4 files changed, 21 insertions(+), 20 deletions(-) diff --git a/documentation/reference/pt-BR/arquitetura.xml b/documentation/reference/pt-BR/arquitetura.xml index 340b03d..9af072e 100644 --- a/documentation/reference/pt-BR/arquitetura.xml +++ b/documentation/reference/pt-BR/arquitetura.xml @@ -41,10 +41,8 @@ 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, depender de contratos. - 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. @@ -53,14 +51,13 @@ Qual o motivo de toda esta explicação? Os programadores mais curiosos irão encontrar classes do framework que estão - inseridas no pacote internal. - 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 br.gov.frameworkdemoiselle.internal. + 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 - internal - 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 br.gov.frameworkdemoiselle.internal + 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. @@ -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: @ViewController, @BusinessController e @PersistenceController. - 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. - 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 Presentation Model - é 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). diff --git a/documentation/reference/pt-BR/excecao.xml b/documentation/reference/pt-BR/excecao.xml index 0d4cf12..0c49eb7 100644 --- a/documentation/reference/pt-BR/excecao.xml +++ b/documentation/reference/pt-BR/excecao.xml @@ -22,7 +22,7 @@ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd"> - br.gov.frameworkdemoiselle.internal.interceptor.ExceptionHandlerInterceptor + br.gov.frameworkdemoiselle.exception.ExceptionHandlerInterceptor ]]> diff --git a/documentation/reference/pt-BR/security.xml b/documentation/reference/pt-BR/security.xml index 3ecf432..74ce2b7 100644 --- a/documentation/reference/pt-BR/security.xml +++ b/documentation/reference/pt-BR/security.xml @@ -27,8 +27,8 @@ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd"> - br.gov.frameworkdemoiselle.internal.interceptor.RequiredPermissionInterceptor - br.gov.frameworkdemoiselle.internal.interceptor.RequiredRoleInterceptor + br.gov.frameworkdemoiselle.security.RequiredPermissionInterceptor + br.gov.frameworkdemoiselle.security.RequiredRoleInterceptor ]]> diff --git a/documentation/reference/pt-BR/transacao.xml b/documentation/reference/pt-BR/transacao.xml index 6cf1710..95a3603 100644 --- a/documentation/reference/pt-BR/transacao.xml +++ b/documentation/reference/pt-BR/transacao.xml @@ -34,7 +34,7 @@ http://java.sun.com/xml/ns/javaee/beans_1_0.xsd"> - br.gov.frameworkdemoiselle.internal.interceptor.TransactionalInterceptor + br.gov.frameworkdemoiselle.transaction.TransactionalInterceptor ]]> @@ -77,11 +77,15 @@ public class AbacaxiException {
O objeto Transaction - 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 TransactionContext em sua classe e obter a transação corrente.
-- libgit2 0.21.2