Demoiselle Tutorial Módulo 1 Arquitetura Vanderson Botelho da Silva (SERPRO/SUPST/STCTA) Emerson Sachio Saito (SERPRO/CETEC/CTCTA) Flávio Gomes da Silva Lisboa (SERPRO/CETEC/CTCTA) Serge Normando Rehem (SERPRO/CETEC/CTSDR) 18 de março de 2010 1 Laboratório 1 - Arquitetura e configuração Este laboratório tem por objetivo fixar os conceitos abordados no Módulo 01 do tutorial que trata as questões de arquitetura do Framework Demoiselle e orientar o processo de instalação e configuração do ambiente de desenvolvimento e das aplicações instanciadas por ele. Caso esteja optando por não utilizar a ferramenta MAVEN, utilize o documento Demoiselle-Tutorial-Modulo01-Arquitetura-Anexo-I, ao invés deste. Para o bom andamento deste laboratório, espera-se que o ambiente do desenvolvedor contenha os software listados na Tabela 1. Software Versão Objetivo Compilador Java (JDK) 1.5.0 17 1 Compilação dos projetos Eclipse Ganymede 3.4.2 IDE para desenvolvimento AspectJ for Eclipse 1.6.4 Compilação de aspectos Maven Integration for Eclipse 0.9.7 1 Integração com projetos Maven Servidor de Aplicação Tomcat 6.0.18 Servidor de aplicação Web Demoiselle Wizard 1.0.2 Gerar código da aplicação Jboss Tools 3.0 Acessórios para desenvolvimento Tabela 1: Software necessario no ambiente de desenvolvimento Os objetivos específicos desse laboratório são: Criar e configurar projetos via arquétipo Maven; Criar projeto do tutorial (projeto que terá continuidade nos demais laboratórios); Configurar projeto via Demoiselle Wizard. 1 Versão mínima 1
1.1 Instalação e configuração do Ambiente Para instalar e configurar o ambiente de desenvolvimento, execute os passos abaixo: 1. Baixar e instalar a JDK JAVA (http://java.sun.com/javase/downloads/ index_jdk5.jsp), também é possível utilizar JAVA 6, mas mantendo a compatibilidade com JAVA 5. 2. Baixar e instalar a IDE Eclipse Ganymede (http://www.eclipse.org/ ganymede/). 3. Inicie o uso do Eclipse. 4. Já na interface do Eclipse utilize a opção de Software Updates: Menu Help Software Updates. 5. Utilize a opção Add Site... (Figura 1) para instalar os seguintes softwares: (a) AspectJ Development Tools for Eclipse (http://download.eclipse. org/tools/ajdt/34/update) (b) Maven Integration for Eclipse (http://m2eclipse.sonatype.org/ update/) (c) Demoiselle Wizard (http://demoiselle-wzd.sourceforge.net/updatesite) (d) JBoss Tools (http://download.jboss.org/jbosstools/updates/ stable) Figura 1: Lista de update sites configurados no Eclipse 2
1.2 Uso do arquétipo Demoiselle Para criar um novo projeto utilizando o arquétipo Demoiselle, siga os passos abaixo: 1. Configure o repositório maven Abra o Eclipse A primeira vez que plugin do Eclipse (m2) é instalado, o repositório local é criado na pasta.m2, que fica na Pasta do Usuário (USER HOME). No Windows, normalmente fica em C:\Documents and Settings\$USER HOME\.m2\ ; no Linux, em /home/$user HOME/.m2/ ). 3 No seu repositório local ($USER HOME/.m2) crie o arquivo archetype-catalog.xml e copie o conteúdo abaixo. <?xml version= 1. 0 encoding= UTF 8?> <archetype catalog> <archetypes> <archetype> <groupid> br. gov. component. d e m o i s e l l e. archetypes </groupid> <artifactid> d e m o i s e l l e archetype webapp sample </ artifactid> <version>1. 0. 0</ version> <repository> h t t p : // d e m o i s e l l e. s o u r c e f o r g e. net / r e p o s i t o r y / r e l e a s e </ repository> </ archetype> </ archetypes> </ archetype catalog> 2. Crie o projeto seguindo os passos abaixo: No Eclipse, acione o menu File New Project... Selecione a opção Maven Project..., conforme visualizado na Figura 2 Na próxima tela é possível configurar o local onde o projeto será criado. Mantenha sua tela conforme a Figura 3 para que o projeto seja criado dentro do Workspace padrão. Na tela seguinte, visualizada na Figura 4 são exibidos todos os arquétipos cadastros no archetype-catalog.xml; Selecione a última versão disponível do archetype Demoiselle (demoisellearchetype-webapp-sample) Na tela seguinte, mostrada na Figura 5, informe os parâmetros do projeto 3 A pasta.m2 é protegida, portanto pode não estar visível por padrão. Para acessá-la, se estiver numa máquina Windows, configure a exibição de arquivos ocultos. No Linux, utilize as teclas Ctrl+H para exibir e esconder arquivos ocultos. 3
Figura 2: Seleção de projeto Maven Group Id: representa a identificação da organização; Artifact Id: representa o nome do projeto; Version: versão do projeto; Package: pacote raiz do projeto. Acione o botão Finish para iniciar a criação do projeto Seu projeto será criado conforme estrutura da Figura 6 O arquétipo Maven contrói uma aplicação JEE compatível com os seguinte componentes e frameworks: JSF Api 1.2.08 RichFaces 3.1.2 Weblets Api 1.1 MyFaces Tomahawk 1.1.7 JSF-Facelets 1.1.14 Postgresql 8.0-318 JasperReports 3.1.0 3. Adicione características do Wizard Demoiselle ao projeto: Clique com o botão direito sobre o projeto; Selecione Demoiselle Adicionar/Remover características Demoiselle Figura 7; 4
Figura 3: Criação de um novo projeto Maven a partir do arquétipo O projeto receberá o ícone do Framework Demoiselle, conforme Figura 8 4. Configure o servidor de aplicação (Tomcat ou JBoss) Entre nas propriedades do projeto (Project Properties) Entre nas configurações do Maven e informe o profile ativo (Figura 9) tomcat para servidor Tomcat jboss para servidor JBoss Neste laboratório, utilizaremos o Tomcat 5. Configure o plugin para uso do Tomcat (caso já esteja configurado, avance para o próximo passo): Selecione o menu Window Preferences; Na janela de preferências selecione o item Server Runtime Environments (Figura 10; Clique no botão Add para adicionar um novo servidor; Selecione a versão 6.0 do Apache Tomcat conforme Figura 11; Marque a opção Also create new local server para criar o servidor local; Vá para a próxima tela (Figura 12); No campo Tomcat installation directory, informe o local onde o Tomcat foi extraído; Clique no botão Finish e feche a janela de preferências; 5
Figura 4: Configuração do catálogo local de arquétipos Abra a View Servers (Window Show View Servers). deve listar o servidor tomcat conforme Figura 13. 6. Adicione o projeto ao Plugin Tomcat: Adicione o projeto escola ao servidor Tomcat (Figura 14; 7. Configure a autenticação da aplicação via Realm padrão do Tomcat No próprio Eclipse, abra o arquivo tomcat-users.xml localizado dentro do projeto Servers (Figura 15) Crie usuários e papéis conforme a listagem abaixo: <tomcat users> <role rolename= r o l e a l u n o /> <role rolename= r o l e p r o f e s s o r /> <role rolename= r o l e a d m i n i s t r a d o r /> <user username= aluno password= aluno r o l e s = r o l e a l u n o /> <user username= p r o f e s s o r password= p r o f e s s o r r o l e s = r o l e p r o f e s s o r /> <user username= admin password= admin r o l e s = r o l e a d m i n i s t r a d o r /> </tomcat users> Inicie o Tomcat e veja se a aplicação foi carregada corretamente; Entre na URL http://localhost:8080/escola/. A página de login deverá ser exibida conforme a Figura 16; Autentique-se com o usuário admin e senha admin; A tela inicial da aplicação deverá ser exibida conforme Figura 17 Ela 6
Figura 5: Parâmetros do projeto Maven Figura 6: Estrutura de pacotes do projeto escola 7
Figura 7: Menu adicionar/remover características Demoiselle Figura 8: Projeto escola com icone do Framework Demoiselle Figura 9: Ativacao do profile tomcat 8
Figura 10: Configuração do server runtime Figura 11: Configuração do server runtime Tomcat 9
Figura 12: Configuração do diretório de instalação do servidor Web Figura 13: Aba Servers Figura 14: Menu Adicionar/Remover Projetos da Aba Serves 10
Figura 15: Arquivo tomcat-users.xml Figura 16: Página de login padrão do Demoiselle Figura 17: Tela inicial padrão da aplicação Demoiselle 11