diff --git a/documentation/quickstart/pt-BR/authorgroup.xml b/documentation/quickstart/pt-BR/authorgroup.xml index 8559022..073205b 100755 --- a/documentation/quickstart/pt-BR/authorgroup.xml +++ b/documentation/quickstart/pt-BR/authorgroup.xml @@ -4,6 +4,10 @@ Emerson + Oliveira + + + Emerson Saito diff --git a/documentation/quickstart/pt-BR/bookinfo.xml b/documentation/quickstart/pt-BR/bookinfo.xml index eef54c3..33d40b9 100644 --- a/documentation/quickstart/pt-BR/bookinfo.xml +++ b/documentation/quickstart/pt-BR/bookinfo.xml @@ -2,7 +2,7 @@ - Framework Demoiselle 2.3 + Framework Demoiselle 2.3.0 QuickStart diff --git a/documentation/quickstart/pt-BR/criacao.xml b/documentation/quickstart/pt-BR/criacao.xml index 0e01b53..e288366 100644 --- a/documentation/quickstart/pt-BR/criacao.xml +++ b/documentation/quickstart/pt-BR/criacao.xml @@ -7,7 +7,7 @@
Nossa primeira aplicação - Para iniciar o uso do Demoiselle Framework 2.3, criaremos uma aplicação + Para iniciar o uso do Demoiselle Framework, criaremos uma aplicação Java do tipo Web utilizando o Apache Maven, através do plugin para IDE Eclipse (M2Eclipse) para gerenciar todo o clico de vida do Projeto, desde a criação até o deploy. @@ -66,7 +66,7 @@ - A versão do arquétipo irá variar conforme surjam novas versões do Demoiselle. A imagem deste guia apresenta a versão 2.3, contudo, + A versão do arquétipo irá variar conforme surjam novas versões do Demoiselle. A imagem deste guia apresenta a versão 2.3.0, contudo, fique sempre atento para as novas versões do Demoiselle em nosso site e sempre utilize a versão do arquétipo mais recente. @@ -116,8 +116,7 @@
- Ao término do processo será criado o projeto bookmark gerenciado - pelo Maven e com a seguinte estrutura de diretórios: + Ao término do processo será criado o projeto bookmark gerenciado pelo Maven e com a seguinte estrutura de diretórios: - -
- Entidade de Domínio + Entidade de domínio Dentro do pacote br.gov.frameworkdemoiselle.sample.bookmark.domain foi criada a classe Bookmark, a qual será responsável por representar um objeto de bookmark a ser persistido no banco de dados usando JPA: - + Os dois construtores da classe Bookmark serão utilizados posteriormente na aplicação. @@ -258,31 +250,29 @@
- Camada de Persistência + Camada de persistência Dentro do pacote br.gov.frameworkdemoiselle.sample.bookmark.persistence foi criada a classe BookmarkDAO, a qual será responsável por manipular os dados: - { - - private static final long serialVersionUID = 1L; - - } - ]]> + { + + private static final long serialVersionUID = 1L; + +}]]> A anotação @PersistenceController trata-se de um estereótipo fornecido - pelo Demoiselle Framework 2 para indicar que uma classe será tratada + pelo Demoiselle Framework para indicar que uma classe será tratada como controlador da camada de persistência na aplicação. A classe abstrata JPACrud faz parte do código de suporte fornecido pelo - Demoiselle Framework 2 (especificamente na extensão JPA). Ao utilizá-la, + Demoiselle Framework (especificamente na extensão JPA). Ao utilizá-la, o desenvolvedor não precisará implementar métodos de manipulação de uma entidade, tais como busca, listagem, inclusão, alteração e exclusão de registros. Dessa forma, apenas métodos específicos do caso de uso necessitam ser criados manualmente. @@ -296,7 +286,7 @@ No diretório /src/main/resources/META-INF/ foi criado o arquivo persistence.xml utilizado para armazenar as configurações de acesso ao banco de dados via JPA (conexões controladas por um JPA Provider, ex: Hibernate) - ou JTA (conexões controladas pelo Application Server, ex: JBossAS) e, como pode ser observado, o Demoiselle Framework 2 + ou JTA (conexões controladas pelo Application Server, ex: JBossAS) e, como pode ser observado, o Demoiselle Framework já traz neste arquivo vários exemplos de configurações para os mais distintos Application Servers, como: JBoss AS7, JBoss AS6, GlassFish 3, Tomcat 6 e Tomcat7. @@ -304,29 +294,31 @@ O projeto criado pelo arquétipo demoiselle-jsf-jpa já vem configurado para usar conexão JPA com o HSQLDB, conforme código abaixo: - - - - - java:jboss/datasources/ExampleDS - - br.gov.frameworkdemoiselle.sample.bookmark.domain.Bookmark - - - - - - - - - ]]> + + + + + java:jboss/datasources/ExampleDS + + br.gov.frameworkdemoiselle.sample.bookmark.domain.Bookmark + + + + + + + + + +]]>
- Camada de Negócio + Camada de negócio Dentro do pacote br.gov.frameworkdemoiselle.sample.bookmark.business foi criada a classe BookmarkBC, a qual será responsável por gerenciar as regras de negócio referentes aos bookmarks: @@ -334,9 +326,9 @@ { - + private static final long serialVersionUID = 1L; - + @Startup @Transactional public void load() { @@ -363,13 +355,13 @@ public class BookmarkBC extends DelegateCrud { A anotação @BusinessController trata-se de um estereótipo fornecido - pelo Demoiselle Framework 2 para indicar que uma classe será tratada + pelo Demoiselle Framework para indicar que uma classe será tratada como controlador da camada de negócio na aplicação. A classe DelegateCrud faz parte do código de suporte fornecido pelo - Demoiselle Framework 2. Ao utilizá-la, o desenvolvedor não precisará + Demoiselle Framework. Ao utilizá-la, o desenvolvedor não precisará implementar métodos de negócio triviais de uma entidade e tampouco programar a injeção de dependência entre as camadas de negócio e persistência. Tal injeção será realizada de forma implícita. @@ -382,7 +374,7 @@ public class BookmarkBC extends DelegateCrud {
- Camada de Apresentação + Camada de apresentação Dentro do pacote package br.gov.frameworkdemoiselle.sample.bookmark.view foram criadas as classes BookmarkEditMB e BookmarkListMB, onde a primeira é responsável @@ -425,7 +417,6 @@ public class BookmarkEditMB extends AbstractEditPageBean { protected void handleLoad() { setBean(this.bookmarkBC.load(getId())); } - }]]> @@ -458,13 +449,12 @@ public class BookmarkListMB extends AbstractListPageBean { } return getPreviousView(); } - }]]> A anotação @ViewController trata-se de um estereótipo fornecido - pelo Demoiselle Framework 2 para indicar que uma classe será tratada + pelo Demoiselle Framework para indicar que uma classe será tratada como controlador da camada de apresentação (i.e., visão) na aplicação. @@ -479,13 +469,13 @@ public class BookmarkListMB extends AbstractListPageBean { A anotação @Transactional trata-se de uma anotação fornecida pelo - Demoiselle Framework 2 para indicar que o método em questão + Demoiselle Framework para indicar que o método em questão será incluído na sessão transacional. Caso essa anotação esteja vinculada na classe, todos os seus métodos serão considerados transacionais. As classes AbstractEditPageBean e AbstractListPageBean fazem parte - do código de suporte fornecido pelo Demoiselle Framework 2 (especificamente na extensão JSF). + do código de suporte fornecido pelo Demoiselle Framework (especificamente na extensão JSF). Ao utilizá-las, o desenvolvedor não precisará implementar métodos específicos de navegação para uma tela de cadastro (i.e., do tipo CRUD). diff --git a/documentation/quickstart/pt-BR/images/new-maven-project02.png b/documentation/quickstart/pt-BR/images/new-maven-project02.png index aaea537..07042a7 100644 Binary files a/documentation/quickstart/pt-BR/images/new-maven-project02.png and b/documentation/quickstart/pt-BR/images/new-maven-project02.png differ diff --git a/documentation/quickstart/pt-BR/master.xml b/documentation/quickstart/pt-BR/master.xml index 4c51b10..9a1c631 100644 --- a/documentation/quickstart/pt-BR/master.xml +++ b/documentation/quickstart/pt-BR/master.xml @@ -7,10 +7,4 @@ - - - - + \ No newline at end of file diff --git a/documentation/quickstart/pt-BR/melhoria.xml b/documentation/quickstart/pt-BR/melhoria.xml index 899af07..c7a79ea 100644 --- a/documentation/quickstart/pt-BR/melhoria.xml +++ b/documentation/quickstart/pt-BR/melhoria.xml @@ -9,7 +9,7 @@ Exibindo mensagens para o usuário Uma vez que o objetivo principal da aplicação foi concluído (i.e., listagem e edição de bookmarks), - veremos algumas funcionalidades adicionais fornecidas pelo Demoiselle Framework 2, + veremos algumas funcionalidades adicionais fornecidas pelo Demoiselle Framework, iniciando pelo tratamento de mensagens. @@ -18,14 +18,15 @@ exibidas ao usuário: - + + - A unidade básica de manipulação de mensagens no Demoiselle Framework 2 + A unidade básica de manipulação de mensagens no Demoiselle Framework é a interface Message. Ou seja, basta que esta última seja implementada na aplicação para que o contexto de mensagens possa manipulá-la. A classe DefaultMessage é oferecida como implementação padrão dessa interface. @@ -56,30 +57,30 @@ bookmark-update-ok=Bookmark atualizado: {0}]]> { +public class BookmarkBC extends DelegateCrud { - @Inject - private MessageContext messageContext; - - ... +@Inject +private MessageContext messageContext; - @Override - public void insert(Bookmark bookmark) { - super.insert(bookmark); - messageContext.add(InfoMessages.BOOKMARK_INSERT_OK, bookmark.getDescription()); - } - - @Override - public void update(Bookmark bookmark) { - super.update(bookmark); - messageContext.add(InfoMessages.BOOKMARK_UPDATE_OK, bookmark.getDescription()); - } - - @Override - public void delete(Long id) { - super.delete(id); - messageContext.add(InfoMessages.BOOKMARK_DELETE_OK, id); - } +... + +@Override +public void insert(Bookmark bookmark) { + super.insert(bookmark); + messageContext.add(InfoMessages.BOOKMARK_INSERT_OK, bookmark.getDescription()); +} + +@Override +public void update(Bookmark bookmark) { + super.update(bookmark); + messageContext.add(InfoMessages.BOOKMARK_UPDATE_OK, bookmark.getDescription()); +} + +@Override +public void delete(Long id) { + super.delete(id); + messageContext.add(InfoMessages.BOOKMARK_DELETE_OK, id); +} }]]> @@ -143,14 +144,14 @@ bookmark-update-ok=Bookmark atualizado: {0}]]> do projeto bookmark e inclua nele a seguinte dependência: - - ... - - org.hibernate - hibernate-validator - 4.3.0.Final - - ]]> + + ... + + org.hibernate + hibernate-validator + 4.3.0.Final + +]]> @@ -172,27 +173,27 @@ bookmark-update-ok=Bookmark atualizado: {0}]]> - + -- libgit2 0.21.2