Demoiselle Wizard Manual

5/10/2018 Demoiselle Wizard Manual - slidepdf.com

http://slidepdf.com/reader/full/demoiselle-wizard-manual 1/40

Manual Demoiselle WizardCETEC/CTCTA



Manual Demoiselle Wizard – CETEC

Histórico de Versões

Data Versão Descrição Autor Revisor Aprovado

por 07/05/2009 0.1 Criação do documento Mário Costa Flávio Lisboa

24/06/2009 0.2Correção da URL do updatesite

Flávio Lisboa

25/06/2009 1.0Inclusão de exemplo deaplicação

Flávio Lisboa

30/06/2009 1.1Finalização do exemplo deaplicação

Flávio Lisboa

12/01/10 1.1.1Revisão para versão 1.1.1 doWizard

Emerson S.Saito

07/05/10 1.1.1Atualização de URLsconforme reestruturaçãoapós unificação dos projetos.

RodrigoHJORT

2




Sumário

1.Visão Geral........................................................................................................................................41.1. Pré-requisitos............................................................................................................................4

1.1.1. Do usuário.........................................................................................................................41.1.2. Do ambiente......................................................................................................................4

1.2. Instalação..................................................................................................................................41.3. Criar Projeto com Maven (m2Eclipse).......................................................................................4

1.3.1. Criar Projeto sem plugin Maven. .......................................................................................51.3.2. Exemplo de Estrutura do Projeto ......................................................................................6

1.4. Estrutura de Pacotes e Arquivos de Configuração...................................................................6

2.Configurar Projeto.............................................................................................................................92.1. Aba Configuração.....................................................................................................................9

2.1.1. Descrição dos Campos...................................................................................................102.1.2. Descrição das Alterações................................................................................................10

2.2. Configurações do Hibernate ...................................................................................................102.2.1. Descrição dos Campos...................................................................................................112.2.2. Descrição das alterações................................................................................................12

2.3. JPA (Java Persistence API)....................................................................................................122.3.1. Descrição dos campos....................................................................................................132.3.1. Descrição das alterações................................................................................................14

2.4. Cadastro de Mensagens.........................................................................................................142.4.1. Descrição dos Campos...................................................................................................152.4.2. Descrição das Alterações................................................................................................15

3. Editar Projeto..................................................................................................................................163.1. Geração de DAOs...................................................................................................................16


3.2. Geração de Business Controllers...........................................................................................203.2.1. Descrição dos Campos...................................................................................................213.2.2. Descrição das Alterações................................................................................................21

3.3. Geração de Regras de Navegação.......................................................................................223.3.1. Descrição dos Campos...................................................................................................233.3.2. Descrição das Alterações................................................................................................23

3.4. Geração de Managed Beans..................................................................................................243.4.1. Descrição dos Campos...................................................................................................25

3.4.2. Descrição das Alterações................................................................................................263.5. Geração de Fachadas............................................................................................................27


3.6. Geração de Testes Unitários..................................................................................................303.6.1. Descrição dos Campos...................................................................................................313.6.2. Descrição das Alterações................................................................................................31

3.7. Criar páginas...........................................................................................................................323.7.1. Descrição dos Campos...................................................................................................323.7.2. Cadastro da Página de Listagem....................................................................................33

3.7.2.1. Descrição dos Campos............................................................................................343.7.2.2. Descrição das Alterações........................................................................................35

3.7.3. Cadastro da Página de Visualização..............................................................................353.7.3.1. Descrição dos Campos............................................................................................363.7.3.2. Descrição das Alterações........................................................................................37

3




3.7.4. Cadastro da Página de Edição.......................................................................................373.7.4.1. Descrição dos Campos............................................................................................373.7.4.2. Descrição das Alterações........................................................................................38

4




1.Visão Geral1

Demoiselle Wizard é uma ferramenta que visa auxiliar o desenvolvimento deaplicação WEB que utilizam o Demoiselle Framework. A ideia do Wizard é apoiar naconfiguração, procurando gerar o código básico comum de partes da aplicação, deixando ofoco do desenvolvedor nas regras de negócio.

1.1. Pré-requisitos

Como toda ferramenta de software, o Demoiselle Wizard está baseado em algunsconceitos e produtos que não serão abordados neste manual.

1.1.1. Do usuário

– Conhecimento no uso da plataforma Eclipse (http://www.eclipse.org/).

– Desenvolvimento JEE (http://java.sun.com/javaee/). – Padrões de projeto em Java

(http://java.sun.com/blueprints/corej2eepatterns/Patterns/index.html)

1.1.2. Do ambiente

– JDK 1.5 ou superior (http://java.sun.com/javaee/downloads/index.jsp).

– Eclipse IDE, versão 3.4.2 ou superior (http://www.eclipse.org/downloads/).

– AspectJ Development Tools for Eclipse(http://download.eclipse.org/tools/ajdt/34/update)

– Recomendados:

– Maven Integration for Eclipse (http://m2eclipse.sonatype.org/update/)

– JBoss Tools (http://download.jboss.org/jbosstools/updates/stable)

1.2. Instalação

A instalação e atualização do Demoiselle Wizard será através de um updatesite doEclipse disponibilizado no site: http://demoiselle.sourceforge.net/wizard/updatesite/

– Eclipse 3.4.x Menu: Help → Software Updates → Available Software → Add Site

– Eclipse 3.5.x Menu: Help → Install New Software → Add...

1.3. Criar Projeto com Maven (m2Eclipse)1

Nesta opção, o projeto será criado pelo plugin Maven (ver manual do Demoiselle:http://demoiselle.svn.sourceforge.net/viewvc/demoiselle/trunk/docs/others/tutorial/Demoiselle-Tutorial-Modulo01-Arquitetura-Laboratorio.pdf ). O projeto irá conter um conjunto de

classes, pacotes, diretórios e arquivos de configuração e um arquivo de configuração doMaven, o pom.xml. Este arquivo irá prover informações das bibliotecas que o projetodependerá.

5

http://www.eclipse.org/

http://java.sun.com/javaee/

http://java.sun.com/blueprints/corej2eepatterns/Patterns/index.html

http://java.sun.com/javaee/downloads/index.jsp

http://www.eclipse.org/downloads/

http://download.eclipse.org/tools/ajdt/34/update

http://m2eclipse.sonatype.org/update/

http://download.jboss.org/jbosstools/updates/stable

http://demoiselle.sourceforge.net/wizard/updatesite/

http://demoiselle.svn.sourceforge.net/viewvc/demoiselle/trunk/docs/others/tutorial/Demoiselle-Tutorial-Modulo01-Arquitetura-Laboratorio.pdf


http://java.sun.com/javaee/

http://java.sun.com/blueprints/corej2eepatterns/Patterns/index.html

http://java.sun.com/javaee/downloads/index.jsp

http://www.eclipse.org/downloads/

http://download.eclipse.org/tools/ajdt/34/update

http://m2eclipse.sonatype.org/update/

http://download.jboss.org/jbosstools/updates/stable



http://demoiselle.sourceforge.net/wizard/updatesite/

http://www.eclipse.org/




Ao finalizar a operação, o plugin Maven irá criar o projeto com a estrutura básica daaplicação.

O Wizard dá opção para o usuário de ”transformar um projeto java” em uma aplicação

do tipo Demoiselle. Através do item de menu "Demoiselle - Adicionar/Remover características do Demoiselle Framework", o usuário adiciona ou remove ascaracterísticas necessárias para identificar a aplicação como uma aplicação Demoiselle.

Mesmo através do M2Eclipse, o desenvolvedor deverá “reconhecer” este projeto comoum projeto Demoiselle:

– Selecionar o projeto e clicar com o botão direito do mouse para ativar o menususpenso, depois em "Demoiselle → Adicionar/remover características doDemoiselle".

Figura 1.3 – Adicionando características do Demoiselle Framework

IMPORTANTE: O usuário só tem acesso as demais funcionalidades do Wizard se aaplicação que ele estiver editando possuir características de uma aplicação Demoiselle.Utilize esta funcionalidade para adicionar estas características.U

1.3.1. Criar Projeto sem plugin Maven.1

Caso opte por não utilizar o plugin Maven, que é recomendado pelo Demoiselle, épossível criar um projeto Java no ambiente Eclipse e depois “transformá-lo” em um projetoDemoiselle para utilização do Wizard.

– Neste link está um exemplo:http://demoiselle.svn.sourceforge.net/viewvc/demoiselle/trunk/docs/others/tutorial/Demoiselle-Tutorial-Modulo01-Arquitetura-Anexo-I.pdf

6

http://demoiselle.svn.sourceforge.net/viewvc/demoiselle/trunk/docs/others/tutorial/Demoiselle-Tutorial-Modulo01-Arquitetura-Anexo-I.pdf






Manual Demoiselle Wizard – CETECM

1.3.2. Exemplo de Estrutura do Projeto

Figura 1.6 – Projeto Criado

7




11.4. Estrutura de Pacotes e Arquivos de Configuração

br.gov.demoiselle.projeto.bean

Pacote onde serão armazenadas as classes dos POJOs da aplicação.

br.gov.demoiselle.projeto.business

Pacote onde serão armazenadas as interfaces dos Business Controllers da aplicação.

br.gov.demoiselle.projeto.business.implementation

Pacote onde serão armazenadas as implementações dos Business Controllers daaplicação.a

br.gov.demoiselle.projeto.config

Pacote onde serão armazenadas as classes de configuração

br.gov.demoiselle.projeto.constant

Pacote onde serão armazenadas as classes de constantes da aplicação.

br.gov.demoiselle.projeto.message

Pacote onde serão armazenadas as classes de mensagens da aplicação.

br.gov.demoiselle.projeto.persistence.dao

Pacote onde serão armazenadas as interfaces dos DAOs da aplicação.

br.gov.demoiselle.projeto.persistence.dao.filter

Pacote onde serão armazenadas as classes dos filtros de dados da aplicação.

br.gov.demoiselle.projeto.persistence.dao.implementation

Pacote onde serão armazenadas as implementações dos DAOs da aplicação.

br.gov.demoiselle.projeto.view.managedbean

Pacote onde serão armazenadas as implementações dos Managed Beans da aplicação.

br.gov.demoiselle.projeto.view.reportb

Pacote onde serão armazenadas as implementações dos relatórios da aplicação.

A seguir a descrição de alguns diretórios e arquivos de configuração da aplicação.

Nome do Arquivo/Diretório Finalidade

framework.properties Arquivo de configuração do projeto

Descrição

Este arquivo contém variáveis de configuração do projeto, ele pode ser editado através dowizard "Configurar projeto" do Wizard.


src/main/resources/hibernate.cfg.xml Arquivo de configuração do Hibernate

Descrição

8




Este arquivo contém as variáveis de configuração do Hibernate, ele também será editadoatravés do wizard "Configurar projeto" do Wizard.


src/main/resources/hbm Diretório de configuração do Hibernate

Descrição

Este diretório irá armazenar os arquivos de mapeamento HBM do Hibernate, isso se aaplicação utilizar HBM, caso contrário este diretório não será utilizado.


src/main/webapp/WEB-INF/faces-config.xml Arquivo de configuração JSF

DescriçãoEste arquivo contém todas as informações sobre os Managed Beans e as regras denavegação. Será editado ao longo da fase "Editar projeto".


src/main/webapp/WEB-INF/web.xml Arquivo de configuração da aplicaçãoWEB

Descrição

Este arquivo possui informações de como a aplicação Web deverá se comportar, ele jávem pré configurado e recomenda-se somente aos usuários mais experiente alterá-lo.


.demoiselle.xml Arquivo de configuração do Wizard

Descrição

Este arquivo possui informações de configuração do Wizard.


pom.xml Arquivo de configuração do Maven

Descrição

Este arquivo possui informações de configuração do Maven.

9




2.Configurar Projeto

Neste Item do Wizard o usuário poder escolher e editar as configurações básicas doprojeto, as informações para a conexão do Hibernate e cadastrar as mensagens do projeto.Segue adiante a explicação deste mecanismo de funcionamento do Wizard e em seguidalinks para as explicações de ambas as telas.

A funcionalidade é ativada pelo menu de projeto do Eclipse, selecionando o projeto eclicando com o botão direito do mouse. Demoiselle → Configurar projeto.

10




22.1. Aba Configuração.C

O Framework Demoiselle oferece ao desenvolvedor mecanismos que facilitam amanutenção de variáveis de configuração da aplicação. Para auxiliar, o Wizard oferecesuporte na criação e edição destas variáveis (exceto as variáveis de sistema). O Wizardbusca no projeto as classes que implementam a interface IConfig (vide manual doDemoiselle) e disponibiliza para alteração as variáveis destas classes.

Figura 2.1 - Tela de Configuração das variáveis do projeto

2.1.1. Descrição dos Campos

● Classes de configuração: O campo indica qual classe que implementaIConfig terá suas variáveis editadas.

● Propriedades: A tabela propriedades lista todas as variáveis da classe queestão anotadas por @ConfigKey. Clicando duas vezes na linha referente apropriedade, o usuário pode alterar o valor desta variável.

2.1.2. Descrição das Alterações

Ao final das operações, o Plugin irá criar ou alterar as propriedades nos arquivos xml

ou properties.

11




2.2. Configurações do Hibernate

Irá criar ou configurar os arquivos necessários para uso do Hibernate como camada depersistência.

Figura 2.2 - Tela de Configuração do Hibernate


● Conexão: O campo tipo de conexão define o modo que a aplicação iráacessar o banco de dados, existe dois tipos de acesso, via Data Source e viaDriver , os demais campos da aplicação estarão disponíveis conforme aescolha deste.

● Show SQL: O campo Show SQL indica se o Hibernate deve logar ou não osSQLs executados no banco.

● Format SQL: O campo Format SQL indica se o Hibernate deve formatar ounão os SQLs executados no banco.

● Banco de Dados: O campo Banco de Dados indica qual o banco será

acessado pelo Hibernate. Os tipos são pré-definidos, caso o usuário desejeincluir algum outro deve contatar a equipe responsável pelo Demoiselle.

● Nome do Data Source: O campo Nome do Data Source indica o Alias do Data

12




Source que será utilizado. Este campo só estará disponível se o tipo deconexão for Data Source.

● Dialect: O campo Dialect indica qual o dialeto será utilizado para acessar o

banco de dados. Este campo é somente leitura, ele será preenchido de acordocom o Banco de Dados selecionado.

● URL: Também disponível somente no tipo Driver, a URL indica o caminho dobanco de dados da aplicação. Para cada banco de dados cadastrado existeuma URL padrão na qual o usuário deve trocar os campos: BD_APLICACAO elocalhost (se não for acessar um banco local).

● Usuário: O campo usuário define o login da aplicação no banco de dados.Somente para o tipo driver.

● Senha: O campo senha define a senha do usuário da aplicação no banco dedados. Somente para o tipo driver.

● Auto update HBM: O campo auto update indica se o Hibernate irá atualizar

automaticamente o banco de dados de acordo com mudanças nomapeamento cadastrado.

● Tabela de mapeamento de Hibernate: Há dois tipos de mapeamento doHibernate, um via HBM e outro via anotações nos POJOs. O primeiro modoaparece automaticamente todas as opções na tabela, devendo o usuáriomarcar os HBMs necessários. Os POJOs devem ser inseridos através dobotão “Adicionar POJO”. Para remover qualquer item basta retirar o check daprimeira coluna.

2.2.2. Descrição das alterações

Ao salvar as alterações o Wizard irá editar o arquivo de configuração do Hibernate comas alterações feitas pelo usuário.

13




32.3. JPA (Java Persistence API)

A tela de configuração do JPA é dividida em três partes, são elas: Lista de Persistence

Units já cadastradas; os botões adicionar, remover e editar; e a área de edição daPersistence Unit. Clicando em algum item da lista de Pus, o usuário poderá observar, naárea de edição, os dados da Persistence Unit selecionada e caso tenha a necessidade dealterar algo deverá iniciar a edição deste clicando no botão Editar. A adição e remoção dePersistence Units são feitas através dos botões Adicionar e Remover respectivamente. apóso término da adição/edição/remoção das Persistence Units o usuário deverá salvar asalterações (botão Salvar da área de edição) ou cancelar (botão Cancelar da área deedição).e

Figura 2.3 - Tela de Configuração do JPA

2.3.1. Descrição dos campos

• NomeO campo nome indica o nome da Persistence Unit a ser criada/editada.

• Provider O campo Provider abre as opções de implementação JPA para a Persistence Unit aser criada/editada. O Wizard prove suporte aos seguintes Providers: "JPA Provider",Hibernate Provider e "Oracle Toplink Provider"

14




• Tipo O campo tipo indica o tipo da Persistence Unit a ser criada/editada. As opções são:JTA ou Recurso Local

• Data Source O campo Data Source (opcional) indica o nome do Data Source associado aPersistence Unit a ser criada/editada. O não preenchimento deste campo indicaráque a PU não possui Data Source.

• Propriedades A Tabela Propriedades indica todas as tuplas chave, valor das propriedades queserão cadastradas para cada PU.

• Tabela de mapeamento de Hibernate Há dois tipos de mapeamento do JPA, um via resources e outro via classes Pojosanotadas. O primeiro modo aparece automaticamente todas as opções na tabela,devendo o usuário marcar os recursos necessários. Os Pojos devem ser inseridos

através do botão “Adicionar Pojo”. Para remover qualquer item basta retirar o checkda primeira coluna.

2.3.1. Descrição das alterações

Ao salvar as alterações, o Wizard irá editar o arquivo de configuração do JPA com asalterações feitas pelo usuário.

15




42.4. Cadastro de Mensagens

As mensagens da aplicação são armazenadas em classes do tipo enum. Existem três

tipos de mensagens: de Erro; Informação; ou de Erro Fatal. Para cada tipo, existirá umaclasse associada e todas as mensagens do tipo serão armazenadas nesta classe. A figura2.3 exibe a tela de cadastro.

Figura 2.4 – Tela de Cadastro de Mensagens

Conforme podemos observar na figura 2.4, a tela de Mensagem é dividida em trêspartes, são elas: Lista das Mensagens já cadastradas; os botões adicionar, remover eeditar; e a área de edição da Mensagem. Clicando em algum item da lista de Mensagens, ousuário poderá observar, na área de edição, os dados da Mensagem selecionada e casotenha a necessidade de alterar algo deverá iniciar a edição desta clicando no botão Editar.

A adição e remoção de Exceções são feitas através dos botões Adicionar e Remover,respectivamente. Após o término da adição/edição das Exceções, o usuário deverá salvar as alterações (botão Salvar da área de edição) ou cancelar (botão Cancelar da área deedição). O campo pacote indicará onde o pacote onde serão criadas as classes que irãoarmazenar as mensagens. Como sugestão, o framework traz o pacote:

br.gov.demoiselle.projeto.message".

IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar no

16




botão aplicar da tela principal ou no botão Finish do wizard. Após a edição das Mensagens,a seguinte mensagem deverá aparecer na tela: "“Mensagens cadastradas comsucesso”.


Nome O campo nome serve para identificar a mensagem na classe.

● Mensagem O campo mensagem é o conteúdo da mensagem.Tipo O campo tipo da mensagem identifica qual a severidade da mensagem (ERROR;FATAL; ou INFO).


Ao salvar as alterações, o Plugin irá criar ou editar a(s) classe(s) que possui(em)alguma mensagem associada. As classes terão os seguintes nomes: ErrorMessage,FatalMessage e InfoMessage e sempre implementam a interface IMessage.

17




3. Editar Projeto

Esta funcionalidade auxilia na edição do projeto permitindo desenvolver as camadasda aplicação de acordo com o padrão Demoiselle. O processo começa na camada DAO epassa pelo Business Controller, Managed Bean, Regras de Navegação, as Fachadas atéchegar aos testes unitários.

Ativando o Meno de Edição do Projeto.

3.1. Geração de DAOs

Após a configuração do projeto e a criação dos POJOs e mapeamentos (ver Manualdo Framework), o usuário está apto a cadastrar as classes da camada DAO (Data AccessObject).O

Figura 3.1 – Tela de Criação de DAOs

18




Conforme podemos observar na figura acima, a tela de DAO é dividida em três partes,são elas: Lista de DAOs já cadastrados; os botões adicionar, remover e editar; e a área deedição do DAO. Clicando em algum item da lista de DAOs, o usuário poderá observar, na

área de edição, os dados do DAO selecionado e caso tenha a necessidade de alterar algodeverá iniciar a edição deste clicando no botão Editar.

A adição e remoção de DAOs são feitas através dos botões Adicionar e Remover,respectivamente. Após o término da adição/edição/remoção dos DAOs, o usuário deverásalvar as alterações (botão Salvar da área de edição) ou cancelar (botão Cancelar da áreade edição).

IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar nobotão aplicar da tela principal ou no botão Finish do Wizard. Após a edição dos DAOs, aseguinte mensagem deverá aparecer na tela: "DAOs editados com sucesso."


● Pacote Para selecionar o pacote que o DAO será criado o usuário deve clicar no botão Pesquisar e selecioná-lo na tela de seleção de pacotes similar aexibida na figura 3.2.

Figura 3.2 – Seleção de Pacote

19




● POJO Para selecionar o POJO que o DAO utilizará será criado o usuário deveclicar no botão Pesquisar e selecioná-lo na tela de seleção de POJOs similar aexibida na figura 3.3.

Figura 3.3 – Seleção de POJO

● Tipo O campo tipo irá definir o tipo de implementação do DAO, as opções são:Hibernate, JDBC e Adabas.


Ao salvar as alterações o Plugin irá criar as interfaces e implementações dos DAOSeditados/criados de acordo com o tipo selecionado.

20




Figura 3.4 – Interface gerada para o POJO Aluno

Figura 3.5 – Implementação gerada para o POJO Aluno e tipo Hibernate

21




3.2. Geração de Business Controllers

Após a configuração do projeto, a criação dos POJOs e mapeamentos (ver Manual doDemoiselle) e a criação dos DAOs do projeto, o usuário está apto a cadastrar as classes dacamada Business Controller.

Figura 3.6 – Tela de Cadastro de Business Controllers

Conforme podemos observar na figura 3.6, a tela de Business Controller é dividida emtrês partes, são elas: Lista de Business Controllers já cadastrados; os botões adicionar,remover e editar; e a área de edição do Business Controller. Clicando em algum item dalista de Business Controllers ,o usuário poderá observar, na área de edição, os dados doBusiness Controller selecionado e caso tenha a necessidade de alterar algo deverá iniciar aedição deste clicando no botão Editar.

A adição e remoção de Business Controllers são feitas através dos botões Adicionar eRemover respectivamente. após o término da adição/edição/remoção dos BusinessControllers, o usuário deverá salvar as alterações (botão Salvar da área de edição) ou

cancelar (botão Cancelar da área de edição).c

IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar no

22




botão aplicar da tela principal ou no botão Finish do wizard. Após a edição dos BusinessControllers, a seguinte mensagem deverá aparecer na tela: "Business Controllerseditados com sucesso."


● Pacote de constantes: Este campo identifica o pacote onde será gravado aclasse (AliasNavigationRule.java) que conterá o conjunto de constantes que,identifica todos os casos de navegação existentes. Estas constantes serãoutilizadas no cadastro dos métodos do Managed Bean.

● Identificador da Regra de Navegação: Este campo identifica o conjunto decasos de navegação cadastrados nos campos abaixo.

● Casos de Navegação: O grupo Casos de navegação irá definir todas aspossíveis páginas de saída para a regra.

○

Identificador : Este campo é o identificador do caso de navegação, é através deleque o framework identifica qual caso de navegação foi selecionado nas ações dousuário.

○ Página de Destino: O campo página de destino define qual apágina que será executada se o caso de navegação for selecionadoapós a execução da regra de Navegação.


Ao salvar as alterações, o Plugin irá editar o arquivo de configuração JSF na área deRegras de Navegação.

23




3.3. Geração de Regras de Navegação.

A tela de Navegação é dividida em três partes, são elas: Lista das Regras deNavegação já cadastradas; os botões adicionar, remover e editar; e a área de edição dasRegras. Clicando em algum item da lista, o usuário poderá observar, na área de edição, osdados da Regra selecionada e caso tenha a necessidade de alterar algo deverá iniciar aedição deste clicando no botão Editar. A adição e remoção das Regras de Navegação sãofeitas através dos botões Adicionar e Remover respectivamente. após o término daadição/edição/remoção das Regras de Navegação, o usuário deverá salvar as alterações(botão Salvar da área de edição) ou cancelar (botão Cancelar da área de edição)

Tela de Cadastro de Regras de Navegação

IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar nobotão aplicar da tela principal ou no botão Finish do wizard. Após a edição das Regras deNavegação, a seguinte mensagem deverá aparecer na tela: "Regras de Navegaçãocadastradas com sucesso."

24





• Pacote de constantesEste campo identifica o pacote onde será gravado a classe(AliasNavigationRule.java) que conterá o conjunto de constantes que identificamtodos os casos de navegação existentes. Estas constantes serão utilizadas nocadastro dos métodos do Managed Bean.

• Identificador da Regra de Navegação Este campo identifica o conjunto de casos de navegação cadastrados nos camposabaixo.

• Casos de Navegação O grupo Casos de navegação irá definir todas as possíveis páginas de saída para aregra.

• Identificador

Este campo é o identificador do caso de navegação, é através dele que oframework identifica qual caso de navegação foi selecionado nas ações dousuário.

• Página de Destino O campo página de destino define qual a página que será executada se o casode navegação for selecionado após a execução da regra de Navegação.


Ao salvar as alterações, o Plugin irá editar o arquivo de configuração JSF na área deRegras de Navegação.

25




3.4. Geração de Managed Beans

Após a criação dos Business Controllers e das Regras de navegação, o usuário estáapto a cadastrar as classes da camada Managed Bean.

Figura 3.4 - Tela de Cadastro de Managed Beans

Conforme podemos observar na figura 3.4, a tela de Managed Bean é dividida em trêspartes, são elas: Lista de Managed Beans já cadastrados; os botões adicionar, remover eeditar; e a área de edição do Managed Bean. Clicando em algum item da lista de ManagedBeans o usuário poderá observar, na área de edição, os dados do Managed Beanselecionado e caso tenha a necessidade de alterar algo deverá iniciar a edição desteclicando no botão Editar.

A adição e remoção de Managed Beans são feitas através dos botões Adicionar eRemover respectivamente. após o término da adição/edição/remoção dos Managed Beans

o usuário deverá salvar as alterações (botão Salvar da área de edição) ou cancelar (botãoCancelar da área de edição).

26




IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar nobotão aplicar da tela principal ou no botão Finish do wizard. Após a edição dos ManagedBeans, a seguinte mensagem deverá aparecer na tela: "Managed Beans editados com

sucesso."


● Nome: O campo nome indica o nome do Managed Bean a ser criado/editado.● Pacote: Para selecionar o pacote que o Managed Bean será criado o usuário

deve clicar no botão Pesquisar e selecioná-lo na tela de seleção de pacotessimilar a exibida na figura 3.8.

● Nome da variável O campo nome da variável indica a variável que será criadae colocada no escopo para o Managed Bean ser utilizado nas páginas da

aplicação.● Escopo O campo escopo indica o tipo de escopo do Managed Bean, as

opções são: application, request e session.● Business Controller O campo Business Controller indicará qual a Interface

BC que o Managed Bean irá acessar. Este campo é opcional.● POJOs Para selecionar e inserir os POJOs que o Managed Bean utilizará, o

usuário deve clicar no botão Pesquisar, selecioná-lo na tela de seleção dePOJOs similar a exibida na figura 3.9 e depois incluir o POJO. Para remover algum POJO basta selecioná-lo e clicar no botão Remover.

● Ações: Para inserir, editar e remover as ações do Managed Beans basta clicar

nos botões de controle ao lado da tabela e selecionar o nome da ação e oretorno desta no popup que irá abrir na tela.


27




Figura 3.9 – Seleção de POJO


Ao aplicar as alterações o Plugin irá editar o arquivo de configuração JSF na área demanaged beans com as alterações feitas pelo usuário. Além disso o plugin criará as classesdos Managed Beans editados/criados.

Figura 3.10 – Classe gerada para o POJO Aluno

28




3.5. Geração de Fachadas

Após a criação dos Business Controllers, o usuário também estará apto a cadastrar classes do tipo Fachada.

Figura 3.11 – Tela de Cadastro de Fachadas

Conforme podemos observar na figura acima, a tela de Fachadas é dividida em trêspartes, sendo elas: Lista de Fachadas já cadastrados; os botões adicionar, remover e editar;e a área de edição da fachada. Clicando em algum item da lista de Fachadas o usuáriopoderá observar, na área de edição, os dados da Fachada selecionado e caso tenha anecessidade de alterar algo deverá iniciar a edição deste clicando no botão Editar.

A adição e remoção de Fachadas são feitas através dos botões Adicionar e Remover respectivamente. após o término da adição/edição/remoção dos Fachadas o usuário deverásalvar as alterações (botão Salvar da área de edição) ou cancelar (botão Cancelar da áreade edição).

29




IMPORTANTE : Todas as alterações feitas só serão aplicadas após o usuário clicar nobotão aplicar da tela principal ou no botão Finish do wizard. Após a edição das Fachada, aseguinte mensagem deverá aparecer na tela: "Fachada editadas com sucesso."


● Nome : O campo nome indica o nome da classe Fachada a ser criada/editada.● Pacote: Para selecionar o pacote onde a Fachada será criado o usuário deve

clicar no botão Pesquisar e selecioná-lo na tela de seleção de pacotes similar a exibida na figura 3.12.


●

Business Controller : O campo Business Controller indicará qual a interfaceBC que a Fachada irá acessar. Este campo é opcional.


Ao aplicar as alterações o Plugin irá criar as classes das Fachadas editadas/criadas.

30




Figura 3.13 – Fachada gerada para o BC Aluno

31




3.6. Geração de Testes Unitários

Após a configuração do projeto, a criação dos Pojos e mapeamentos (ver Manual doDemoiselle) e a criação das diversas camadas da aplicação, o usuário deve desenvolver osTestes Unitários para estas diversas classes do sistema. Para isso o Wizard prove umafuncionalidade que irá gerar estes testes de acordo com a Interface da camada a ser testada no padrão do componente Junit (http://www.junit.org/).

Tela de Cadastro de Testes Unitários

Conforme podemos observar na figura acima, a tela de Testes Unitários é dividida emtrês partes, são elas: Lista de Testes Unitários já cadastrados; os botões adicionar eremover; e a área de edição do Teste Unitário. Clicando em algum item da lista de TestesUnitários o usuário poderá observar, na área de edição, os dados do Teste Unitárioselecionado. A adição e remoção de Testes Unitários são feitas através dos botõesAdicionar e Remover respectivamente, após o término da adição/remoção dos TestesUnitários o usuário deverá salvar as alterações (botão Salvar da área de edição) oucancelar (botão Cancelar da área de edição).

32

http://www.junit.org/

http://www.junit.org/





• Tipo de Interface O campo tipo de Interface indica qual a camada alvo para a criação dos testes. As

opções são: DAO, Busines Controller, Managed Bean e Façade

• Classe Alvo para geração dos testes Selecionar, através do botão pesquisar qual Interface servirá de base para a geraçãoda classe de testes.


Ao salvar as alterações, o Plugin irá criar as classes no diretório padrão de testes(src/test/java) com a mesma estrutura de pacote da classe base.

33




3.7. Criar páginas

A criação das páginas da aplicação tem dois requisitos: Os POJOs que serãoutilizados e o Managed Bean da entidade. O wizard possui dois passos, o primeiro, ousuário seleciona o local das páginas e quais os tipos de páginas que serão cadastradas,no segundo passo o usuário deverá preencher os diversos campos de cada página antes degerá-las.

A seguir, na figura 3.14 a primeira tela do wizard e as caixas de opções links para asdemais. Após o segundo passo, o usuário deverá clicar no botão Finish para criar aspáginas ou em Cancelar, para cancelar a operação sem nenhuma alteração.


● Diretório: Para selecionar o diretório onde as páginas serão criadas o usuário

deve clicar no botão Pesquisar e selecioná-lo na tela de seleção de diretóriossimilar a exibida na figura 3.15.

● Modelos: Selecionar os tipos de páginas que serão criadas, as opções são:Página de listagem, Página de visualização, Página de edição. O usuário deveselecionar pelo menos um modelo para continuar a criação das páginas.

Figura 3.14 – Tela de seleção das páginas

34




Figura 3.15 – Seleção de Diretório

3.7.2. Cadastro da Página de Listagem

Ao selecionar na tela inicial o modelo "Listagem" e passar para a próxima tela, estapossuirá uma aba para o cadastro da página de Listagem, vide figura 3.16. O usuáriodeverá definir o Managed Bean e o nome da página (campos obrigatórios), este últimodeverá possuir a extensão ".jsp". Os demais itens não são obrigatórios mas deverão ser preenchidos para o correto funcionamento da página que será criada.

35




Figura 3.16 – Tela de Cadastro da Página de Listagem

3.7.2.1. Descrição dos Campos

● Nome do arquivo: O campo nome do arquivo deverá conter uma sequenciade caracteres válidos para nome de arquivo, se a extensão não for informadaserá assumido ".xhtml".

● Managed Bean : Para selecionar o managed bean que a página estaráassociada basta clicar no botão Pesquisar e selecioná-lo.

● POJO: O campo POJO indica qual a variável será utilizada na iteração dapágina.

● Filtros: O grupo Filtros definirá quais campos dos objetos do Managed Beanserão filtros da pesquisa.

○ Campo : Nome do campo que será filtro.○ Rótulo: Rótulo que aparecerá na página identificando o filtro.○ Tipo: Tipo do campo, as opções são:

■ calendar : Campo de edição seguido de um botão queexibe um calendário para o usuário selecionar a data.

■ inputText: Campo de edição.■ inputHidden : Campo oculto.■ selectOneMenu : Combo com vários itens para o usuário

selecionar um.■ selectOneRadio : Grupo de itens para o usuário selecionar

36




um.■ selectManyCheckbox : Grupo de itens para o usuário

selecionar vários.

■ outputText: Campo de visualização.■ graphicImage : Imagem.

● Colunas: O grupo Colunas definirá quais as ações e os campos dos objetosdo Managed Bean serão colunas na listagem de objetos que satisfizeram apesquisa.

○ Ação(Caixa de seleção): Indica se a coluna é uma Ação (ex.:Exibir, alterar ou excluir) ou se é um Campo vindo do ManagedBean.

○ Ação: Nome da ação que representa a coluna. Somente quando acoluna for uma ação.

○ Campo: Nome do campo que será coluna. Somente quando acoluna não for uma ação.

○ Rótulo: Rótulo que aparecerá na tela identificando a coluna.

3.7.2.2. Descrição das Alterações

Ao salvar as alterações(botão Finish) o Plugin irá criar a página de listagem bem comoas demais páginas selecionadas.

3.7.3. Cadastro da Página de Visualização3

Ao selecionar na tela inicial o modelo "Visualização" e passar para a próxima tela, estapossuirá uma aba para o cadastro da página de Visualização, vide figura 3.17. O usuáriodeverá definir o Managed Bean e o nome da página (campos obrigatórios). Os demais itensnão são obrigatórios, mas deverão ser preenchidos para o correto funcionamento da páginaque será criada.

37



Manual Demoiselle Wizard – CETECM

Figura 3.17 – Tela de Cadastro da Página de Visualização


● Nome do arquivo O campo nome do arquivo deverá conter uma sequencia decaracteres seguido da extensão ".jsp".

● Managed Bean Para selecionar o managed bean que a página estaráassociada basta clicar no botão Pesquisar e selecioná-lo.

● Tipo de campo O Tipo do campo indica se todos os campos da tela serão dotipo OutPut (campo de visualização) ou se será do tipo InPut (campo de ediçãodo tipo somente leitura)

● Campos O grupo Campos definirá quais campos do objeto do Managed Beanserão exibidos na página.

● Campo Nome do campo que será exibido.● Rótulo Rótulo que aparecerá na página identificando o campo.

● Detalhes O grupo Detalhes definirá quais PropertyHelpers do Managed Beanterão um relacionamento de Mestre X Detalhe na página.

○ Botão Remover Detalhe Remove o detalhe selecionado na tabela.○ Botão Editar Detalhe Para editar o detalhe selecionado na tabela,

deve-se clicar neste botão, abrirá uma tela para a seleção doscampos, colunas e detalhes do detalhe.

38





Ao salvar as alterações(botão Finish) o Plugin irá criar a página de visualização bemcomo as demais páginas selecionadas.

3.7.4. Cadastro da Página de Edição

Ao selecionar na tela inicial o modelo "Edição" e passar para a próxima tela, estapossuirá uma aba para o cadastro da página de Edição, vide figura 3.18. O usuário deverádefinir o Managed Bean e o nome da página (campos obrigatórios). Os demais itens nãosão obrigatórios mas deverão ser preenchidos para o correto funcionamento da página queserá criada.

Figura 3.18 – Tela de Cadastro da Página de Edição


● Nome do arquivo O campo nome do arquivo deverá conter uma sequencia decaracteres seguido da extensão ".jsp".

● Managed Bean Para selecionar o managed bean que a página estaráassociada basta clicar no botão Pesquisar e selecioná-lo.

● Campos O grupo Campos definirá quais campos do objeto do Managed Beanserão exibidos na página.

○ Campo Nome do campo que será exibido.○ Rótulo Rótulo que aparecerá na página identificando o campo.

○ Tipo Tipo do campo, as opções são:■ calendar : Campo de edição seguido de um botão que

exibe um calendário para o usuário selecionar a data.

39




■ inputText: Campo de edição.■ inputHidden : Campo oculto.■ selectOneMenu : Combo com vários itens para o usuário

selecionar um.■ selectOneRadio : Grupo de itens para o usuário selecionar

um.■ selectManyCheckbox : Grupo de itens para o usuário

selecionar vários.■ outputText: Campo de visualização.■ graphicImage : Imagem.:

● Detalhes O grupo Detalhes definirá quais PropertyHelpers do Managed Beanterão um relacionamento de Mestre X Detalhe na página.

○ Botão Remover Detalhe Remove o detalhe selecionado na tabela.

○ Botão Editar Detalhe Para editar o detalhe selecionado na tabela,deve-se clicar neste botão, abrirá uma tela para a seleção doscampos, colunas e detalhes do detalhe.


Ao salvar as alterações(botão Finish) o Plugin irá criar a página de edição bem comoas demais páginas selecionadas.

4 – Tutorial para uso

No link link abaixo está disponível um tutorial que demonstra o uso do Wizard paraapoio ao desenvolvimento de uma aplicação no padrão Demoiselle.

http://www.frameworkdemoiselle.gov.br/menu/framework/manuais-e-tutoriais

40



Documents

Demoiselle Wizard Manual