Framework Demoiselle Versão 2.

Transcrição

1 demoiselle_ Desenvolvimento Java EE 6 com Framework Demoiselle Versão 2. Mais leveza, reúso, flexibilidade e extensibilidade na nova versão do framework Java padrão do Governo Federal. Após quatro anos de existência, o framework Demoiselle já está estabelecido como padrão de desenvolvimento do Serpro, tem se tornado também a referência para desenvolvimento do governo de alguns Estados da Federação, assim como de algumas empresas privadas que viram nele não só a possibilidade de poder desenvolver para os órgãos públicos, mas também como uma ferramenta útil para atendimento de suas próprias demandas. Na edição de número 36 de 2009 desta revista foi publicada uma matéria sobre o framework Demoiselle, apresentando sua primeira série de versão e os objetivos a que se propunha, e desde então, com o apoio das críticas e sugestões, o projeto tem evoluído e agregado mais interessados em sua comunidade. Essa segunda série do projeto foi construída com base num processo aberto e colaborativo, onde foi aberto um fórum de discussões para receber as propostas da comunidade. O direcionamento para a aderência à especificação JEE6[ 4 ] foi um dos pilares do desenvolvimento. Desta forma, tanto a base núcleo da ferramenta como também os outros artefatos que são conhecidos como seus componentes foram renovados. Agora apresentamos o que há de novidades nos projetos. base nos estudos que foram feitos com outro framework Java para desenvolvimento Web chamado Plataforma Pinhão que foi desenvolvido pela Celepar[ 5 ] e que também chegou a ser usado pelo Serpro, mas que não foi evoluído pela criadora e naquele momento já não atendia completamente as necessidades do Serpro. No ano seguinte, em 2009, o projeto foi aberto para a comunidade através do ambiente colaborativo mais usado no mundo que é o SourceForge[ 6 ], e a partir deste fato todo o processo de planejamento e execução do desenvolvimento dos projetos têm como base as ferramentas oferecidas por este ambiente. No ano de 2010 foi aberto o processo de planejamento para versão 2, que envolveu a abertura de um fórum público no SourceForge para recebimento de sugestões, várias chamadas em todas as mídias digitais disponíveis e acessíveis ao projeto. Com base nestas sugestões foi implementada e entregue em dezembro de 2010 a primeira versão estável da série: a A partir desta data, várias melhorias foram feitas até chegar à versão atual, 2.2.2, na qual apresentamos aqui. Um pouco da história do projeto Para aqueles que não tiveram a oportunidade de ler na edição 36 de 2009, apresentamos aqui um pouco da cronologia do projeto, e os que já tiveram acesso poderão refrescar suas memórias. No ano de 2008 foi entregue pelo Serpro, ainda internamente, a primeira versão da ferramenta que foi criada com As novidades do projeto Lançado no final de dezembro de 2010, a série da versão 2 do framework Demoiselle, que foi criada em um processo aberto com a comunidade, foi completamente modificada com relação à série anterior. Conforme os anseios dos colaboradores, a premissa principal foi a aderência à especificação Java En- / 24

2 Emerson Sachio Saito Bacharel em Análise de Sistemas pela PUC-PR, com especialização em Tecnologia da Informação pela UFPR. Possui formação técnica em contabilidade. Trabalhou como analista de informática na Celepar (Companhia de Informática do Paraná) de 2001 a 2009, onde, entre outras atividades com a linguagem JAVA e outras tecnologias, foi um dos desenvolvedores do framework Pinhão [ 1 ]. Atualmente é analista de desenvolvimento no Serpro [ 2 ] (Serviço Federal de Processamento de Dados), onde faz parte da equipe de desenvolvimento do framework Demoiselle [ 3 ]. Renovado através de um processo aberto com a comunidade, uma das principais características do projeto, o Framework Demoiselle, na segunda versão, tornou-se mais leve e flexível. Adotando como princípio a aderência à especificação Java Enterprise Edition 6 (JSR-316), além de bem atualizada, a ferramenta passa a ser mais extensível e facilmente acoplável a outras soluções compatíveis com a JEE6, permitindo mais independência ao desenvolvedor. Por ser a plataforma padrão de desenvolvimento do Serpro Serviço Federal de Processamento de Dados, a nova versão da ferramenta faz com que a empresa cumpra seu papel de agente de inovação de TI do governo federal. Por ser uma ferramenta OpenSource (código aberto), também é uma agente da integração entre governo e sociedade, pois permite a participação de qualquer pessoa ou empresa no seu processo de desenvolvimento. Apresentamos aqui quais foram essas mudanças. terprise Edition 6, que trouxe diversas novidades e melhorias para os outros projetos que ela engloba, como, por exemplo, a Java Persistence API 2 (JPA2) [ 7 ], Java Server Faces 2 (JSF2)[ 8 ], Entreprise Java Beans 3.1 (EJB 3.1)[ 9 ], Contexts and Dependency Injection (CDI)[ 10 ], entre outras novidades. Outro direcionamento do desenvolvimento foi fazer uma ferramenta leve e flexível, e isso se traduz em um framework mais enxuto. Assim, a cada versão, o Demoiselle usa cada vez mais o que já está disponível no mercado e oferece apenas o que serve como auxílio para o desenvolvedor usar estas tecnologias de forma mais simplificada. O grande diferencial do projeto acaba sendo as ferramentas e componentes oferecidos pela comunidade e a própria comunidade que está se tornando um ambiente de colaboração mais eficiente com o aumento da participação dos interessados. Atendendo às contribuições e opiniões da comunidade durante o processo de definição da nova versão, houve algumas mudanças com relação à série da versão 1 que fazem com que o processo de migração entre elas não seja totalmente transparente para o desenvolvedor, pois a adoção de tecnologias ligadas a novas versões das especificações traz impacto direto no código java e, no caso do uso do JSF, nas páginas XHTML. Este foi um custo que foi pago para trazer melhor evolução ao projeto. E, para minimizar o impacto da migração, a comunidade disponibiliza um guia de mudanças para ajudar neste processo, e as experiências deste tipo que ocorrem no Serpro têm demonstrado que mesmo em casos de migração o esforço é compensado pelo ganho de flexibilidade e produtividade que a nova versão proporciona. Arquitetura do projeto Na atual versão a arquitetura do projeto está dividida em três partes: core, extensões e componentes, conforme representa a figura 1.» Core: contém as implementações das funções 25 \

3 Demoiselle V2 Demoiselle-Core <<Maven-Archetypes>> Demoiselle-Extension Demoiselle-JPA Demoiselle-JSF Demoiselle-JTA Demoiselle-SE Demoiselle-Report Demoisell Demoiselle-JUnit Demoiselle-Validation Demoiselle-Vaadin Demoiselle-Monitoring Demoiselle-Authorization Figura 1. Visão da arquitetura do Demoiselle. básicas para o funcionamento do Framework: suas classes utilitárias, controle de mensagens, configurações, exceções etc., e é fortemente baseado nos recursos do CDI. É também onde se encontram as definições das anotações para os estereótipos das camadas, pois o Demoiselle recomenda o uso do padrão MVC (Modelo, Visão e Controle) no desenvolvimento de aplicações.» Extensões: são funcionalidades dependentes do Core, mas de uso opcional, que implementam facilitadores para utilização de tecnologias aderentes ao JEE6, atualmente estão disponíveis extensões para:» JSF: fornece um conjunto de funcionalidades para uso na camada interface com o usuário da especificação JSF2, e provê também alguns templates de Managed Beans com funcionalidades básicas de listagem e edição. Para o uso dessa extensão, também está disponível um arquétipo Maven para geração da estrutura de uma aplicação.» JPA: facilitador para uso de controle de transação administrado pela aplicação e também um template com operações básicas do tipo CRUD: Create, Read, Update, Delete.» JTA: funcionalidade para delegação do controle de transação para um container JEE[ 11 ] conforme a especialização JTA[ 12 ].» Java Standard Edition (SE): extensão para uso do Demoiselle para desenvolvimento de aplicações Java do tipo Desktop (ex: Swing).» Componentes: recursos opcionais que podem não depender de nenhuma característica do Demoiselle, mas que são utilizados para agregar funcionalidades de implementações de terceiros, e por isso em muitos casos dependentes de fornecedores, que são comumente úteis para o desenvolvimento de aplicações. Até o presente momento temos:» Demoiselle-Report: baseado no JasperReports[ 13 ], é um facilitador para manipulação de relatórios.» Demoisell facilitador para envio de , baseado na API JavaMail[ 14 ], tem como diferencial a disponibilização de uma DSL (Domain Specific Language)[ 15 ] que simplifica ainda mais a manipulação do componente.» Demoiselle-JUnit: criado para possibilitar o uso da biblioteca Junit[ 16 ], ou seja, a execução de testes de unidade em projetos com CDI, mas em ambiente de desenvolvimento, como o Eclipse.» Demoiselle-Validation: este componente tem como principal objetivo fornecer um conjunto de validações aderentes com a JSR303, Bean Validation. São fornecidas algumas validações comuns a aplicações / 26

4 Figura 2. Quadro-resumo das mensagens na lista de usuários. brasileiras, como: CEP, CPF, CNPJ, Inscrição Estadual e PIS/PASEP. A utilização destas validações é bastante simples, devendo usar apenas @ no atributo do Bean que deve ser validado.» Demoiselle-Authorization: é uma iniciativa que visa a permitir a utilização de maneira simplificada do recurso de controle de autenticação e autorização, em tecnologia Java, conhecido como JAAS[ 17 ].» Demoiselle-Vaadin: o Vaadin[ 18 ] é um framework para construção de interfaces web. Apesar de usar o GWT como mecanismo para a exibição de seus componentes, eles têm algumas características que os diferenciam. No Vaadin, assim como no GWT, a construção da interface ocorre de forma bem semelhante ao modelo já conhecido no Swing/SWT: atrav és da composição de diversos componentes e usando apenas código Java. O objetivo deste componente é permitir o uso desta tecnologia com o Demoiselle, possibilitando o uso de Injeção de Dependência, além das demais funcionalidades já conhecidas do framework. Também são fornecidas funcionalidades extras que facilitam a criação de aplicações, voltadas a padrões de mercado bastante conhecidos. Um arquétipo Maven para geração da estrutura de uma aplicação usando este componente também é oferecido.» Demoiselle-Monitoring: é um componente para monitoração de aplicações em Java desenvolvidas com o Demoiselle. Como objetivo geral, o componente fornece mecanismos que possibilitam a uma aplicação Java responder as requisições provenientes de um servidor (modalidade polling) e enviar automaticamente notificações a um servidor (modalidade trapping). Atualmente, o componente suporta as seguintes tecnologias e padrões de monitoramento: JMX, SNMP e Zabbix. Impulso no crescimento da comunidade A versão do Demoiselle, primeira da séria, foi lançada no final de dezembro de 2010, e já no mês seguinte, o número de participações na lista de discussões atingiu um número maior que qualquer outro anterior desde a abertura do projeto no ambiente SourceForge (conforme ilustra a figura 2). Este número tem se mantido sempre superior, demonstrando que a nova versão trouxe maior interesse da comunidade. Vale lembrar que os funcionários do Serpro, fundador do projeto, raramente utilizam este canal de comunicação para procurar ajuda, pois contam com outros meios de suporte interno. A comunidade Demoiselle conta também com um portal de notícias que é independente do ambiente SourceForge, pois atualmente há outros recursos fora do SourceForge sendo utilizados pelo projeto e este portal faz o papel de direcionador e concentrador destes recursos. Outro fator que também demonstra o aumento da participação foi a mudança do repositório de fontes do projeto do ambiente SVN[ 19 ] no SourceForge para o GitHub[ 20 ]. Talvez alguns ainda não conheçam, mas o Git é um sistema de controle de versão distribuído com ênfase em velocidade e inicialmente projetado e desenvolvido por Linus Torvalds para o desenvolvimento do kernel Linux. O GitHub é um serviço web que oferece recursos baseados no Git. E pela sua forma de uso, é uma ferramenta muito mais democrática para colaboração entre desenvolvedores. No caso do Demoiselle, apesar de ainda discreta, a participação direta no código através do GitHub já ocorre, mas no repositório anterior, que era o SVN, não houve contribuições diretas, sendo apenas através de registros na ferramenta de BugTrack. O projeto tem sido representado em vários eventos de tecnologia Java e antes mesmo de ser entregue oficialmente, a versão 2 foi escolhida para ser apresentada durante o JavaOne Brasil de 2010, e também é frequente em eventos já consagrados no Brasil, 27 \

5 como o JustJava. E isso tem proporcionado um efeito positivo no interesse dos desenvolvedores pelo projeto. São vários os casos relatados, na lista de discussões, sobre trabalhos de conclusão de curso que usam o Demoiselle em algumas universidades e faculdades no País, o que demonstra também um bom interesse da área acadêmica. Disseminação do conhecimento Além da documentação de referência[ 21 ] que contém as instruções básicas para uso do framework Demoiselle, são disponibilizados materiais em formato de tutorias, geralmente acompanhados de videoaulas, que podem ser utilizados para auto-estudo e estão disponíveis no portal do projeto. Na confecção do material, tem se procurado inserir boas práticas de programação como o desenvolvimento orientado a testes, conhecido como TDD (Test Driven Development). Outra forma de disseminação é através de cursos de ensino à distância (EAD) utilizando a plataforma chamada Moodle[ 22 ]. Atualmente está disponível o curso Demoiselle 2 Introdução ao Desenvolvimento com Framework Demoiselle versão 2 e, através da lista de usuários, são divulgadas as aberturas de inscrições onde qualquer desenvolvedor interessado pode participar de forma gratuita. Também há planos para elaboração de cursos e tutoriais que abordem as principais tecnologias usadas em conjunto com o Demoiselle para desenvolvimento de soluções, que são os casos do Apache Maven, CDI, JSF2 e JPA2. O principal diferencial nesta modalidade é que o participante conta com o apoio de um tutor durante o curso e ao final é emitido um certificado. O desenvolvimento do framework tem se baseado em práticas ágeis, sendo o Scrum[ 23 ] a principal metodologia. Assim, o colaborador também acaba tendo contato com estas práticas ao participar do processo de desenvolvimento do Demoiselle. Ferramentas de apoio à configuração de ambiente Uma tarefa que parece ser bastante simples para o usuário experiente pode se tornar um verdadeiro desafio para o iniciante, que é a configuração do ambiente de desenvolvimento. Por padrão, o Demoiselle recomenda o software Eclipse como ambiente de desenvolvimento, e como em vários projetos do tipo JEE, é comum o uso de vários plugins de apoio que, no caso do Demoiselle, podemos citar o M2Eclipse[ 24 ], que é suporte para vários facilitadores disponibilizados pelo projeto como os arquétipos, e o JBoss Tools[ 25 ], que possui uma série de funcionalidades que ajudam no desenvolvimento do projeto. Mesmo com a conveniência que foi trazida com o Eclipse MarketPlace, ainda não é tão simples para o desenvolvedor inexperiente fazer a relação entre todos os plugins necessários e suas respectivas configurações. Também é preciso escolher um servidor de aplicações (atualmente o Demoiselle é testado com JBoss-AS e Apache-Tomcat) e configurá-lo no Eclipse. Pensando neste público, a comunidade Demoiselle dispõe de um projeto chamado Demoiselle-Infra[ 26 ], que tem por objetivo criar formas de simplificar esse trabalho de criação de ambiente. A forma mais simples de todas é através de uma imagem de DVD que contém uma distribuição do Linux-Ubuntu já com o ambiente de desenvolvimento instalado e configurado para uso. A imagem pode ser baixada diretamente do SourceForge no link indicado acima e também é possível conseguir a mídia junto à comunidade principalmente em eventos onde o projeto é apresentado. Para sistemas operacionais do tipo Linux que operam com pacotes de instalação do tipo Debian (.deb), como é o caso do próprio Debian, Ubuntu, Mint etc., com a colaboração da Universidade Federal do Paraná, é disponibilizado um repositório contendo os pacotes necessários para a criação e configuração do ambiente de desenvolvimento, que pode ser feito através do famoso apt-get install ou o aplicativo Synaptic. Para distribuições Linux que usam pacotes.rpm, são feitas versões convertidas dos pacotes e colocados para download no Sourceforge. Para o sistema operacional MS-Windows, existe alguns instaladores para algumas das versões mais utilizadas, e que também estão disponíveis para download na área do Sourceforge. Novo patrocinador Que o framework Demoiselle é um projeto Open- Source e possui uma comunidade livre, não há dúvidas. Mas alguns questionam sobre o projeto ser um produto oferecido pelo Governo e, portanto, só serviria para Governo. Aqueles que acompanharem a comunidade através de alguns dos seus canais de comunicação logo perceberão que há bastante participação de pessoas e entidades que não têm relação alguma com o governo e que simplesmente encontraram um produto e uma comunidade onde podem confiar para desenvolverem suas soluções. O Serpro foi o fundador do projeto e, pela organização da comunidade que sempre foi pública e aberta[ 27 ], se posicionou como o primeiro patrocinador e por algum tempo o único. Durante uma etapa de um evento que foi promovido pela comunidade, e que aconteceu em Recife-PE no dia 15 de maio de 2012, foi oficializado o segundo patrocinador do projeto, que é a empresa BankSystem[ 28]. Os técnicos desta empresa já haviam se tornado assíduos na lista de usuários e fóruns do projeto por orientação da sua direção, que começou a usar o fra- / 28

6 mework Demoiselle para prestar serviços para o Estado de Pernambuco, e adotou o projeto de tal forma que se tornou um padrão de desenvolvimento dela para suas soluções e, diante desse cenário, resolveu se inserir de forma mais próxima do projeto se tornando um patrocinador. A IDE Eclipse, que é a ferramenta de desenvolvimento padrão do projeto, é um bom exemplo de um projeto que foi concebido por uma organização, que foi a IBM, depois liberada para comunidade e que foi amadurecendo ao ponto de hoje ser totalmente independente. O Serpro não possui mecanismos de fazer algo como a IBM que, além de liberar o código, ainda aportou uma considerável quantia de fundos para que a comunidade pudesse se manter sozinha, mas cumpre seu papel de instituição pública ao tornar o projeto público e criar mecanismos para que ele se torne independente. Atualmente, o Serpro mantém alguns recursos dedicados ao projeto, primeiramente por interesse próprio, pois é a sua plataforma padrão de desenvolvimento de soluções, e também com o papel de atuar junto e com comunidade para cumprir também seu papel de patrocinador. Com a chegada de novos patrocinadores, a tendência é que o projeto se torne cada vez mais uma ótima alternativa para o apoio ao desenvolvedor. Um exemplo prático Ambiente de desenvolvimento utilizado Como já foi comentado, existe um projeto que provê formas de montagem automática do ambiente de desenvolvimento. E caso queira reproduzir este exemplo, vamos listar os softwares necessários para o caso, e que fazem parte do ambiente que foi utilizado:» Eclipse IDE 3.7 (Indigo), com os plugins: Jboss- -tools, M2E (Maven to Eclipse) e Demoiselle- -Nimble. Com catálogo de arquétipo remoto configurado para: Servidor de aplicações JBoss-AS 6.1 ou Jboss- -AS 7.1 (a partir da versão 2.3 do Demoiselle). Note que um dos plugins do Eclipse é um produto desenvolvido pela comunidade Demoiselle, que é chamado Demoiselle-Nimble. Esse subprojeto é uma iniciativa de criar uma ferramenta para geração automática do código comum e repetitivo, que geralmente toma certo tempo do desenvolvedor e não é o objetivo principal do desenvolvimento. A ferramenta é desenvolvida com a linguagem Groovy[ 29 ] e utiliza templates Apache-Velocity. E como as aplicações estão baseadas no framework, é possível criar várias partes da aplicação, pois estarão em um formato bem definido. Mas também é possível criar templates para geração de qualquer tipo de aplicação, desde que haja um padrão de construção. Gerando uma aplicação de exemplo O primeiro passo é criar uma aplicação com o arquétipo maven disponibilizado pelo Demoiselle, através da ferramenta Eclipse nos menus: File > New > Project > Maven Project. Selecionamos o arquétipo: demoiselle-jsf-jpa, conforme exemplificado na figura 3. Figura 3. Selecionando o arquétipo demoiselle-jsf-jpa. Isso significa que nossa aplicação usará o JSF como camada de apresentação. Em seguida, informamos os dados da aplicação no estilo gerenciado pelo Apache-Maven: Group Id, Artifact Id e Version. A partir destas informações, o plugin gera no nome do pacote para a aplicação, conforme pode ser visto na figura 4. Figura 4. Informando os dados da aplicação. Isso é suficiente para criar a estrutura do projeto com os artefatos necessários e o Apache Maven fará o gerenciamento das bibliotecas. Na figura 5, pode-se ver o resultado. 29 \

7 primeira tag persistence-unit do arquivo e excluiremos todas as outras que estão comentadas. Em seguida editaremos o arquivo POM.XML para incluir o componente Demoiselle-validation, acrescentando as linhas abaixo: Listagem 1. Linhas para incluir no arquivo POM.XML: <dependency> <groupid>br.gov.frameworkdemoiselle.component </groupid> <artifactid>demoiselle-validation</artifactid> <scope>compile</scope> </dependency> <dependency> <groupid>org.hibernate</groupid> <artifactid>hibernate-validator</artifactid> <scope>compile</scope> </dependency> Figura 5. Aplicação criada pelo arquétipo demoiselle-jsf-jpa. O arquétipo nesta versão já cria uma aplicação de exemplo usando a biblioteca PrimeFaces 3, como implementação para JSF. Basta incluí-la no servidor de aplicações (no caso o Jboss 6.1) e executá-lo, o resultado é o mostrado na figura 6. Agora vamos preparar algumas classes para executar o nosso gerador de códigos, que é o Demoiselle- -Nimble. Dentro do pacote chamado domain, criaremos as seguintes classes: Listagem 2. Implementação da classe Pessoa.java: package br.org.frameworkdemoiselle.exemplo. domain; import java.util.date; import javax.persistence.column; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.mappedsuperclass; import javax.persistence.temporal; import javax.persistence.temporaltype; import br.gov.frameworkdemoiselle.validation. public abstract class private private String cpf; Figura 6. Aplicação de exemplo funcionando. Para continuar o exemplo, primeiro vamos verificar o arquivo de configuração chamado persistence. xml, do diretório /src/main/resources, e é o arquivo usado pelo JPA para estabelecer a conexão e configuração com o banco de dados. O arquétipo já traz uma série de exemplos comentados para que o desenvolvedor possa escolher o que melhor lhe atende. Neste exemplo usaremos a configuração default que é = false, length = 255) private String = = TemporalType.DATE) private Date datanascimento; public void setid(long id) { this.id = id; / 30

8 public void setcpf(string cpf) { this.cpf = cpf; public String getcpf() { return cpf; public void setdatanascimento(date datanascimento) { this.datanascimento = datanascimento; public Date getdatanascimento() { return datanascimento; public Long getid() { return id; public void setnome(string nome) { this.nome = nome; public String getnome() { return nome; Listagem 3. Implementação da classe Contato.java: package br.org.frameworkdemoiselle.exemplo.domain; import java.io.serializable; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.table; public int getnumerotelefone() { return numerotelefone; public void setnumerotelefone(int numerotelefone) { this.numerotelefone = numerotelefone; Perceba que as classes das Listagens 2 e 3 estão apenas com anotações padrão da especificação JPA. Poderia ser utilizado, por exemplo, uma ferramenta que faz esse tipo de mapeamento diretamente de uma base de dados já existente. Portanto, o Demoiselle procura não interferir nas soluções que já estão estabelecidas. Em seguida, voltamos para o ambiente Eclipse e executaremos o Nimble, que é acionado por um ícone na barra de ferramentas conforme mostrado na figura 7. Figura 7. Ícone acionador da ferramenta Demoiselle-Nimble. Ao clicar no acionador, a tela da ferramenta deverá ser apresentada, onde devermos escolher um dos templates distribuídos com o plugin na IDE Eclipse. Perceba que são apresentadas várias opções, pois estão disponíveis templates para geração de artefatos para a série anterior da versão do Demoiselle e também para outras versões da biblioteca PrimeFaces. Escolheremos a opção para CRUD com Primefaces 3[ 30 ], conforme pode ser visto na Contato ) public class Contato extends Pessoa implements Serializable { private static final long serialversionuid = private String private int numerotelefone; public String get () { return ; public void set (string ) { this. = ; Figura 8. Escolhendo um template. Na tela seguinte, mostrada na figura 9, deveremos informar os itens:» Output Folder: o diretório da aplicação no workspace do Eclipse.» Package Name: nome do pacote principal da aplicação.» Entity Name: nome da entidade (uma classe do pacote domain). 31 \

9 package br.org.frameworkdemoiselle.exemplo.business; Figura 9. Informação de dados para geração de código. Ao clicar no botão Finish, serão gerados todos os artefatos necessários para uma operação CRUD simples segundo o padrão do Demoiselle. No pacote sugerido como o da camada de persistência será gerada uma classe, vista na Listagem 4, com o sufixo DAO. Listagem 4. Implementação da classe ContatoDAO. java: package br.org.frameworkdemoiselle.exemplo. persistence; import javax.inject.inject; import org.slf4j.logger; import br.gov.frameworkdemoiselle.stereotype. PersistenceController; import br.gov.frameworkdemoiselle. template.jpacrud; import br.org.frameworkdemoiselle.exemplo.domain. public class ContatoDAO extends JPACrud<Contato, Long> { private static final long serialversionuid unused ) private Logger logger; Esta classe estende a classe de template fornecida pelo Demoiselle chamada JPACrud que já contém as funcionalidades básicas de criação, recuperação, atualização e exclusão de dados, e os tipos genéricos são o nome da entidade e o tipo da chave identificadora da entidade. A classe recebe a PersistenceController que é o estereótipo que a identifica como uma classe da camada de persistência. É incluído também um código de injeção de uma classe de log, somente como orientação de exemplo. No pacote de sugestão de camada de negócios, encontraremos uma classe, vista na Listagem 5, com o sufixo BC. Listagem 5. Implementação da classe ContatoBC. java: import br.gov.frameworkdemoiselle.stereotype. BusinessController; import br.gov.frameworkdemoiselle.template. DelegateCrud; import br.org.frameworkdemoiselle.exemplo.domain. Contato; import br.org.frameworkdemoiselle.exemplo.persistence. public class ContatoBC extends DelegateCrud<Contato, Long, ContatoDAO> { private static final long serialversionuid = 1L; Aqui vemos apenas a extensão da classe de template chamada DelegateCrud, cujos tipos genéricos são a classe de entidade, o tipo da chave identificadora da entidade e a classe de persistência. A classe recebe a que é o estereótipo que a identifica como uma classe da camada de negócios. E no pacote sugerido como o de camada de visão, encontraremos duas classes com sufixo MB: uma que implementa a funcionalidade de apresentação dos dados da entidade (Listagem 6) e outra (Listagem 7) para manipulação dos dados. Listagem 6. Implementação da classe Contato- ListMB.java: package br.org.frameworkdemoiselle.exemplo.view; import java.util.iterator; import java.util.list; import javax.inject.inject; import br.gov.frameworkdemoiselle.annotation. NextView; import br.gov.frameworkdemoiselle.annotation. PreviousView; import br.gov.frameworkdemoiselle.stereotype. ViewController; import br.gov.frameworkdemoiselle.template. AbstractListPageBean; import br.gov.frameworkdemoiselle.transaction. Transactional; import br.org.frameworkdemoiselle.exemplo.business. ContatoBC; import /contato_edit.xhtml /contato_list.xhtml ) / 32

10 public class ContatoListMB extends AbstractListPageBean<Contato, Long> { private static final long serialversionuid = private ContatoBC protected List<Contato> handleresultlist() { return this.contatobc.findall(); public String deleteselection() { boolean delete; for (Iterator<Long> iter = getselection().keyset().iterator(); iter.hasnext();) { Long id = iter.next(); delete = getselection().get(id); if (delete) { contatobc.delete(id); iter.remove(); return getpreviousview(); A classe da Listagem 6 estende a classe de template chamada AbstractListPageBean que já contém algumas funcionalidades básicas de recuperação de dados, como paginação, por exemplo, e que por estarem nesta camada poderão ser acionadas pelas páginas JSF (.xhtml). Os tipos genéricos são o nome da entidade e o tipo da chave identificadora da entidade. A classe recebe a que é o estereótipo que a identifica como uma classe da camada de visão e também como um ManagedBean da especificação JSF. As PreviousView são facilitadores para a navegação no novo padrão JSF2, onde não é preciso editar o arquivo faces-config.xml. É incluído também um método para execução da listagem dos dados na página JSF e outro para exclusão de um item que pode ser selecionado de um componente JSF (Primefaces). Listagem 7. Implementação da classe ContatoEditMB.java: package br.org.frameworkdemoiselle.exemplo.view; import javax.inject.inject; import br.gov.frameworkdemoiselle.annotation. PreviousView; import br.gov.frameworkdemoiselle.stereotype. ViewController; import br.gov.frameworkdemoiselle.template. AbstractEditPageBean; import br.gov.frameworkdemoiselle.transaction. Transactional; import br.org.frameworkdemoiselle.exemplo.business. ContatoBC; import br.org.frameworkdemoiselle.exemplo.domain. Contato; package br.org.frameworkdemoiselle.exemplo.view; import javax.inject.inject; import br.gov.frameworkdemoiselle.annotation. PreviousView; import br.gov.frameworkdemoiselle.stereotype. ViewController; import br.gov.frameworkdemoiselle.template. AbstractEditPageBean; import br.gov.frameworkdemoiselle.transaction. Transactional; import br.org.frameworkdemoiselle.exemplo.business. ContatoBC; import /contato_list.xhtml ) public class ContatoEditMB extends AbstractEditPageBean<Contato, Long> { private static final long serialversionuid = private ContatoBC public String delete() { this.contatobc.delete(getid()); return public String insert() { this.contatobc.insert(getbean()); return public String update() { this.contatobc.update(getbean()); return protected void handleload() { setbean(this.contatobc.load(getid())); A classe da Listagem 7 estende a classe de template chamada AbstractEditPageBean, que já contém algumas funcionalidades básicas que auxiliam na manipulação de dados, como o FacesContext, por exemplo. O template usado recebe os parâmetros que são o nome da entidade e o tipo da chave identificadora da entidade. Os métodos padrão foram sobrescritos para 33 \

11 adicionar as funcionalidades de navegação no padrão JSF2, e exemplificar que podem ser incluídas outras funcionalidades. O Demoiselle-Nimble altera os arquivos persistence.xml, para incluir o mapeamento da classe de domínio, e o message.properties, para gerar os textos de mensagens que poderão ser customizadas e/ou internacionalizadas. Também são geradas as páginas JSF (.xhtml) correspondentes às classes da camada de visão (Listagens 6 e 7). Para exemplificar, apresentamos apenas a página de edição (Listagem 8), pois excetuando-se os parâmetros o restante são tags do core JSF e da biblioteca Primefaces. Listagem 8. Página JSF gerada pelo Demoiselle- -Nimble, contato_edit.xhml: <ui:composition xmlns= w3.org/1999/xhtml xmlns:f= xmlns:p= xmlns:h= xmlns:ui= template= /template/main.xhtml > <ui:define name= body > <h:form prependid= false > <p:toolbar> <p:toolbargroup align= left > <p:commandbutton value= #{messages[ button.save ] action= #{contatoeditmb.insert rendered= #{!contatoeditmb.updatemode ajax= false /> <p:commandbutton value= #{messages[ button.save ] action= #{contatoeditmb.update rendered= #{contatoeditmb.updatemode ajax= false /> <p:commandbutton value= #{messages[ button.delete ] onclick= confirmation.show() rendered= #{contatoeditmb.updatemode type= button immediate= true ajax= false /> <p:confirmdialog message= #{messages[ label.confirm.delete ] showeffect= bounce hideeffect= explode header= #{messages[ label.dialog.delete ] severity= alert widgetvar= confirmation > <h:commandbutton value= #{messages[ button.dialog.yes ] action= #{contatoeditmb.delete immediate= true ajax= false /> <h:commandbutton value= #{messages[ button.dialog.no ] onclick= confirmation.hide() type= button /> </p:confirmdialog> </p:toolbargroup> </p:toolbar> <br /> <p:fieldset > 1 Projeto Pinhão: > 2 Serpro: > 3 Portal do Projeto Demoiselle frameworkdemoiselle.gov.br/ > 4 Especificação do JEE6 > 5 Celepar > 6 Projeto no SourceForge demoiselle/ > 7 Especificação da JPA2 > 8 Especificação do JSF2 > 9 Especificação do EJB communityprocess/final/jsr318/index.html > 10 Especificação do CDI > 11 JEE Conteiners tutorial/doc/overview4.html > 12 JTA ( index.html) > 13 JasperReports jasperreports > 14 Java Mail javamail/index.html / 34

12 legend= #{messages[ contato.label ] toggleable= true togglespeed= 500 > <h:panelgrid id= fields columns= 3 > <h:outputlabel value= #{messages[ contato.label. ]: for= styleclass= text-input /> <h:inputtext id= value= #{contatoeditmb.bean. title= #{messages[ contato.alt. ] /> <p:message for= /> <h:outputlabel value= #{messages[ contato. label.numerotelefone ]: for= numerotelefone styleclass= text-input /> <h:inputtext id= numerotelefone value= #{contatoeditmb.bean.numerotelefone title= #{messages[ contato.alt.numerotelefone ] /> <p:message for= numerotelefone /> <h:outputlabel value= #{messages[ contato.label.id ]: for= id styleclass= text-input /> <h:outputtext id= id value= #{contatoeditmb.bean.id /> <p:message for= id /> <h:outputlabel value= #{messages[ contato.label.nome ]: for= nome styleclass= text-input /> <h:inputtext id= nome value= #{contatoeditmb.bean.nome title= #{messages[ contato.alt.nome ] /> <p:message for= nome /> <h:outputlabel value= #{messages[ contato.label.cpf ]: for= cpf styleclass= text-input /> <h:inputtext id= cpf value= #{contatoeditmb.bean.cpf title= #{messages[ contato.alt.cpf ] /> <p:message for= cpf /> <h:outputlabel value= #{messages[ contato.label.datanascimento ]: for= datanascimento styleclass= text-input /> <p:calendar id= datanascimento value= #{contatoeditmb.bean.datanascimento pattern= #{messages[ label.date.pattern ] navigator= true showbuttonpanel= true locale= #{currentlocale title= #{messages[ contato.alt.datanascimento ] /> <p:message for= datanascimento /> </h:panelgrid> </p:fieldset> </h:form> </ui:define> </ui:composition> /referências > 15 Domain Specific Language Domain-specific_language > 16 JUnit > 17 JAAS security/jaas/jaasrefguide.html > 18 VAADIN > 19 SVN > 20 GitHub > 21 Documentação de referência do Demoiselle demoiselle.sourceforge.net/docs/ > 22 EAD Demoiselle > 23 Scrum > 24 Maven to Eclipse > 25 JBoss Tools > 26 Demoiselle-Infra infra/site/ > 27 Constituição da Comunidade apps/mediawiki/demoiselle/index.php?title=comunidade > 28 BankSystem > 29 Linguagem Groovy > 30 PrimeFaces 35 \

13 Considerações finais Sabemos que o Podemos verificar o resultado final nas figuras 10 e 11. Mesmo se tratando de um exemplo bem simplificado é possível verificar algumas facilidades que o Demoiselle pode trazer ao processo de desenvolvimento. projeto está em fase de amadurecimento e ainda tem muito a evoluir, e é isso que tem acontecido na medida do possível. Esperamos que este artigo possa ter mostrado um pouco como a ferramenta tem melhorado, com o apoio dos usuários e colaboradores, durante esses poucos anos de existência e como um projeto OpenSource está aberto a qualquer colaboração. A comunidade Demoiselle procura criar não só boas ferramentas de apoio ao desenvolvedor, mas também um ambiente colaborativo e incentivador onde as pessoas podem encontrar ajuda e preparação. E muito menos é nossa intenção criar a melhor e definitiva ferramenta de apoio ao desenvolvedor. O que oferecemos é uma boa alternativa e uma oportunidade de participar de uma comunidade aberta e nacional. Quem tiver interesse em conhecer mais, está convidado a visitar o nosso portal e, caso queira, participar da lista de discussões. /para saber mais Figura 10. Tela de listagem de contatos. > Na edição número 40 (março/2010) desta revista, o Java EE 6 foi destaque da capa e também trouxe alguns artigos que trataram algumas das principais especificações que fazem parte da plataforma JEE 6: A revolução do Java EE 6, Um overview sobre as novidades da JSR 316, páginas 30 a 34, de Pedro Henrique S. Mariano. CDI Injeção de Dependências e Gerenciamento de Contextos no Java EE 6, fala sobre a JSR 299 que é um recurso bastante utilizado pelo Demoiselle, páginas 35 a 45, de Alessandro Lazarotti. Figura 11. Tela de edição de contatos. As Novidades do JSF 2.0, que é tecnologia padrão para camada de apresentação da JEE 6, e aborda sobre as características e vantagens em relação à versão anterior, páginas 46 a 50, de Sérgio Lopes. / 36