Tutorial – Módulo 01 – Arquitetura

LABORATÓRIO 01 – 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 da 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 seguintes softwares:

Objetivos: #

• 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.

Exercício 1.0 – Instalação e configuração do Ambiente: #

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á no 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:
1. AspectJ Development Tools for Eclipse (http://download.eclipse.org/tools/ajdt/34/update)
2. Maven Integration for Eclipse (http://m2eclipse.sonatype.org/update/)
3. Demoiselle Wizard (http://demoiselle.sourceforge.net/wizard/updatesite.)
4. JBoss Tools (http://download.jboss.org/jbosstools/updates/stable)

Exercício 1.1 – Arquétipo Demoiselle #

1. Configuração do 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/”).

Dica: 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.

• 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.demoiselle.archetypes</groupId>
      <artifactId>demoiselle-archetype-webapp-sample</artifactId>
      <version>1.0.0</version>
      <repository>
        http://demoiselle.sourceforge.net/repository/release
      </repository>
    </archetype>
  </archetypes>
</archetype-catalog>

2. Criando um novo projeto #

• Volte ao Eclipse é acione o menu: File → New → Project...
• Selecione a opção Maven Project (figura 2)://

Figura 2: Seleção de projeto Maven

• 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.

Figura 3: Criação de um novo projeto Maven a partir de arquétipo

• Na tela seguinte (figura 4) são exibidos todos os arquétipos cadastros no archetype-catalog.xml}Selecione no campo Catalog a opção: Default Local} Selecione a última versão do arquétipo demoiselle (demoiselle-archetype-webapp-sample).

Figura 4: Configuração do catálogo local de arquétipos Maven

Vá à próxima tela.

• Informe os dados do seu projeto. Group Id: representa a identificação da organização;
• Artifact Id: representa o nome do projeto; Version: versão do projeto;
• Package: pacote raiz da aplicação.

Figura 5: Parâmetros do projeto Maven

• Acione o botão Finish para iniciar a criação do projeto.

Seu projeto deverá ser criado conforme estrutura da figura 6:

Figura 6: Estrutura de pacotes do projeto escola

O Arquétipo Maven constrói uma aplicação JEE compatível com os seguintes componentes/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. Adicionando características do Wizard Demoiselle ao projeto: #

• Clique com o botão direito sob o projeto
• Selecione o menu Demoiselle;
• Selecione: Adicionar/Remover Características Demoiselle (figura 7);

Figura 7: Menu adicionar/remover características Demoiselle

O projeto receberá o ícone do Framework Demoiselle.

4. Configuração do servidor de aplicação (Tomcat ou JBoss) #

• Entre nas propriedades do projeto (Project → Properties);
• Ativar profile Tomcat;
• Entre nas configurações do Maven e informe que o profile ativo: “tomcat”.

Figura 8: Ativação do profile do Tomcat

• Para ativar o profile JBoss informe o valor “jboss” (não será utilizado neste laboratório)

Caso o plugin para uso do Tomcat já esteja configurado avance ao item 5, caso contrário: 

Configuração do plugin tomcat

• Selecione o menu Window → Preferences}
• Na janela de preferências, selecione o item Server → Runtime Environments}
• Clique no botão Add para adicionar um novo servidor;

Figura 9: Configuração do server runtime

Selecione a versão 6.0 do Apache Tomcat conforme figura 10:

Figura 10: Configuração do server runtime

• Marque a opção “Also create new local server” para criar o servidor local;
• Vá para a próxima tela (figura 11);
• No campo “Tomcat installation directory”, informe o local onde o Tomcat foi extraído;

Figura 11: Configuração do diretório de instalação do servidor Web

• Clique no botão Finish e feche a janela de preferências;
• Abra a View Servers (Window → Show View → Servers). Ela deve listar o servidor tomcat conforme figura 12:

Figura 12: Aba Servers

5. Inclusão do projeto escola ao Plugin Tomcat: #

• Adicione o projeto escola ao servidor Tomcat (figura 13)

Figura 13: Menu Adicionar/Remover Projetos da aba Server

6. Configurando 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 14)

Figura 14: Arquivo tomcat-users.xml

Crie os seguintes usuários e papéis conforme exemplo abaixo

<tomcat-users>
  <role rolename="role_aluno"/>
  <role rolename="role_professor"/>
  <role rolename="role_administrador"/>
  <user username="aluno" password="aluno" roles="role_aluno"/>
  <user username="professor" password="professor" roles="role_professor"/>
  <user username="administrador" password="administrador" roles="role_administrador"/>
</tomcat-users>

• Inicie o Tomcat e verifique se aplicação foi carregada corretamente.
• Entre na url http://localhost:8080/escola/. A página de login deverá ser exibida conforme figura 15:

Figura 15: Página de login padrão do Demoiselle

Autentique-se com o usuário administrador e senha administrador A tela inicial da aplicação deverá ser exibida conforme figura 16.

Figura 16: Tela inicial padrão da aplicação Demoiselle

Créditos

Laboratório criado por Vanderson Botellho da Silva (SERPRO/SUPST/STCTA)

Contribuições:

Emerson Sachio Saito (SERPRO/CETEC/CTCTA)

Flávio Gomes da Silva Lisboa (SERPRO/CETEC/CTCTA)

Serge Normando Rehem (SERPRO/CETEC/CTSDR)