Demoiselle Nimble

Guia do Usurio

Emerson Saito Rodrigo Hjort Serge Rehem

Guia do usurio ..................................................................................................................... v 1. Sobre Demoiselle Nimble .................................................................................................... 1 1.1. O que ................................................................................................................. 1 1.2. Templates Disponveis ............................................................................................... 1 2. Instalao ........................................................................................................................ 3 2.1. Via pacotes Debian GNU/Linux .................................................................................... 3 2.2. Instalao a partir do download .................................................................................... 3 3. Guia Rpido ..................................................................................................................... 3.1. Interface Grfica ....................................................................................................... 3.1.1. Templates de Criao de Aplicaes ................................................................... 3.1.2. Templates de Gerao de CRUD para JSF e VAADIN com Demoiselle v2.x .................... 5 5 6 6

3.1.3. Template de Gerao de CRUD para JSF com Demoiselle v1.x .................................. 7 3.2. Linhas de comando ................................................................................................... 8 3.2.1. Executando em ambiente LINUX ........................................................................ 8 3.2.2. Executando em ambiente MS-Windows ................................................................ 9 4. Plugin para Eclipse IDE .................................................................................................... 11 4.1. Instalao ............................................................................................................. 11 4.1.1. Instalao no Eclipse Indigo ou superior .............................................................. 11 4.1.2. Instalao em verses antigas. ......................................................................... 15 4.2. Instrues de Uso ................................................................................................... 17 5. Plugin para NetBeans IDE ................................................................................................. 19 5.1. Instalao ............................................................................................................. 19 5.2. Instrues de Uso ................................................................................................... 22 6. Exemplo usando Eclipse IDE ............................................................................................. 25 6.1. Prepararao ......................................................................................................... 25 6.2. Gerando uma aplicao Web Tradicional ....................................................................... 30 6.3. Gerando uma aplicao Web Mobile ............................................................................ 33

iii

iv

Guia do usurio
Apresentamos o guia do usurio do Demoiselle Nimble, que uma ferramenta de apoio ao Desenvolvimento do Demoiselle Framework a partir da verso 2.0.

Importante
O Demoiselle Nimble est disponvel para o usurio final nas seguintes opes:

Desktop Eclipse Plugin NetBeans Plugin

vi

Sobre Demoiselle Nimble

Informaes bsicas sobre a ferramenta

1.1. O que
O Demoiselle Nimble um processador automatizado de templates , sendo estes genricos e podendo inclusive ser criados pelo prprio utilizador. Podemos consider-lo como uma evoluo da ferramenta atual o Demoiselle Wizard Eclipse Plugin [http:// demoiselle.sourceforge.net/wizard/] que como o prprio nome j diz um especificamente um plugin para a IDE Eclipse
1

Nota
Um processador de templates (i.e., template processor, tambm conhecido como template engine ou template parser) um software ou um componente de software projetado para combinar um ou mais templates com um modelo de dados a fim de produzir um ou mais documentos resultantes, podendo estes serem pginas web, arquivos de texto ou cdigos fontes.

No caso especfico do Demoiselle Nimble, no template so definidas estruturas de arquivos e scripts de transformao utilizando linguagens como Velocity e Groovy. Uma vez iniciado o processamento, este faz uso de variveis cujos valores foram definidos pelo usurio e que permitem com que os diretrios e arquivos resultantes possam ser dinamicamente criados e ou modificados.

1.2. Templates Disponveis

So disponibilizados com o Demoiselle Nimble os seguintes templates voltados para a gerao automtica de cdigo para o Framework Demoiselle: Demoiselle v1 Create JSF Application: cria a estrutura bsica de uma aplicao baseada no Demoiselle Framework Verso 1.x Demoiselle v1 Generate CRUD: cria os artefatos para as funcionalidades de CRUD (Create, Read, Update and Delete) de uma entidade no Demoiselle Framework Verso 1.x Demoiselle V2 Create JSF Application: Demoiselle) Demoiselle v2 Create VAADIN Application: cria uma aplicao baseada na extenso Demoiselle Vaadin (com Demoiselle Framework verso 2.x) Demoiselle v2 Generate JSF-PrimeFaces2 CRUD: cria todos os artefatos necessrios para as funcionalidades CRUD (Create, Read, Update and Delete) de uma dada entidade baseando-se no Demoiselle Framework verso 2.x, e utilizando a biblioteca JSF2 PrimeFaces verso 2.x Demoiselle v2 Generate JSF2 (PrimeFaces3 Mobile) CRUD: cria todos os artefatos necessrios para o CRUD (Create, Read, Update and Delete) de uma dada entidade baseando-se no Demoiselle Framework verso 2.x, e utilizando a biblioteca JSF2, especializada para WEB Mobile, PrimeFaces-Mobile verso 3.x
1

cria uma aplicao completa e funcional baseada no Demoiselle

Framework verso 2.x com JSF e JPA (usa internamente um arqutipo Maven da verso mais recente do

Para informaes gerais sobre utilitrios processadores de template, acesse o site http://en.wikipedia.org/wiki/ Template_processor

Captulo 1. Sobre Demoiselle ...

Demoiselle v2 Generate JSF2 (PrimeFaces 3) CRUD: cria todos os artefatos necessrios para o CRUD (Create, Read, Update and Delete) de uma dada entidade baseando-se no Demoiselle Framework verso 2.x, e utilizando a biblioteca JSF2 PrimeFaces verso 3.x Demoiselle v2 Generate Vaadin CRUD: cria os artefatos para o CRUD de uma entidade na extenso Demoiselle Vaadin (com Demoiselle Framework verso 2.x)

Instalao
Orientaes de instalao e configurao para o modo Desktop Atualmente h dois modos para fazer a instalao do Demoiselle Nimble, que so:

2.1. Via pacotes Debian GNU/Linux

Foi disponibilizado um pacote Debian chamado demoiselle-nimble para o Demoiselle Nimble no repositrio do projeto Demoiselle Infra. Para instal-lo nesta plataforma, basta executar o comando a seguir em um terminal do Linux:

# apt-get install demoiselle-nimble

Para maiores informaes sobre a configurao e o modo de utilizao dos pacotes de software do projeto Demoiselle Infra para Linux, acesse o site http://demoiselle.sourceforge.net/infra/

Nota
Recomendamos utilizar a soluo Demoiselle Infra, que ir resolver as outras questes de ambiente de desenvolvimento para o Demoiselle

2.2. Instalao a partir do download

Pr-requisitos Antes de comear a usar o Demoiselle Nimble, voc precisa ter instalado ou instalar uma JDK - Java Development Kit. Nos sistemas operacionais linux recomendamos a OpenJDK Nos sistemas operacionais proprietrios normalmente est disponvel a implementao da Oracle: Site de Download da SUN-JDK [http://www.oracle.com/technetwork/java/javase/downloads/index.html] Veja que no basta ter simplesmente uma JRE - Java Runtime Environment, necessria uma JDK pois o Nimble executa operaes que necessitam de bibliotecas que no esto disponveis numa JRE. Alm disso, preciso definir a varivel de ambiente JAVA_HOME apontando para o caminho onde se localiza a JDK (ex: /usr/lib/jvm/ java-6-openjdk/).

Exemplo SO LINUX.

export JAVA_HOME=/usr/lib/jvm/java-6-openjdk/

No LINUX, preciso incluir no arquivo /etc/profile

Exemplo SO ms-windows.

set JAVA_HOME=C:\Arquivos de programas\Java\jdk1.6.0_17\

3

Captulo 2. Instalao

Para ms-windows, o indicado abrir as configuraes de ambiente (Icone Meu Computador) e incluir uma nova varivel de ambiente.

Nota
Recomenda-se utilizar a verso 1.5 ou superior da JDK. Porm se seu objetivo utilizar a verso 2.0 do Demoiselle a verso mnima recomendada a 1.6

Para utilizar alguns dos templates de criao de aplicaes (create-app-*), tambm preciso ter instalado e configurado o APACHE MAVEN [http://maven.apache.org] No ambiente LINUX Ubuntu/Debian o pacote Demoiselle Infra tambm j fornece um pacote para esta ferramenta:

# apt-get install demoiselle-maven2

Na pgina de Download [http://maven.apache.org/download.html] h uma seo chamada Installation Instructions que orienta a instalao e configurao desta ferramenta. Passo a passo Faa o Download [http://sourceforge.net/projects/demoiselle/files/tools/nimble] da ltima release do Demoiselle Nimble (disponvel nos formatos ZIP e TGZ) Extraia os arquivos em uma localizao conveniente (ex: C:\Demoiselle no Windows ou ~/demoiselle no Linux) Crie uma varivel chamada DEMOISELLE_HOME que aponte para o caminho definido no passo anterior

Exemplo SO LINUX.

export DEMOISELLE_HOME=~/demoiselle export PATH=$PATH:$DEMOISELLE_HOME/bin

No LINUX, preciso incluir no arquivo /etc/profile Altere os direitos dos arquivos em "/bin" para permisso de execuo chmod +x $DEMOISELLE_HOME/bin/demoiselle

Exemplo SO ms-windows.

set DEMOISELLE_HOME=C:\Demoiselle set DEMOISELLE=%DEMOISELLE_HOME%\bin set PATH=%PATH%;%DEMOISELLE%

Para ms-windows, o indicado abrir as configuraes de ambiente (Icone Meu Computador) e incluir novas variveis de ambiente. Abra um prompt de comando (no Windows) ou um terminal (no Linux) e digite o comando "demoiselle" a fim de verificar o sucesso da instalao

Guia Rpido
Guia de uso para o modo Desktop Aps a instalao e configurao do Demoiselle Nimble no ambiente Desktop (Linux ou ms-windows) a ferramenta estar pronta para execuo. As formas de execuo esto dividas em 2(dois) modos:

3.1. Interface Grfica

O Demoiselle Nimble apresenta uma opo de interface grfica do tipo JAVA-SE SWING [http://java.sun.com/docs/ books/tutorial/uiswing/] e seu acionamento simples, basta abrir um prompt de comando (no Windows) ou um terminal (no Linux) e digite o comando:

demoiselle -g
Para usurios do ms-windows acostumados a usar o windows Explorer para encontrar os arquivos instalados no computador, basta tambm procurar o arquivo demoiselle.bat localizado na pasta /bin do diretrio onde foi "instalado" o Demoiselle Nimble. Ao acionar este arquivo desta maneira o "defaul" a interface grfica.

Interface Grfica do Demoiselle Nimble. Tela Principal Nesta tela Inicial h o boto Browse... que permite que seja selecionado o diretrio onde esto os Templates a serem executados. Com a instalao do Demoiselle Nimble o diretrio /templates criado com os "defaults" disponibilizados pelo Demoiselle. Lembrando que tambm possvel serem criados novos. Nesta tela, alm da possibilidade de escolha dos diretrios de templates, deve ser selecionado o Template que deseja executar. E clicar no boto Next > para prossegir a execuo. As funes dos demais botes, na parte inferior da tela, so:

<Back: Retorna tela anterior (Desabilitado na primeira tela)

Captulo 3. Guia Rpido

Next >: Segue para a ao seguinte (prxima tela) Cancel: Cancela a operao e fecha a interface grfica. Finish Aciona a execuo do Template. S habilitado quando todas as variveis (informaes) necessrias foram completadas Para os Templates fornecidos pelo Demoiselle, conforme forem escolhidos na tela principal, sero apresentadas as seguintes telas:

3.1.1. Templates de Criao de Aplicaes

Tela dos Templates de Criao de Aplicao As informaes solicitadas nas telas so as mesmas para criao de aplicaes JSF com Demoiselle v1, JSF com Demoiselle v2 e Vaadin com Demoiselle v2, pois o Template faz somente a chamada ao Maven e aciona o arqutipo Demoiselle j disponvel no repositrio no SourceForge Sendo elas: 1.Output Folder: Informar ou selecionar (usando boto "Browse...") em qual diretrio deseja que o projeto seja criado. A dica aqui usar o diretrio do workspace, se deseja usar o Eclipse como IDE de Desenvolvimento 2.Package Name: Informar o nome do pacote JAVA padro da sua aplicao (ex: br.org.frameworkdemoiselle.) 3.Project Name: O nome da aplicao/Projeto a ser criada. 4.Version O nmero da verso inicial.

3.1.2. Templates de Gerao de CRUD para JSF e VAADIN com Demoiselle v2.x
Um CRUD acrnimo de Create, Retrieve, Update e Delete em lngua Inglesa, so as operaes bsicas relacionadas ao uso de bancos de dados em aplicaes, assim nestes Templates, os produtos gerados so as classes para implementao destas operaes, e tambm todos os artefatos de configurao e interface (pginas XHTML).

Template de Gerao de CRUD para JSF com Demoiselle v1.x

Tela dos Templates de Gerao de CRUD para Aplicaes JSF e VAADIN com Demoiselle v2.x So estas as informaes necessrias para o processamento destes templates

1.Output Folder: Informar ou selecionar (usando boto "Browse...") em qual diretrio deseja que o projeto seja criado. A dica aqui usar o diretrio do workspace, se deseja usar o Eclipse como IDE de Desenvolvimento 2.Package Name: Informar o nome do pacote JAVA padro da sua aplicao (ex: br.org.frameworkdemoiselle.) 3.Entity Name: O nome da Entidade para qual ser gerado o CRUD

3.1.3. Template de Gerao de CRUD para JSF com Demoiselle v1.x

Para verso 1.x do Demoiselle Framework a apresentao da tela apresenta uma pequena diferena

Captulo 3. Guia Rpido

Tela do Templates de Gerao de CRUD para Aplicaes JSF com Demoiselle v1.x So estas as informaes necessrias para o processamento deste template 1.Output Folder: Informar ou selecionar (usando boto "Browse...") em qual diretrio deseja que o projeto seja criado. A dica aqui usar o diretrio do workspace, se deseja usar o Eclipse como IDE de Desenvolvimento 2.Package Name: Informar o nome do pacote JAVA padro da sua aplicao (ex: br.org.frameworkdemoiselle.) 3.Entity Name: O nome da Entidade para qual ser gerado o CRUD 4.Use CRUD component: Esta opo deve ser marcada quando a aplicao alvo utiliza o componente DemoiselleCRUD.

3.2. Linhas de comando

A outra opo para uso do Demoiselle Nimble para Desktop atravs de linhas de comando. E neste caso havero algumas diferena conforme o Sistema Operacional que estiver sendo utilizado. Assim neste guia dividermos os exemplos sees para cada um. Um dos motivos para se usar linha de comando a possibilidade passagem de parmetros para o aplicativo, os parmetros do Demoiselle Nimble so estes: -h: apresenta um texto de ajuda. -g: aciona a inteface grfica. -i: informa o diretrio de templates -o: especifica o diretrio de saida, onde sero gerados os artefatos <<Nome do Template>>: Nome do template a ser processado -v []lista de variveis=valor: lista com variveis que sero usadas pelo template

3.2.1. Executando em ambiente LINUX

Boa parte dos usurios LINUX esto habituados a utilizar os terminais de linhas de comando para executar operaes com aplicativos, assim o Demoiselle Nimble tambm oferece esta opo. Tendo sido configuradas corretamente as variveis de ambiente, as seguintes operaes podem ser executadas: demoiselle <<Nome do Template>> Exemplo

demoiselle create-app-jsf
demoiselle <<Nome do Template>> <<Parmetros>> Exemplo

demoiselle create-app-jsf -i /templates/ -o /temp/

Executando em ambiente MS-Windows

demoiselle create-app-jsf -i /templates/ br.gov.frameworkdemoiselle.sample myApp 1.0.0

Tambm possvel passar parmetros para a interface Grfica Exemplo

-o

/temp/

demoiselle create-app-jsf -g -i ../templates/ -o /temp/

demoiselle create-app-jsf -g -i ../templates/ br.gov.frameworkdemoiselle.sample myApp 1.0.0

-o

/temp/

3.2.2. Executando em ambiente MS-Windows

Embora os usurio de sistemas operacionais MS-windows no costumem utilizar terminais de linhas de comandos, o Demoiselle-Nimble tambm oferece este opo. Atualmente com algumas diferenas no uso, por ser a primeira verso do script (.bat) Novamente, preciso que tenham sido configuradas corretamente as variveis de ambiente, e abrir um "Prompt de Comando" para que as seguintes operaes possam ser executadas:

demoiselle <<Parmetros>> Exemplo

demoiselle -i c:\temp\templates\create-app-jsf -o c:\temp\

demoiselle -i c:\temp\templates\crate-app-jsf projectName=ProjetoNovo

Tambm possvel passar parmetros para a interface Grfica Exemplo

-o

c:\temp

-v

demoiselle -g -i c:\temp\templates\create-app-jsf -o c:\temp

MS-Windos marca registrada da Microsoft

10

Plugin para Eclipse IDE

Guia de uso para o Puglin para Eclipse Uma das opes de uso do Demoiselle Nimble a sua integrao IDE Eclipse [http://www.eclipse.org/downloads/] atravs de um plugin. A vantagem no uso deste plugin que com a sua integrao com a IDE, alguns parmetros como diretrios de Templates, diretrio de sada, nome do projeto, podem ser fornecidos automaticamente pela prpria IDE. Como o Demoiselle-Nimble foi concebido para ser independente de Plataforma, o Eclipse faz apenas a chamada interface grfica do Demoiselle-Nimble passando os parmetros necessrios e as atulizaes no ambiente (workspace). Assim, as instrues de uso dos templates so as mesmas contidas no Guia - Interface Grfica Neste captulo vamos nos ater apenas os detalhes referentes intalao e uso no Eclipse

4.1. Instalao
Aqui, lembramos novamente que para usurios LINUX/DEBIAN existe o projeto Infra http:// demoiselle.sourceforge.net/infra/ que facilita a instalao das ferramentas que o Demoiselle recomenda para uso em seu desenvolvimento. Usando o pacote mais atual no necessrio fazer a instalao. Neste caso s seguir para o item: Seo 4.2, Instrues de Uso

4.1.1. Instalao no Eclipse Indigo ou superior

Nas verses mais atuais existe um servio chamado Eclipse MarketPlace, que facilita bastante o processo de instalao de plugins. O primeiro passo encontrar esse item no Eclipse. Acione o menu: Help -> Eclipse Marketplace, como mostra a figura abaixo:

11

Captulo 4. Plugin para Eclip...

Eclipse Marketplace No prximo passo, digete a palavra Demoiselle no campo de busca e clique no boto GO Aps carregado o resultado da pesquisa localize o item Demoiselle Nimble Eclipse Plugin e clique no boto Install

12

Instalao no Eclipse Indigo ou superior

Localizando Demoiselle Nimble no Eclipse Marketplace Na tela seguinte, verifique se os itens esto selecionados e clique no boto Next >

Selecionando o plugin Na tela seguinte, preciso aceitar a licena, clicar no boto Finish

13

Captulo 4. Plugin para Eclip...

Aceitando a licena Durante este processo, a tela abaixo pode ser apresentada, apenas um aviso sobre a assinatura da bibliteca , basta clicar no boto OK

Aviso sobre assinatura da biblioteca Depois aguarde o processo de instalao terminar

Aceitando a licena Ao final o Eclipse precisar ser reiniciado.

14

Instalao em verses antigas.

Aceitando a licena Depois de reiniciado, veja Seo 4.2, Instrues de Uso

4.1.2. Instalao em verses antigas.

Os pr-requisitos para o uso da Plugin so os mesmos para o Modo Desktop alm claro da IDE Eclipse instalada No Eclipse 3.6 (Helios) ou superior acione o menu Help Install New Software No Eclipse 3.5 (Helios) ou anterior acione o menu Help Software Updates A tela seguinte dever ser apresentada

Imagem da Tela de instalao de Plugins para Eclipse Clique no boto Add... para incluir um novo repositrio, conforme a figura abaixo

Tela para incluso de novo repositrio de plugin

15

Captulo 4. Plugin para Eclip...

Nesta tela preecha as seguintes informaes: Name:Demoiselle Nimble Location:http://demoiselle.sourceforge.net/nimble/updatesite Voltando tela anterior, que dever ser atualizada assim:

Imagem da Tela de instalao de Plugins para Eclipse, com novo repositrio No quadro onde aparecem as opes Name e Version Procure e marque a verso mais atual.Em seguida clique no boto Next >

16

Instrues de Uso

Imagem da Tela de detalhes da instalao do Plugin Se no houver erros ou avisos, clique no boto Next > Na ltima tela marque a opo de aceite da licena e clique no boto Finish

Imagem da Tela de aceite da licena Aguarde a instalao e reinicie o Eclipse, conforme ser sugerido pelo prprio

4.2. Instrues de Uso

Feita a instalao conforme as opes anteriores, j possivel executar o Demoiselle Nimble, os acionadores esto em:

Um cone na barra de ferramentas:

Icone do Demoiselle Nimble na barra de ferramentas Em um Menu Prprio

Icone do Demoiselle Nimble na barra de ferramentas Para saber mais sobre o uso com eclipse veja Captulo 6, Exemplo usando Eclipse IDE

17

18

Plugin para NetBeans IDE

Guia de uso para o Puglin para NetBeansIDE Assim como no Eclipse o Demoiselle Nimble tambm tem a sua integrao IDE NetBeans [http://netbeans.org/ downloads/] atravs de um plugin. Como o Demoiselle-Nimble foi concebido para ser independente de Plataforma, o Netbeans faz apenas uma a chamada interface grfica do Demoiselle-Nimble. Assim, as instrues de uso dos templates so as mesmas contidas no Guia - Interface Grfica Neste captulo vamos nos ater apenas os detalhes referentes intalao e uso no NetBeans

5.1. Instalao
Os pr-requisitos para o uso da Plugin so os mesmos para o Modo Desktop alm claro da IDE NetBeans instalada (Testada com v 7.0) Baixe o arquivo de instalao do pluguin do endereo: http://demoiselle.sourceforge.net/nimble/netbeans/br-govframeworkdemoiselle-tools-nimble-netbeans.nbm No ambiente de desenvolvimento do NetBeans acione o menu Ferramentas Plugins A tela seguinte dever ser apresentada

Tela de instalao de Plugins para NetBeans Selecione a aba Baixados e clique no boto Adicionar Plug-ins... para incluir um novo repositrio, conforme a figura abaixo Na tela abaixo selecione o arquivobr-gov-frameworkdemoiselle-tools-nimble-netbeans.nbm no diretrio onde foi baixado o Plugin

19

Captulo 5. Plugin para NetBe...

Tela para incluso de novo repositrio de plugin Voltando tela anterior, que dever ser atualizada assim:

Tela de instalao de Plugins para NetBeans, com novo plugin No quadro onde aparecem as colunas Instalar e Nome Marque a coluna Instalar.Em seguida clique no boto com o mesmo nome Instalar no canto inferior esquerdo da tela

20

Instalao

Imagem da Tela de detalhes da instalao do Plugin Se no houver erros ou avisos, clique no boto Prximo > Na prxima tela marque a opo de aceite da licena e clique no boto Instalar

Imagem da Tela de aceite da licena

21

Captulo 5. Plugin para NetBe...

Na tela seguinte clique no boto Continuar

Tela de sequncia de instalao Aguarde a instalao

5.2. Instrues de Uso

Feita a instalao conforme as opes anteriores, j possivel executar o Demoiselle Nimble Nesta verso do plugin preciso que seja criado um projeto para que o plugin seja habilitado Recomendamos usar o arqutipo Maven do Demoiselle http://demoiselle.sourceforge.net/repository/archetypecatalog.xml Depois de criado, selecione o projeto e veja onde esto os acionadores do Plugin Demoiselle Nimble

Um cone na barra de ferramentas:

Icone do Demoiselle Nimble na barra de ferramentas Sub-item no Menu Ferramentas

22

Instrues de Uso

Sub-item Demoiselle Nimble

23

24

Exemplo usando Eclipse IDE

Exemplo prtico usando o ambiente de Desenvolvimento Eclipse IDE O Demoiselle Nimble possui um plugin para Eclipse que j conta com uma boa integrao. Ento neste captulo faremos uma desmonstrao com o uso desta ferramenta. Vamos considerar que a instalao e configurao j esteja de acordo com as intrues contidas no captulo Seo 4.1, Instalao

6.1. Prepararao
Antes de iniciar o uso do Demoiselle-Nimble, vamos criar um projeto usando um arqutipo do Demoiselle. Selecione o projeto e veja onde esto os acionadores do Plugin Demoiselle Nimble Um cone na barra de ferramentas:

Icone do Demoiselle Nimble na barra de ferramentas Sub-item no Menu Ferramentas

Sub-item Demoiselle Nimble Acione o Demoiselle-Nimble atravs dos atalhos acima, aps alguns segundos a tela seguinte dever ser apresentada:

25

Captulo 6. Exemplo usando Ec...

Criando uma aplicao Maven com Demoiselle Nimble Selecione a opo: Demoiselle V2 Create JSF Application, e clique no boto Next >

Criando uma aplicao JSF com Demoiselle Nimble Nesta tela, na opo: 1. Output Folder, no Eclipse estar selecionado o Workspace atual, caso contrrio utilize o boto Browse... para encontrar o diretrio correto Informe as seguintes informaes nos campos seguintes: 2. Package Name: br.org.frameworkdemoiselle 3. Project Name: testeV2 4. Version: 1.0.0 Em seguinda clique no boto Finish e aguarde que o processo seja concludo pelo Eclipse. Verifique o arquivo /src/main/resources/persistence.xml e remova os comentrios para escolher a estratgia de transao. Conforme mostrado abaixo:

<?xml version="1.0" encoding="UTF-8"?> <persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http:// www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/ persistence/persistence_2_0.xsd"> <!-- If you are using JBoss AS7 with non JTA transaction then use this persistence-unit --> <!---> <persistence-unit name="testeV2-ds" transaction-type="RESOURCE_LOCAL"> <non-jta-data-source>java:jboss/datasources/ExampleDS</non-jta-data-source> <properties> <property name="hibernate.show_sql" value="true" /> <property name="hibernate.format_sql" value="false" /> <property name="hibernate.hbm2ddl.auto" value="create-drop" /> </properties> </persistence-unit> </persistence>

26

Prepararao

No arquivo /src/main/resources/messages.properties, encontre e muda a propriedade: main.app.title=TesteV2 O passo seguinte identificar o Projeto no Eclipse como um projeto Maven, para isso selecione o projeto recmcriado e clique com o boto direito do mouse para acionar o menu e selecione as opes Configure -> Convert to Maven Project

Configurando aplicao Maven no Eclipse Aps criado o projeto, vamos localizar o pacote Domian conforme a figura abaixo:

27

Captulo 6. Exemplo usando Ec...

Localizando o pacote das classes de domnio Crie neste pacote uma classe chamada Pessoa, conforme o cdigo abaixo

import import import import import import import

java.util.Date; javax.persistence.Column; javax.persistence.GeneratedValue; javax.persistence.Id; javax.persistence.MappedSuperclass; javax.persistence.Temporal; javax.persistence.TemporalType;

@MappedSuperclass public abstract class Pessoa { @Id @GeneratedValue private Long id; @Column private Long cpf; @Column(nullable=false, private String nome; length=255)

@Column(nullable=false) @Temporal(value=TemporalType.DATE) private Date dataNascimento;

28

Prepararao

public void setId(Long id) { this.id = id; } public Long getId() { return id; } public void setNome(String nome) { this.nome = nome; } public String getNome() { return nome; } public void setCpf(Long cpf) { this.cpf = cpf; } public Long getCpf() { return cpf; } public void setDataNascimento(Date dataNascimento) { this.dataNascimento = dataNascimento; } public Date getDataNascimento() { return dataNascimento; } }

Depois criaremos a classe Estudante, de acordo com o cdigo abaixo :

import java.io.Serializable; import java.util.Date; import javax.persistence.Column; import import import import javax.persistence.Entity; javax.persistence.Table; javax.persistence.Temporal; javax.persistence.TemporalType;

@Entity @Table(name="Estudante") public class Estudante extends Pessoa implements Serializable { /** * */ private static final long serialVersionUID = 1L; @Column(nullable=false) @Temporal(value=TemporalType.DATE) private Date dataMatricula; @Column private int numeroMatricula; public Date getDataMatricula() { return dataMatricula; }

29

Captulo 6. Exemplo usando Ec...

public void setDataMatricula(Date dataMatricula) { this.dataMatricula = dataMatricula; } public int getNumeroMatricula() { return numeroMatricula; } public void setNumeroMatricula(int numeroMatricula) { this.numeroMatricula = numeroMatricula; } }

Isso tudo que precisamos criar manualmente para comear o uso do Demoiselle-Nimble.

6.2. Gerando uma aplicao Web Tradicional

Neste primeiro exemplo, vamos utilizar a ferramenta para gerar os artefatos de uma aplicao WEB tradicional. Selecione o projeto e veja onde esto os acionadores do Plugin Demoiselle Nimble

Um cone na barra de ferramentas:

Icone do Demoiselle Nimble na barra de ferramentas Sub-item no Menu Ferramentas

Sub-item Demoiselle Nimble Com o projeto selecionado, use uma das opes acima para acionar a interface do Demoiselle Nimble, onde selecionaremos o Template para gerao de um CRUD (Create, Read, Update e Delete) que so as operaes bsicas de criar, ler, atualizar e apagar Selecione o Template adequado ao arqutipo que foi criado, neste exemplo optamos pelo Primefaces 3, que compatvel com a verso 2.2.2 (ou superior) do Demoiselle conforme a figura abaixo:

30

Gerando uma aplicao Web Tradicional

Escolhendo o template de CRUD Na tela seguinte, devero ser informados os parmetros para gerao dos artefatos 1. Output Folder*: Use o boto Browse... para selecionar o projeto dentro do diretrio de Workspace do Eclipse 2. Entity Name*: Use o boto Click to select an entity class file... e procure no diretrio (/src/main/java/br/org/ frameworkdemoiselle/domain/) a classe Estudante 3. Package Name*: Ser preenchido automticamente com br.org.frameworkdemoiselle

Informando os parmetros para criao dos artefatos Aguarde o processamento at que a tela de confirmao aparecea

31

Captulo 6. Exemplo usando Ec...

Processamento do Template OK Confira os artefatos que foram gerados nos pacotes de negcio(business), persistncia (persistence) e de viso (view) Na pasta /src/main/webapp tambm devero ser geradas as pginas XHTML de edio e listagem

Listagem dos artefatos criados Veja tambm nos arquivos: persistence.xml, messages.properties e menu.xhml, que novas informaes foram includas. Para testar as funcionalidade criadas, adicione o projeto no servidor JBoss e inicie o mesmo. No exemplo a aplicao estar em http://localhost:8080/testeV2

32

Gerando uma aplicao Web Mobile

Resultado na aplicao em funcionamento

6.3. Gerando uma aplicao Web Mobile

Atualmente muitos dos dispositivos de comunicao mveis (celulares, tablets, etc..) possuem acesso internet, e possvel acessar atravs de um navegador (browser) qualquer aplicao ou site. Porm, na maioria dos casos a tela no fica bem apresentvel pois no foi desenhada para um dispositivo mvel. Mas j existe solues para isso, que so a bibliotecas para criar sites que se adaptam melhor neste tipo de dispositivo. Com base nisto o DemoiselleNimble possui um template (modelo) para gerao deste tipo de interface. Os procedimentos iniciais, que iniciar a ferramenta, so os mesmos do item anterior: Seo 6.2, Gerando uma aplicao Web Tradicional mudando a partir da escolha do template. Conforme apresentado na tela abaixo:

Escolhendo o template de CRUD para Mobile Na tela seguinte, devero ser informados os parmetros para gerao dos artefatos 1. Output Folder*: Use o boto Browse... para selecionar o projeto dentro do diretrio de Workspace do Eclipse 2. Entity Name*: Use o boto Click to select an entity class file... e procure no diretrio (/src/main/java/br/org/ frameworkdemoiselle/domain/) a classe Estudante

33

Captulo 6. Exemplo usando Ec...

3. Package Name*: Ser preenchido automticamente com br.org.frameworkdemoiselle

Informando os parmetros para criao dos artefatos

Cuidado
Os procedimentos seguintes devem ser observados atentamente

Ao clicar no boto Finish da tela anterior, algumas mensagens sero apresentadadas A primeira ser perguntando sobre o arquivo index.html, como estamos gerando uma aplicao Mobile o template poder sobrepor esse arquivo para implementar uma forma bem simplificada de identificar qual tipo de dispositivo est acessando a aplicao. Neste caso s uma forma de gerar um exemplo, mas caso sua aplicao possua uma forma mais elaborada, basta responder negativamente (clique no boto:No ) ao pedido de sobrescrio mostrado na pgina abaixo, no caso deste exemplo vamos permitir que sobrescreva clicando no boto: Yes

Sobrescrevendo o arquivo index.html Neste exemplo, a sequncia mostrar uma tela que pergunta para sobrescrever as classes java de Persistncia (DAO), Negcio (BC) e Viso(MB). Pois j havamos criado essas classes no item anterior, caso esteja gerando apenas para mobile essa pergunta no aparecer e as classes sero criadas. Note que so exatamente as mesmas pois a nica diferena justamente a parte de viso que so as pginas. No nosso caso, vamos ignorar isso clicando no boto No to All

34

Gerando uma aplicao Web Mobile

Sobrescrevendo as classes java Ao final ser apresentada a tela informando que o processamento foi executado

Processamento do Template OK Com isso poderemos conferir no diretrio /src/main/webapp/ os artefatos que foram criados:

Artefatos para web-mobile criados. Alm o novo arquivo index.html, tambm podemos verificar que foi criado o arquivo mobile.html. E um novo diretrio (/mobile) tambm foi includo e conter todas pginas para a interface mobile. Antes de testarmos a aplicao vamos vericar o arquivo POM.XML para certificarmos se est correto. Clique no arquivo e selecione a aba Dependecy Hierachy Veja se h a dependncia para o Primefaces-Mobile importante verificar tambm a verso do Primefaces que deve ser no mnimo a 3.4

35

Captulo 6. Exemplo usando Ec...

Viso de Dependency Hierarchy no POM.XML Com isso a aplicao j est pronta para ser testada. Republique novamente no servidor de aplicaes e inicie o servidor. Obviamente no haver nenhuma diferena ao acessar do navegador (browser) web do seu computador, o ideal publicar na internet e para isso h alguns servios em nuvem que fornecem ambiente gratuto e compatvel com o Demoiselle como o Openshift [http://openshift.redhat.com/] da RedHat. E depois testar em um tablet ou celular com navegador web. Uma estratgia que adotamos foi usar o software VirtualBox [https://www.virtualbox.org/] e criar uma mquina virtual com Android [https://www.buildroid.org/] Acessando de um navegador em dispositivo mvel a intefaces ser assim:

36

Gerando uma aplicao Web Mobile

Tela de navegao - Mobile

Tela de listagem

37

Captulo 6. Exemplo usando Ec...

Tela de Edio

38