Demoiselle Tutorial Módulo 1 Arquitetura

Transcrição

1 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 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) Compilação dos projetos Eclipse Ganymede IDE para desenvolvimento AspectJ for Eclipse Compilação de aspectos Maven Integration for Eclipse Integração com projetos Maven Servidor de Aplicação Tomcat Servidor de aplicação Web Demoiselle Wizard 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

2 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 ( index_jdk5.jsp), também é possível utilizar JAVA 6, mas mantendo a compatibilidade com JAVA Baixar e instalar a IDE Eclipse Ganymede ( 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 ( org/tools/ajdt/34/update) (b) Maven Integration for Eclipse ( update/) (c) Demoiselle Wizard ( (d) JBoss Tools ( stable) Figura 1: Lista de update sites configurados no Eclipse 2

3 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> </ 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

4 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 RichFaces Weblets Api 1.1 MyFaces Tomahawk JSF-Facelets Postgresql JasperReports 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

5 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

6 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 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 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

7 Figura 5: Parâmetros do projeto Maven Figura 6: Estrutura de pacotes do projeto escola 7

8 Figura 7: Menu adicionar/remover características Demoiselle Figura 8: Projeto escola com icone do Framework Demoiselle Figura 9: Ativacao do profile tomcat 8

9 Figura 10: Configuração do server runtime Figura 11: Configuração do server runtime Tomcat 9

10 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

11 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