Demoiselle – Tutorial – M´
odulo 1 – Arquitetura
Vanderson Botelho da Silva (SERPRO/SUPST/STCTA)
Emerson Sachio Saito (SERPRO/CETEC/CTCTA)
Fl´
avio Gomes da Silva Lisboa (SERPRO/CETEC/CTCTA)
Serge Normando Rehem (SERPRO/CETEC/CTSDR)
18 de mar¸co de 2010
1
Laborat´
orio 1 - Arquitetura e configura¸
c˜
ao
Este laborat´orio tem por objetivo fixar os conceitos abordados no M´odulo 01 do tutorial que trata as quest˜oes de arquitetura do Framework Demoiselle e orientar o processo de instala¸c˜ao e configura¸c˜ao do ambiente de desenvolvimento e das aplica¸c˜oes instanciadas por ele.
Caso esteja optando por n˜ao utilizar a ferramenta MAVEN, utilize o docu-mento Demoiselle-Tutorial-Modulo01-Arquitetura-Anexo-I, ao inv´es deste.
Para o bom andamento deste laborat´orio, espera-se que o ambiente do de-senvolvedor contenha os software listados na Tabela1.
Software Vers˜ao Objetivo
Compilador Java (JDK) 1.5.0 171 Compila¸c˜ao dos projetos
Eclipse Ganymede 3.4.2 IDE para desenvolvimento
AspectJ for Eclipse 1.6.4 Compila¸c˜ao de aspectos Maven Integration for Eclipse 0.9.71 Integra¸c˜ao com projetos Maven Servidor de Aplica¸c˜ao Tomcat 6.0.18 Servidor de aplica¸c˜ao Web Demoiselle Wizard 1.0.2 Gerar c´odigo da aplica¸c˜ao
Jboss Tools 3.0 Acess´orios para desenvolvimento
Tabela 1: Software necessario no ambiente de desenvolvimento
Os objetivos espec´ıficos desse laborat´orio s˜ao: • Criar e configurar projetos via arqu´etipo Maven;
• Criar projeto do tutorial (projeto que ter´a continuidade nos demais labo-rat´orios);
• Configurar projeto via Demoiselle Wizard.
1.1
Instala¸
c˜
ao e configura¸
c˜
ao 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´em ´e 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´a na interface do Eclipse utilize a op¸c˜ao de Software Updates: Menu→Help→Software Updates.
5. Utilize a op¸c˜ao Add Site... (Figura1) para instalar os seguintes softwa-res:
(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)
1.2
Uso do arqu´
etipo Demoiselle
Para criar um novo projeto utilizando o arqu´etipo Demoiselle, siga os passos abaixo:
1. Configure o reposit´orio maven • Abra o Eclipse
• A primeira vez que plugin do Eclipse (m2) ´e instalado, o reposit´orio local ´e criado na pasta .m2, que fica na Pasta do Usu´ario (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´orio local ($USER HOME/.m2) crie o arquivo archetype-catalog.xml e copie o conte´udo 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 . a r c h e t y p e s </groupId> <a r t i f a c t I d> d e m o i s e l l e −a r c h e t y p e −webapp−sample </ a r t i f a c t I d> <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 . n e t / 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¸c˜ao Maven Project..., conforme visualizado na Fi-gura 2
• Na pr´oxima tela ´e poss´ıvel configurar o local onde o projeto ser´a criado. Mantenha sua tela conforme a Figura 3 para que o projeto seja criado dentro do Workspace padr˜ao.
• Na tela seguinte, visualizada na Figura4s˜ao exibidos todos os arqu´etipos cadastros no archetype-catalog.xml;
• Selecione a ´ultima vers˜ao dispon´ıvel do archetype Demoiselle (demoiselle-archetype-webapp-sample)
• Na tela seguinte, mostrada na Figura 5, informe os parˆametros do projeto
3A pasta .m2 ´e protegida, portanto pode n˜ao estar vis´ıvel por padr˜ao. Para acess´a-la, se
estiver numa m´aquina Windows, configure a exibi¸c˜ao de arquivos ocultos. No Linux, utilize as teclas Ctrl+H para exibir e esconder arquivos ocultos.
Figura 2: Sele¸c˜ao de projeto Maven
Group Id: representa a identifica¸c˜ao da organiza¸c˜ao; Artifact Id: representa o nome do projeto;
Version: vers˜ao do projeto; Package: pacote raiz do projeto.
• Acione o bot˜ao Finish para iniciar a cria¸c˜ao do projeto • Seu projeto ser´a criado conforme estrutura da Figura6
O arqu´etipo Maven contr´oi uma aplica¸c˜ao 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˜ao direito sobre o projeto;
• Selecione Demoiselle→Adicionar/Remover caracter´ısticas De-moiselle Figura7;
Figura 3: Cria¸c˜ao de um novo projeto Maven a partir do arqu´etipo
• O projeto receber´a o ´ıcone do Framework Demoiselle, conforme Fi-gura 8
4. Configure o servidor de aplica¸c˜ao (Tomcat ou JBoss)
• Entre nas propriedades do projeto (Project→Properties)
• Entre nas configura¸c˜oes do Maven e informe o profile ativo (Figura9)
– “tomcat” para servidor Tomcat – “jboss” para servidor JBoss
Neste laborat´orio, utilizaremos o Tomcat
5. Configure o plugin para uso do Tomcat (caso j´a esteja configurado, avance para o pr´oximo passo):
• Selecione o menu Window→Preferences;
• Na janela de preferˆencias selecione o item Server→Runtime En-vironments (Figura10;
• Clique no bot˜ao Add para adicionar um novo servidor; • Selecione a vers˜ao 6.0 do Apache Tomcat conforme Figura11; • Marque a op¸c˜ao Also create new local server para criar o servidor
local;
• V´a para a pr´oxima tela (Figura12);
• No campo Tomcat installation directory, informe o local onde o Tomcat foi extra´ıdo;
Figura 4: Configura¸c˜ao do cat´alogo local de arqu´etipos
• Abra a View Servers (Window→Show View→Servers). Ela deve listar o servidor tomcat conforme Figura13.
6. Adicione o projeto ao Plugin Tomcat:
• Adicione o projeto escola ao servidor Tomcat (Figura14; 7. Configure a autentica¸c˜ao da aplica¸c˜ao via Realm padr˜ao do Tomcat
• No pr´oprio Eclipse, abra o arquivo tomcat-users.xml localizado dentro do projeto “Servers” (Figura15)
• Crie usu´arios e pap´eis conforme a listagem abaixo: <tomcat−users>
<r o l e r o l e n a m e=” r o l e a l u n o ”/> <r o l e r o l e n a m e=” r o l e p r o f e s s o r ”/> <r o l e r o l e n a m e=” r o l e a d m i n i s t r a d o r ”/> <user username=”a l u n o ” password=”a l u n o ”
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¸c˜ao foi carregada corretamente; • Entre na URLhttp://localhost:8080/escola/. A p´agina de login
dever´a ser exibida conforme a Figura16;
• Autentique-se com o usu´ario admin e senha admin;
Figura 5: Parˆametros do projeto Maven
Figura 7: Menu adicionar/remover caracter´ısticas Demoiselle
Figura 8: Projeto escola com icone do Framework Demoiselle
Figura 10: Configura¸c˜ao do server runtime
Figura 12: Configura¸c˜ao do diret´orio de instala¸c˜ao do servidor Web
Figura 13: Aba Servers
Figura 15: Arquivo tomcat-users.xml
Figura 16: P´agina de login padr˜ao do Demoiselle