Java, Tutorial

06 Maven, JSF 2, Spring e Hibernate

Integrando tecnologias para facilitar o desenvolvimento web
[ Edwins Leonardi ]
Sumrio
20 Seam 3: Servlet e o futuro
Java, Tutorial Utilizando CDI para facilitar o desenvolvimento de servlets
[ Adam Victor Nazareth Brandizzi ]

28 Explorando os componentes do Dojo Toolkit

Java

Tutorial Usabilidade e simplicidade com os componentes do Dojo Toolkit

[ Luis Antonio Tavares ]

38 JavaOne Latin America 2011

Java O evento Java mais importante da Amrica Latina
[ Loiane Groner ]

44 Transaes com EJB

Java, Tutorial Manipule transaes com as facilidades do Java EE
[ Eduardo Correia da Silva ]

52 Aplicaes Java EE lightweight Ol, eu sou o DevMan! Desta p-

Boas Prticas

Java, Boas Prticas Reavaliando o uso de boas prticas e padres Java EE gina em diante, eu estarei lhe aju-
[ Oscar Costa ] dando a compreender com ainda
mais facilidade o contedo desta
60 Maven 3, Sonar e Hudson edio. Ser um prazer contar com
Java, Boas Prticas Descobrindo uma maneira mais gil de desenvolver software
sua companhia! Confira abaixo o
[ Rodrigo Branas ]
que teremos nesta revista:
Eng. de Software

Engenharia 70 Processo de Teste de Software

de Software
Garantindo mais qualidade com a implantao de um novo processo
[ Renata Eliza e Vivian Lagares ]

Brinde na web desta edio

Vdeos
3 3 vdeo-aulas sobre JPA e JSF.

Para visualizar acesse o link:

http://www.devmedia.com.br/articles/listcomp.asp?keyword=jm101&codigobanca=deltaspike

Gostou das vdeo aulas? O portal www.devmedia.com.br possui mais de 2 mil vdeo aulas e dezenas de cursos online sobre desenvolvimento de software!
Agora voc pode comprar as vdeo aulas que preferir e fazer sua prpria combinao de vdeos! Saiba mais em www.devmedia.com.br/creditos

Feedback D seu feedback sobre esta edio!

eu
s

A Java Magazine tem que ser feita ao seu gosto. Para isso, precisamos saber o que voc, leitor, acha da revista!
D

sobre e

D seu voto sobre esta edio, artigo por artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
s

ta
edio
Para votar, voc vai precisar do cdigo de banca desta edio, que : deltaspike
 Carta ao Leitor
Ano IX Edio 101 2012 ISSN 1676-8361

Edio

A
Editor
Eduardo Spnola (eduspinola@gmail.com) o iniciar o desenvolvimento de uma aplicao, quando no temos uma arquitetura padro,
sempre passamos pelo mesmo dilema: quais frameworks utilizar para implementar o
Produo sistema? Apesar de cada opo oferecer diferenciais para cada tipo de soluo, ter uma
Jornalista Responsvel Kaline Dolabella - JP24185 estrutura padro pode facilitar e muito nesta etapa. baseado neste contexto que destacamos a

Distribuio matria de capa da Java Magazine 101.

FC Comercial e Distribuidora S.A
Rua Teodoro da Silva, 907, Graja - RJ
CEP 20563-900, (21) 3879-7766 - (21) 2577-6362
Atendimento ao leitor
A DevMedia possui uma Central de Atendimento on-line, onde voc pode
tirar suas dvidas sobre servios, enviar crticas e sugestes e falar com um de
nossos atendentes. Atravs da nossa central tambm possvel alterar dados
cadastrais, consultar o status de assinaturas e conferir a data de envio de suas
revistas. Acesse www.devmedia.com.br/central, ou se preferir entre em
contato conosco atravs do telefone 21 3382-5038.
Edies anteriores
Adquira as edies anteriores da revista Java Magazine ou de qualquer outra
publicao do Grupo DevMedia de forma prtica e segura, em
www.devmedia.com.br/anteriores.
Publicidade
publicidade@devmedia.com.br 21 3382-5038
Anncios Anunciando nas publicaes e nos sites do Grupo DevMedia, voc
divulga sua marca ou produto para mais de 100 mil desenvolvedores de todo o
Brasil, em mais de 200 cidades. Solicite nossos Media Kits, com detalhes sobre
preos e formatos de anncios.
Reprints Editoriais Se foi publicado na Java Magazine um artigo que
possa alavancar as suas vendas, multiplique essa oportunidade! Solicite a
reimpresso da matria junto com a capa da edio em que saiu, e distribua
esse reprint personalizado entre seus clientes.
Dessa forma, Maven, JSF 2, Spring e Hibernate mostra a integrao dos frameworks JSF 2,
Spring e Hibernate na arquitetura de projetos web e a utilizao da ferramenta Maven como
agente facilitador desta integrao. Tambm so discutidas as vantagens e caractersticas de cada
componente utilizado.
No artigo Seam 3: Servlet e o futuro, estudaremos Seam Servlet, o quarto mdulo a ser mantido
pelos desenvolvedores de JBoss Seam. Veremos como Seam Servlet permite utilizar a Servlet API
de maneira mais simples e poderosa, atravs de CDI.
Explorando os componentes do Dojo Toolkit expe vrios componentes do Dojo, mostrando na
prtica como utiliz-los em uma aplicao. Para isso, so abordados desde menus at componentes
para funes especficas, como calendrios e campos para horas. Alm disso, foram discutidos
alguns conceitos relacionados usabilidade em ambientes web.
Em JavaOne Latin America 2011 comentamos sobre o evento mais importante da comunidade
Java. durante este evento que grandes anncios e novidades so apresentados. Saber o que ocorreu
durante o evento permite uma melhor compreenso sobre os rumos da plataforma Java.
Transaes com EJB discursa sobre formas de se trabalhar com transaes em conjunto com
o Java EE, as caractersticas bsicas de uma transao, a JPA e os modos de gerenciamento de
transaes CMT e BMT.
No artigo Aplicaes Java EE lightweight veremos como construir aplicaes Java EE leves
e enxutas, utilizando Padres J2EE revisitados para a nova verso da plataforma. Para isso,
mostraremos trs alternativas de implementao de casos de uso do tipo CRUD utilizando os
padres Java EE.
Na matria Maven 3, Sonar e Hudson abordaremos a integrao das ferramentas Maven 3,
Sonar e Hudson com a inteno de criar um ambiente de desenvolvimento mais gil por meio do
estmulo eliminao de atividades repetitivas, reduo na incidncia de defeitos e aumento da

Encarte de CDs Faa como nossos maiores anunciantes. Encarte um CD qualidade do cdigo produzido.
com uma amostra de seus produtos na Java Magazine e atinja um pblico Por fim, focando em Engenharia de Software, Processo de Teste de Software explica como a
segmentado e formador de opinio. utilizao de um Processo de Teste pode melhorar a efetividade dos testes, controlando as atividades
e garantindo mais credibilidade e valor ao produto.
Java, o logotipo da xcara de caf Java e todas as marcas e logotipos baseados
em/ ou referentes a Java so marcas comerciais ou marcas registradas da Sun
Microsystems, Inc. nos Estados Unidos e em outros pases.

Fale com o Editor!

muito importante para a equipe saber o
que voc est achando da revista: que tipo
de artigo voc gostaria de ler, que artigo voc
mais gostou e qual artigo voc menos gostou.
Fique a vontade para entrar em contato com
os editores e dar a sua sugesto!
Se voc estiver interessado em publicar um
artigo na revista ou no site Java Magazine,
entre em contato com o editor, informando
o ttulo e mini-resumo do tema que voc
gostaria de publicar: Eduardo Oliveira Spnola
eduspinola@gmail.com
Eduardo Spnola - Editor da Revista
eduspinola@gmail.com @eduspinola / @Java_Magazine

Assine agora e tenha acesso a

todo o contedo da DevMedia:
www.devmedia.com.br/mvp
 Seo Java: Nesta seo voc encontra artigos intermedirios e avanados sobre Java

Maven, JSF 2, Spring e Hib

Integrando tecnologias para facilitar o de

Resumo DevMan
De que se trata o artigo:
O artigo mostra a integrao dos frameworks JSF 2, Spring e Hibernate na arquitetura de projetos web e a
utilizao da ferramenta Maven como agente facilitador desta integrao. Tambm so discutidas as vantagens
e caractersticas de cada componente utilizado.

Em que situao o tema til:

O conjunto de ferramentas e frameworks apresentados mostra uma dentre as tantas possveis combinaes
de tecnologias do mundo Java. A soluo apresentada pode servir como arquitetura de um projeto de sistema
web ou servir como um comparativo com outras tecnologias disponveis.

Maven, JSF 2, Spring e Hibernate:

Apresentaremos neste artigo a construo de uma aplicao web que faz uso de poderosos frameworks e
ferramentas Java: Maven, JSF 2, Spring e Hibernate. Sero abordados os fundamentos por trs de cada uma
destas tecnologias e ser apresentado o motivo de suas escolhas. Sero discutidos tambm os passos para
integrao das mesmas e a demonstrao de suas capacidades de forma bastante prtica. O exemplo cons-
trudo, apesar de simples, aborda tpicos avanados no desenvolvimento de sistemas Java, como injeo de
dependncia, controle transacional, Ajax e mapeamento objeto relacional. Alm disso, embora o exemplo
use especificamente as tecnologias citadas, o artigo emprega boas prticas de arquitetura de software para
fornecer baixo acoplamento entre os seus componentes, possibilitando uma fcil expanso ou mudana
das tecnologias.

N
este artigo construiremos um
exemplo que mostrar de forma
objetiva a arquitetura de uma
aplicao Web que envolve a integrao
das seguintes tecnologias do mundo Java:
Maven, JSF 2, Spring e Hibernate.
Maven uma ferramenta pertencente
ao grupo Apache que tem como finali-
dade o gerenciamento e a automao de
projetos Java. De acordo com o prprio
site do Maven, a ferramenta tem os se-
guintes objetivos: prover um padro para
desenvolvimento de aplicaes; criar
mecanismos para uma clara definio do
contedo do projeto; facilitar a publicao
de informaes do projeto; e possibilitar
o compartilhamento de bibliotecas entre
vrios projetos. Um dos principais servios
providos pelo Maven o gerenciamento de
dependncias. Esta facilidade ser apre-
sentada e discutida mais frente no artigo
e a razo principal da escolha desta fer-
ramenta no desenvolvimento da aplicao
exemplo que iremos construir.
JSF o framework Java padro para a
construo de aplicaes web a partir da
verso Java EE 5. uma especificao para
o desenvolvimento de interfaces web utili-
zando uma arquitetura voltada a compo-
nentes. Assim, na definio de uma pgina
web utilizamos componentes JSF dentro
desta pgina sem a necessidade de escre-
vermos cdigo HTML. O desenvolvimento
de pginas pode ser simplesmente baseado
na ao de pegar e arrastar componentes
na tela. Este framework faz uso do bom e
velho padro ModeloVisoControlador
(MVC) na sua arquitetura, o que ajuda na
manuteno do cdigo. E pelo fato do JSF
ser apenas uma especificao, voc pode

6 Java Magazine Edio 101


bernate
senvolvimento web
escolher a implementao que mais lhe agradar. Neste artigo
utilizaremos a implementao de referncia do JSF 2, o Mojarra.
O JSF 2 a mais nova especificao do framework e traz enormes
melhorias em comparao com as verses anteriores. Algumas
destas melhorias sero abordadas ao longo do artigo.
Spring um framework de desenvolvimento Java que emer-
giu em 2003 como uma alternativa ao ento conturbado EJB
(Enterprise JavaBeans). Este framework tem como paradigma o
desenvolvimento gil e leve, baseado em POJO (Plain Old Java
Objects). Ele prov um ecossistema completo de desenvolvi-
mento, possibilitando o seu uso em diversos tipos de aplicati-
vos. O Spring possibilita uma simples integrao com outros
frameworks Java, como por exemplo, Struts, JSF e Hibernate.
Tambm permite o uso de servios do padro Java EE, como por
exemplo, JPA, JMS, JTA, entre outros. Alm disso, implementa
e possibilita o uso de boas prticas de programao, como
inverso de controle e programao orientada a aspectos. A
essncia do Spring est no seu container de IoC (Inversion of
Control), que um ambiente responsvel por criar, gerenciar e
injetar os objetos de uma aplicao. Em suma, o Spring um
framework completo que agiliza bastante o desenvolvimento
de uma aplicao. A escolha do mesmo em nossa arquitetura
se justifica pelo uso do seu poderoso IoC container, da sua in-
tegrao com JPA (Hibernate) e do fcil e transparente controle
transacional provido pelo framework.
O JPA (Java Persistence API) a especificao padro do Java para
persistncia. Ela define como deve ser feito o mapeamento de um
modelo orientado a objetos para um banco de dados relacional.
Como JPA apenas uma especificao, assim como JSF, existem
vrios frameworks que o implementam, dentre eles, destacamos
Hibernate, TopLink e JDO. Frameworks deste tipo so chamados
de ORM (Object-Relational Mapping). Para a construo do nosso
exemplo, usaremos a implementao JPA do Hibernate. O servio
prestado pelo JPA uma camada de abstrao para o acesso e
manipulao dos dados relacionais do banco de dados de uma
maneira orientada a objetos. Esta camada de abstrao prov um
caminho bidirecional no qual os dados relacionais (colunas das
tabelas) so transformados em objetos do nosso modelo e vice-
versa. Um objeto JPA mapeado para uma tabela do banco de dados
chamado de entidade. O JPA tambm oferece o Entity Manager ou
gerenciador de entidades, que responsvel por abstrair as opera-
es relacionais do banco de dados de insero, leitura, alterao
e excluso, comumente chamadas de operaes CRUD (Create,
Read, Update e Delete). A escolha do Hibernate na persistncia
O artigo visa demonstrar a
possvel combinao Maven +
JSF 2 + Spring + Hibernate na
arquitetura de projetos web
Edwins Leonardi
dos dados do nosso projeto se deve ao fato de ele ser o framework
ORM Java mais consolidado do mercado e implementar a especi-
ficao padro Java EE para persistncia, o JPA.
At o momento realizamos apenas breves introdues do
potencial das tecnologias que sero utilizadas neste artigo.
Quando integradas, Maven, JSF, Spring e Hibernate tornam-
se um poderoso conjunto na arquitetura de aplicaes Web,
possibilitando um desenvolvimento rpido e robusto de apli-
caes. Agora estamos prontos para iniciarmos a construo
da aplicao exemplo!
Especificao do exemplo e Ambiente de Desenvolvimento
Utilizaremos como exemplo de integrao das ferramentas e
frameworks citados a criao de uma aplicao Web bastante
simples. Esta aplicao mantm o cadastro de clubes e atletas de
futebol, e daremos a ela o nome de Onze Vencedor uma aluso
ao clssico jogo de futebol Winning Eleven.
Teremos apenas duas telas na nossa aplicao: uma para a manu-
teno de clubes e outra para a manuteno de atletas. Estas telas
oferecem as operaes CRUD para insero, leitura, alterao e
excluso de registros. Alm disso, as telas possuem dois modos
distintos: um de edio, usado na incluso e alterao; e outro
para pesquisa de registros.
O diagrama de classes da nossa aplicao pode ser visto na
Figura 1. Note que existe uma agregao entre as classes Clube e
Atleta, onde definimos que um clube tem vrios atletas e um atle-
ta pertence a apenas um clube. A classe Atleta tambm tem uma
associao com um tipo enumerado chamado Posicao, que mantm
as possveis posies que um atleta de futebol pode ter.
Por fim, a nossa aplicao ter um banco de dados relacional
para o armazenamento dos dados, e para tal, utilizaremos o banco
de dados MySQL.
O nosso ambiente de desenvolvimento contar com a IDE Eclipse
Indigo 3.7 e com o servidor Web Apache Tomcat 7. As instalaes
do MySQL, Eclipse e Tomcat 7 esto fora do escopo deste artigo,
por isso, para detalhes sobre a instalao destes programas, con-
sulte a seo Links.
Utilizaremos o Maven na fase de desenvolvimento para o ge-
renciamento de dependncias e para a distribuio do projeto em
um arquivo WAR. Para uma melhor produtividade recomenda-se
a integrao do mesmo IDE utilizada. No entanto, o Eclipse
no oferece suporte nativo ao desenvolvimento com Maven,
portanto, adicionaremos IDE um plugin chamado M2Eclipse.
Este plugin acrescenta ao Eclipse a capacidade de criar, impor-
Edio 101 Java Magazine 7
Maven, JSF 2, Spring e Hibernate
tar e gerenciar projetos Maven. Os detalhes de como instalar o
plugin M2Eclipse podem ser encontrados na Edio 93 da Java
Magazine, no artigo Alm da IDE Parte 2, e tambm no site do
plugin (veja a seo Links).
Figura 1. Diagrama de classes da aplicao de exemplo
Arquitetura do projeto
Embora a especificao da aplicao de exemplo do nosso artigo
seja simples por conter apenas operaes CRUD, faremos uso de
uma boa arquitetura de sistemas utilizando padres que possi-
bilitem uma fcil expanso do cdigo futuramente.
O cdigo ter uma diviso lgica utilizando o padro arqui-
tetural MVC (Modelo-Viso-Controle). Na camada de viso da
aplicao teremos as pginas JSF que iro conter os componentes
visuais da aplicao, como o caso de formulrios, botes, texto,
entre outros.
JSF faz uso de beans Java para possibilitar a separao do cdigo
de apresentao do cdigo de negcio. Por sua vez, uma pgina
JSF referencia um ou mais beans, que so classes Java que arma-
zenam o cdigo de negcio que deve ser invocado pelas pginas
da aplicao. Estes beans tm seu ciclo de vida gerenciado pelo
JSF, sendo assim chamados de Managed Beans.
Os managed beans do JSF fazem o papel de controladores da
nossa aplicao. Eles recebem um estmulo da camada de viso
para a execuo de alguma operao e em seguida delegam esta
execuo classe de negcio responsvel. Aps a execuo da
regra de negcio o controlador repassa o resultado da operao
camada de viso.
J a camada de modelo do nosso exemplo representada pelas
classes de entidades JPA que so mostradas na Figura 1.
Alm destas, teremos uma camada de servio (Facade) que im-
plementa as regras de negcio da aplicao. A camada de servio
visa encapsular, isolar o cdigo de negcio da aplicao, sendo
considerada uma boa prtica por facilitar o reuso o cdigo.
Por ltimo temos a camada de persistncia DAO (Data Access
Object). Os objetos DAO so responsveis pelas operaes realiza-
8 Java Magazine Edio 101
das no banco de dados. A utilizao do mesmo um bom padro
de desenvolvimento, pois separa as regras de negcio da aplicao
das operaes de manipulao do banco de dados.
Os nossos objetos DAO fazem uso de um objeto do tipo EntityMa-
nager, que criado pelo Hibernate e injetado pelo Spring no DAO.
Falaremos sobre o EntityManager mais adiante no artigo.
O fluxo da aplicao inicia-se na camada de viso por algum
evento disparado pelo usurio na pgina JSF. O managed bean que
atua como controlador, recebe tal evento, validando a entrada de
dados e chamando a camada de servio para efetuar a operao
desejada. A camada de servio, assim, pode vir a chamar a camada
DAO se a operao envolver acesso a banco de dados. Por fim, o
modelo atualizado na camada de servios que devolve o modelo
atualizado para a camada de viso aps o final da operao.
Os componentes da arquitetura que montaremos e suas intera-
es podem ser visualizados na Figura 2.
Figura 2. Componentes da arquitetura do projeto
Criao do projeto Maven
Agora que foi apresentado o exemplo e a arquitetura que iremos
utilizar, vamos criao do projeto Maven. Utilizaremos para
este passo o Eclipse, que j deve estar com o plugin M2Eclipse
devidamente configurado.
Deste modo, abra o Eclipse e clique em File > New > Other, sele-
cione a opo Maven Project, que se encontra dentro da categoria
Maven, e clique no boto Next. Na prxima tela mostrada nenhuma
configurao precisa ser feita, ento podemos prosseguir clicando
no boto Next.
Agora chegamos etapa mais importante da criao do projeto
Maven: a definio do arqutipo (archetype). Arqutipos Maven
so templates de projetos. O Maven utiliza o arqutipo escolhido
e cria um projeto com uma estrutura bsica.
Para o nosso exemplo utilizaremos um arqutipo de projeto Web.
Na tela apresentada, digite no campo filter o nome maven-archetype-
webapp, selecione este arqutipo e clique em Next. Na tela seguinte,
defina o Group Id = br.com.javamagazine, Artifact Id = OnzeVencedor, Version =
1.0-SNAPSHOT e package = br.com.javamagazine.onzevencedor. Pronto, nosso
projeto Web est criado.
Feito isso o Maven criou um projeto no Eclipse com convenes
de diretrios e arquivos que so definidos no arqutipo maven-
archetype-webapp. Atravs do uso de plugins o Maven possibilita
que voc crie seus prprios arqutipos com as convenes que
desejar. Note que alm de diretrios padres em aplicaes Web
Java, como por exemplo, o diretrio WEB-INF, o Maven tambm
criou o arquivo de configurao web.xml e uma pgina inicial
chamada index.jsp. A estrutura do projeto criada pelo Maven pode
ser vista na Figura 3.
podem existir problemas de incompatibilidade entre as verses
das bibliotecas utilizadas.
O gerenciamento de dependncias do Maven se mostra muito
til na resoluo dos problemas citados. As dependncias do
projeto so criadas declarativamente no arquivo pom.xml como
mostrado na Listagem 1 dentro da tag <dependency>. As depen-
dncias declaradas no arquivo POM so resolvidas pelo Maven
de forma transparente ao desenvolvedor. O Maven se conecta a
um repositrio remoto, faz o download das dependncias e as
adiciona automaticamente ao classpath do projeto. Note que para
declarar uma dependncia no arquivo pom.xml necessrio infor-
mar um valor s propriedades: groupId, que seria a identificao
de um grupo de artefatos; artifactId, que seria a identificao de
um artefato; e version, que indica a verso do artefato.
Alm de fazer o download das bibliotecas especificadas no ar-
quivo pom.xml, o Maven tambm baixa as dependncias que estas
bibliotecas possuem. Por exemplo, considere a Listagem 1. Ns
declaramos a dependncia da biblioteca hibernate-core e o Maven
automaticamente trouxe as dependncias que esta biblioteca
possui (antlr, commons-collections, dom4j, jta e slf4j-api).

- possvel no Eclipse verificar a hierarquia das dependncias do projeto abrindo

o arquivo pom.xml na aba Dependency Hierarchy. bom salientar que o Maven
em nosso projeto resolve todas as dependncias existentes e no apenas as do
Hibernate e Spring.

Figura 3. Estrutura do projeto criado usando o Maven

A adoo do Maven no desenvolvimento do projeto foi escolhi-

da para facilitar o gerenciamento de dependncias existente em
nossa aplicao. As dependncias de um projeto so as bibliotecas
essenciais ao seu correto funcionamento.
Como iremos utilizar em nossa arquitetura o Spring e o Hiber-
nate, e estes dois tm um grande nmero de dependncias com
bibliotecas externas, muitas vezes o uso destes frameworks em
um projeto no tarefa fcil.
Primeiramente para fazer uso destes frameworks ns deve-
ramos adicionar todos os arquivos JAR necessrios na pasta
WEB-INF/lib do projeto, o que representa, em nosso exemplo,
mais de 30 arquivos JAR. Outro ponto de dificuldade que
antes de adicionar estes arquivos ao projeto preciso baix-los
da internet. Nas verses mais recentes do Spring e do Hibernate
no so empacotados junto com suas distribuies as dependn-
cias externas existentes, o que significa que quem for utilizar o
framework dever procurar pelas dependncias e baix-las por
conta prpria. Esta tarefa no nada divertida e muitas vezes o
desenvolvedor s descobre a falta de uma dependncia em tempo
de execuo quando a aplicao estiver rodando. Ainda assim

Edio 101 Java Magazine 9

Maven, JSF 2, Spring e Hibernate

Listagem 1. Contedo do arquivo pom.xml

<project xmlns=http://maven.apache.org/POM/4.0.0 <version>${org.springframework.version}</version>
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance </dependency>
xsi:schemaLocation=http://maven.apache.org/POM/4.0.0 <dependency>
http://maven.apache.org/maven-v4_0_0.xsd> <groupId>org.springframework</groupId>
<modelVersion>4.0.0</modelVersion> <artifactId>spring-jdbc</artifactId>
<groupId>br.com.javamagazine</groupId> <version>${org.springframework.version}</version>
<artifactId>OnzeVencedor</artifactId> </dependency>
<packaging>war</packaging> <dependency>
<version>1.0-SNAPSHOT</version> <groupId>org.springframework</groupId>
<name>OnzeVencedor Maven Webapp</name> <artifactId>spring-orm</artifactId>
<url>http://maven.apache.org</url> <version>${org.springframework.version}</version>
<properties> </dependency>
<org.springframework.version>3.0.6.RELEASE</org.springframework.version> <dependency>
</properties> <groupId>org.springframework</groupId>
<dependencies> <artifactId>spring-web</artifactId>
<dependency> <version>${org.springframework.version}</version>
<groupId>com.sun.faces</groupId> </dependency>
<artifactId>jsf-api</artifactId> <dependency>
<version>2.1.6</version> <groupId>org.hibernate</groupId>
</dependency> <artifactId>hibernate-entitymanager</artifactId>
<dependency> <version>3.4.0.GA</version>
<groupId>com.sun.faces</groupId> </dependency>
<artifactId>jsf-impl</artifactId> <dependency>
<version>2.1.6</version> <groupId>org.hibernate</groupId>
</dependency> <artifactId>hibernate-validator</artifactId>
<dependency> <version>4.0.2.GA</version>
<groupId>javax.servlet</groupId> </dependency>
<artifactId>jstl</artifactId> <dependency>
<version>1.2</version> <groupId>mysql</groupId>
</dependency> <artifactId>mysql-connector-java</artifactId>
<dependency> <version>5.1.15</version>
<groupId>javax.persistence</groupId> </dependency>
<artifactId>persistence-api</artifactId> <dependency>
<version>1.0</version> <groupId>cglib</groupId>
</dependency> <artifactId>cglib-nodep</artifactId>
<dependency> <version>2.2.2</version>
<groupId>org.springframework</groupId> </dependency>
<artifactId>spring-core</artifactId> <dependency>
<version>${org.springframework.version}</version> <groupId>org.slf4j</groupId>
</dependency> <artifactId>slf4j-api</artifactId>
<dependency> <version>1.6.1</version>
<groupId>org.springframework</groupId> </dependency>
<artifactId>spring-expression</artifactId> <dependency>
<version>${org.springframework.version}</version> <groupId>org.slf4j</groupId>
</dependency> <artifactId>slf4j-simple</artifactId>
<dependency> <version>1.6.1</version>
<groupId>org.springframework</groupId> </dependency>
<artifactId>spring-beans</artifactId> <dependency>
<version>${org.springframework.version}</version> <groupId>asm</groupId>
</dependency> <artifactId>asm-commons</artifactId>
<dependency> <version>3.1</version>
<groupId>org.springframework</groupId> </dependency>
<artifactId>spring-aop</artifactId> </dependencies>
<version>${org.springframework.version}</version> <build>
</dependency> <finalName>OnzeVencedor</finalName>
<dependency> <plugins>
<groupId>org.springframework</groupId> <plugin>
<artifactId>spring-context</artifactId> <groupId>org.apache.maven.plugins</groupId>
<version>${org.springframework.version}</version> <artifactId>maven-pmd-plugin</artifactId>
</dependency> <version>2.5</version>
<dependency> <configuration>
<groupId>org.springframework</groupId> <targetJdk>1.6</targetJdk>
<artifactId>spring-context-support</artifactId> </configuration>
<version>${org.springframework.version}</version> </plugin>
</dependency> </plugins>
<dependency> </build>
<groupId>org.springframework</groupId> </project>
<artifactId>spring-tx</artifactId>

10 Java Magazine Edio 101

 Esta caracterstica do Maven excelente para um trabalho co-
laborativo de uma equipe que atua no desenvolvimento de um
mesmo projeto. As dependncias do projeto so criadas uma
vez no arquivo pom.xml e posteriormente apenas este arquivo
compartilhado entre a equipe. No existe a necessidade de com-
partilhar toda a biblioteca de dependncias. Inclusive o cdigo
do exemplo deste artigo, disponvel no site da Java Magazine, no
contm as bibliotecas, mas apenas a definio das dependncias
no arquivo pom.xml.
A configurao da aplicao est presente no arquivo web.xml,
que no nosso caso est localizado na pasta src/main/webapp/WEB-
INF. A Listagem 3 traz o contedo do mesmo. Este arquivo o
deployment descriptor da nossa aplicao. Ele orienta o servidor
web a como configurar a aplicao.
Listagem 2. Roteiro com os comandos para a criao do banco de dados da aplicao.
create database OnzeVencedorDB;

Agora que entendemos um pouco sobre o servio de gerencia- connect OnzeVencedorDB;

mento de dependncias provido pelo Maven, vamos adicionar ao
nosso projeto bibliotecas do JSF 2, Spring, Hibernate e MySQL. create table Clube(
IDF_CLUBE INTEGER auto_increment NOT NULL
A Listagem 1 contm a definio que deve ser includa em nos-
,NOME VARCHAR(40) NOT NULL
so arquivo pom.xml, que est presente na raiz do projeto. Aps ,CONSTRAINT PRIMARY KEY(IDF_CLUBE)
salvar o arquivo, verifique a presena das bibliotecas no Project );
Explorer, dentro de Maven Dependencies. Estas dependncias foram
create table Atleta(
baixadas automaticamente pelo Maven e j esto disponveis ao IDF_ATLETA INTEGER auto_increment NOT NULL
nosso projeto. ,NOME VARCHAR(40) NOT NULL
Agora iremos adicionar ao projeto um source folder, que ir con- ,DTA_NASCIMENTO DATE NOT NULL
,IDF_CLUBE INTEGER NOT NULL
ter as classes Java. Deste modo, selecione a pasta src/main/resources
,IDF_POSICAO INTEGER NOT NULL
e com o boto direito clique em New > Source Folder. O valor da ,CONSTRAINT PRIMARY KEY(IDF_ATLETA)
propriedade Project name deve ser igual a OnzeVencedor e o );
valor da propriedade Folder name deve ser igual a src/main/java.
ALTER TABLE Atleta ADD CONSTRAINT FK_CLUBE_ATLETA
Pronto, nosso projeto est criado e pronto para ser codificado. FOREIGN KEY (IDF_CLUBE) REFERENCES Clube(IDF_CLUBE);

- O projeto recm-criado no Eclipse oferece suporte da IDE ao Maven, mas algumas Listagem 3. Arquivo de configurao do Servlet container, web.xml.

facilidades como as funes de auto completar na criao de pginas JSF no esto

<?xml version=1.0 encoding=UTF-8?>
habilitadas. Para oferecer tais facilidades ao projeto execute os seguintes passos: <web-app version=3.0 xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
clique com o boto direito sobre o projeto, depois em Properties > Project Facets. xmlns=http://java.sun.com/xml/ns/javaee
Acesse o link Convert to faceted form..., em seguida selecione a opo Dynamic xmlns:web=http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd
xsi:schemaLocation=http://java.sun.com/xml/ns/javaee
Web Module e clique no link Further configuration available... Mude a propriedade
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd
Content Directory para src/main/webapp, clique no boto Ok e depois no boto id=WebApp_ID>
Apply. Agora cheque a opo JavaServer Faces e acesse o link Further configuration <display-name>OnzeVencedor</display-name>
available... Na seo chamada JSF Implementation Library, deixe a lista Type com <!-- Configuracao do Spring -->
<context-param>
o valor igual a Disable Library Configuration. Para encerrar, clique no boto Ok,
<param-name>contextConfigLocation</param-name>
depois no boto Apply e finalmente no boto Ok novamente. <param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>
Criao do Banco de Dados <listener>
<listener-class>org.springframework.web.context.ContextLoaderListener
Para a persistncia dos dados do nosso projeto devemos criar um
</listener-class>
banco de dados relacional. Assim, aps a instalao do MySQL </listener>
(veja Links), abra o programa utilitrio MySQL Command Line <!-- Configuracao DO JSF -->
Client. Uma tela de prompt ser mostrada e a senha do banco <servlet>
<servlet-name>Faces Servlet</servlet-name>
dever ser fornecida. Em seguida digite sequencialmente os
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
comandos mostrados na Listagem 2. Dessa forma criamos um <load-on-startup>1</load-on-startup>
banco de dados chamado OnzeVencedorDB que possui duas </servlet>
tabelas: Clube e Atleta. <servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.jsf</url-pattern>
Integrao JSF2, Spring e Hibernate <url-pattern>/faces/*</url-pattern>
Chegamos parte que o tema principal deste artigo, a inte- </servlet-mapping>
grao dos frameworks supracitados. Este tpico ir se resumir <welcome-file-list>
<welcome-file>index.jsf</welcome-file>
edio dos arquivos XML de configurao da aplicao web, do
</welcome-file-list>
JSF, do Spring e do Hibernate, sendo, respectivamente, web.xml, </web-app>
faces-config.xml, applicationContext.xml e persistence.xml.

Edio 101 Java Magazine 11

Maven, JSF 2, Spring e Hibernate
Configurao do JSF
No arquivo web.xml tambm feita uma configurao para
habilitar o JSF a atuar como front controller da nossa aplicao,
ou seja, o JSF quem vai receber as requisies direcionadas ao
nosso site. Esta configurao realizada na definio da servlet
Faces Servlet. Note que o JSF ser usado em requisies a pginas
com os seguintes padres de URL: *.jsf e /faces/*. Dessa forma,
devemos ter este padro em mente quando formos referenciar
uma pgina da nossa aplicao atravs de hyperlinks.
Configurao do Spring
Ns utilizaremos o Spring para gerenciar os nossos objetos de
negcio, para gerenciar os objetos de acesso a dados e para a rea-
lizao do controle transacional da aplicao. Para isso, devemos
inicializar o contexto do Spring juntamente com a inicializao da
aplicao. Fazemos isto tambm no arquivo web.xml, acrescentando
um ouvinte para inicializao do contexto do Spring. O ouvinte
responsvel por isso chama-se ContextLoaderListener. Note tambm
que existe um parmetro dentro do nosso arquivo web.xml chamado
contextConfigLocation, com o valor igual a /WEB-INF/applicationContext.
xml. Este parmetro relativo ao nome do arquivo de configurao
do Spring. Poderamos ter dado um nome qualquer para ele.
Em seguida iremos criar o arquivo de configurao do Spring.
Como definido no web.xml, este arquivo deve se chamar applica-
tionContext.xml e ser criado no folder src/main/webapp/WEB-INF.
Este arquivo contm a configurao necessria para instanciar o
Spring IoC container, que ser responsvel por criar e gerenciar
nossos beans e tambm por injet-los em outros beans.
Beans so como so chamados os objetos gerenciados pelo
Spring. Os beans no contexto do Spring so simples POJOs (Plain
Old Java Objects), ou seja, so objetos simples que no precisam
implementar uma interface ou estender uma classe base especfica
para que funcionem.
O contedo do arquivo applicationContext.xml mostrado na
Listagem 4. Vamos analisar as principais tags deste arquivo:
<context:annotation-config />: informa que iremos usar anotaes
para definir os objetos (beans) que sero gerenciados pelo Spring.
Podemos configurar os nossos beans do Spring em arquivos XML,
arquivos properties ou usando anotaes;
< context:component-scan>: define em sua propriedade base-package
um pacote da aplicao como ponto de partida para que o Spring
faa uma busca por objetos anotados como beans Spring. A pro-
cura ocorrer a partir do pacote indicado incluindo sub pacotes;
<tx:annotation-driven />: indica que usaremos anotaes para fazer o
gerenciamento transacional declarativo nos mtodos que precisam
de controle de transaes. Mtodos anotados com @Transactional
tm controle transacional efetuado pelo Spring;
<bean id=dataSource>: cria um bean que implementa javax.sql.Data-
Source. Um objeto DataSource responsvel por criar conexes com
o banco de dados. Este bean criado pelo Spring pode ser injetado
em outros beans ou ser integrado a outros componentes Spring.
Um ponto importante que dentro desta tag existem os parme-
tros de conexo com o banco de dados. Desta forma, o usurio e
12 Java Magazine Edio 101
senha definidos no banco de dados devem ser informados cor-
retamente nas propriedades username e password, respectivamente.
Observe que a classe Spring que implementa a interface DataSource
DriverManagerDataSource. Esta classe muito simples e cria uma
nova conexo a cada vez que uma solicitada. Para ilustrao do
nosso exemplo ela suficiente, mas em ambientes de produo
uma alternativa deve ser utilizada, como por exemplo, um pool de
conexes. Um pool de conexes um agrupamento de conexes com
o banco de dados que ficam aguardando at serem requisitadas
pela aplicao. Quando uma conexo requisitada uma das cone-
xes disponveis no pool movida e utilizada pela aplicao para
executar alguma tarefa no banco de dados. Ao final da operao
a conexo volta ao pool e pode servir a outras requisies. O uso
do pool de conexes otimiza a performance da aplicao pois
conexes no so criadas a todo o momento. Solues abertas
que provm o servio de pool de conexes so o Apache Commons
DBCP e C3PO;
<bean id=entityManagerFactory>: cria um bean do tipo javax.persistence.
EntityManagerFactory utilizando o Hibernate como provedor. Este bean
criado pelo Spring pode ser injetado em outros beans ou ser integra-
do a outros componentes Spring. Note a definio da propriedade
persistenceUnitName. O valor desta dever ser informado no arquivo de
configurao do Hibernate, que criaremos a seguir;
Por ltimo, no arquivo de configurao do Spring, temos a tag
<bean id=transactionManager>, que cria um bean do Spring respon-
svel pelo gerenciamento das transaes da aplicao.
Configurao do Hibernate
Agora vamos criar o arquivo de configurao do Hibernate (JPA).
Primeiramente ser necessria a criao de uma pasta META-INF
na raiz do source folder Java. Assim, no Project Explorer do Eclip-
se, selecione a pasta src/main/java. Com o boto direito clique em
New > Other, escolha a opo Folder que est dentro da categoria
General, defina o nome do novo folder como META-INF e den-
tro deste folder crie o arquivo persistence.xml com o contedo da
Listagem 5. Este bem pequeno e contm apenas a definio do
nome da unidade persistente. Uma unidade persistente contm
um conjunto de classes persistentes e as regras de como elas
devem ser persistidas. Note que o nome utilizado neste arquivo
referenciado no arquivo de configurao do Spring dentro da
configurao da fonte de dados da aplicao.
Integrao JSF e Spring
At aqui j temos criado as integraes para o Banco de Dados,
Hibernate e Spring. Finalmente vamos realizar a ltima integrao
que falta para que nossa aplicao tire proveito de todos estes
frameworks, a integrao entre JSF e Spring.
Cada pgina JSF referencia propriedades armazenadas em ob-
jetos chamados managed beans (beans gerenciados). Estes beans
contm, alm das propriedades das pginas, chamadas para a
lgica de negcio da aplicao. No contexto do JSF, os managed
beans armazenam o estado das pginas web. A criao e a ma-
nipulao dos beans gerenciados so tarefas realizadas pelo JSF.
 Listagem 4. Arquivo de configurao do Spring, applicationContext.xml. Como citado acima, os managed beans so responsveis por fazer a
chamada dos mtodos de negcio da aplicao. No entanto, os objetos
<?xml version=1.0 encoding=UTF-8?>
que armazenaro nossa lgica de negcios sero beans do Spring. En-
<beans xmlns=http://www.springframework.org/schema/beans
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance to precisamos de algum mecanismo para poder usar os nossos beans
xmlns:context=http://www.springframework.org/schema/context gerenciados pelo Spring nos managed beans gerenciados pelo JSF.
xmlns:tx=http://www.springframework.org/schema/tx Isto pode ser feito definindo uma expression language dentro
xsi:schemaLocation=http://www.springframework.org/schema/beans
do arquivo de configurao do JSF, faces-config.xml, como mostra
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context
a Listagem 6. Este arquivo precisa ser criado na pasta src/main/
http://www.springframework.org/schema/context/spring-context-3.0.xsd webapp/WEB-INF. A expression language determinada capaz de
http://www.springframework.org/schema/tx resolver os beans do Spring dentro do contexto do JSF, ou seja,
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd>
poderemos usar os nossos objetos gerenciados pelo Spring dentro
<!-- Seta anotaoes para serem usadas pelo Spring -->
<context:annotation-config />
dos managed beans gerenciados pelo JSF.
<!-- Define o pacote onde o Spring vai procurar por beans anotados -->
<context:component-scan base-package=br.com.javamagazine.onzevencedor.
service,br.com.javamagazine.onzevencedor.dao /> Listagem 6. Arquivo de configurao JSF, faces-config.xml.
<!-- define que as transaoes irao ser anotadas -->
<?xml version=1.0 encoding=UTF-8?>
<tx:annotation-driven />
<faces-config
<!-- Configuracao do Banco de Dados -->
xmlns=http://java.sun.com/xml/ns/javaee
<bean id=dataSource
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
class=org.springframework.jdbc.datasource.DriverManagerDataSource>
xsi:schemaLocation=http://java.sun.com/xml/ns/javaee
<property name=driverClassName value=com.mysql.jdbc.Driver />
http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd
<property name=url value=jdbc:mysql://localhost:3306/OnzeVencedorDB />
version=2.0>
<property name=username value=USUARIO />
<application>
<property name=password value=SENHA />
<el-resolver>org.springframework.web.jsf.el.SpringBeanFacesELResolver
</bean>
</el-resolver>
<!-- Configuracao do Hibernate -->
</application>
<bean id=entityManagerFactory
</faces-config>
class=org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean>
<property name=persistenceUnitName value=onzeVencedorPu />
<property name=dataSource ref=dataSource />
<property name=jpaVendorAdapter>
<bean class=org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter>
Desenvolvendo a aplicao
<property name=databasePlatform Depois de muita configurao de ambiente e dos frameworks
value=org.hibernate.dialect.MySQLDialect /> utilizados em nossa arquitetura, chega a hora de gastar tempo
<property name=showSql value=true /> com o que realmente interessa: a codificao da nossa aplicao.
</bean>
Como apresentado anteriormente, o nosso exemplo ser um
</property>
</bean> sistema Web com operaes de CRUD. Embora simples, o exemplo
<!-- Configuracao do gerente de transacoes do Spring --> abordar tpicos importantes no desenvolvimento de sistemas,
<bean id=transactionManager class=org.springframework.orm.jpa. como controle transacional, Ajax, inverso de controle, arquitetura
JpaTransactionManager>
de sistemas, entre outros.
<property name=entityManagerFactory ref=entityManagerFactory />
</bean> Na aplicao, o nosso modelo ter apenas duas entidades: Clube
</beans> e Atleta. Entretanto, por questes de espao, ser mostrado nas
listagens apenas o cdigo de implementao do CRUD de clubes.
Listagem 5. Arquivo de configurao Hibernate(JPA), persistence.xml.
O leitor, baseado neste cdigo, desafiado a criar o cdigo de
<?xml version=1.0 encoding=UTF-8?> implementao do CRUD de atletas.
<persistence:persistence version=2.0
xmlns:persistence=http://java.sun.com/xml/ns/persistence - Vale ressaltar que o cdigo completo da aplicao pode ser baixado no site da
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
Java Magazine.
xsi:schemaLocation=http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd >
<persistence:persistence-unit name=onzeVencedorPu/> Entidades JPA (Model)
</persistence:persistence> Comearemos a implementao do cdigo pela criao das en-
tidades JPA. Para facilitar o desenvolvimento do CRUD de atletas
por parte do leitor, alm do cdigo da entidade Clube, tambm ser
Vale ressaltar neste ponto a importncia da distino dos beans fornecido o cdigo da entidade Atleta. As Listagens 7 e 8 mostram
do Spring e dos managed beans do JSF no artigo. O termo managed a definio destas entidades, respectivamente. Adicionalmente,
bean faz referncia aos beans do JSF, enquanto o termo bean diz temos uma enum chamada Posicao que armazena as posies em
respeito aos beans do Spring. que um jogador de futebol pode atuar (veja a Listagem 9).

Edio 101 Java Magazine 13

Maven, JSF 2, Spring e Hibernate

- Ateno, os imports e os mtodos getters e setters foram omitidos, mas devem A anotao @Id define a propriedade que ser o identificador
ser criados! nico da classe e da tabela. Esta anotao obrigatria. Note que
o nome da propriedade na classe Clube que est anotada com @Id
Repare na anotao @Entity. Ela declara a classe como persis- idf. uma boa prtica definir uma propriedade id com um valor
tente e gerenciada pelo Hibernate. Alm dela, poderamos ter gerado automaticamente, pois ela no deve ser alterada nunca.
tambm a definio da anotao @Table, que define qual o nome A anotao @Column faz o mapeamento entre a propriedade na
da tabela no banco de dados ao qual a classe ser mapeada. classe persistente e a coluna no banco de dados. Novamente na
Omitimos esta anotao porque por padro o JPA tenta mapear classe Clube, ainda na propriedade idf, repare que o nome da coluna
a classe a uma tabela de mesmo nome, como acontece no nosso mapeada propriedade igual a IDF_CLUBE, conforme o cdi-
caso, onde os nomes das tabelas clube e atleta so iguais aos go: @Column(name=IDF_CLUBE). Se o nome da coluna na tabela fosse
nomes das entidades. Se tivssemos uma tabela com o nome igual ao nome da propriedade na classe persistente, a anotao
TB_CLUBE, por exemplo, usaramos a seguinte anotao: @Column poderia ser omitida.
@Table(name=TB_CLUBE). A anotao @GeneratedValue(strategy=GenerationType.IDENTITY) informa
ao JPA que o valor da propriedade idf no dever ser fornecido, pois
ser gerado automaticamente pelo banco. Esta anotao possui
Listagem 7. Cdigo da entidade Clube. uma propriedade chamada strategy, que indica a estratgia para
a gerao automtica do valor. As seguintes estratgias podem
package br.com.javamagazine.onzevencedor.entity;
ser utilizadas:
//imports omitidos
@Entity I DENTITY = Coluna identidade que gerada pelo banco de dados;
public class Clube implements Serializable{ SEQUENCE = Nome de uma sequence utilizada pelo banco de dados;
@Id TABLE = Nome de uma tabela no banco de dados que armazena
@Column(name=IDF_CLUBE)
o valor a ser utilizado;
@GeneratedValue(strategy=GenerationType.IDENTITY)
private Integer idf; AUTO = O JPA automaticamente tenta escolher a melhor dentre
@Column(name=NOME) as opes disponveis.
private String nome;
@OneToMany(fetch=FetchType.LAZY, mappedBy=clube)
A anotao @Enumerated usada para o mapeamento de tipos
private List<Atleta> atletas;
//Getters and Setter omitidos enumerados. Na classe Atleta temos a definio do tipo enumerado
} para a propriedade posicao da seguinte forma: @Enumerated(EnumType.
ORDINAL). O EnumType.ORDINAL o valor padro. Ele indica que o valor
Listagem 8. Cdigo da entidade Atleta.
a ser gravado no banco de dados um valor numrico corres-
package br.com.javamagazine.onzevencedor.entity; pondente posio do valor na Enum. J EnumType.STRING indica
//imports omitidos que o valor a ser gravado no banco um texto correspondente
@Entity
ao valor da Enum.
public class Atleta implements Serializable{
@Id
Destacam-se tambm as anotaes @OneToMany na classe Clube
@GeneratedValue(strategy=GenerationType.IDENTITY) e @ManyToOne na classe Atleta. Estas anotaes denotam o tipo de
@Column(name=IDF_ATLETA) associao existente no nosso modelo, na qual um clube tem vrios
private Integer idf; atletas e vrios atletas pertencem a um clube. Nesta associao a
@Column(name=NOME)
private String nome;
classe Clube est ligada tabela clube, a qual tem uma chave es-
@Column(name=DTA_NASCIMENTO) trangeira que referencia a tabela atleta. Por isso, alm da anotao
@Temporal(TemporalType.DATE) @ManyToOne, a associao na classe Clube deve definir a anotao
private Date dtaNascimento; @JoinColumn. A anotao @JoinColumn define como o Hibernate far
@Column(name=IDF_POSICAO)
@Enumerated(EnumType.ORDINAL)
o relacionamento entre as duas tabelas no banco de dados, alm
private Posicao posicao; de definir o nome da coluna do relacionamento.
@ManyToOne
@JoinColumn(name=IDF_CLUBE) - importante salientar que toda entidade JPA obrigatoriamente deve ter um
private Clube clube;
construtor sem argumentos pblico ou protegido. Este construtor sem argumentos
//Getters and Setter omitidos
} utilizado pelo EntityManager para criao das entidades.

Listagem 9. Cdigo do Enum Posicao.

Spring Beans (Camada de Servio e DAO)
package br.com.javamagazine.onzevencedor.entity; Agora vamos criar os beans do Spring. Ns teremos duas cama-
public enum Posicao { das da nossa aplicao que sero gerenciadas pelo Spring, a cama-
Goleiro, Zagueiro, Lateral, Volante, Ponta, Meio_Campo, Atacante; da de servios e a camada DAO, representadas, respectivamente,
}
pelas classes ClubeService (Listagem 10) e ClubeDAO (Listagem 11).

14 Java Magazine Edio 101

Listagem 10. Cdigo do DAO gerenciado pelo Spring, ClubeDAO. Comeando pela classe ClubeDAO, observe a anotao @Repository.
Esta anotao um esteretipo do Spring que utilizado na
package br.com.javamagazine.onzevencedor.dao;
//import omitidos
camada de persistncia (DAOs). Quando um DAO anotado com
@Repository(clubeDao) @Repository as excees do JPA sero traduzidas em excees do tipo
public class ClubeDAO { DataAccessException do Spring, o que significa que no precisaremos
@PersistenceContext
protected EntityManager entityManager;
tratar a mensagens de erro do banco de dados.
@Transactional(readOnly=true) Para o Spring IoC container gerenciar seus componentes voc
public List<Clube> findAll(){ dever anot-los com um dos quatro esteretipos disponveis:
String jpql = SELECT c from Clube c order by c.nome;
Query query = entityManager.createQuery(jpql); @Component = esteretipo bsico de componente gerenciado pelo
List<Clube> clubes = (List<Clube>) query.getResultList(); Spring;
return clubes; @Service = esteretipo usado para componentes na camada de
}
@Transactional(readOnly=true) servios;
public List<Clube> findByName(String nomeClube){ @ Controller = esteretipo usado para componentes na camada de
String jpql = SELECT c from Clube c where nome like :nome order by c.nome;
apresentao;
Query query = entityManager.createQuery(jpql);
query.setParameter(nome, nomeClube + %); @Repository = esteretipo usado para componentes na camada de
List<Clube> clubes = (List<Clube>) query.getResultList(); persistncia.
return clubes;
}
@Transactional Outra anotao importante na nossa classe DAO @Persistence
public Clube create(Clube clube){ Context. Esta a anotao padro do JPA para a injeo do entity ma-
entityManager.persist(clube);
return clube;
nager, que o responsvel pelas operaes de insero, atualizao,
} deleo e consulta no banco de dados. O Spring automaticamente fa-
@Transactional brica um entity manager para a nossa classe atravs desta anotao
public void update(Clube clube){
entityManager.merge(clube); usando a configurao que foi definida no arquivo de configurao
} applicationContext.xml, na tag <bean id=entityManagerFactory>. Atravs
@Transactional desta tag definida a criao de uma fbrica de entity managers
public void delete(Clube clube){
clube = entityManager.find(Clube.class, clube.getIdf()); que sero criados pelo Spring utilizando a biblioteca do Hibernate
entityManager.remove(clube); chamada Hibernate EntityManager.
}
A anotao @Transactional informa que a execuo de um mtodo
public void setEntityManager(EntityManager entityManager) {
this.entityManager = entityManager; ter controle transacional, ou seja, ao entrar na execuo de um
} mtodo o Spring se encarrega de criar uma nova transao. Se a
}
execuo do mtodo chegar at o fim sem erros, o Spring ento
Listagem 11. Cdigo do bean gerenciado pelo Spring, ClubeService. faz um commit da transao. Na ocorrncia de algum erro durante
a execuo do mtodo, o Spring faz um rollback.
package br.com.javamagazine.onzevencedor.service;
Se um mtodo transacional, digamos o mtodo A(), dentro da
//imports omitidos
@Service(clubeService)
sua execuo chama algum outro mtodo transacional, digamos
public class ClubeService { o mtodo B(), a mesma transao utilizada na execuo dos dois.
@Autowired Em caso de algum erro ocorrer na execuo do mtodo B(), todas as
private ClubeDAO dao; operaes realizadas no mtodo A() sero invalidadas pelo rollback
public List<Clube> getAllClubes(){
return dao.findAll();
causado pelo erro do mtodo B().
} Analisaremos agora a classe ClubeService. Esta classe tem a ano-
public List<Clube> getClubesByName(String nomeClube){ tao @Service(clubeService), que indica que um componente de
return dao.findByName(nomeClube); servio com o nome de clubeService ser criado e gerenciado pelo
}
public Clube createClube(Clube clube){
Spring. Um componente de servio uma especializao dos
return dao.create(clube); componentes do Spring que alerta o framework que se trata de
} um componente na camada de servio. Atualmente o Spring no
public void updateClube(Clube clube){ oferece nenhum servio adicional a um componente especfico
dao.update(clube);
}
de servio, mas isso pode acontecer em verses futuras, por isso
public void deleteClube(Clube clube){ uma boa prtica anotar as classes desta camada com a anotao
dao.delete(clube); @Service.
} Outra anotao muito importante utilizada na classe ClubeService
public void setDao(ClubeDAO dao) {
@Autowired. Esta injeta na propriedade anotada um bean do
this.dao = dao;
} Spring que seja do mesmo tipo da propriedade. Em nosso caso, a
} propriedade do tipo ClubeDAO. Se o Spring no encontrar nenhum

Edio 101 Java Magazine 15

Maven, JSF 2, Spring e Hibernate

bean com o tipo pedido, uma exceo em tempo de execuo ir Um item importante a ser destacado aqui a injeo dos nossos
ocorrer. Na nossa aplicao, como definimos a classe ClubeDAO servios Spring nos managed beans do JSF. Na classe ClubeBean
com a anotao @Repository, esta classe ser um bean gerenciado isto feito atravs da anotao @ManagedProperty(#{clubeService}).
pelo Spring e uma instncia dela ser automaticamente injetada Repare que o nome clubeService foi o nome definido para o nosso
na nossa classe de servio. servio na classe ClubeService.
Um ponto que merece ateno a configurao dos pacotes nos
quais o Spring ir procurar por classes anotadas com @Component, Listagem 12. Cdigo da pgina clube.xhtml.
@Controller, @Service e @Repository. Esta configurao feita no arqui-
<?xml version=1.0 encoding=ISO-8859-1 ?>
vo applicationContext.xml, na tag context:component-scan, dentro da <!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.0 Transitional//
propriedade base-package. Para a nossa aplicao passamos dois ENhttp://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd>
<html xmlns=http://www.w3.org/1999/xhtml
pacotes nos quais o Spring deve procurar a definio dos nossos
xmlns:f=http://java.sun.com/jsf/core
beans: br.com.javamagazine.onzevencedor.service e br.com.javamagazine. xmlns:h=http://java.sun.com/jsf/html>
onzevencedor.dao. <h:head>
<meta http-equiv=Content-Type content=text/html; charset=UTF-8 />
<title>Clube</title>
JSF (View e Controller) </h:head>
Nosso back-end est pronto para realizar as operaes da nossa <h:body>
<h:messages globalOnly=true />
aplicao, ento vamos criao do nosso front-end, comeando <h:form id=formPesquisa rendered=#{!clubeBean.editMode}>
pelas pginas JSF. Para isso, iremos empregar facelets, que a partir <h:commandLink value=Adicionar Clube actionListener=#{clubeBean.create}/>
da verso 2 do JavaServer Faces passou a ser tecnologia padro para <h:panelGrid columns=2>
<h:panelGroup>
as pginas, substituindo o JSP. Facelets possui vrias vantagens sobre <h:outputText value=Filtro: />
o JSP, dentre as quais destacamos o suporte ao uso de templates. <h:inputText maxlength=30 size=30 value=#{clubeBean.nomeClube}>
Teremos trs pginas na nossa aplicao: clube.xhtml, atleta. <f:ajax event=keyup render=resultados
listener=#{clubeBean.filtrarClube} />
xhtml e index.xhtml, mostradas nas Listagens 12, 13 e 14, respec- </h:inputText>
tivamente. Os arquivos XHTML devem ser criados na pasta src/ </h:panelGroup>
</h:panelGrid>
main/webapp.
<h:dataTable value=#{clubeBean.clubes} var=clube id=resultados border=1>
As pginas clube.xhtml e atleta.xhtml possuem dois formulrios: <h:column>
um formulrio de pesquisa e outro de edio (usado na incluso e <f:facet name=header>ID</f:facet>
<h:outputText value=#{clube.idf} />
alterao). A tela de pesquisa de clubes possui uma caixa de texto
</h:column>
que filtra a grid de resultados pelo nome do clube. Esta caixa de <h:column>
texto dispara uma requisio Ajax no seu evento onkeyup. Igual- <f:facet name=header>Nome do Clube</f:facet>
<h:outputText value=#{clube.nome} />
mente, a tela de pesquisa de atletas possui uma lista de clubes que </h:column>
funciona como filtro dos resultados. Cada vez que o valor da lista <h:column>
muda, uma requisio Ajax enviada ao servidor para alterar os <f:facet name=header>#</f:facet>
<h:commandLink value=Alterar action=#{clubeBean.update}>
resultados da pesquisa. Estes exemplos demonstram o suporte a <f:setPropertyActionListener target=#{clubeBean.clube}
Ajax adicionado ao JSF2. Por fim, index.xhtml faz o papel de pgina value=#{clube} />
inicial e principal da aplicao, e por isso auxilia na navegao </h:commandLink>
</h:column>
contendo links para as outras pginas existentes. <h:column>
Aps a criao das pginas vamos criar os managed beans <f:facet name=header>#</f:facet>
do JSF. So estas classes que recebero as requisies do JSF e <h:commandLink id=lnkDelete value=Excluir
onclick=if (!confirm(Tem certeza que deseja excluir este dado?))
devero invocar os objetos de negcio, receber uma resposta return false
da camada de negcios e disponibiliz-la para a renderizao action=#{clubeBean.delete}>
<f:setPropertyActionListener target=#{clubeBean.clube}
na camada de viso. As classes dos managed beans podem ser
value=#{clube} />
vistas nas Listagens 15 e 16. O managed bean do CRUD atleta </h:commandLink>
no apresentado e fica como desafio ao leitor. A classe BaseBean </h:column>
</h:dataTable>
usada como classe ancestral dos nossos outros beans. Dentro </h:form>
dela podemos colocar mtodos utilitrios comuns a todos os <h:form id=formEdicao rendered=#{clubeBean.editMode}>
managed beans da aplicao e, desta forma, fazer um bom uso <h:panelGrid columns=2>
<h:outputText value=Nome do clube:/>
da herana de objetos. Definimos nesta classe mtodos para <h:inputText maxlength=30 size=30 value=#{clubeBean.clube.nome}/>
a criao de mensagens de erro e mensagens informativas no </h:panelGrid>
FacesContext. FacesContext um objeto que contm informaes de <h:commandButton value=Salvar actionListener=#{clubeBean.salvar}/>
<h:commandButton value=Cancelar action=clube/>
uma requisio JSF e da sua respectiva resposta. muito til </h:form>
para a mudana programtica do contedo de componentes das </h:body>
pginas, como por exemplo, insero de mensagens de erro. </html>

16 Java Magazine Edio 101

Listagem 13. Cdigo da pgina atleta.xhtml.

<?xml version=1.0 encoding=ISO-8859-1 ?> <f:facet name=header>#</f:facet>

<!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.0 Transitional//EN <h:commandLink id=lnkDelete value=Excluir
http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd> onclick=if (!confirm(Tem certeza que deseja excluir este dado?)) return false
<html xmlns=http://www.w3.org/1999/xhtml action=#{atletaBean.delete}>
xmlns:f=http://java.sun.com/jsf/core <f:setPropertyActionListener target=#{atletaBean.atleta}value=#{at} />
xmlns:h=http://java.sun.com/jsf/html> </h:commandLink>
<h:head> </h:column>
<meta http-equiv=Content-Type content=text/html; charset=ISO-8859-1 /> </h:dataTable>
<title>Atleta</title> </h:form>
</h:head> <h:form id=formEdicao rendered=#{atletaBean.editMode}>
<h:body> <h:panelGrid columns=2>
<h:messages globalOnly=true /> <h:outputLabel value=Nome do Atleta: for=txtNomeAtleta />
<h:form id=formPesquisa rendered=#{!atletaBean.editMode}> <h:panelGroup>
<h:commandLink value=Adicionar Atleta actionListener=#{atletaBean.create}/> <h:inputText size=40 maxlength=40 required=true label=Nome do Atleta
<h:panelGrid columns=2> value=#{atletaBean.atleta.nome} id=txtNomeAtleta />
<h:outputLabel value=Filtrar jogadores por clube: for=cbFiltroClube /> <h:message for=txtNomeAtleta/>
<h:selectOneMenu id=cbFiltroClube value=#{atletaBean.filtroIdfClube}> </h:panelGroup>
<f:selectItem itemLabel=--Nenhum-- itemValue=/> <h:outputLabel value=Data de Nascimento: for=txtDataNascimento/>
<f:selectItems value=#{atletaBean.clubes} var=club <h:panelGroup>
itemLabel=#{club.nome} itemValue=#{club.idf}/> <h:inputText size=12 maxlength=12 required=true label=Data de Nascimento
<f:ajax event=change listener=#{atletaBean.filtrarAtletaPorClube} value=#{atletaBean.atleta.dtaNascimento} id=txtDataNascimento>
render=resultados/> <f:convertDateTime pattern=dd/MM/yyyy />
</h:selectOneMenu> </h:inputText>
</h:panelGrid> <h:message for=txtDataNascimento/>
<h:dataTable value=#{atletaBean.atletas} var=at id=resultados border=1> </h:panelGroup>
<h:column> <h:outputLabel value=Clube: for=cbClube />
<f:facet name=header>ID</f:facet> <h:panelGroup>
<h:outputText value=#{at.idf} /> <h:selectOneMenu id=cbClube value=#{atletaBean.idfClube}
</h:column> required=true label=Clube>
<h:column> <f:selectItem itemLabel=--Selecione-- itemValue=/>
<f:facet name=header>Nome do Atleta</f:facet> <f:selectItems value=#{atletaBean.clubes} var=club
<h:outputText value=#{at.nome} /> itemLabel=#{club.nome} itemValue=#{club.idf}/>
</h:column> </h:selectOneMenu>
<h:column> <h:message for=cbClube/>
<f:facet name=header>Data de Nascimento</f:facet> </h:panelGroup>
<h:outputText value=#{at.dtaNascimento} /> <h:outputLabel value=Posio: for=cbPosicao />
</h:column> <h:panelGroup>
<h:column> <h:selectOneRadio id=cbPosicao value=#{atletaBean.atleta.posicao}
<f:facet name=header>Posio</f:facet> required=true label=Posio>
<h:outputText value=#{at.posicao} /> <f:selectItems value=#{atletaBean.posicoes} var=posicao />
</h:column> </h:selectOneRadio>
<h:column> <h:message for=cbPosicao/>
<f:facet name=header>Clube</f:facet> </h:panelGroup>
<h:outputText value=#{at.clube.nome} /> </h:panelGrid>
</h:column> <h:panelGrid columns=2>
<h:column> <h:commandButton value=Salvar actionListener=#{atletaBean.salvar}/>
<f:facet name=header>#</f:facet> <h:commandButton value=Cancelar action=#{atletaBean.cancel}
<h:commandLink value=Alterar action=#{atletaBean.update}> immediate=true/>
<f:setPropertyActionListener target=#{atletaBean.atleta}value=#{at} /> </h:panelGrid>
</h:commandLink> </h:form>
</h:column> </h:body>
<h:column> </html>

Listagem 14. Cdigo da pgina index.xhtml. Listagem 15. Cdigo da classe base dos nossos managed beans, BaseBean.

<?xml version=1.0 encoding=ISO-8859-1 ?> package br.com.javamagazine.onzevencedor.controller;

<!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.0 Transitional// //imports omitidos
EN http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd> public class BaseBean implements Serializable{
<html xmlns=http://www.w3.org/1999/xhtml protected void addErrorMessage(String componentId, String errorMessage){
xmlns:f=http://java.sun.com/jsf/core addMessage(componentId, errorMessage, FacesMessage.SEVERITY_ERROR);
xmlns:h=http://java.sun.com/jsf/html> } protected void addErrorMessage(String errorMessage){
<h:head> addErrorMessage(null, errorMessage);
<meta http-equiv=Content-Type content=text/html; charset=UTF-8 /> } protected void addInfoMessage(String componentId, String infoMessage){
</h:head> addMessage(componentId, infoMessage, FacesMessage.SEVERITY_INFO);
<h:body> } protected void addInfoMessage(String infoMessage){
<h2>Bem vindo ao JSF2.</h2> addInfoMessage(null, infoMessage);
<ul> } private void addMessage(String componentId, String errorMessage, Severity severity){
<li><h:link value=Clube outcome=clube/></li> FacesMessage message = new FacesMessage(errorMessage);
<li><h:link value=Atleta outcome=atleta/></li> message.setSeverity(severity);
</ul> FacesContext.getCurrentInstance().addMessage(componentId, message);
</h:body> }
</html> }

Edio 101 Java Magazine 17

Maven, JSF 2, Spring e Hibernate

Listagem 16. Cdigo do managed bean, ClubeBean. este arquivo para o diretrio <TOMCAT>/webapps, no qual <TOM-
CAT> o diretrio onde o Tomcat est instalado em sua mquina.
package br.com.javamagazine.onzevencedor.controller;
//imports omitidos Agora preciso iniciar o Tomcat executando o arquivo startup.bat
@ManagedBean(name = clubeBean) (ou startup.sh em ambientes Unix).
@ViewScoped
public class ClubeBean extends BaseBean{ Aps a inicializao do mesmo, acesse a aplicao no endereo
@ManagedProperty(#{clubeService}) http://localhost:8080/OnzeVencedor. Feito isso a pgina index.
private ClubeService model;
private Clube clube; xhtml ser apresentada. Ela contm links para as pginas clube.
private List<Clube> clubes; xhtml e atleta.xhtml, que podem ser visualizadas nas Figuras 4 e 5.
private String nomeClube;
private boolean editMode;
public Clube getClube() {
if(clube == null){
clube = new Clube();
}
return clube;
}
public void salvar(){
System.out.println(idf clube +clube.getIdf());
if(clube.getIdf() == null || clube.getIdf().intValue() == 0){
clube = model.createClube(clube);
clube = new Clube();
addInfoMessage(Clube criado com sucesso.);
}else{
model.updateClube(clube);
addInfoMessage(Clube alterado com sucesso.);
}
}
public void delete(){
model.deleteClube(clube);
if(nomeClube != null && !nomeClube.isEmpty())
clubes = model.getClubesByName(nomeClube);
else
clubes = model.getAllClubes();
} Figura 4. Pgina clube.xhtml sendo exibida no browser
public void create(){
this.clube = new Clube();
this.editMode = true;
}
public void update(){
this.editMode = true;
}
public void cancel(){
this.editMode = false;
}
public void filtrarClube(AjaxBehaviorEvent event){
if(nomeClube != null && !nomeClube.isEmpty()){
clubes = model.getClubesByName(nomeClube);
}else{
clubes = model.getAllClubes();
}
}
public List<Clube> getClubes() {
if(clubes == null){
clubes = model.getAllClubes();
}
return clubes; Figura 5. Pagina atleta.xhtml sendo exibida no browser
}
//getters and setters omitidos
} Concluses
O artigo mostrou de forma prtica a configurao necessria
para a integrao dos frameworks JSF 2, Spring e Hibernate na
Build da Aplicao com Maven arquitetura de projetos Web. Tambm mostrou como tirar proveito
Pronto, finalmente estamos prontos para executar a nossa aplica- da IDE Eclipse e da ferramenta Maven para facilitar o trabalho
o. Deixaremos o Maven tomar conta do build do nosso projeto. de build e principalmente de gerenciamento de dependncias. O
Para isto, selecione o projeto OnzeVencedor no Project Explorer e, exemplo construdo apresenta uma eficiente soluo de arquitetura
com o boto direito, clique em Run As > Maven Install. O Maven de software com frameworks e ferramentas gratuitas e bastante di-
ir gerar um monte de mensagens no console. A mensagem que fundidas no mercado. Tal arquitetura possibilita o desenvolvimento
queremos a de Build Success no final do console, indicando de uma aplicao robusta e leve de forma gil. A aplicao permite
sucesso no build. uma fcil extenso ou mudana das tecnologias utilizadas por seus
Note que uma pasta target foi criada na raiz do projeto. Dentro componentes apresentarem um baixo grau de acoplamento. Assim,
desta existe um arquivo WAR chamado OnzeVencedor.war. Copie poderamos reutilizar o projeto substituindo o Spring por EJB nas

18 Java Magazine Edio 101

camadas de persistncia e servios sem grandes impactos em nosso http://maven.apache.org/download.html
cdigo, ou poderamos fazer uso das vrias bibliotecas existentes Download do Maven, verso 3.0.3.
para JSF 2, como PrimeFaces, IceFaces ou MyFaces, estendendo desta
forma o nmero de componentes JSF da nossa aplicao.
http://www.eclipse.org/downloads/
A partir deste artigo temos um exemplo funcional do uso destas
Download do Eclipse.
tecnologias na arquitetura de um projeto web. A arquitetura apre- http://tomcat.apache.org/index.html
sentada pode ser utilizada pelo leitor como base para o desenvolvi- Download do Tomcat.
mento de novas aplicaes ao mesmo tempo em que deixa pontos
http://eclipse.org/m2e/
em seu projeto que podem ser melhorados, como por exemplo,
Instrues para instalao do plugin M2Eclipse na IDE Eclipse.
o uso do pool de conexes, substituio dos managed beans ge-
renciados pelo JSF por beans gerenciados pela especificao CDI http://sourceforge.net/projects/c3p0/
(Contexts and Dependency Injection), uso de templates de pginas e Download e instrues do C3PO
o uso de uma biblioteca de expanso dos componentes JSF. Para
http://commons.apache.org/dbcp/
uma melhor eficcia no uso destas ferramentas interessante um
Pgina de referncia do Apache DBCP
aprofundamento maior nas respectivas documentaes.

Edwins Leonardi D seu feedback sobre esta edio! Feedback

eu
edwins.leonardi@gmail.com

s
A Java Magazine tem que ser feita ao

D
formado em sistemas de informao pela Universidade Positivo seu gosto. Para isso, precisamos saber

sobre e
(Curitiba-PR) e ps-graduando do curso de Tecnologias Web da o que voc, leitor, acha da revista!

s
ta
edio
PUC-PR. Atualmente trabalha na IBM como IT Specialist. Atua h mais de
D seu voto sobre este artigo, atravs do link:
sete anos com desenvolvimento de sistemas Java. Possui as certificaes
SCJP, SCWCD e SCBCD. www.devmedia.com.br/javamagazine/feedback

Edio 101 Java Magazine 19

 Seo Java: Nesta seo voc encontra artigos intermedirios e avanados sobre Java

Seam 3: Servlet e o futuro

Utilizando CDI para facilitar o desenvolvi

Resumo DevMan
De que se trata o artigo:
Neste artigo, estudaremos Seam Servlet, o quarto mdulo a ser mantido pelos desenvolvedores de JBoss
Seam. Veremos como Seam Servlet permite utilizar a Servlet API de maneira mais simples e poderosa,
atravs de CDI.

Em que situao o tema til:

Seam Servlet facilita grandemente o desenvolvimento de aplicaes web Java EE 6 que utilizem servlets.
O mdulo prov mtodos produtores para parmetros e objetos do ambiente das servlets, criar mtodos
observadores do ciclo de vida de servlets e utilizar Seam Catch para tratar erros no capturados.

Seam 3: Servlet e o futuro:

Dos vrios mdulos de Seam 3.0, apenas quatro esto presentes em Seam 3.1. Neste artigo, veremos o
quarto mdulo, Seam Servlet, que permite utilizar CDI com servlets de maneira prtica, provendo mtodos
produtores, eventos de CDI e tratamento de excees teis para a Servlet API. Ademais, faremos uma breve
exposio sobre o futuro, ainda pouco claro, da famlia de frameworks Seam.

C
onforme vimos nos artigos anterio-
res, a recepo ambgua de Seam 3
pela comunidade levou a pesadas
reestruturaes no framework. Mdulos
mais relacionados a outras tecnologias
foram transferidos para diversos projetos.
Por exemplo, Seam Faces passou a fazer
parte do RichFaces; Seam Persistence se
tornou responsabilidade do Hibernate;
Seam REST ao projeto RESTEasy; e assim
por diante. Apenas quatro mdulos fica-
ram sob a gide do projeto Seam: Solder,
Catch, Config e Servlet. J estudamos
os trs primeiros nos artigos anteriores.
Agora, conheceremos Seam Servlet.
Seam Servlet permite utilizar CDI com
servlets de maneira mais poderosa e sim-
ples que o padro das especificaes. Com
ele, possvel obter valores definidos pela
Servlet API atravs de injeo de depen-
dncias, por exemplo. Tambm possvel
executar aes durante as fases do ciclo
de vida de servlets atravs de eventos de
CDI, e delegar excees no tratadas para
Seam Catch.
Assim como Solder, Catch e Config, Seam
Servlet um subcomponente de Solder em
Seam 3.1. Entretanto, este novo e maior Seam
Solder ser mesclado com outros projetos
(notadamente, Apache CODI e CDISource),
formando um novo projeto focado em esten-
der CDI. Este novo projeto pe em dvida
o futuro da famlia de frameworks Seam,
conforme veremos mais frente.
Seam Servlet
O ltimo dos mdulos de Seam 3 a ser fun-
dido ao Solder o Seam Servlet, que adiciona
facilidades que integram Servlet API e CDI
de maneira mais poderosa. Para o desenvol-
vedor de aplicaes, existem trs tipos de
aprimoramentos: mtodos produtores para
diversos objetos da Servlet API, lanamento
de eventos de CDI a partir de eventos de
servlet e integrao com Seam Catch.
Instalao
Em containers que suportem a verso 3
da Servlet API, instalar Seam Servlet
em uma aplicao to simples quanto

20 Java Magazine Edio 101

 Neste artigo, estudaremos
mais um mdulo de Seam 3,
o Seam Servlet, que integra
melhor a Servlet API com CDI

mento de servlets
Adam Victor Nazareth Brandizzi

adicionar os JARs da API e da implementao do mdulo no

Listagem 1. Dependncias necessrias para utilizar Seam Servlet.
classpath da aplicao. possvel baixar os arquivos necessrios
no link apresentado ao final do artigo. <dependency>
<groupId>org.jboss.seam.servlet</groupId>
Uma soluo mais gerencivel seria utilizar Maven para adi- <artifactId>seam-servlet-api</artifactId>
cionar Seam Servlet s dependncias do projeto. Para adicionar <version>3.0.0.Final</version>
<scope>compile</scope>
todo o Seam Servlet ao projeto, basta adicionar a configurao </dependency>
abaixo ao pom.xml: <dependency>
<groupId>org.jboss.seam.servlet</groupId>
<dependency> <artifactId>seam-servlet-impl</artifactId>
<groupId>org.jboss.seam.servlet</groupId> <version>3.0.0.Final</version>
<artifactId>seam-servlet</artifactId> <scope>runtime</scope>
<version>3.0.0.Final</version> </dependency>
</dependency> <dependency>
<groupId>org.jboss.logging</groupId>
<artifactId>jboss-logging</artifactId>
Esta forma tem a desvantagem de tornar a implementao de <version>3.0.0.Beta4</version>
Seam Servlet conhecida em tempo de compilao. Neste caso, <scope>compile</scope>
</dependency>
um desenvolvedor pode, por desateno, utilizar diretamente
classes de Seam Servlet no lugar das interfaces do mdulo, o que Listagem 2. Configuraes que devem constar no web.xml de uma aplicao que
geraria acoplamento entre a aplicao e o mdulo. Isto pode ser utilize Seam Servlet para que possa processar eventos via CDI.

evitado acrescentando a interface e a implementao do mdulo <listener>

como dependncias diferentes, em escopos diferentes. Para fazer <listener-class>org.jboss.seam.servlet.event.ServletEventBridgeListener
</listener-class>
isto, basta utilizar as configuraes apresentadas na Listagem 1 </listener>
no pom.xml. <servlet>
Se o container em questo no suportar Servlet API na verso 3, <servlet-name>Servlet Event Bridge Servlet</servlet-name>
<servlet-class>org.jboss.seam.servlet.event.ServletEventBridgeServlet
necessrio acrescentar mais algumas configuraes no web. </servlet-class>
xml do projeto. Por exemplo, preciso habilitar explicitamente </servlet>
<filter>
o tratamento de eventos de servlets como eventos de CDI. Para <filter-name>Servlet Event Bridge Filter</filter-name>
isto, adicionamos um listener, um filtro e um servlet nativos de <filter-class>org.jboss.seam.servlet.event.ServletEventBridgeFilter</filter-class>
</filter>
Seam Servlet. O cdigo a ser inserido no web.xml pode ser visto <filter-mapping>
na Listagem 2. <filter-name>Servlet Event Bridge Filter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
- Seam Servlet permite que vrios beans teis sejam injetados. Os mtodos produ-
tores destes beans, porm, dependem da captura de eventos configurada acima. Listagem 3. Incluso de filtro necessrio para integrar Seam Catch com Seam
Servlet em containers que no suportem Servlet API 3.
Em outras palavras, mesmo que o desenvolvedor no pretenda usar eventos de
CDI para processar as fases do ciclo de vida de servlets, necessrio adicionar as <filter>
<filter-name>Catch Exception Filter</filter-name>
configuraes apresentadas.
<filter-class>org.jboss.seam.servlet.exception.CatchExceptionFilter</filter-class>
</filter>
A integrao com Seam Catch tambm exige uma configurao <filter-mapping>
<filter-name>Catch Exception Filter</filter-name>
especfica no web.xml. Esta, porm, mais simples. Caso o de- <url-pattern>/*</url-pattern>
senvolvedor deseje utilizar Catch para gerenciar as excees no </filter-mapping>
tratadas oriundas de servlets, basta adicionar um filtro aplicao.
O filtro pode ser visto na Listagem 3.
Eventos de servlets em CDI
- Note que a classe do filtro do Catch org.jboss.seam.servlet.exception.CatchException Desde a verso 2.3, a Servlet API oferece a possibilidade de escutar
Filter. A documentao oficial de Seam Servlet afirma que org.jboss.seam.servlet. eventos dos ciclos de vida de vrios objetos. possvel desenvolver
CatchExceptionFilter (sem exception), mas est errada. classes isto , listeners para serem executadas quando uma apli-

Edio 101 Java Magazine 21

Seam 3: Servlet e o futuro
cao web inicia ou termina a execuo; quando uma sesso criada
e destruda; quando uma requisio recebida ou processada; e em
muitas outras situaes. Seam Servlet permite que o desenvolvedor
possa adicionar sua prpria lgica de negcios a estes eventos sem
precisar implementar interfaces da Servlet API. Ao invs disto,
podem-se criar mtodos observadores para eventos de CDI.
H muitos eventos de servlet disponveis. Por exemplo, possvel
tratar eventos relativos a uma aplicao. Para isso, basta criar um m-
todo observador para o tipo ServletContext. A classe a seguir apresenta
um destes mtodos observadores, que imprime no log uma mensa-
gem simples quando um contexto inicializado ou destrudo:
public class ObservadorContexto {
public void eventoOcorreu(@Observes ServletContext contexto) {
System.out.println(Um evento ocorreu relacionado ao contexto de servlet +
contexto.getServletContextName());
}
}
Tambm possvel criar observadores para os eventos espec-
ficos de inicializao ou destruio de contextos. Para distinguir
quais eventos de contexto um observador vai tratar, basta utilizar
os qualificadores @Initialized e @Destroyed. Um observador cujo
parmetro anotado com @Observes seja qualificado com @Initialized
ser invocado apenas quando o contexto for iniciado; j um obser-
vador com o parmetro qualificado com @Destroyed executado na
destruio do contexto. Por exemplo, suponha que nossa aplicao
precise criar um diretrio para salvar arquivos a serem baixados
no momento em que for iniciada. Podemos definir o caminho
como um parmetro de contexto no web.xml:
<context-param>
<param-name>diretorio-downloads</param-name>
<param-value>/var/minha-app/meus-downloads</param-value>
</context-param>
Definido o parmetro, podemos criar um observador que recu-
pere o valor e crie o diretrio:
public class ObservadorContextoCriado {
public void criaDiretorioDownloads(@Observes @Initialized ServletContext contexto) {
File file = new File(downloads);
if (!file.exists()) {
file.mkdir();
} resposta foram criados. Quando for executado, o observador
} vai imprimir informaes obtidas tanto da requisio quanto
}
Outros eventos observveis atravs de Seam Servlet so as fases
do ciclo de vida de requisies e respostas HTTP. Para tanto, basta
criar um mtodo observador cujo parmetro observado seja do
tipo ServletRequest ou ServletResponse, respectivamente. Assim como
os eventos do contexto de servlet, possvel observar a criao
e a destruio de requisies e respostas. O mtodo observador
abaixo, por exemplo, imprime uma mensagem toda vez que uma
requisio for criada:
public void requestCriado(@Observes @Initialized ServletRequest req) {
System.out.println(Uma requisio foi criada);
} }
22 Java Magazine Edio 101
J o mtodo observador que se segue, imprime uma mensagem
quando uma resposta destruda:
public void responseDestruido(@Observes @Destroyed ServletResponse res) {
System.out.println(Uma resposta foi destruda);
}
Alm de @Initialized e @Destroyed h tambm o qualificador
@Path para este tipo de evento. Esta anotao recebe uma String
como parmetro, que o caminho que levou servlet da aplica-
o. Se tivermos, por exemplo, uma aplicao rodando em http://
localhost:8080/minha-app e acessarmos via navegador a URL http://
localhost:8080/minha-app/teste, o mtodo observador abaixo vai
imprimir uma mensagem na sada-padro:
public void requestTeste(@Observes @Path(teste) ServletRequest req) {
System.out.println(A URL /teste foi solicitada);
}
Note que o parmetro de @Path deve ser o caminho exato da
servlet, e no h suporte a nenhum tipo de caractere-curinga.
Em outras palavras, @Path(teste.*) restringiria o observador a
processar requisies para http://localhost:8080/minha-app/teste.*,
mas no para, por exemplo, http://localhost:8080/minha-app/teste-
longo, ao contrrio do que aconteceria com os padres de URL do
mapeamento de servlets.
possvel escutar eventos relativos a HttpServletRequest e HttpServlet
Response tambm. Se for preciso invocar mtodos destas interfaces,
mais interessante utilizar estas classes no mtodo observador,
ao invs de ServletRequest e ServletResponse. O mtodo observador
abaixo, por exemplo, escuta eventos relativos a HttpServletRequest
porque utiliza o mtodo getServletPath(), que especfico desta
interface e no est disponvel em ServletRequest:
public void requestTeste(@Observes @Path(teste) HttpServletRequest req) {
System.out.println(A URL + req.getServletPath() + foi solicitada);
}
Ademais, caso o desenvolvedor queira capturar um evento e ter
acesso tanto requisio quanto resposta, basta utilizar o objeto
RequestContext definido por Seam Servlet como tipo observado.
Por exemplo, o mtodo ObservadorRequestContext.requestOuResponse-
CriadoEmURL() da Listagem 4 observa se uma requisio ou uma
da resposta, e tambm do contexto da servlet.
- Caso queira escutar apenas eventos relativos a HTTP, o desenvolvedor pode utilizar
a classe HttpServletRequestContext no lugar de ServletRequestContext.
Por fim, Seam Servlet tambm permite observar eventos rela-
tivos a sesses HTTP. Se precisarmos fazer um observador ser
executado em todos os eventos, basta cri-lo com um parmetro
do tipo HttpSession:
public void observaSessao(@Observes HttpSession sessao) {
System.out.println(Um evento ocorreu com a sesso + sessao.getId());
 Listagem 4. Classe ObservadorRequestContext, cujo mtodo executado quando
uma requisio submetida URL "/path".
public class ObservadorRequestContext {
public void requestOuResponseCriadoEmURL(
@Observes @Initialized @Path(url)
ServletRequestContext contexto) {
System.out.println(Uma requisio ou uma resposta foi criada +
para o caminho \url\.);
System.out.println(Servlet: + contexto.getRequest());
System.out.println(Encoding: + contexto.getResponse().getCharacterEncoding());
System.out.println(Path contexto + contexto.getServletContext().
getContextPath());
} grande flexibilidade de Weld, fazem com que Seam Servlet
} permita ao desenvolvedor que nunca mais escreva um listener
Entretanto, este um caso pouco usual. No geral, queremos exe-
cutar eventos para fases especficas do ciclo de vida das sesses.
Neste sentido, Seam Servlet permite-nos usar os qualificadores
@Initialized e @Destroyed j conhecidos para restringir a execuo do
mtodo observador s situaes correspondentes:
public void observaSessaoIniciada(@Observes @Initialized HttpSession sessao) {
System.out.println(A sesso + sessao.getId() + foi iniciada);
} quando for utiliz-lo.
public void observaSessaoDestruida(@Observes @Destroyed HttpSession sessao) {
System.out.println(A sesso + sessao.getId() + foi destruda);
}
Alm destas fases, eventos tambm so propagados quando
uma sesso vai ser passivada (isto , persistida em disco ou outra
memria permanente) e, logo aps, ser ativada (isto , recuperada
do disco). Para estes casos, os qualificadores so, respectivamente,
@WillPassivate e @DidActivate:
public void observaSessaoPassivada(@Observes @WillPassivate HttpSession sessao) {
System.out.println(A sesso + sessao.getId() + ser passivada);
} Action mostrada na Listagem 5. O ponto mais relevante desta classe
public void observaSessaoA(@Observes @DidActivate HttpSession sessao) {
System.out.println(A sesso + sessao.getId() + foi ativada);
}
Comparativo entre mtodos observadores e listeners
interessante notar que, ao contrrio dos listeners da Servlet API,
os parmetros dos mtodos observadores no so instncias de
EventObject. Por exemplo, a interface ServletRequestListener, que deve
ser implementada por todos os listeners, exige a implementao
de dois mtodos, contextInitialized() e contextDestroyed(), e ambos
recebem por parmetro uma instncia de ServletRequestEvent (cuja
superclasse EventObject). Oras, o nico dado relevante que se
pode recuperar de um ServletRequestEvent a prpria instncia de
ServletRequest. Neste caso, Seam Servlet nos poupa de um wrap-
per desnecessrio. Do mesmo modo, os mtodos observadores
de eventos de contexto de servlet no esperam por instncias
de ServletContextEvent, mas sim de ServletContext, e observadores de
eventos de sesso recebem por parmetro objetos HttpSession no
lugar de HttpSessionEvent.
Os mtodos observadores tm vantagens sobre os listeners. Alm
da simplicidade do parmetro recebido, mtodos observadores
dispensam o desenvolvedor de criar mtodos desnecessrios.
Por exemplo, um programador que implementasse HttpSession
Listener para executar algo quando uma sesso fosse criada, se veria
forado a implementar um mtodo para processar a destruio
da sesso.
Outra vantagem, esta mais considervel, que eventos de Weld
dispensam alteraes no web.xml. Listeners da Servlet API devem
ser configurados no arquivo web.xml, o que tedioso e pouco
flexvel. Em CDI, ao contrrio, a mera existncia do mtodo obser-
vador suficiente para ativ-lo. Essa e outras vantagens, aliadas
para aplicaes Java EE 6.
Injeo de parmetros
Uma das funcionalidades mais interessantes de Seam Servlet
a capacidade de injetar vrios aspectos do estado do container
de servlet em beans de CDI. Os objetos injetados so tambm
instncias de beans e podem estar em vrios escopos. preciso,
portanto, ter em mente qual o escopo do bean a ser injetado
Por exemplo, considere o formulrio abaixo, retirado de um facelet:
<h:form>
<input type=text name=usuario />
<input type=password name=senha />
<h:commandButton id=Autenticar action=#{loginAction.autenticar} />
</h:form>
- No recomendvel utilizar elementos <input> de HTML em um componente JSF
<h:form>. O formulrio acima serve apenas para propsito de exemplo.
O bean referenciado no <h:commandButton> definido pela classe Login
so os atributos usuario e senha, que so declarados como abaixo:
@Inject @RequestParam(usuario) private String usuario;
@Inject @RequestParam(senha) private String senha;
O qualificador @RequestParam faz com que Weld recupere os
parmetros da requisio cujos nomes lhe so passados como
argumento, e os atribua ao ponto de injeo. Os valores atribu-
dos so beans no pseudo-escopo dependente, de modo que este
qualificador s deve ser utilizado diretamente em beans cujo
escopo , no mximo, de requisio. Como o esteretipo @Model de
nossa classe garante que LoginAction fica no escopo de requisio,
podemos injetar os parmetros sem problemas.
- Caso o bean em que o parmetro ser injetado pertena a um escopo maior que
o de requisio, pode-se utilizar uma instncia de Instance para recuperar o par-
metro. O ponto de injeo seria declarado como @Inject @RequestParam(usuario)
private Instance<String> usuarioProxy; e o valor do parmetro seria recuperado pelo
mtodo get(): String usuario = usuarioProxy.get().
O argumento de @RequestParam opcional. Caso no seja passado
nenhum nome para o parmetro, o qualificador utilizar o nome do
ponto de injeo para este propsito. Isto significa, por exemplo, que,
Edio 101 Java Magazine 23
Seam 3: Servlet e o futuro
como no nosso exemplo os nomes dos parmetros e dos atributos
injetados so os mesmos, o argumento de @RequestParam suprfluo
e poderamos ter escrito apenas:
@Inject @RequestParam private String usuario;
@Inject @RequestParam private String senha;
Caso no haja um parmetro correspondente ao nome na requi-
sio, o valor injetado ser null. No entanto, possvel atribuir um
valor padro ao ponto com a anotao @DefaultValue. Deste modo, se
o parmetro correspondente no foi submetido, o valor definido
por @DefaultValue ser injetado:
@Inject @RequestParam @DefaultValue(guest) private String usuario;
@Inject @RequestParam @DefaultValue() private String senha;
Assim como @RequestParam nos permite injetar valores de parmetros
de requisio como beans dependentes, o qualificador @HeaderParam
permite recuperar parmetros do cabealho HTTP. Na linha abaixo,
por exemplo, recuperamos o user agent que enviou a requisio:
@Inject @HeaderParam(User-Agent) private String userAgent;
O argumento de @HeaderParam opcional, tal como o de @Re-
questParam, e tambm possvel atribuir um valor padro com a
anotao @DefaultValue.
Existe tambm o qualificador @CookieParam, que qualifica o ponto
de injeo a receber o valor de um cookie HTTP. Poderamos usar
este qualificador para, no nosso LoginAction, recuperar um usurio
que eventualmente tivesse salvado sua sesso via cookies:
@Inject @CookieParam(USUARIO_AUTENTICADO) private String usuarioSalvo;
@Inject @RequestParam @DefaultValue(teste) private String usuario;
@CookieParam pode dispensar o argumento que lhe passado, e
tambm aceita ser inicializado com @DefaultValue. Ademais, o ponto
de injeo de um cookie pode ser tambm do tipo Cookie da Servlet
API. Neste caso, naturalmente, o valor a ser injetado ser um objeto
Cookie. A linha a seguir mostra como injetar este bean:
@Inject @CookieParam(USUARIO_AUTENTICADO) private Cookie usuarioSalvo;
Isto til quando se precisa obter mais informaes sobre o
cookie, como domnio e data de expirao. Naturalmente, tam-
bm possvel recuperar o valor do cookie, que seria injetado
caso o ponto de injeo fosse do tipo String, atravs do mtodo
Cookie.getValue().
Valores injetados em um ponto qualificado por @HeaderParam
e @CookieParam so, assim como no caso de @RequestParam, beans
do pseudo-escopo dependente. Deste modo, eles s podem ser
injetados com segurana em beans dependentes ou do escopo
de requisio. Caso deseje injetar algum valor associado a esses
qualificadores em escopos mais abrangentes, utilize Instance.
Alm destes valores definidos pela aplicao ou pelo usurio,
possvel injetar informaes sobre o contexto e o servidor em
que a aplicao roda. Por exemplo, para recuperar o caminho do
contexto de servlet, basta utilizar o qualificador @ContextPath:
@Inject @ContextPath private String caminhoContexto;
24 Java Magazine Edio 101
Para injetar o valor retornado pelo mtodo getServerInfo() do con-
texto de servlet, usa-se o qualificador @ServerInfo:
@Inject @ServerInfo private String infoServidor;
Estas informaes podem ser teis para depurao e para
recuperar recursos estticos de dentro do contexto. Assim
como os demais parmetros, os valores injetados so beans
dependentes. Se for necessrio injet-los em beans cujo escopo
seja mais abrangente que o de requisio, deve-se usar Instance
como provedor do bean.
Listagem 5. Classe LoginAction, utilizada para autenticao.
@Model
public class LoginAction {
@Inject @RequestParam(usuario) private String usuario;
@Inject @RequestParam(senha) private String senha;
public String autenticar() {
FacesMessage mensagem = null;
if (senhaCorreta(usuario, senha)) {
mensagem = new FacesMessage(Autenticao bem sucedida!);
mensagem.setSeverity(FacesMessage.SEVERITY_INFO);
} else {
mensagem = new FacesMessage(Usurio ou senha invlidos!);
mensagem.setSeverity(FacesMessage.SEVERITY_ERROR);
}
FacesContext.getCurrentInstance().addMessage(null, mensagem);
return index;
}
// Mais mtodos
}
Injeo de objetos do ambiente de servlet
Alm de permitir injetar valores de parmetros especficos,
Seam Servlet tambm gera beans para vrios objetos importantes
providos pelo container de servlet.
Por exemplo, possvel injetar o contexto da aplicao em um
bean quando se utiliza Seam Servlet. Para tanto, basta criar um
ponto de injeo do tipo ServletContext, que um bean no escopo de
aplicao ser injetado:
@Inject private ServletContext contextoAplicacao;
Outros objetos injetveis so as requisies e as respostas HTTP.
Neste caso, os pontos de injeo devem ser dos tipos ServletRequest
e ServletResponse, respectivamente:
@Inject private ServletRequest requisicao;
@Inject private ServletResponse resposta;
Alternativamente, podem-se utilizar pontos de injeo dos
tipos HttpServletRequest e HttpServletResponse, tambm, caso os
mtodos especficos destas interfaces sejam necessrios. To-
dos esses beans esto no escopo de requisio. Como no so
dependentes, seguro injet-los em qualquer bean de qualquer
escopo.
Outro objeto injetvel atravs de Seam Servlet a sesso do usurio.
Para tanto, basta criar um ponto de injeo do tipo HttpSession:
@Inject private HttpSession sessao;
 Neste caso, importante ter em mente que
isto forar a criao da sesso, caso ainda no
exista. Se isto no for interessante, deve-se
injetar um objeto do tipo HttpSessionStatus, que
provido por Seam Servlet. Esta classe possui
um mtodo isActive(), que retorna true caso a
sesso j exista. Se for necessrio criar ou
recuperar a sesso, pode-se utilizar o mtodo
get(). O cdigo abaixo, por exemplo, verifica se
uma sesso existe e, se no existir, a cria:
@Inject private HttpSessionStatus statusSessao;
public String criarSessao() {
if (!statusSessao.isActive()) {
statusSessao.get();
}
return index;
}
Assim como HttpSession, HttpSessionStatus
um bean do escopo de requisio e, portan-
to, pode ser injetado em beans de qualquer
outro escopo.
J vimos como injetar um cookie especfico
em um bean. Para injetar uma lista com todos
os cookies de uma pgina, basta criar um
ponto de injeo cujo tipo seja uma lista de
objetos Cookie. A lista gerada uma instncia
de bean no escopo de requisio:
@Inject private List<Cookie> listaCookies;
As facilidades de injeo de objetos do
ambiente de servlet permitem que o desen-
volvedor recupere dados importantes de
maneira menos acoplada e mais declarativa.
Os qualificadores e mtodos produtores de
Seam Servlet evitam a reescrita de compo-
nentes relativamente simples, mas frequen-
temente usados. importante notar, porm,
que, em containers que no suportem Servlet
API 3, a injeo destes valores depende da
configurao de Seam Servlet.
Integrao com Seam Catch
Seam Servlet tambm permite utilizar
Seam Catch para gerenciar as excees
no tratadas pelas servlets. Este um
grande avano em relao Servlet API,
cujas ferramentas para gerenciamento de
excees so bastante limitadas.
Para utilizar esta funcionalidade, neces-
srio ter Catch na sua aplicao. O artigo
anterior desta srie explica como fazer isso.
Resumidamente, a melhor maneira de faz-
lo , provavelmente, adicionar o contedo
da Listagem 6 ao pom.xml do projeto.
Figura 1. Tela de erro padro do Tomcat
Uma vez que se tenha Catch na aplicao e
o web.xml esteja devidamente configurado,
manipular excees lanadas por servlets
to simples quanto criar mtodos manipu-
ladores. O artigo anterior desta srie explica
como fazer isso em detalhes; aqui, vamos
ver um exemplo para ilustrar seu uso.
Considere a ServletFaltosa da Listagem 7.
Esta servlet pode lanar uma exceo do
tipo ErroInternoException, do tipo DadoNaoEn-
contradoException ou simplesmente redire-
cionar para uma JSP. Quando uma das
excees lanada, a tela padro de erro
interno do servidor apresentada, como
na Figura 1.
Agora, observe o bean declarado na
Listagem 8. Ele possui dois mtodos ma-
nipuladores de exceo um para ErroIn-
ternoException e um para DadoNaoEncontradoEx-
ception. Os manipuladores apenas definem
cdigos de erro a serem enviados, mas isto
j faz considervel diferena. Por exemplo,
se acessarmos a mesma URL anterior, uma
nova tela de erro ser apresentada. A nova
tela pode ser vista na Figura 2.
- Note como, na classe da Listagem 8, as excees
lanadas por HttpServletResponse.sendError() so
delegadas a Catch. Estes erros nunca devem ocorrer,
mas boa prtica delegar todas as excees no
efetivamente tratadas a Seam Catch, uma vez que
se tenha comeado a usar este mdulo.
Listagem 6. Adicionando Seam Catch como
dependncia no pom.xml.
<dependency>
<groupId>org.jboss.seam.catch</groupId>
<artifactId>seam-catch-api</artifactId>
<version>3.0.0.Final</version>
</dependency>
<dependency>
<groupId>org.jboss.seam.catch</groupId>
<artifactId>seam-catch-impl</artifactId>
<version>3.0.0.Final</version>
<scope>runtime</scope>
</dependency>}
Listagem 7. Servlet que lana dois tipos de
exceo.
public class ServletFaltosa extends HttpServlet {
protected void doGet(HttpServletRequest req,
HttpServletResponse resp)
throws ServletException, IOException {
String erro = req.getParameter(erro);
if (nao-encontrado.equals(erro)) {
throw new ServletException
(new DadoNaoEncontradoException());
} else if (interno.equals(erro)) {
throw new ServletException
(new ErroInternoException());
}
resp.sendRedirect(sucesso.jsp);
}
}
No nosso exemplo, ns apenas mudamos
o erro e a mensagem a serem apresenta-
das, mas poderamos inibir totalmente a
apresentao de uma tela de erro e at re-
direcionar para outra pgina. Se nenhum
Edio 101 Java Magazine 25
Seam 3: Servlet e o futuro
mtodo manipulador tivesse manipulado a exceo (ou qualquer
mtodo manipulador executasse CaughtException.rethrow()), a tela de
erro padro do Tomcat seria apresentada.
Figura 2. Nova mensagem de erro para lanamento da exceo DadoNaoEncontradoException
Listagem 8. Bean com mtodos manipuladores de Seam Catch.
@HandlesExceptions
public class TratadorExcecoes {
@Inject private Event<ExceptionToCatch> exceptionEvento;
public void manipulaErroInterno(
@Handles CaughtException<ErroInternoException> ce,
HttpServletResponse resposta) {
try {
resposta.sendError(500, Um erro interno ocorreu);
} catch (IOException e) {
// Nunca deve ocorrer
exceptionEvento.fire(new ExceptionToCatch(e));
}
}
public void manipulaDadoNaoEncontrado(
@Handles CaughtException<DadoNaoEncontradoException> ce,
HttpServletResponse resposta) {
try {
resposta.sendError(404, Recurso no encontrado);
} catch (IOException e) {
// Nunca deve ocorrer
exceptionEvento.fire(new ExceptionToCatch(e));
} que Seam 3 foi um mau nome para este projeto, cuja relao
}
}
- Um ponto interessante de se relembrar que o mtodo doGet() de nossa servlet
lana uma ServletException cuja causa uma DadoNaoEncontradoException, mas
no uma DadoNaoEncontradoException diretamente. Como vimos no ltimo artigo,
porm, Catch no s trata todas as causas, como comea pela mais antiga. Esta
uma das razes para se utilizar Seam Catch.
Planeja-se adicionar ainda mais facilidades para integrar Catch
com servlets, como anotaes para definir cdigos de erro. Entre-
tanto, assim como muitos outros aspectos futuros de Seam 3, estas
possveis funcionalidades de Seam Catch dependem de decises
importantes que esto sendo tomadas nesse momento sobre o
futuro do projeto.
O futuro do JBoss Seam
A recepo do novo framework pela comunidade de usurios
de Seam 2 foi ambivalente. Enquanto alguns desenvolvedores
26 Java Magazine Edio 101
aprovaram as novas mudanas, um bom nmero de programa-
dores j experimentados em Seam 2 considerou as mudanas
ruins.
Vrias razes foram citadas. Seam 3 no tem praticamente
relao alguma com Seam 2, tornando a migrao de aplicaes
antigas impossvel apenas a total reescrita uma soluo.
Alis, Seam 3 nem sequer almeja atender as mesmas deman-
das de Seam 2. Tampouco existe uma estratgia de migrao
documentada de Seam 2 para Seam 3. Os componentes de
Seam 3 precisam ser coletados e integrados manualmente,
de maneira pouco prtica. Alm disso, o cdigo atual est
permeado de bugs e mal documentado. Por sua vez, Seam 2,
ainda largamente utilizado, passou a receber menos ateno
dos desenvolvedores, em favor da nova ferramenta. Assim a
lista de reclamaes foi crescendo.
A equipe de desenvolvimento de Seam 3 tomou ento algu-
mas decises. A mais drstica foi, certamente, distribuir vrios
mdulos de Seam a outros projetos:
Seam Persistence foi delegado ao projeto Hibernate e reno-
meado como Hibernate CDI;
S eam Validation tambm foi delegado ao Hibernate, sendo
integrado ao componente Hibernate Validator;
S eam Wicket foi transferido ao projeto Wicket da Apache;
S eam REST foi integrado ao RESTEasy;
Seam Faces passou a ser uma biblioteca do projeto RichFaces,
chamada Faces CDI.
Ademais, Catch, Config e Servlet foram unificados em Seam
Solder.
Este novo passo deixou alguns desenvolvedores ainda mais
confusos. Seam 3 tornava-se, assim, ainda menos integrado do
que era e, portanto, mais distante de Seam 2. Membros da comu-
nidade afirmavam, e desenvolvedores do projeto concordavam,
com o projeto anterior era praticamente inexistente. Uma vez
que o ncleo de Seam 2 se tornou dispensvel, o projeto Seam
passou por uma crise de identidade.
Ento, em 30 de setembro, Shane Bryzak, desenvolvedor do
projeto Seam, postou nos fruns de discusso do projeto um
tpico pedindo opinies da comunidade sobre como deveria
ser o Seam do futuro, apelidado de Seam.Next. Aps longa dis-
cusso, em 30 de novembro, foi anunciado no portal In Relation
To o futuro de Seam. E as decises foram surpreendentes.
Resumidamente, anunciou-se um acordo entre vrios projetos
para criar um megaprojeto, administrado por uma organi-
zao no subordinada a corporaes. O novo megaprojeto
foi proposto na incubadora da Fundao Apache e se chama
Apache DeltaSpike. A principal funo deste integrar diversas
extenses portveis de CDI, como MyFace CODI, CDISource e,
tambm, Seam 3. Notadamente, os mdulos de Seam 3 sero
migrados para o novo projeto.
Do texto em que se apresenta o novo projeto, difcil concluir
sobre qual vai ser o futuro de Seam. Por exemplo, o final do
texto afirma que Seam 3 ser mantido, mas no fala nada sobre
a evoluo do framework, nem sobre o futuro de Seam 2. A im-
presso geral que, de fato, o framework Seam chegou ao final
da linha e seu sucessor ser DeltaSpike.
Concluses
Vrios mdulos foram retirados da proposta original de Seam 3
e delegados a outros projetos. Dos originais, apenas quatro
mdulos permaneceram sob a gide do projeto Seam e foram
mesclados em um s, o novo Seam Solder. Nos artigos anterio-
res, havamos estudado trs dos mdulos antigos: Solder, Catch
e Config. Neste artigo, vimos o ltimo: Seam Servlet.
A principal funo de Seam Servlet integrar a Servlet API
com CDI. Por exemplo, Seam Servlet permite executar aes
em fases do ciclo de vida de servlets atravs de observadores
Adam Victor Nazareth Brandizzi
brandizzi@gmail.com
desenvolvedor em vrias linguagens. Programa em Java h
quatro anos, trabalhando majoritariamente com Struts 2 e com a
ferramenta de portais Liferay. licenciado em Computao pela Univer-
sidade de Braslia e atualmente trabalha para SEA Tecnologia.
D seu feedback sobre esta edio!
Feedback
eu
s
de eventos de CDI, muito mais simples e prticos de criar que
servlet listeners. Servlet tambm permite injetar parmetros e
objetos do ambiente de servlet em beans CDI, alm de prover
uma bridge entre servlets e Seam Catch.
As facilidades que vimos, hoje unificadas no mdulo Solder,
so realmente bastante teis para o desenvolvimento com CDI
e Weld. Entretanto, o framework Seam, como conhecido, tem um
futuro obscuro. Com a criao de DeltaSpike, bem possvel
que todas as facilidades do ncleo de Seam 3 venham a ser
disponveis apenas no novo projeto, e Seam simplesmente seja
descontinuado.
http://seamframework.org/Seam3/DistributionDownloads
Pgina de download de mdulos de Seam, de onde se pode
baixar Seam Config e Seam Servlet.
http://docs.jboss.org/seam/3/servlet/latest/reference/en-US/html/
Documentao de Seam Servlet
http://in.relation.to/Bloggers/SoWhatsHappeningWithSeam
Post no blog in.relation.to anunciando, entre outras coisas, a
repartio dos mdulos de Seam 3 entre vrios projetos e a fuso de
Catch, Servlet e Config em Solder.
http://seamframework.org/Community/SeamNextDiscussion

A Java Magazine tem que ser feita ao

D

seu gosto. Para isso, precisamos saber Tpico no frum de seamframework.com em que a comunidade
sobre e

o que voc, leitor, acha da revista! opinou e fez pedidos sobre o futuro de Seam.
s

ta
edio

D seu voto sobre este artigo, atravs do link: http://in.relation.to/Bloggers/SeamNextAnnouncement

www.devmedia.com.br/javamagazine/feedback Post no blog in.relation.to explicando o projeto DeltaSpike.

Edio 101 Java Magazine 27

 Seo Java: Nesta seo voc encontra artigos intermedirios e avanados sobre Java

Explorando os component
Usabilidade e simplicidade com os compo

Resumo DevMan
De que se trata o artigo:
O artigo explora vrios componentes do Dojo, mostrando na prtica como utiliz-los em uma aplicao.
Para isso, so abordados desde menus at componentes para funes especficas, como calendrios e
campos para horas. Alm disso, foram discutidos alguns conceitos relacionados usabilidade em am-
bientes web.

Em que situao o tema til:

Este tema til para todos os desenvolvedores que desejam conhecer a simplicidade, facilidade e diver-
sidade da biblioteca JavaScript Dojo numa abordagem prtica.

Explorando os componentes do Dojo Toolkit:

Este artigo demonstra o comportamento de vrios componentes da biblioteca JavaScript Dojo Toolkit,
ressaltando o visual claro e intuitivo dos mesmos. Tambm abordada, em um exemplo prtico, toda a
facilidade de integrao dos componentes quando utilizados em uma aplicao Java para web.

A
tualmente a internet conta com
um vasto nmero de usurios.
Nmero este que tende a ultra-
passar o limite do IPv4 em pouco tempo.
Isto se deve ao acesso internet cada
vez mais facilitado, atingindo classes e
grupos que antes no eram incorporados
na grande rede e que trazem consigo
diferentes perfis.
Neste ambiente heterogneo da internet,
fundamental dispor as funcionalidades
do sistema de maneira objetiva, atingindo
assim esses diferentes perfis. Tambm
importante considerar que os usurios no
gostam de utilizar um sistema cansativo,
que dificulta a localizao de contedo ou
a realizao de atividades, impondo bar-
reiras ao seu uso. Preocupados com estes
aspectos que devemos comear a pensar
na usabilidade do nosso sistema.
A usabilidade a facilidade com que as
pessoas podem empregar uma ferramenta
ou objeto a fim de realizar uma tarefa es-
pecfica. No contexto do desenvolvimento
de aplicaes, devemos sempre focar em
deixar a interface grfica mais clara e
simples possvel, de forma a no existir ne-
nhuma ambiguidade ou dificuldade para
o usurio e mantendo o visual mais limpo.
Assim, a navegao pelo sistema ser sim-
ples, removendo possveis obstculos para
usurios com pouca experincia.
Este assunto tem assumido cada vez
mais importncia no desenvolvimento
de software. De maneira que algumas
empresas desenvolvem e mantm um
guia interno para usabilidade. Deste
modo, ao implementar um novo sistema,
os programadores se orientam pelas prti-
cas descritas no guia. No meio acadmico
no diferente, e algumas universidades
tambm tm adotado disciplinas voltadas
para o tema.
Um exemplo simples de problema de
usabilidade seriam os campos de login.
Embora este termo seja claro para ns
desenvolvedores, pessoas que no esto
habituadas ao desenvolvimento de softwa-
re podem no entender o termo a princpio,
e demorar um pouco at descobrirem seu
uso. Sendo que neste exemplo, se usarmos
usurio e senha como nome para os cam-
pos de login, a interface se tornar muito
mais intuitiva para um usurio leigo.

28 Java Magazine Edio 101

 Aprenda como

es do Dojo Toolkit
enriquecer o visual de
seus formulrios web
utilizando recursos
desta biblioteca

nentes do Dojo Toolkit

Luis Antonio Tavares

Alguns outros exemplos de prticas de usabilidade para a web

so:
Marcar links j visitados pelo usurio;
E vitar uso indiscriminado de animaes;
No expor muita informao em uma mesma regio da tela;
E vitar abrir links em uma nova janela;
D ar ttulo a um formulrio condizente com sua funo;
Utilizar campos de texto com um tamanho adequado para o
dado que ser informado.

Esses pontos so apenas uma amostra de prticas de usabili-

dade. Partindo destes princpios e visando uma aplicao web
mais intuitiva e clara para o usurio, este artigo tem como foco
abordar a usabilidade e simplicidade dos componentes para
formulrio do Dojo Toolkit, demonstrando na prtica como
aproveitarmos de sua interface simples e amigvel.
Estes aspectos sero apresentados em duas sees: uma seo Figura 1. Tela de preferncias do Eclipse
explicando o uso de alguns componentes separadamente; e
outra demonstrando um formulrio no qual os dados so sub- Criando o projeto para desenvolver o exemplo
metidos para um Servlet Java. Dentro do Eclipse, crie o projeto onde iremos implementar nos-
so exemplo. Para isso, d um clique com o boto direito dentro
Preparando o ambiente de trabalho da viso Project Explorer, acesse a opo New e depois clique em
No decorrer do artigo, alguns programas sero construdos Dynamic Web Project, conforme mostra a Figura 2.
com o objetivo de exemplificar o uso dos componentes do Dojo
em uma aplicao web, e para o desenvolvimento destes, preci-
samos antes montar o ambiente de trabalho. Assim, esta seo
ir relatar os passos para a configurao deste ambiente.
Dentre as ferramentas que vamos utilizar, esto a IDE Eclip-
se Indigo para Java EE, o JRE (Java Runtime Environment), o
Apache Tomcat verso 7, a biblioteca google-gson e, por fim,
a biblioteca JavaScript Dojo Toolkit. Os endereos para baixar
estes softwares podem ser encontrados na seo Links.

Configurando o Tomcat
Para iniciarmos o projeto, devemos primeiramente configurar o
Tomcat para rodar nossos exemplos. Para isso, no Eclipse, selecione
Window > Preferences. Na tela de preferncias ilustrada pela Figura 1,
clique em Server > Runtime Environments, e ento, no boto Add,
localizado no canto direito superior da tela.
Na janela seguinte, selecione a verso 7 do Tomcat e clique Figura 2. Criando um Dynamic Web Project
em Next. Feito isso, na prxima tela clique em Browse para
informar o diretrio onde o Tomcat foi instalado e depois em Voc pode dar qualquer nome a este projeto, mas importante
Finish. Terminados esses passos, o servidor estar configurado que o Target runtime esteja selecionado como Apache Tomcat v7.0,
no Eclipse. Agora podemos criar nosso projeto. como mostra a Figura 3.

Edio 101 Java Magazine 29

Explorando os componentes do Dojo Toolkit

esto corretos, e se voc preferir, poder remover os erros atravs

da viso Markers do Eclipse, ou incluir uma regra nas preferncias
da IDE, para no validar os arquivos do Dojo.
Para remover os erros atravs da viso Markers, deve-se clicar
nos itens que esto circulados na Figura 5 e excluir os subitens
que apresentam erros de validao. Apenas uma ressalva: esses
erros de validao de arquivo no influenciam no funcionamento
da aplicao.

Figura 5. Removendo erros de sintaxe do Dojo

Para esta aplicao tambm ser necessrio baixar a biblioteca

google-gson. No decorrer do desenvolvimento vamos entender
melhor sua utilizao. O endereo para download desta tambm se
encontra na seo Links. Aps baixar a verso 1.7.1, descompacte
o zip e copie o arquivo gson-1.7.1.jar para a pasta WebContent/WEB-
INF/lib. Como resultado, vamos obter a estrutura apresentada na
Figura 6.

Figura 3. Configuraes da criao do projeto

Aps criar o projeto, vamos fazer o download do Dojo Toolkit.

Deste modo, na pgina de download, procure por Dojo Toolkit
Release e baixe o arquivo no formato zip. A verso do Dojo que
utilizaremos ser a 1.6.1.
Terminada esta etapa, descompacte o arquivo dojo-release-1.
6.1.zip e copie as pastas dojo, dijit e dojox, contidas na pasta dojo-
release-1.6.1, para dentro da pasta WebContent do nosso projeto.
Feito isso, teremos a estrutura exibida pela Figura 4.

Figura 6. Estrutura do exemplo usando o Dojo Toolkit

Agora que j montamos o ambiente de trabalho, vamos criar

alguns aplicativos exemplo. Dessa forma estudaremos alguns
componentes e recursos da biblioteca Dojo Toolkit observando
na prtica como utiliz-los.

Figura 4. Criando a estrutura do projeto. Conhecendo alguns componentes

Nesta seo sero apresentados alguns componentes da biblio-
Observe que o Eclipse entende que h erros na pasta dojox du- teca Dojo separadamente. Atravs dessa abordagem, poderemos
rante o processo de validao. Processo esse que valida a sintaxe conhecer um nmero maior de componentes da biblioteca e estu-
dos arquivos criados na IDE. Mas em fato, os arquivos da pasta dar aspectos de cada um deles. Dentre o que ser demonstrado, h

30 Java Magazine Edio 101

componentes que no possuem uma integrao direta com Java,
mas que podem agregar valor ao visual da nossa aplicao.
Muitos dos componentes que sero analisados podem ser cria-
dos tanto de maneira declarativa (nas prprias tags) como de forma
programtica (usando script para montar o componente em uma
div HTML). Estas opes so alternadas entre os exemplos, mas
importante saber que grande parte dos componentes pode ser
construda das duas maneiras.
Durante o desenvolvimento dos exemplos ser comum, nas
pginas, a importao de arquivos provenientes da URL http://
ajax.googleapis.com/ajax. Isso faz nossa aplicao dependente de um
acesso Internet para rodar, porm, caso voc prefira executar
a aplicao sem essa dependncia, basta baixar esses arquivos,
coloc-los na estrutura de pastas do WebContent e alterar a URL
de importao para o caminho local.
Usando abas do Dojo
O primeiro aplicativo que vamos desenvolver trata-se de um
exemplo utilizando os componentes de abas do Dojo. Para isso,
crie uma pgina index.html dentro da pasta WebContent e adicione
neste arquivo o cdigo apresentado na Listagem 1.
Observe na primeira tag script que o primeiro arquivo a ser im-
portado na pgina o dojo.xd.js. Ele contm as funes do core do
Dojo, como por exemplo, dojo.byId() e dojo.ready() funes bsicas
e necessrias aos demais mdulos.
Entretanto, para o uso da maioria dos recursos do Dojo, ne-
cessrio usar a funo require(), a qual importa o mdulo passado
como argumento. Atravs desta funo, temos a importao dos
dois componentes que so usados neste exemplo: o TabContainer
e o ContentPane.
Logo mais, na funo dojo.addOnLoad(), so definidas algumas
aes que sero executadas assim que a pgina for carregada. No
incio da funo temos a criao do container das abas (varivel
tc), que posiciona este componente na div com id tabs, localizada
na tag body da pgina.
Na sequncia temos a criao de dois painis, sendo que cada um
deles representa uma aba. Aps esta definio, eles so adicionados
ao container atravs da chamada tc.addChild(). Por fim, o container
iniciado usando o tc.startup(). Ao rodar o exemplo, podemos ver a
aparncia das abas do Dojo como ilustra a Figura 7. Para alternar
entre elas, basta clicar na opo desejada.

Listagem 1. Cdigo para o exemplo usando abas.

<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01

//EN http://www.w3.org/TR/html4/strict.dtd>
<html dir=ltr>
<head>
<style type=text/css>
body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
</style>
Figura 7. Exemplo usando abas
<script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
djConfig=parseOnLoad: true> Uma das prticas de usabilidade no dispor grandes quanti-
</script>
<script type=text/javascript> dades de informao em uma mesma pgina ou regio da tela.
dojo.require(dijit.layout.TabContainer); O componente abas uma alternativa para suprir esta prtica,
dojo.require(dijit.layout.ContentPane);
dojo.addOnLoad(function() { pois atravs dele podemos dividir melhor as informaes que
var tc = new dijit.layout.TabContainer({ queremos expor em nossa aplicao.
style: height: 100%; width: 100%;
},
tabs); Usando componente para hora
var cp1 = new dijit.layout.ContentPane({ O Dojo tambm prov um campo especial para entrada de dados
title: Inicial,
content: Bem vindo ao nosso site! relacionados a horas. A Listagem 2 traz um cdigo de exemplo
}); que mostra o uso deste componente, o TimeTextBox. Ento, digite
tc.addChild(cp1);
var cp2 = new dijit.layout.ContentPane({
este cdigo no arquivo index.html.
title: Contato, Estudando o cdigo, note que para utilizar o componente basta
content: Entre em contato pelo telefone XXXX - XXXX importar o arquivo principal do Dojo (primeira tag script), importar
});
tc.addChild(cp2); o mdulo dijit.form.TimeTextBox (segunda tag script) e definir dentro
tc.startup(); da tag body um input com o atributo dojoType recebendo como valor o
});
</script> nome do mdulo. Feito isso, o TimeTextBox ser montado no input.
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/ A Figura 8 ilustra o componente em funcionamento. Observe que
dojo/1.6/dijit/themes/claro/claro.css />
ao executar o exemplo as horas so dispostas verticalmente, e ao
</head>
<body class= claro > selecionar um horrio, o input ser automaticamente preenchido
<div style=width: 350px; height: 140px> com este valor. Voltando nossa anlise para o aspecto da usabilidade,
<div id=tabs></div>
</div> pode-se perceber que este componente traz mais agilidade para a
</body> pgina, evitando erros de formato para o campo e tambm obrigando
</html>
o usurio a selecionar somente os valores que foram pr-definidos.

Edio 101 Java Magazine 31

Explorando os componentes do Dojo Toolkit

Listagem 2. Cdigo exemplo com campo para horas. Ao rodar o exemplo, vamos obter a tela ilustrada pela Figura 9,
que mostra o visual limpo do menu e tambm a clareza com que
<!DOCTYPE html PUBLIC -//W3C//DTD HTML 4.01 Transitional
//ENhttp://www.w3.org/TR/html4/loose.dtd> voc pode organiz-lo, criando nveis para dispor as opes. Desta
<html> forma, voc poder agrupar melhor as informaes de acordo com
<head>
<meta http-equiv=Content-Type content=text/html; charset=ISO-8859-1/> o contexto do seu sistema. Vantagens como estas, demonstram
<style type=text/css> como os componentes do Dojo Toolkit contribuem para uma
body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
</style>
aplicao mais simples e intuitiva.
<script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
djConfig=parseOnLoad: true>
</script> Listagem 3. Cdigo para o exemplo com menus.
<script type=text/javascript>
dojo.require(dijit.form.TimeTextBox); <!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01//EN
</script> http://www.w3.org/TR/html4/strict.dtd>
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/ <html dir=ltr>
dojo/1.6/dijit/themes/claro/claro.css /> <head>
</head> <style type=text/css>
<body class=claro> body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
<label>Horrio:</label> </style>
<input dojoType=dijit.form.TimeTextBox type=text> <script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
</body> djConfig=parseOnLoad: true>
</html> </script>
<script type=text/javascript>
dojo.require(dijit.Menu);
</script>
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
dojo/1.6/dijit/themes/claro/claro.css />
</head>
<body class= claro >
<div dojoType=dijit.Menu id=windowContextMenu contextMenuForWindow=true
style=display: none;>
<div dojoType=dijit.MenuItem iconClass=dijitEditorIcon dijitEditorIconCut
onClick=alert(Voc clicou no boto Recortar!)>
Recortar
</div>
<div dojoType=dijit.MenuItem iconClass=dijitEditorIcon dijitEditorIconCopy
onClick=alert(Voc clicou no boto Copiar!)>
Copiar
</div>
<div dojoType=dijit.MenuItem iconClass=dijitEditorIcon dijitEditorIconPaste
onClick=alert(Voc clicou no boto Colar!)>
Figura 8. Exemplo usando componente para hora Colar
</div>
Usando menus do Dojo <div dojoType=dijit.MenuSeparator></div>
<div dojoType=dijit.PopupMenuItem>
Agora vamos ver, na prtica, um pouco dos componentes de <span>Submenus</span>
menu do Dojo Toolkit. Para isso, digite o cdigo da Listagem 3 <div dojoType=dijit.Menu id=submenu1>
<div dojoType=dijit.MenuItem onClick=alert(Submenu 1!)>
no arquivo index.html. Submenu Um
Veja que para este aplicativo necessrio a incluso do mdulo </div>
<div dojoType=dijit.MenuItem onClick=alert(Submenu 2!)>
dijit.Menu, que est na segunda tag script da pgina. Depois, dentro Submenu Dois
da tag body, temos a criao do menu de forma declarativa, ou seja, </div>
</div>
o menu definido empregando tags e atributos. </div>
Logo no incio da tag body temos a definio do componente prin- </div>
<span>
cipal, o dijit.Menu. Em seguida h a definio de vrios itens para
Clique com o boto direito na pgina.
o mesmo. Em cada item do menu percebe-se o uso de um cone </span>
do pacote dijit atravs do atributo iconClass. O Dojo j traz alguns </body>
</html>
cones prontos, sendo que para utiliz-los basta atribuir o nome
do mesmo em iconClass. E para efeito de demonstrao, tambm
definimos algumas aes por meio do atributo onClick.
Repare tambm a incluso de um separador do Dojo (dijit.Menu
Separator) e, logo depois, a criao de um dijit.PopupMenuItem. este
componente que permite que um novo menu seja exibido ao sobre-
por ou selecionar a opo correspondente a ele. Visualmente trata-se
de um submenu, porm os componentes so os mesmos utilizados
no menu principal. Note que, dentro do PopupMenuItem, um Menu
definido com dois MenuItems representando os submenus.
Figura 9. Exemplo usando menus

32 Java Magazine Edio 101

Usando o slider do Dojo
O componente slider trata-se de um cursor que medida que o
deslocamos, incrementamos ou decrementamos o seu valor. Este
componente til, por exemplo, para uma aplicao que realiza
vrias configuraes de valores numricos, sendo necessrio se
conhecer os valores limites (mnimos e mximos). Dessa forma,
o slider no permite que se extrapolem esses valores, e ainda Figura 10. Exemplo usando o slider
mantm um indicador visual do valor atual e seus limites.
Para vermos na prtica este exemplo, digite o cdigo da Listagem 4 uma largura de 300 pixels para o componente, e em onChange, es-
na pgina index.html e rode o aplicativo. pecificamos que a cada mudana de valor, o input com id sliderValue
ser atualizado.
Por fim, passamos o id slider da div onde o componente ser montado
Listagem 4. Cdigo para o exemplo com slider. como ltimo argumento do construtor. A Figura 10 demonstra a
aplicao em execuo. Ao movimentar o cursor o valor do campo de
<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01//EN http://www.w3.org/TR/
html4/strict.dtd> texto ser alterado de acordo com as mudanas realizadas no slider.
<html dir=ltr>
<head>
<style type=text/css>
Usando a barra de progresso do Dojo
body, html { font-family:helvetica,arial,sans-serif; font-size:90%; } O aplicativo apresentado na Listagem 5, tem como objetivo
</style> simular um download usando a barra de progresso do Dojo. Veja
<script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
djConfig=parseOnLoad: true>
na tag body que para o uso deste componente necessrio criar
</script> uma div para o mesmo ser montado.
<script type=text/javascript>
dojo.require(dijit.form.Slider);
Listagem 5. Cdigo para o exemplo da barra de progresso.
dojo.require(dijit.form.TextBox);
dojo.addOnLoad(function() {
<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01//EN
var slider = new dijit.form.HorizontalSlider({
http://www.w3.org/TR/html4/strict.dtd>
name: slider,
<html dir=ltr>
value: 5,
<head>
minimum: -10,
<style type=text/css>
maximum: 10,
body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
intermediateChanges: true,
</style>
style: width:300px;,
<script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
onChange: function(value) {
djConfig=parseOnLoad: true>
dojo.byId(sliderValue).value = value;
</script>
}
<script type=text/javascript>
},
dojo.require(dijit.ProgressBar);
slider);
var i = 0;
});
function download() {
</script>
jsProgress.update({
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
maximum: 10,
dojo/1.6/dijit/themes/claro/claro.css />
progress: ++i
</head>
});
<body class= claro >
if (i < 10) {
<div id=slider></div>
setTimeout(download, 1000);
<input type=text id=sliderValue dojoType=dijit.form.TextBox />
}
</body>
}
</html>
</script>
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
dojo/1.6/dijit/themes/claro/claro.css />
Na segunda tag script deste exemplo, temos a importao do m- </head>
<body class= claro >
dulo TextBox e do mdulo Slider. Na sequncia, acontece a chamada <div dojoType=dijit.ProgressBar style=width:300px jsId=jsProgress
a dojo.addOnLoad(), que define uma funo para ser executada no id=downloadProgress maximum=10></div><br />
momento em que a pgina for carregada. <input type=button value=Download onclick=download(); />
</body>
Nesta funo criado o componente slider. Note que ao ser ins- </html>
tanciado, realizada a configurao de vrios parmetros, como
o nome do componente (name), o valor inicial (value) e os valores
mnimo e mximo (minimum e maximum). Tambm podemos perceber na segunda tag script da pgina, o
O atributo intermediateChanges, se estiver definido como true, mdulo ProgressBar sendo carregado, e depois a funo download()
indica que o valor do slider ser alterado mesmo com o cursor do criada para atualizar a barra em determinado intervalo de tempo,
componente em movimento. Depois, no atributo style, setamos simulando assim uma barra de download.

Edio 101 Java Magazine 33

Explorando os componentes do Dojo Toolkit

Quando a funo download() chamada, ela atualiza a barra incre- Listagem 6. Cdigo da pgina principal da aplicao.
mentando o atributo progress em uma unidade, e, caso o progresso
ainda no tenha atingido o valor mximo (que foi definido no <!DOCTYPE html PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN http://www.
w3.org/TR/html4/loose.dtd>
atributo maximum como igual a 10), ocorre uma chamada usando <html>
a setTimeout(). Esta instruo volta a executar a funo download() <head>
decorridos os 1000 milissegundos que foram passados como <meta http-equiv=Content-Type content=text/html; charset=ISO-8859-1/>
<style type=text/css>
argumento. Caso a barra tenha atingido o valor mximo, este body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
ciclo se encerra. </style>
A Figura 11 expe a barra de progresso em funcionamento. Este <script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
djConfig=parseOnLoad: true>
componente pode ser til quando usado para informar visual- </script>
mente o quanto de uma determinada tarefa j foi concludo. Uma <script type=text/javascript>
indicao grfica muitas vezes mais agradvel para o usurio dojo.require(dijit.form.Form);
dojo.require(dijit.form.Button);
do que exibir apenas texto. dojo.require(dijit.form.TextBox);
dojo.require(dijit.form.DateTextBox);
dojo.require(dijit.form.CurrencyTextBox);
dojo.require(dijit.form.CheckBox);
</script>
<link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
dojo/1.6/dijit/themes/claro/claro.css />
</head>
<body class=claro>
<h3>Dados para realizao da reserva</h3>
Figura 11. Exemplo usando a barra de progresso <div dojoType=dijit.form.Form id=myForm jsId=myForm
action=MyServlet method=POST>
<table>
Exemplo de formulrio usando o Dojo Toolkit <tr>
Nesta seo vamos explorar um pouco mais dos componentes <td><label>Nome:</label></td>
<td><input dojoType=dijit.form.TextBox type=text name=name
do Dojo atravs de um aplicativo exemplo. O programa trata-se
id=name></td>
de um formulrio web, o qual fornecer informaes referentes </tr>
realizao de uma reserva em um hotel ou pousada. <tr>
<td><label>Data inicial da reserva:</label></td>
Aps submeter essas informaes, um Servlet ir receb-las,
<td><input dojoType=dijit.form.DateTextBox type=text name=date1
trat-las e ento direcion-las para uma pgina que ir simular id=date1 value=2012-01-10 /></td>
uma resposta ao usurio. A ttulo de demonstrao, ao chegar ao </tr>
<tr>
Servlet, as informaes sero apenas repassadas para a pgina de
<td><label>Data final da reserva:</label></td>
resposta. Mas em uma aplicao real, os dados podem depender <td><input dojoType=dijit.form.DateTextBox type=text name=date2
de recursos do servidor para a gerao de algum resultado vlido id=date2 value=2012-01-20 /></td>
</tr>
ao usurio. Neste prprio caso, se fossemos implantar o aplicativo
<tr>
em um hotel, um banco de dados seria necessrio para verificar a <td><label>Nmero de pessoas:</label></td>
disponibilidade dos quartos e registrar as reservas realizadas. <td><input dojoType=dijit.form.TextBox type=text name=num id=num>
</td>
</tr>
Desenvolvendo e entendendo o exemplo <tr>
Para desenvolver as pginas do exemplo, utilizaremos a mesma <td><label>Adiantamento (XXX,XX):</label></td>
estrutura de diretrios criada na seo anterior. Deste modo, <td><input dojoType=dijit.form.CurrencyTextBox type=text name=money
id=money></td>
dentro da pasta WebContent, crie a pgina index.html e adicione o </tr>
cdigo apresentado na Listagem 6. <tr>
Logo na segunda tag script do cdigo, vemos o uso da funo <td><label>Veculo:</label></td>
<td><input dojoType=dijit.form.CheckBox id=car name=car
require para importar os mdulos do Dojo que sero necessrios value=Sim checked ></td>
na pgina inicial. So eles o Form, o Button, o TextBox, o DateText </tr>
Box, o CurrencyTextBox e o CheckBox. <tr>
<td align=center colspan=2>
Para a criao do formulrio, usamos o componente dijit.form. <button dojoType=dijit.form.Button type=submit
Form, que similar tag HTML <form>, mas possui um nmero iconClass=dijitIconSave>Salvar Reserva</button>
maior de recursos, como por exemplo, a validao dos campos, que </td>
</tr>
no nosso exemplo no ser utilizada. Note que o componente Form </table>
foi criado em uma div. Nela definimos que os dados dos campos </div>
sero submetidos atravs do mtodo POST para MySerlvet, que </body>
</html>
foi especificado no atributo action.

34 Java Magazine Edio 101


Figura 12. DateTextBox na pgina inicial da aplicao
Dentro desta div possvel observar os campos para entrada de
dados. Dentre eles, um campo para o nome, empregando o com-
ponente TextBox. Ao us-lo o visual das bordas do input e suas
dimenses so alteradas de acordo com o tema adotado. Tambm
definido um campo para a data inicial da reserva e outro para a
data final, utilizando o DateTextBox. A Figura 12 demonstra este
componente ao rodar a pgina inicial da aplicao.
Na sequncia, h um campo para a quantidade de pessoas
(TextBox), e ento, utilizamos um tipo especial de input, denomi-
nado CurrencyTextBox, que se trata de um campo para moeda que
j inclui validao e at completa com ",00" se, por exemplo,
informarmos um valor inteiro.
Abaixo de CurrencyTextBox h a definio de um CheckBox, no qual
o cliente informa se ir de carro e, depois, o boto Salvar Reserva.
Observe no boto que informamos uma classe de cone atravs
do atributo iconClass. A Figura 13 ilustra o formulrio completo
criado na pgina index.html.
Figura 13. Pgina inicial da aplicao
- Apenas como ressalva: no desenvolvimento da pgina no implementamos
validao nos campos do formulrio. Portanto, erros podem ocorrer no servidor
caso dados em formatos invlidos sejam informados.
Ao selecionar o boto Salvar Reserva todos os dados preenchidos
no formulrio sero enviados para MyServlet, que vamos implemen-
tar neste momento. Para isso, devemos criar um pacote dentro da
pasta src. Este pacote receber o nome de example.servlet, e dentro
dele desenvolveremos o Servlet que ser responsvel por simular
um registro de reserva, apenas direcionando os dados recebidos
para uma pgina de resposta.
Para criar o Servlet, d um clique com o boto direito sobre o pa-
cote e depois em New > Servlet. Dessa forma, a janela para criao
do mesmo ser apresentada, como mostra a Figura 14. D o nome
de MyServlet para a classe e ento clique em Finish.
Figura 14. Criando um novo Servlet
A Listagem 7 exibe o cdigo de MyServlet. Este ir receber os pa-
rmetros passados pelo formulrio (dados de reversa do cliente) e
enviar um JSON com as mesmas informaes para uma pgina de
confirmao de reserva que simula uma resposta ao usurio.
Ao receber a requisio no Servlet, pelo mtodo doPost(), os parme-
tros so transferidos para variveis e depois o contedo destas vari-
veis inserido em um HashMap. Neste ponto h apenas uma exceo
para o parmetro car. Como ele se refere ao CheckBox, se o componente
no for marcado no formulrio, o parmetro car no ser enviado, ou
seja, a chamada request.getParameter() retornar null para car. Devido a
isso, h uma condio verificando o valor desta varivel.
Dando continuidade a nossa anlise, o HashMap convertido para
a notao JSON utilizando a biblioteca gson do Google. No entanto,
antes de entendermos o que est acontecendo no cdigo, necess-
rio conhecer o conceito de JSON e o que a biblioteca gson faz.
O JSON trata-se de uma maneira leve para a troca de informa-
es, uma representao de objetos JavaScript no formato de String.
J o google-gson uma biblioteca que possibilita convertermos
objetos Java para essa notao, ou convertermos objetos na notao
Edio 101 Java Magazine 35
Explorando os componentes do Dojo Toolkit

JSON para Java. Para compreender melhor este conceito, vamos Listagem 8. Cdigo da pgina JSP responsvel por criar a grid.
voltar anlise do cdigo da classe MyServlet.
<%@ page language=java contentType=text/html; charset=ISO-8859-1
No nosso Servlet, aps adicionarmos os dados referentes reser-
pageEncoding=ISO-8859-1%>
va no HashMap, usamos a biblioteca gson, atravs do mtodo gson. <!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01//EN
toJson(), para converter o HashMap em uma String JSON, armazenando http://www.w3.org/TR/html4/strict.dtd>
<html dir=ltr>
o resultado na varivel json. Note que aps essa converso, existe <head>
uma linha de cdigo responsvel por apresentar a String resultante <meta http-equiv=Content-Type content=text/html; charset=ISO-8859-1/>
<style type=text/css>
no console, como mostra o exemplo seguinte: body, html { font-family:helvetica,arial,sans-serif; font-size:90%; }
</style>
{car:Sim, num:3, name:Luis Tavares, money:100, date2:2012-01-20, <script src=http://ajax.googleapis.com/ajax/libs/dojo/1.6/dojo/dojo.xd.js
date1:2012-01-10} djConfig=parseOnLoad: true>
</script>
Veja que a String possui o formato de um objeto JavaScript. Na <script>
dojo.require(dojo.data.ItemFileWriteStore);
sequncia, o JSON com as informaes enviado para a pgina dojo.require(dojox.grid.DataGrid);
de resposta. Voc pode ver na chamada request.setAttribute(), a <%
String result = (String) request.getAttribute(result);
varivel json sendo inserida no request. if (result != null) {
Agora, vamos analisar o que acontece quando essa varivel %>
var json = <%=result %>;
recebida na pgina de confirmao de reserva. <%
}
%>
var userInfo = [{name: Nome, info: json.name},
Listagem 7. Cdigo do Servlet da aplicao. {name: Data inicial, info: json.date1},
{name: Data final, info: json.date2},
package example.servlet; {name: Qtd Pessoas, info: json.num},
import java.io.IOException; {name: Adiantamento, info: json.money},
import java.util.HashMap; {name: Carro?, info: json.car}];
import javax.servlet.RequestDispatcher; var userData = {
import javax.servlet.ServletException; items: userInfo
};
import javax.servlet.annotation.WebServlet;
var gridLayout = [
import javax.servlet.http.HttpServlet;
[{
import javax.servlet.http.HttpServletRequest;
field: name,
import javax.servlet.http.HttpServletResponse; name: Informaes,
import com.google.gson.Gson; width: 10
@WebServlet(/MyServlet) },
public class MyServlet extends HttpServlet { {
private static final long serialVersionUID = 1L; field: info,
protected void doGet(HttpServletRequest request, HttpServletResponse name: ,
response) throws ServletException, IOException { width: 16
} }]];
protected void doPost(HttpServletRequest request, HttpServletResponse </script>
response) throws ServletException, IOException { <link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
String name = request.getParameter(name); dojo/1.6/dijit/themes/claro/claro.css />
String date1 = request.getParameter(date1); <link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
String date2 = request.getParameter(date2); dojo/1.6/dojox/grid/resources/Grid.css />
String num = request.getParameter(num); <link rel=stylesheet type=text/css href=http://ajax.googleapis.com/ajax/libs/
dojo/1.6/dojox/grid/resources/nihiloGrid.css />
String money = request.getParameter(money);
<style type=text/css>
String car = request.getParameter(car);
.dojoxGrid table { margin: 0; }
if (car == null){
</style>
car = No; </head>
} <body class=claro>
HashMap<String, String> map = new HashMap<String, String>(); <div dojoType=dojo.data.ItemFileWriteStore data=userData
map.put(name, name); jsId=dataStore></div>
map.put(date1, date1); <h3>Reserva realizada com sucesso!</h3>
map.put(date2, date2); <div id=grid style=width: 354px; height: 200px; dojoType=dojox.grid.DataGrid
map.put(num, num); store=dataStore structure=gridLayout></div>
map.put(money, money); </body>
map.put(car, car); </html>
Gson gson = new Gson();
String json = gson.toJson(map);
System.out.println(json);
RequestDispatcher dispatcher = null; Analisando a montagem da pgina de resposta da reserva
dispatcher = request.getRequestDispatcher(/grid.jsp);
Neste momento estudaremos a pgina responsvel por simular a
request.setAttribute(result, json);
dispatcher.forward(request, response); confirmao da reserva. Seu cdigo apresentado na Listagem 8 e
} deve ser inserido no arquivo grid.jsp. Este arquivo, por sua vez, deve
}
ser criado dentro da pasta WebContent do projeto.

36 Java Magazine Edio 101

 Analisando a segunda tag <script>, temos os dois mdulos
necessrios criao da grid sendo carregados, so eles: grid e pgina, aps a submisso do formulrio.
store, que estudaremos a seguir. Na sequncia, as informaes
enviadas pelo Servlet so atribudas a uma varivel JavaScript
chamada json.
Feito isso, criamos um array JavaScript (userInfo) para armaze-
nar as informaes provenientes do Servlet e tambm criamos a
varivel userData, que armazena os itens que estaro presentes
na grid, atribuindo como itens cada um dos dados do usurio
informados ao realizar a reserva.
A grid tem seus dados providos por um ItemFileWriteStore, que
definido na primeira div da tag <body>. Neste componente tam-
bm definimos que os itens que sero providos esto armazenados
na varivel userData. Ento, criamos uma div para a grid, e na div
especificamos o componente store que a grid utilizar.
Para finalizar, vamos ver como ficou a estrutura do projeto
e rodar o aplicativo para entendermos o seu funcionamento.
A Figura 15 apresenta a estrutura final do projeto que construmos
Figura 15. Estrutura do exemplo
Figura 16. Grid simulando uma confirmao de reserva
para o nosso exemplo, e a Figura 16 mostra a grid j montada na
Concluso
Este artigo abordou o uso de diversos componentes do Dojo
Toolkit, focando na sua usabilidade e simplicidade. Foram
demonstrados no somente os componentes para formulrios,
mas tambm componentes como menus e abas que colaboram
para uma melhor organizao e disposio das informaes
em uma pgina web. Alguns conceitos de usabilidade tambm
foram discutidos no decorrer dos exemplos, mostrando as van-
tagens que o Dojo Toolkit pode propiciar quando utilizamos
seus recursos.
Luis Antonio Tavares
luis.tavares@msn.com
bacharel em Sistemas de Informao pela Universidade do Vale do Sa-
puca e tcnico em eletrnica. Atua desde 2008 no desenvolvimento de
software, trabalhando com linguagens como Java, Python, C, C#, Lua, entre
outras. Atualmente trabalha no Inatel em projetos com Linux Embarcado.
http://dojotoolkit.org
Site oficial do Dojo Toolkit.
http://dojotoolkit.org/download
Link para download do Dojo Toolkit.
http://dojotoolkit.org/documentation
Documentao do Dojo Toolkit.
http://www.eclipse.org/downloads
Link para download do Eclipse
http://tomcat.apache.org/download-70.cgi
Link para download do Apache Tomcat.
http://code.google.com/p/google-gson/downloads/detail?name=google-gson-
1.7.1-release.zip
Link para download da biblioteca google-gson.
D seu feedback sobre esta edio! Feedback
eu
s
A Java Magazine tem que ser feita ao
D
seu gosto. Para isso, precisamos saber
sobre e
o que voc, leitor, acha da revista!
s
ta
edio
D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
Edio 101 Java Magazine 37
 Seo Java: Nesta seo voc encontra artigos intermedirios e avanados sobre Java

JavaOne Latin America 20

O evento Java mais importante da Amrica

Resumo DevMan
De que se trata o artigo:
O JavaOne o evento mais importante da comunidade Java. durante este evento que grandes anncios
e novidades so apresentados. Saber o que ocorreu durante o evento permite uma melhor compreenso
sobre os rumos da plataforma Java.

Em que situao o tema til:

Acompanhar o que ocorre em eventos de grande importncia para manter-se atualizado. O JavaOne
Latin America reuniu palestrantes internacionais e as principais figuras da comunidade brasileira que,
durante os dias do evento, discutiram e apresentaram temas relevantes sobre o ecossistema Java.

JavaOne Latin America 2011:

O JavaOne Latin America 2011 foi realizado em conjunto com os eventos Oracle OpenWorld nos dias 6 a
8 de dezembro na cidade de So Paulo pelo segundo ano seguido. Este evento englobou toda a Amrica
Latina ao invs de apenas o Brasil (como foi na edio passada), tornando-se o maior e mais importante
evento Java dos continentes Amrica da Sul e Amrica Central.

P
elo segundo ano seguido, o JavaOne
Latin America 2011 (tambm conhe-
cido como JavaOne Brasil) foi reali-
zado em So Paulo entre os dias 6 e 8 de
dezembro de 2011 no Transamrica Expo
Center juntamente com o Oracle Open
World. Este evento sem dvida alguma, o
maior e mais importante evento realizado
na Amrica Latina sobre a tecnologia Java,
e consequentemente, o maior evento sobre
Java do Brasil.
O JavaOne realizado anualmente nos
Estados Unidos, na cidade de San Fran-
cisco, desde 1996. Atualmente conta com
aproximadamente 15 mil participantes.
O pblico alvo so estudantes de TI e
profissionais que trabalham com a tecno-
logia Java.
Em 2010, a Oracle decidiu organizar edi-
es regionais do JavaOne pela primeira
vez na histria do evento, e os pases esco-
lhidos foram Brasil, Rssia, China e ndia.
Em 2011, pela segunda vez consecutiva, a
empresa realizou uma edio do JavaOne
no Brasil (e desta vez decidiram expandir a
abrangncia do evento para toda a Amri-
ca Latina, renomeando o evento para Java-
One Latin America), e tambm ir realizar
o evento nos seguintes pases: Japo (4 e 5
de abril de 2012, sendo a primeira vez que
o evento ser realizado neste pas), Rssia e
ndia (no segundo bimestre de 2012, sendo
a segunda vez que o evento ser realizado
nos pases citados).
Pr-Evento: Java Geek Bike Ride
No domingo que antecedeu o evento (4
de dezembro de 2011), Fabiane Nardon, ex-
pert Java e Java Champion, organizou um
passeio de bicicleta pela ciclovia da cidade
de So Paulo. Toda a comunidade Java foi
convidada para passar um tempo com os
experts e evangelistas da Oracle e bater um
papo fora dos tpicos tcnicos.
O Evento e a Organizao
Assim como em 2010, o JavaOne foi rea-
lizado paralelamente com o Oracle Open
World. Apesar de dois eventos totalmente
distintos o primeiro focado na tecno-

38 Java Magazine Edio 101


11
a Latina
logia Java, tendo um perfil mais tcnico, e o segundo focado no
ambiente corporativo (solues e produtos Oracle) funcionam
muito bem juntos.
Em 2010, aproximadamente 800 participantes compareceram ao
evento, e infelizmente, em 2011, esse nmero no foi ultrapassado.
Em 2010 alguns problemas ocorreram durante a conferncia,
como superlotao das salas, filas longas e problemas com ar
condicionado. Outro ponto que tambm sofreu reclamao dos
participantes foi o fato do Oracle Open World ter sido realizado
no pavimento maior do Transamrica Expo Center e o JavaOne
ter ficado com um espao muito pequeno, localizado no piso
superior do prdio ao lado do pavilho. Graas ao feedback da
comunidade e dos participantes, estes problemas foram endere-
ados organizao e em 2011 a organizao do evento melhorou
muito. A conferncia foi realizada no pavilho de exposio, um
espao muito maior (juntamente com o Oracle Open World), e
os auditrios usados para as palestras tinham um espao bem
maior tambm. Alm disso, a organizao tambm ampliou o
Java Lounge, um espao com puffs para a comunidade passar
um tempo e relaxar durante o evento.
Networking
Um evento desse porte uma tima oportunidade para ne-
tworking. Pensando nisso, a organizao do evento montou um
espao onde os participantes podiam descontrair e bater um papo
com os evangelistas e experts da Oracle, alm dos Java Champions
(veja a Figura 1).
Figura 1. Java Lounge no JavaOne Latin America 2011
Acompanhe em
primeira mo como
foi o JavaOne Latin
America 2011 realizado
na cidade de So Paulo
Loiane Groner
Durante o evento, a equipe do OTN (Oracle Technology Net
work) gravou vrias entrevistas com experts Java brasileiros
e experts Java da Oracle, entre eles: Fabiane Nardon (Java EE),
Loiane Groner (Java e JavaScript), Jim Weaver (JavaFX), Geertjan
Wielenga (NetBeans), Edilmar e Joo (JUG Leaders do JUGMS),
Juliano Viana (Java EE e GlassFish), Yara Senger e Yvone Masca-
renhas veja a Figura 2.
Figura 2. Loiane entrevista Juliano Viana para o Oracle Technology Network
O episdio 60 do Java Spotlight Podcast (podcast sobre Java
gravado pela Oracle que disponibilizado para comunidade)
tambm foi gravado ao vivo durante o evento. Este podcast contm
uma entrevista com Yara e Vincius Senger, que falaram sobre o
aniversrio de 10 anos da Global Code, e uma entrevista com Mike
Lehmann (diretor snior de gerenciamento de produtos Oracle),
que falou sobre a release do WebLogic 12c.
Palestras e Keynotes
Um ponto muito forte do evento foi a qualidade das palestras e
keynotes apresentados. E essa qualidade muito se deve ao comit
de avaliao local (alm dos palestrantes escolhidos), formado por:
Bruno Souza (Java Man), Fabiane Nardon, Mauricio Leal, Yara
Senger, Vincius Senger, Loiane Groner, Bruno Ghisi, Guilherme
Silveira, Paulo Silveira, Edson Yanaga, Daniel de Oliveira e Fabio
Veloso. Essas pessoas receberam carta branca da organizao
da Oracle para escolher quais palestras seriam apresentadas no
evento. Ou seja, no houve nenhuma presso por parte da Oracle
Edio 101 Java Magazine 39
JavaOne Latin America 2011
e as palestras aprovadas pelo processo de
call for papers foram devido ao mrito
tcnico de cada uma delas.
A Oracle tambm cedeu boa parte do
nmero de palestras para a comunidade
brasileira, ou seja, essas palestras foram
apresentadas no evento por brasileiros e
escolhidas pelo comit de avaliao local.
Em 2010, 50% das palestras foram apre-
sentadas por palestrantes da Oracle e 50%
foram apresentadas por palestrantes da
comunidade Java brasileira. Em 2011, essa
diviso ficou em 43% das palestras para
palestrantes Oracle e 57% para palestrantes
da comunidade brasileira. Esse nmero de-
monstra que a Oracle quer dar foco ao con-
tedo produzido localmente, e apresentado
para sua comunidade local. No total, foram
56 palestras tcnicas apresentadas durante
a conferncia, divididas entre as seguintes
tracks: Java EE Web Profile, Platform Tech-
nologies, Web Services and the Cloud; Core
Java Platform; Java ME, Mobile, Embedded
Figura 3. Oracle Strategy Keynote: Georges Saab, Nandini
Ramani e Sharat Chander
Figura 4. JDK Roadmap Fonte: Oracle
40 Java Magazine Edio 101
and Devices; e Client Side Technologies and
Rich User Experiences.
O JavaOne Latin America 2011 tambm
contou com quatro sesses HOL (Hands
on Lab), onde foram demonstrados como
usar GlassFish, Java EE, Java FX e outras
tecnologias na prtica.
O evento tambm contou com dois keyno-
tes organizados pela Oracle (mesmo nmero
de 2010), onde foram apresentados os planos
e as novidades do ecossistema Java.
O primeiro keynote Oracle foi apresen-
tado por Nandini Ramani, Georges Saab
e Sharat Chander, que falaram sobre a
estratgia da Oracle em relao plata- senvolvedores; e tambm a plataforma
forma Java para os prximos anos (veja
a Figura 3).
O segundo keynote Oracle foi apresenta-
do por Roger Brinkley, Simon Riter, Arun
Gupta e Terrence Bar, que falaram sobre
Java SE, JavaFX, Java EE/Cloud e Java ME/
Embedded, respectivamente.
Java SE
Durante os keynotes, foram relembrados
alguns pontos importantes que aconte-
ceram durante o ano de 2011. Entre eles
podemos destacar:
Lanamento do JDK 7 em 28 de Julho de
2011 (lanado inclusive no Brasil, durante
o TDC 2011);
R elease do JRockit sob a mesma licena
do JDK;
Lanamento da verso preview do JDK
7 para Mac OS;
IBM, Apple, SAP e Azul ingressam no
OpenJDK;
OpenJDK se torna a referncia de imple-
mentao oficial do Java 7;
Twitter junta-se ao OpenJDK e JCP;
SouJava e London JUG so eleitos como
parte do comit executivo do JCP;
Oracle lana a Oracle Java Magazine, com
mais de 50 mil inscries gratuitas;
Lanamento do NetBeans 7.
A Oracle tambm apresentou algumas
estatsticas sobre o Java, dentre elas: exis-
tem aproximadamente nove milhes de
desenvolvedores Java ao redor do mundo;
Java a linguagem nmero 1 entre os de-
mais utilizada para desenvolvimento de
aplicaes.
No keynote foi apresentado o roadmap
planejado pela Oracle para os lanamentos
Java at 2014. Entre os milestones previs-
tos, esto a release de alguns updates para
o JDK 7 e, em meados de 2013, o lanamen-
to do Java 8, seguido de uma nova verso
do NetBeans com suporte para o mesmo
(veja a Figura 4).
Durante os keynotes tambm foi apre-
sentado o que se pode esperar do Java
8. Entre o contedo previsto, podemos
destacar: o Projeto Jigsaw, que tem como
objetivo permitir a criao de mdulos de
sistemas (colees de classes e interfaces)
dentro da plataforma Java; o projeto Lam-
bda, que introduz closures plataforma
Java; o lanamento do JavaFX 3.0 embutido
no JDK; JavaScript na JVM; entre outros
tpicos que podem ser visualizados na
Figura 5.
O NetBeans tambm foi citado como
parte dos planos de crescimento da Oracle.
Logo que o Java 7 foi lanado, tambm
foi lanada uma verso do NetBeans com
suporte aos novos recursos do Java 7, alm
das ltimas verses do GlassFish. O supor-
te para CDI, servios Rest e persistncia
Java tambm sofreram melhorias. Com
o lanamento do JavaFX 2.0, o NetBeans
tambm suportar esta nova verso, alm
dos desenvolvedores poderem fazer debug
de aplicaes visuais desenvolvidas com
esta plataforma. Atualmente, j foram fei-
tos aproximadamente mais de 22 milhes
de downloads da IDE, que possui cerca de
1 milho de usurios ativos no mundo.
 A Oracle tambm divulgou alguns pla-
nos para depois do lanamento do Java 8.
A ideia ter uma JVM que suporte ml-
tiplas e diferentes linguagens, melhorar a
integrao dessas linguagens com o cdigo
Java, ter uma JVM que seja fcil de usar e
fcil para dar manuteno nas linguagens
suportadas, suporte a multi-tenancy/
cloud, alm de melhorar o gerenciamento
de recursos da JVM na nuvem. Tambm
se pode citar o suporte a um sistema de
tipos de variveis unificado, incluindo
otimizaes s estruturas de dados exis-
Figura 5. Planejamento do Java 8 Fonte: Oracle
tentes, suporte a modelos heterogneos de
computadores, entre outros.

Java EE
O Java EE a plataforma de maior su-
cesso do ecossistema Java. Atualmente ela
possui mais de 40 milhes de downloads,
e no mundo enterprise, a plataforma
nmero um nas empresas.
Apesar de todo o sucesso do Java EE,
ainda existem muitas coisas que precisam
ser melhoradas. preciso cada vez mais
eliminar o XML das aplicaes e fazer
com que desenvolvedor foque mais em
Java. Os planos para esse assunto incluem
otimizao de tarefas (tentativa de elimi-
nar a maior quantidade de configuraes
em XML e aumentar o uso de anotaes), Figura 6. Providncia automtica dos servios das dependncias de uma aplicao Fonte: Oracle Fonte: Oracle
elevando a produtividade dos desenvol-
vedores Java EE. fazer o deploy da aplicao primeiro e este API para suporte a JSON, melhorias no
O ponto mais destacado pela Oracle ir configurar todos os recursos e servios suporte de servios REST, entre outros
a questo do cloud computing, ainda necessrios para a aplicao poder ser exe- (veja a Figura 8).
no suportado nativamente pelo Java EE. cutada com sucesso, ou seja, uma espcie
Nos dias de hoje, todas as solues cloud de injeo de dependncia dos recursos JavaFX
disponveis no mercado so proprietrias, essenciais (observe a Figura 6). Tanto se fala que JavaFX uma tecno-
como Amazon, Windows Azure, Google Outro ponto destacado nos keynotes a logia morta, mas este foi um dos tpicos
App Engine, Cloud Fondry e Salesforce. questo da elasticidade de uma aplicao de maior destaque do JavaOne de 2011.
Apesar de servios muito bons, essas Java EE, ou seja, a capacidade de escalar Durante o evento, a Oracle anunciou o
solues no seguem nenhum padro uma aplicao Java EE, juntamente com lanamento do JavaFX 2.0, e quer levar esta
de implementao. A ideia da Oracle outros servios de um data center. Como tecnologia a um prximo nvel, atravs da
criar uma plataforma cloud baseada em se sabe a hora certa de escalar uma apli- distribuio da ferramenta juntamente
padres, assim como as tecnologias Java cao Java EE sem haver desperdcio de com o JDK, e no mais como um produto
EE so implementadas atualmente. recursos? Como obtemos essa informa- parte do ecossistema Java. Dentre os
O plano da Oracle mudar o modo como o? As respostas para essas perguntas novos recursos esto o suporte a vrias
configuramos uma aplicao Java EE nos tambm so o foco para o Java EE 7, onde plataformas, incluindo poder usar JavaFX
dias de hoje, onde precisamos configurar se planeja implementar essa elasticidade em smartphones, modularizao da ar-
os recursos necessrios antes de fazer o (ver a Figura 7). quitetura, ferramenta de edio avanada
deploy da mesma: JDBC, JMS, etc., para Entre outros recursos planejados para (JavaFX Scene Builder NetBeans), alm
depois fazermos o deploy do arquivo Java EE 7, podemos destacar: melhorias de novos componentes. Outro grande
.EAR. Atravs do servio de cloud pode-se da API de JMS, nova API para caching, anncio em relao ao JavaFX foi que

Edio 101 Java Magazine 41

JavaOne Latin America 2011
ele agora open source, e ser parte do OpenJDK. Uma grande
oportunidade da comunidade Java ajudar a manter e fazer com
que essa ferramenta cresa.
Como apresentado na Figura 9, a Oracle tem muitos planos
para o JavaFX, como o lanamento do JavaFX no OpenJDK para
Mac OS e suporte a Linux em meados de 2012 e o lanamento da
verso 3.
Java ME
Um dos pontos destacados durante os keynotes da Oracle foi o fato
de desenvolvedores Java reclamarem que o Java ME diferente do
Java SE. Quando uma pessoa j sabe Java SE e quer aprender Java
ME, necessrio aprender vrias coisas novas para se comear a
desenvolver no mdulo mobile. Tendo isso em vista, a Oracle tem
planos para juntar o Java ME e o Java SE, fazendo releases paralelas
dos dois produtos, ou seja, quando for lanado a verso X do Java SE,
tambm ser lanado a verso X do Java ME. Outro ponto importan-
te do plano da empresa fazer com que seja possvel executar APIs
do Java ME em um ambiente Java SE, alm do desenvolvimento de
novas APIs para desenvolvimento mobile.
Um roadmap do Java ME tambm foi divulgado durante o even-
to, contendo os prximos lanamentos, como podemos verificar
na Figura 10.
Figura 7. Elasticidade de aplicaes Java EE Fonte: Oracle
Figura 8. Objetivos do Java EE 7 Fonte: Oracle
Figura 9. JavaFX Roadmap Fonte: Oracle
42 Java Magazine Edio 101
Figura 10. Java ME Roadmap Fonte: Oracle
Projeto Avatar
Outra grande surpresa do JavaOne Latin America 2011 foi o
anncio do Project Avatar (Projeto Avatar). O HTML 5 uma
tecnologia que veio para mudar o modo como vemos a web atu-
almente, e no temos como fugir dela. O Projeto Avatar abre as
portas para o HTML 5 e ajuda a incorpor-lo nos projetos Java.
Hoje j podemos integrar cdigo HTML 5 com Java, mas no
to simples assim. JavaServer Pages (popularmente conhecidos
como JSPs) foram criados para ajudar e facilitar a integrao de
cdigo HTML com Java, e o Projeto Avatar est sendo criado para
facilitar a integrao do HTML 5 com o Java SE, Java EE e Java
ME (veja a Figura 11).
Figura 11. Projeto Avatar Fonte: Oracle
A Oracle apresentou uma demonstrao de como todas essas
tecnologias iro funcionar juntas no keynote de estratgia da
companhia.
Community Keynote
Em 2011 a Oracle tambm cedeu o fechamento do evento para
a comunidade Java brasileira, com o Community Keynote. A
Oracle deu total autonomia para que a comunidade decidisse
sobre o que apresentar. Foi um voto de confiana que a Oracle
depositou nos representantes brasileiros.
O Community Keynote foi um dos destaques do evento, sendo
apresentado por Bruno Souza e Fabiane Nardon, com partici-
pao especial de Vincius Senger, que apresentou o projeto
JHome, vencedor do Dukes Choice Award 2011, entregue no
JavaOne 2011 (San Francisco Estados Unidos).
O foco dado por Fabiane e Bruno no keynote foi mostrar como
os desenvolvedores Java so pessoas animadas, brilhantes e
capazes de fazer projetos incrveis com Java.
Com o JHome, Vincius Senger passou um caf e ascendeu
vrias lmpadas (inclusive com tema natalino e com direito a
pisca-pisca). A plateia tambm pde participar ascendendo e
desligando uma lmpada atravs de um tweet. Outro desta-
que da apresentao do JHome foi controlar os batimentos
cardacos de Arun Gupta, que estava vestindo um transmis-
sor de frequncia cardaca da Polar usando Java, e quando os
batimentos de Arun Gupta chegaram a 70, o website preferido
dele abriu no telo do keynote hall (oracle.com).
Durante o Community Keynote tambm foi lanado o grupo
JDuchessBR, um segmento dentro do SouJava que possui a
mesma ideia do JDuchess, que uma rede global para mu-
lheres conectadas pela tecnologia Java. O objetivo do grupo
dar maior visibilidade s mulheres que j esto na rea e
tambm incentivar que mais mulheres escolham TI para sua
carreira profissional. Estavam presentes no lanamento do
grupo: Fabiane Nardon, Loiane Groner, Yara Senger e Ana
Abrantes.
E para fechar o evento e o keynote com chave de ouro, foi
exibida uma verso do clipe Java Life - Code Hard (rap
criado pela Oracle) chamada Real Java Geeks, com fotos
de desenvolvedores Java em suas horas vagas. Desenvolve-
dores Java que tambm so msicos, surfistas, jardineiros,
velejadores, ciclistas, etc. Parte do trecho desse rap criado
pela Oracle dizia We code hard in these cubicles, que em
traduo livre para o portugus significa: Ns programamos
muito nesses cubculos (no sentido de baia de trabalho). E
a mensagem sinalizava para sairmos de vez em quando dos
cubculos e viver a vida, fazer outras atividades e se divertir.
Uma tima maneira de fechar o evento!
Concluses
O JavaOne Latin America foi maravilhoso, tornando-se o
evento Java mais importante da Amrica Latina. Durante e
depois do evento, os participantes deram seu feedback e mais
melhorias sero implantadas para o prximo JavaOne Brasil,
que ser um evento ainda melhor. Cabe agora comunidade
brasileira aproveitar e apreciar a oportunidade de entrar em
contato com vrios profissionais brasileiros experientes e
profissionais Oracle que esto frente das ferramentas do
mundo Java.
Loiane Groner
contato@loiane.com, http://loiane.com
bacharel em Cincia da Computao, trabalha como Engenheira de
Software Sr no Citibank (maior instituio financeira do mundo) em
projetos internacionais, em So Paulo. J trabalhou na IBM como IT Specialist
e lder de equipe para projetos internacionais. Possui 6+ anos de experi-
ncia em Java EE. Escritora, tem um livro sobre ExtJS em ingls (Ext JS 4 First Look) lanado
mundialmente pela Packt Publishing. Atua como JUG Leader no CampinasJUG e coordenadora
do ESJUG,alm de ser uma das fundadoras do JDuchessBR. Nas horas vagas escreve artigos
tcnicos e sobre carreira em TI nos blogs http://loiane.com e http://loianegroner.com.
http://www.loiane.com/2011/12/javaone-brasil-2011-video-do-
community-keynote/
Vdeo completo do Community Keynote.
http://www.youtube.com/watch?v=BNJIjgFhpUA
Vdeo dos desenvolvedores Java no fechamento do Community Keynote.
http://blogs.oracle.com/java/entry/javaone_latin_america_videos_and
Entrevistas e podcast gravados durante o JavaOne Brasil 2011.
http://www.oracle.com/javaone/lad-pt/home/index.html
Pgina do evento.
http://geekbikeride.eventbrite.com/
Geek Bike Ride: passeio de bicicleta organizado por Fabiane Nardon.
http://www.soujava.com/jDuchessBR
Site no grupo JDuchess no SouJava.
http://www.loiane.com/2011/12/javaone-latin-america-2011-links-fotos-e-
videos-do-evento
Fotos, vdeos, entrevistas e links do evento.
http://blogs.oracle.com/javaspotlight/
Java Spotlight Podcast.
D seu feedback sobre esta edio!
eu
Feedback
s
A Java Magazine tem que ser feita ao
D
seu gosto. Para isso, precisamos saber
sobre e
o que voc, leitor, acha da revista!
s
ta
edio
D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
Edio 101 Java Magazine 43
 Seo Java: Nesta seo voc encontra artigos intermedirios e avanados sobre Java

Transaes com EJB

Manipule transaes com as facilidades do

Resumo DevMan
De que se trata o artigo:
Este artigo apresenta formas de se trabalhar com transaes em conjunto com o Java EE, as caractersticas
bsicas de uma transao, a JPA e os modos de gerenciamento de transaes CMT e BMT.

Em que situao o tema til:

O tema til para desenvolvedores e projetistas de sistemas que trabalham com EJBs e necessitam
de tcnicas para o controle de transaes, alm dos conhecimentos adicionais sobre o compor-
tamento de transaes no Java EE, a manipulao das interfaces e anotaes JTA, e os modos de
gerenciamento CMT e BMT.

Transaes com EJB:

O Java EE, por meio da JTA, possui dois modos simples para o gerenciamento de transaes: o
configurvel (CMT) e o programvel (BMT). Dessa forma, possvel adotar estes modos para projetar
e desenvolver sistemas mais eficazes com o uso de transaes. Este o foco principal do contedo
apresentado neste artigo.

A
tualmente, grande parte dos sis-
temas corporativos utiliza banco
de dados relacional para guardar
informaes referentes a caractersticas
de negcio que os mesmos se propem a
atender. Com isso, alm do desenvolvedor
conhecer atecnologia Java, importante
conhecer o funcionamento bsico de um
banco de dados ecomo feita a comuni-
cao entre eles.
Quando trabalhamos com o banco de
dados relacional,alm de manipularmos
os dados com as operaes bsicas de
consulta, incluso, alterao e excluso,
tambm se faz necessrio ter o domnio
sobre transaes e como a tecnologia Java
pode trabalhar com ela.
Neste contexto, este artigo ir abordar
uma introduo ao assunto transaes
em banco de dados, destacando seus
princpios e suas instrues de controle,
seguido das formas que o Java EE possui
para control-las, utilizando EJB.
O que uma transao?
Transao uma sequncia ordenada
de operaes em um banco de dados que
so tratadas como um bloco nico. Ela
trabalha com a unio de dois grupos de
instrues, sendo um para manipulao
de dados (incluso, alterao e excluso) e
outro para delimitao da transao (begin,
commit e rollback).
- A delimitao da transao explicitada pelos
termos:begin, que determina o incio da transao;
commit, que confirma o sucesso da manipulao de
dados desde o incio da transao; e rollback, que
anula toda a manipulao de dados desde o incio
da transao.
Uma transao deve seguir o principio
ACID, que o acrnimo para Atmica,
Consistente, Isolada e Durvel. Sendo:
Atmica: Uma transao que deve exe-
cutar completamente ou no executar. Isso
significa que cada operao dentro de uma

44 Java Magazine Edio 101


o Java EE
unidade de trabalho no deve conter erros. Se uma delas falhar,
toda a unidade de trabalho ou transao ser abortada, signifi-
cando que quaisquer alteraes nos dados sero desfeitas. Por
sua vez, se todas elas executarem com sucesso, a transao ser
confirmada, o que significa que as alteraes nos dados tornam-se
permanentes e durveis;
Consistente: Refere-se integridade do armazenamento de
dados. Ela configurada por meio de restries impostas direta-
mente no banco de dados, tais como criao de chaves primrias,
integridade referencial, entre outros. Assegurando que as tran-
saes no quebraro as regras de negcio definidas no banco de
dados;
Isolada: Significa que uma transao precisa ter permisso de
ser executada sem a interferncia de outros processos ou transa-
es. Em outras palavras, os dados que uma transao acessa no
podem sofrer interferncia de qualquer outra parte do sistema at
a transao ou unidade de trabalho ser completada;
Durvel: Significa que todas as alteraes realizadas nos da-
dos durante o perodo de uma transao devem ser gravadas
em algum tipo de armazenamento fsico antes da transao ser
completada com sucesso.
Para compreendermos o uso e a importncia de uma transao,
imagine uma transferncia bancria, onde um determinado
valor deve ser subtrado da conta de origem e somado na conta
de destino.
Na Listagem 1, segue o exemplo de uma especificao para um
mtodo que atenda a esta operao. Porm, as instrues no
possuem tratamento de erros. Estes erros podem ser vrios (por
exemplo, indisponibilidade da rede, o que impossibilita a comu-
nicao entre a aplicao e o banco de dados). Caso a instruo de
subtrao seja efetuada com sucesso e ocorra problema com a de
soma, a operao de transferncia, mesmo assim, ser completada.
Isto , apenas parte da operao foi realizada.
A Listagem 2 demonstra o mesmo exemplo da Listagem 1, po-
rm adicionando o tratamento de errospara as situaes: 1) Em
caso de problema na instruo de subtrao, a instruo de soma
no deve ocorrer; 2) Em caso de problema na instruo de soma,
a instruo de subtrao deve ser desfeita.
Ao analisar a Listagem 2, podemos verificar que foi includa
uma terceira instruo, para desfazer a operao que a primeira
instruo fez em caso de problemas com a segunda. No entanto,
a terceira no possui tratamento de erros e, ao trat-la, seria
necessrio mais uma operao, que tambm necessitaria de um
Entenda como o Java
EE pode auxili-lo no
controle das transaes
com JTA, CMT e BMT
Eduardo Correia da Silva
tratamento. Ou seja, so tratamentos que tendem ao infinito.
neste caso que a transao se aplica.
A Listagem 3, por sua vez, o mesmo exemplo da Listagem 2,
mas modificado para fazer uso de uma transao. A instruo
begin delimita o incio da transao, commit termina a transao
garantindo o sucesso de toda a manipulao de dados, e as instru-
es rollback terminam a transao anulando toda a manipulao
de dados.
A vantagem da utilizao de uma transao a no necessidade
de efetuar operaes adicionais para desfazer manipulaes de
dados de operaes anteriores, uma vez que a instruo rollback
tem esta responsabilidade.
Listagem 1. Exemplo de especificao tcnica para uma transferncia bancria
sem transao.
Mtodo de transferencia( conta origem, conta destino, valor ){
Instruo para alterar o saldo na conta origem, subtraindo o valor a ser transferido
Instruo para alterar o saldo na conta destino, somando o valor transferido
}
Listagem 2. Exemplo de especificao para uma transferncia bancria com
tratamento de erros, sem transao.
Mtodo de transferencia( conta origem, conta destino, valor ){
Instruo para alterar o saldo na conta origem, subtraindo o valor a ser transferido
SE ocorreu problemas na instruo acima ENTO
sair do mtodo
FIM-DO-SE
Instruo para alterar o saldo na conta destino, somando o valor transferido
SE ocorreu problemas na instruo acima ENTO
Instruo para alterar o saldo na conta origem, somando o valor a ser transferido
FIM-DO-SE
}
Listagem 3. Exemplo de especificao para uma transferncia bancria envolvido
por uma transao.
Procedimento de transferencia( conta origem, conta destino, valor ){
begin
Instruo para alterar o valor, subtraindo ele na conta origem
SE ocorreu problemas na instruo acima ENTO
rollback
sair do mtodo
FIM-DO-SE
Instruo para alterar o valor, somando ele na conta destino
SE ocorreu problemas na instruo acima ENTO
rollback
sair do mtodo
FIM-DO-SE
commit
}
Edio 101 Java Magazine 45
Primeiros passos com o Spring LDAP

Transaes em Java EE comEJB, JTA e JTS
O Java EE possui uma API de alto nvel para simplificar e ao
mesmo tempo maximizar o controle das transaes denominada
JTA (Java Transaction API). Ela prov mecanismos ao desenvolvedor
para a manipulao de transaes.
- Java EE (ou Java Enterprise Edition) uma especificao de um conjunto de
recursos (EJB, Servlet, JTA, RMI, Web Services, JNDI, entre outros) para auxlio e
suporte ao desenvolvimento de sistemas corporativos. Esta especificao seguida
tanto pelos fabricantes de servidores de aplicao (Oracle GlassFish, RedHat JBoss,
IBM WebSphere, por exemplo) quanto pelos desenvolvedores que utilizam estes
recursos em sistemas do dia-a-dia.
Neste modo, o Java EE responsvel por efetuar o begin e commit
ou o rollback da transao. E os momentos de ele fazer estas deci-
ses so nas chamadas e nos retornos dos mtodos do EJB.
A Figura 2 exibe um cliente chamando um mtodo de um EJB.
Esta chamada auditada pelo Java EEque decide se efetua o be-
gin ou no de uma transao e repassa o controle para o mtodo
chamado. No retorno do mtodo, caso exista uma transao, o
Java EE audita novamente, decide se efetua o commit ou rollback
da mesma e repassa o controle para o cliente.

A JTA o mecanismo de comunicao entre o EJB e o servio de

gerenciamento de transaes, o JTS (Java Transaction Service). Ou
seja, JTS a implementao do JTA. E ambos esto contidos no
conjunto de funcionalidades disponibilizadas por Java EE.
A Figura 1 ilustra o comportamento de uma transao iniciada
por um EJB, sendo ele o cliente do JTA, utilizando suas interfaces de
gerenciamento e manipulao. Em seguida, as camadas de trabalho
da JTA e JTS, envolvidos como funcionalidades sob o domnio do
Java EE, e a comunicao da transao com o banco de dados.

Figura 2. Java EE em ao quando um mtodo do EJB chamado

A deciso para o Java EE efetuar o begin ou no da transao

Figura 1. O comportamento transacional no Java EE
A JTA possui dois modos de se trabalhar comtransaes, que
so: CMT (Container Managed Transaction Transao Gerenciada
pelo Container) e BMT (Bean Managed Transaction Transao
Gerenciada pelo Bean). O modo CMT configurado inteiramente
de forma declarativa por anotaes ou via XML, e o modo BMT
configurado programaticamente, ou seja, por instrues no
corpo dos mtodos.
O gerenciamento da transao configurado com a anotao
@TransactionManagement no nvel da classe,junto com uma das
opes do enumerador TransactionManagementType, que pode ser
BEAN ou CONTAINER.
configurada pelos atributos de transao. Ou seja, so com estes
atributos previamente configurados nos mtodos da classe do EJB
que o Java EE faz esta deciso.
Para configurar um mtodo da classe do EJB com atributos
de transao, basta anot-lo com @TransactionAttribute, junto com
uma das opes do enumerador TransactionAttributeType, que so:
MANDATORY, REQUIRED, REQUIRES_NEW, SUPPORTS, NOT_SUPPORTED e
NEVER.
NOT_SUPPORTED: Um mtodo com esta configuraono suporta
uma transao. Se o cliente possuir uma transao, ela sus-
pensa at o mtodo do EJB chamado completar sua execuo.
Com isso, a transao no propagada para o mtodo do EJB
chamado ou para qualquer outro EJB que ele possa chamar.
Aps a concluso do mtodo, a transao suspensa retoma sua
execuo (Figura 3);

O modo CMT
Este o modo padro(default) do EJB. Isto , quando um EJB no
possuir a anotao @TransactionManagement, significa que ele est
configurado no modo CMT. Para explicitar esta configurao,
basta anotar a classe do EJB com @TransactionManagement(Transaction
ManagementType.CONTAINER). Figura 3. Atributo NOT_SUPPORTED

46 Java Magazine Edio 101

 SUPPORTS: Um mtodo com esta configurao pode suportar uma
transao (Figura 4, situao A) ou no (Figura 4, situao B). Est
configurao dificilmente usada. Quando o cliente possui uma
transao, a mesma propagada para o EJB chamado.

Figura 6. Atributo REQUIRES_NEW

MANDATORY: A existncia prvia de uma transao do cliente ao

chamar o mtodo do EJB obrigatria (Figura 7, situao A),
Figura 4. Atributo SUPPORTS caso contrrio, a exceo javax.ejb.EJBTransactionRequiredException ser
lanada pelo Java EE ao cliente (Figura 7, situao B).
REQUIRED: Com esta configurao a existncia de uma transao
garantida. Se o cliente possuir uma transao, a mesma pro-
pagada para o EJB chamado (Figura 5, situao A), do contrrio,
o Java EE cria uma nova transao para este EJB (Figura 5,
situao B).

Figura 7. Atributo MANDATORY

NEVER: Ao chamar um mtodo do EJB com esta configurao, o

cliente no deve possuir uma transao (Figura 8, situao A),
caso contrrio, uma exceo javax.ejb.EJBException ser lanada pelo
Java EE ao cliente (Figura 8, situao B).

Figura 5. Atributo REQUIRED

- O tipo REQUIRED a configurao padro (default), e tambm a normalmente

utilizada. este o comportamento do Java EE quando no h configurao de
atributos de transao no EJB.

REQUIRES_NEW: Uma novatransao sempre ser criada quando o

mtodo do EJB for chamado (Figura 6, situao B). Caso o cliente
j possua uma transao, a mesma suspensa temporariamente
at o termino da execuo do mtodo do EJB chamado (Figura 6,
situao A). Figura 8. Atributo NEVER

Edio 101 Java Magazine 47

Primeiros passos com o Spring LDAP
A deciso para o Java EE efetuar o rollback de uma transao
configurada por meio das excees. Em outras palavras, com o
lanamento de uma exceo por um mtodo da classe do EJB que
o Java EE decide se efetua orollback da transao.
Por outro lado, a deciso para o Java EE efetuar o commit sina-
lizada a partir da ausncia de excees no retorno do mtodo da
classe do EJB. Deste modo, caso o mtodo executado no lance
excees, o Java EE efetua o commit da transao.
Excees
As excees exercem um grande impacto sobre o resultado das
transaes, com relao ao procedimento de rollback pelo Java EE.
Elas podem ser classificadas em dois grupos, sendoexcees de
sistema e excees de aplicativo.
Excees de sistema: So subclasses de java.lang.RuntimeException,
mais a mesma, e no so excees checadas. Caso exista uma
transao e uma delas for lanada por um mtodo de uma classe
EJB, o Java EE ir efetuar o rollback da transao;
- As excees checadas obrigam o compilador a cobrar o tratamento delas via
blocos try/catch ou aclusula throws.
Excees de aplicativo: So subclasses de java.lang.Exception,
mais a mesma, e so checadas. Caso exista uma transao e uma
delas for lanada por um mtodo de uma classe EJB, o Java EE
no ir efetuar o rollbackpelo motivo de que esta exceo pode
ser prevista por alguma regra de negcio/aplicativo, e pode ser
tratada para normalizar a situao, sem que exista a necessidade
do rollback. Entretanto, este comportamento pode ser manipula-
do com a anotao @ApplicationException(rollback=true) na classe de
exceo. Com isso, caso ela seja lanada, o Java EE ir efetuar o
rollback da transao.
O modo BMT
Este o modo que permite ao desenvolvedor controlar transaes
de forma programtica, ou seja, por instrues de programao no
corpo do mtodo da classe do EJB. Para trabalhar com esta confi-
gurao, deve-se anotar a classe do EJB com @TransactionManagement
( TransactionManagementType.BEAN).
Ao configurar o EJB para o modo BMT, o Java EE disponibiliza
o objeto javax.transaction.UserTransaction para o controle da transao.
Este objeto possui os mtodos begin(), commit() e rollback(). Para ter
acesso a ele, basta criar um atributo na classe do EJB e utilizar a
anotao @Resource para o Java EE prov-lo.
O trecho de cdigo a seguirmostra a configurao da classe do
EJB para o modo BMT e o atributo UserTransaction com a anotao
@Resource:
@TransactionManagement(TransactionManagementType.BEAN)
public class MeuBean implements MeuBeanRemote{
@Resource
UserTransaction ut;
/* mtodos omitidos */
}
48 Java Magazine Edio 101
De posse do UserTransaction, basta utilizar o mtodo begin() para
dar incio transao, seguido das operaes de manipulao
de dados envolvidas pela proteo do bloco try, adicionado o uso
do mtodo rollback() no bloco catch, e finalmente o uso do mtodo
commit() para terminar a transao com sucesso, conforme o trecho
de cdigo:
ut.begin();
try{
//operaes para manipulao de dados
}catch(Exception e){
ut.rollback();
throw e;
}
ut.commit();
Estudo de caso
Para por em prtica o contedo apresentado, ser explorado o
gerenciamento de transaesnos modos CMT e BMT de um sim-
ples mtodo de transferncia bancria. Esse mtodo est omisso
de padres e boas prticas, para que seja mantida a simplicidade
e o foco no entendimento do conceito.
As tecnologias utilizadas para suportar este exemplo foram:
JBoss AS 6 por ser um servidor de aplicao compatvel com
Java EE;
JPA para abstrao das entidades;
Hibernate como provedor JPA nativo do JBoss AS 6;
HSQLDB que o banco de dados nativo do JBoss AS 6;
IDE Eclipse Indigo.
Entretanto, estas tecnologias podem ser substitudas, caso o
leitor deseje e conhea alguma similar, pois o foco do exemplo
estar sobre o EJB.
Como ponto de partida, criada uma exceo checada personali-
zada e configurada com a anotao @ApplicationException(rollback=true),
conforme a Listagem 4. Com isso, indicando ao Java EE a execuodo
procedimento de rollback em caso de seu lanamento quando existir
uma transao, e quando o modo de gerenciamento da transao
for CMT.
Em seguida, temos a Listagem 5, uma classe Java simples que
representa a entidade da conta corrente, com as anotaes @Entity
e @Id do JPA.
A Listagem 6 o ncleo do exemplo. A classe do EJB est confi-
gurada para o modo CMT, e os mtodos que fazem a manipulao
de dados como REQUIRED. O mtodo mais importante deste EJB
o efetuarTransferencia(), visto que ele possui duas operaes de
manipulao de dados que esto protegidas por uma transao.
Complementando o EJB, sua interface de negcio criada na
Listagem 7.
A classe de testes simples, conforme exibe a Listagem 8, possui as
seguintes operaes: criao de duas contas correntes, conferncia
da persistncia das contas, transferncia de valores entre as duas
contas com sucesso (commit), criao de uma conta corrente falsa
(com id nulo), transferncia de valores entre conta1 e contaFalsa com
problema(rollback) e, finalmente, conferncia do saldo da conta1.
Listagem 4. MinhaException.java: Utilizao da anotao para indicar procedimento Listagem 7. MeuBeanRemote.java: A interface remota de negcio do EJB.
de rollback.
package br.com.jm.transacao.bean;
package br.com.jm.transacao.excecao; import javax.ejb.Remote;
import javax.ejb.ApplicationException; import br.com.jm.transacao.entidade.ContaCorrente;
@ApplicationException(rollback=true) import br.com.jm.transacao.excecao.MinhaException;
public class MinhaException extends Exception { @Remote
public MinhaException(String mensagem){
public interface MeuBeanRemote {
super(mensagem);
public ContaCorrente selecionarContaCorrente(Integer id);
}
public void incluirContaCorrente(ContaCorrente contaCorrente)
}
throws MinhaException, Exception;
Listagem 5. ContaCorrente.java: Entidade. public void efetuarTransferencia(ContaCorrente contaOrigem,
ContaCorrente contaDestino, Integer valor) throws MinhaException, Exception;
package br.com.jm.transacao.entidade; }
import java.io.Serializable;
import javax.persistence.Entity; Listagem 8. Teste.java: Classe de teste simples.
import javax.persistence.Id;
@Entity package br.com.jm.transacao.teste;
public class ContaCorrente implements Serializable{
@Id import javax.naming.*;
private Integer id; import br.com.jm.transacao.bean.MeuBeanRemote;
private Integer saldo; import br.com.jm.transacao.entidade.ContaCorrente;
import br.com.jm.transacao.excecao.MinhaException;
public ContaCorrente(){}
public class Teste {
public ContaCorrente(Integer id, Integer saldo){
this.id = id; public static void main(String[] args) throws Exception{
this.saldo = saldo;
}
Context ctx = new InitialContext();
MeuBeanRemote meuBean =
/* mtodos getters e setters omitidos */
(MeuBeanRemote) ctx.lookup(MeuBean/remote);
}
//Criacao das contas
Listagem 6. MeuBean.java: O EJB configurado como CMT. ContaCorrente conta1 = new ContaCorrente(1, 10);
ContaCorrente conta2 = new ContaCorrente(2, 10);
package br.com.jm.transacao.bean;
import javax.ejb.*; meuBean.incluirContaCorrente(conta1);
import javax.persistence.*; meuBean.incluirContaCorrente(conta2);
import br.com.jm.transacao.entidade.ContaCorrente;
import br.com.jm.transacao.excecao.MinhaException; //Conferncia de valores persistidos ANTES da transferncia
@Stateless conta1 = meuBean.selecionarContaCorrente(1);
@TransactionManagement(TransactionManagementType.CONTAINER) System.out.println(saldo antes da transf. conta1.: + conta1.getSaldo());
public class MeuBean implements MeuBeanRemote{
@PersistenceContext conta2 = meuBean.selecionarContaCorrente(2);
private EntityManager em; System.out.println(saldo antes da transf. conta2.: + conta2.getSaldo());
@TransactionAttribute(TransactionAttributeType.REQUIRED)
public void efetuarTransferencia(ContaCorrente contaOrigem, //TRANSFERENCIA do valor de 5 reais, da conta1 para a conta2
ContaCorrente contaDestino, Integer valor) throws MinhaException, Exception{ meuBean.efetuarTransferencia(conta1, conta2, 5);
try{
contaOrigem.setSaldo(contaOrigem.getSaldo() - valor); //Conferncia de valores persistidos DEPOIS da transferncia
em.merge(contaOrigem); conta1 = meuBean.selecionarContaCorrente(1);
contaDestino.setSaldo(contaDestino.getSaldo() + valor); System.out.println(saldo depois da transf. conta1.: + conta1.getSaldo());
em.merge(contaDestino); conta2 = meuBean.selecionarContaCorrente(2);
}catch(Exception e){ System.out.println(saldo depois da transf. conta2.: + conta2.getSaldo());
throw new MinhaException(e.getMessage()); //forar erro na transferncia para a conta destino.
} ContaCorrente contaFalsa = new ContaCorrente(null, 0);
} try{
@TransactionAttribute(TransactionAttributeType.REQUIRED) meuBean.efetuarTransferencia(conta1, contaFalsa, 5);
public void incluirContaCorrente(ContaCorrente contaCorrente) }catch(MinhaException e){
throws Exception{ System.out.println(Erro.: + e.getMessage());
em.merge(contaCorrente); }
} //Conferncia de valores persistidos DEPOIS do rollback
public ContaCorrente selecionarContaCorrente(Integer id){ conta1 = meuBean.selecionarContaCorrente(1);
return em.find(ContaCorrente.class, id); System.out.println(saldo depois do rollback. conta1.: + conta1.getSaldo());
}
} }
}

Edio 101 Java Magazine 49

Primeiros passos com o Spring LDAP

Para utilizao do JPA necessria a criao do seu XML des-
critor de configuraes, como exibido na Listagem 9. Este possui
uma unidade de persistncia apontada para o Data Source java:/
DefaultDS do HSQLDB, que o banco de dados nativo do JBoss.
Alm disso, um arquivo com as propriedades de acesso ao JNDI
do JBoss, apresentado na Listagem 10, requerido pela instruo
Context ctx = new InitialContext() da Listagem 6. Nele est configurado
qual o endereo de acesso ao JNDI e quais so as interfaces de
acesso especficas do JBoss.
Listagem 9. persistence.xml: Descritor para a configurao da unidade de persis-
tncia do JPA.
<?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>
<persistence-unit name=minhaPersistenceUnit>
<jta-data-source>java:/DefaultDS</jta-data-source>
<properties>
<property name=hibernate.dialect value=org.hibernate.dialect.HSQLDialect />
<property name=hibernate.hbm2ddl.auto value=create-drop/>
</properties>
</persistence-unit>
</persistence>
Listagem 10. jndi.properties: Configura o acesso ao JNDI do JBoss utilizado pelo
Teste.java.
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
java.naming.provider.url=localhost
transferncia, com a contaFalsa, foi lanada a exceo customizada
e o Java EE efetuou o rollback da transao, protegendo assim o
saldo da conta1. A Listagem 11 demonstra o log da execuo da
classe de testes na sada do console.
Para finalizar, a Listagem 12 exibe o mesmo EJB da Listagem 6,
no entanto, configurado para o modo BMT. Como era de se esperar,
ao executar o teste com este EJB, o comportamento da transao e o
resultado so os mesmos da execuo com o EJB em modo CMT.
Listagem 11. Sada do console aps a execuo do teste.
saldo antes da transf. conta1.: 10
saldo antes da transf. conta2.: 10
saldo depois da transf. conta1.: 5
saldo depois da transf. conta2.: 15
Erro.: org.hibernate.id.IdentifierGenerationException: ids for this class must
be manually assigned before calling save():
br.com.jm.transacao.entidade.ContaCorrente
saldo depois do rollback. conta1.: 5
Listagem 12. MeuBean.java: EJB reconfigurado para BMT.
package br.com.jm.transacao.bean;
import javax.annotation.Resource;
import javax.ejb.*;
import javax.persistence.*;
import javax.transaction.UserTransaction;
import br.com.jm.transacao.entidade.ContaCorrente;
import br.com.jm.transacao.excecao.MinhaException;
@Stateless
@TransactionManagement(TransactionManagementType.BEAN)
public class MeuBean implements MeuBeanRemote{
@PersistenceContext
private EntityManager em;

@Resource
Na montagem do ambiente de trabalho, a disposio das classes
private UserTransaction ut;
e interfaces criadas, arquivos XML e propriedades, com configu-
raes necessrias, deve estar similar Figura 9. Neste momen- public void efetuarTransferencia(ContaCorrente contaOrigem,
ContaCorrente contaDestino, Integer valor) throws MinhaException,
totambm importante destacar o arquivo jndi.properties. Este Exception{
deve estar localizado na raiz do projeto, ou seja, fora dos pacotes ut.begin();
e do diretrio META-INF. try{
contaOrigem.setSaldo(contaOrigem.getSaldo() - valor);
em.merge(contaOrigem);

contaDestino.setSaldo(contaDestino.getSaldo() + valor);
em.merge(contaDestino);
}catch(Exception e){
ut.rollback();
throw new MinhaException(e.getMessage());
}
ut.commit();
}

public void incluirContaCorrente(ContaCorrente contaCorrente)

throws Exception{
ut.begin();
em.merge(contaCorrente);
ut.commit();
Figura 9. Disposio das classes, XML e arquivo de propriedades }

public ContaCorrente selecionarContaCorrente(Integer id){

Aps a execuo do teste com o EJB configurado no modo return em.find(ContaCorrente.class, id);
CMT, a primeira transferncia de valores ocorreu com sucesso }
e o Java EE efetuou o commit da transao. Porm, na segunda }

50 Java Magazine Edio 101

Concluso
Neste artigo vimos uma introduo ao conceito de transao, a
forma como a JTA embutida no Java EE efetua o gerenciamento
dela, as possibilidades de uso do EJB em conjunto com os modos
de gerenciamento CMT e BMT, e a influncia das excees.
Como os modos de gerenciamento de transao CMT e BMT
so maneiras diferentes de se trabalhar, vale explicitar algumas
consideraes:
O CMT de mais alto nvel por ser configurvel, e tende a
ser mais intuitivo, uma vez que o comportamento padro
(TransactionManagementType.CONTAINEReTransactionAttributeType.REQUIRED),
sendo necessria uma ateno para as excees. Caso necessrio,
as anotaes podem ser adicionadas e manipuladas sem alterar a
regra de negcios, o que possibilita ao projetista do sistema elabo-
rar classes e mtodos de EJB mais adequados a este modo;
O BMT de mais baixo nvel por ser programvel e mais
flexvel, permitindo ao desenvolvedor controlar transaesdi-
retamente pelas instrues begin, commit e rollback via interface
UserTransaction.
difcil apontar qual o melhor modo entre CMT e BMT. Entre-
tanto, esperamos que este artigo o auxilie na deciso de qual deles
o mais adequado para a necessidade do seu sistema, quando for
necessrio controlar transaes com Java EE.

Eduardo Correia da Silva D seu feedback sobre esta edio! Feedback

eu
eduardoc222@gmail.com

s
A Java Magazine tem que ser feita ao

D
engenheiro de software na Ebiz, graduado em cincias da com- seu gosto. Para isso, precisamos saber

sobre e
putao e ps-graduado em projetos orientados a objetos. Possui o que voc, leitor, acha da revista!

s
ta
as certificaes OCJP, OCWCD, OCBCD e CSM. edio

D seu voto sobre este artigo, atravs do link:

www.devmedia.com.br/javamagazine/feedback

Edio 101 Java Magazine 51

 Seo Boas Prticas: Nesta seo voc encontra artigos sobre as tecnologias que podero aumentar

Aplicaes Java EE lightw

Reavaliando o uso de boas prticas e pad

Resumo DevMan
De que se trata o artigo:
Neste artigo veremos como construir aplicaes Java EE leves e enxutas, utilizando Padres J2EE revi-
sitados para a nova verso da plataforma. Para isso, mostraremos trs alternativas de implementao de
casos de uso do tipo CRUD utilizando os Padres Java EE.

Em que situao o tema til:

A criao de aplicaes corporativas leves e enxutas, que utilizam padres de projetos na medida certa,
no s escalam melhor quando necessrio, como so mais fceis de realizar manutenes e evolues no
decorrer do seu ciclo de vida.

Aplicaes Java EE "lightweight":

A plataforma corporativa Java evoluiu de tal maneira nos ltimos tempos que, muitos dos padres de
projetos J2EE amplamente empregados nas suas antigas verses, no so mais necessrios na atual verso,
Java EE 6. Isso se deve ao fato de que muitos dos problemas solucionados por estes padres deixaram de
existir. Um exemplo desta maior abstrao provida pela plataforma Java EE a possibilidade de criarmos
uma CRUD genrica utilizando apenas o padro Service Facade, sendo que, nas verses anteriores da
plataforma, seria necessrio utilizarmos um Session Facade e um ou mais Business Objects, como o DAO.

C
omo era de se esperar, a cada nova
verso da plataforma corporativa
do Java, a construo de aplicaes
fica mais simples e intuitiva. A sua ltima
verso, Java EE 6, est mais coesa e resolveu
muitos dos problemas de infraestrutura
presentes na plataforma J2EE, permitindo
ao desenvolvedor focar ainda mais nos
problemas de negcio e no se preocupar
muito com problemas de infraestrutura da
plataforma, como por exemplo, a integrao
entre as camadas do sistema. Desta forma,
muitos dos padres J2EE amplamente uti-
lizados anteriormente caram em desuso, e
em alguns casos, tornaram-se anti-padres.
Isto porque simplesmente no so mais
necessrios na nova plataforma Java EE.
Exemplos disso so o Service Locator e o
Business Delegate, anteriormente utiliza-
dos para abstrair complexidades de integra-
o e reduzir o acoplamento de camadas,
no so mais necessrios com a utilizao
de EJB 3 e CDI.
Neste contexto, neste artigo veremos
formas distintas para simplificar a imple-
mentao de casos de uso do tipo CRUD,
rotineiros em aplicaes corporativas Java
EE, utilizando padres J2EE repaginados
para a nova plataforma Java EE. Para isso,
mostraremos diferentes estratgias de im-
plementao dos padres Service Facade
e Data Access Object, tendo como base
os padres apresentados no livro Real
World Java EE Patterns Rethinking Best
Practices, do autor Adam Bien.
Padres Java EE
Os padres J2EE foram catalogados
em meados de 2001 no livro Core J2EE
Patterns Best Practices and Design
Strategies e atualizados em 2003 com a
segunda edio deste mesmo livro. Este
catlogo totaliza 21 padres, divididos em
trs camadas, mostrados na Tabela 1. Desde
ento, nenhuma atualizao foi apresenta-
da oficialmente comunidade Java. Desta

52 Java Magazine Edio 101

a qualidade do desenvolvimento de software

Simplifique suas aplicaes

eight
utilizando os recursos da
plataforma Java EE 6 e
aplicando boas prticas e
padres Java EE

res Java EE
Oscar Costa

forma, sem novas atualizaes, muitos destes padres se tornaram Soluo: apresenta a implementao base do padro, bem como
obsoletos medida que a plataforma era evoluda. possveis estratgias de implementao do mesmo;
Um fator que tornava as aplicaes J2EE complexas de serem Testes: tpico onde mostrado como realizar testes na imple-
implementadas e mantidas, era a necessidade da incluso de mentao;
diversos padres de projetos para resolver problemas de infraes- Documentao: mostra como documentar o padro com dia-
trutura da plataforma. Estes problemas ocorriam logo no incio da gramas e comentrios no cdigo;
construo da aplicao, onde j era exigida a implementao de Consequncia: tpico onde so listados os pontos positivos e
alguns padres, como Business Delegate, Service Locator, Session negativos na utilizao do padro;
Facade e Transfer Object. Padres relacionados: apresenta padres similares ou direta-
mente ligados ao padro explicado.
Camada de apresentao Camada de negcio Camada de integrao
Intercepting Filter Business Delegate * Data Access Object (DAO) Como podem ser observados na Tabela 2, alguns padres tm
Context Object Service Locator * Service Activator
mais de uma denominao. Os nomes destacados entre parnteses
so os nomes antigos, utilizados na plataforma J2EE, como o caso
Front Controller Session Facade Domain Store *
do padro Application Service, que agora chamado de Service
Application Controller Application Service Web Service Broker
Facade. E os padres com nomes separados por barra (/), so
View Helper Business Object padres de certa forma diferentes, porm com comportamento e
Composite View Composite Entity * aplicao muito semelhante, por exemplo: os padres Paginador e
Dispatcher View Transfer Object Fast Lane Reader. Alm disso, algumas estratgias de programa-
Service To Worker TO Assembler * o, como a integrao e migrao de EJB 2 e POJO legado para a
nova plataforma, tambm so descritas pelo autor.
Value List Handler *

Tabela 1. Padres do catlogo "Core J2EE Patterns" Repensando a camada Repensando a camada
Padres de infraestrutura
de negcios de integrao
No livro Real World Java EE Patterns Rethinking Best Prac- Service Facade
Data Access Object Service Starter
tices, o autor questiona a aplicao dos padres de projeto e das (Application Service)
Service Transfer Object / Data
boas prticas da plataforma J2EE em aplicaes concebidas nas Singleton
(Session Facade) Transfer Object
novas plataformas Java EE, mostrando como padres amplamente
Persistent Domain EJB 2 Integration and
utilizados no passado caram por terra. Estes padres esto mar- Bean locator
Object (Business Object) Migration
cados com um asterisco * na Tabela 1. Enquanto outros padres Legacy POJO Inte-
tiveram suas implementaes simplificadas, ou permitiram a Gateway Thread tracker
gration
adoo de diferentes estratgias de implementao para atender Dependency injection
Fluid Logic Generic JCA
a novos problemas. extender
Mas o foco do livro no explicar porque muitos dos padres Asynchronous
Paginator /
J2EE se tornaram inteis. Isso apenas uma consequncia da evo- Resource Integrator Payload extractor
Fast Lane Reader
luo da plataforma, que tambm relatada. O objetivo principal (Service Activator)
Resource Binder
do livro apresentar os padres e boas prticas J2EE ainda teis
Context Holder
na plataforma Java EE. Estes padres so separados por camada,
onde so melhores empregados (veja a Tabela 2), e destrinchados Tabela 2. Padres Java EE
pelos seguintes tpicos:
Problema: so relatados os problemas que o padro resolvia Simplificando um caso de uso CRUD
anteriormente e os motivos pelos quais ele continua a ser utilizado Casos de uso do tipo CRUD, ou suas funcionalidades (criar, ler,
na plataforma Java EE; atualizar e excluir), so habitualmente encontrados em aplicaes
Motivao: lista as motivaes para utilizao do padro; corporativas. E, devido arquitetura multicamadas de muitas

Edio 101 Java Magazine 53

Aplicaes Java EE lightweight
destas aplicaes, as funcionalidades das CRUDs so geralmente
fragmentadas e muitas vezes replicadas para tratar diferentes
casos de uso. Entretanto, o emprego desta complexidade para
casos de uso e funcionalidades simples como estas, no neces-
srio com o nvel de abstrao e com as facilidades presentes na
plataforma Java EE.
Em aplicaes J2EE, a implementao de casos de uso do tipo
CRUD utilizava duas ou trs camadas, como mostrado na Figura 1.
Neste caso, um Session Facade delegava todas as suas chamadas
diretamente a um DAO, sendo que, muitas vezes esta ligao era
intermediada por outro Business Object. J na plataforma Java EE,
esta implementao complexa pode ser substituda por apenas um
Stateless SessionBean, conforme mostrado na Figura 2.
Figura 1. CRUD na plataforma J2EE
Figura 2. CRUD na plataforma Java EE
Esta simplificao do CRUD na plataforma Java EE denomi-
nada por Adam Bien, em seu livro, de CRUD Facade. Ela consiste
em uma estratgia de implementao do padro Service Facade,
exposto na fronteira entre a camada de negcio e a camada de
apresentao, como um Session Facade. E com todas as fun-
cionalidades de um DAO, injetadas atravs do EntityManager.
Desta maneira, utilizando o padro Service Facade, um nico
Stateless SessionBean absorveu o papel de no mnimo duas
camadas, Session Facade e DAO, anteriormente utilizadas em
54 Java Magazine Edio 101
uma implementao purista de casos de uso do tipo CRUD.
A utilizao do padro Service Facade visa melhorar a manute-
nibilidade, simplificando a utilizao dos servios e a construo
de testes, alm de j manter a consistncia dos dados atravs de
transaes providas pela JPA 2.
Pensando em reuso, possvel que um nico CRUD Facade seja
utilizado por todos os CRUDs e outros casos de uso da aplicao.
Desde que, para isso, os recursos disponveis nas especificaes
Java SE e EE sejam utilizados de forma coerente. No exemplo
de CRUD Facade apresentado na Listagem 1, foram utilizados
Generic Methods para os mtodos bsicos de criao, busca dire-
ta, atualizao e excluso, e para os mtodos de pesquisa com
parmetros e paginao, foram utilizadas Named Queries, que
devem ser definidas nos metadados das entidades JPA. A interface
CrudService foi suprimida aqui, pois somente define os mtodos
anotados com @Override.
- Generic Methods foram introduzidos no Java SE 5.0 e so timas opes para reutilizar
mtodos recorrentes. Como por exemplo, os quatro mtodos bsicos da CRUD (criar,
ler, atualizar e excluir), evitando assim a duplicao desnecessria de cdigo.
- Named Queries so consultas estticas escritas nos metadados das entidades
JPA, que podem ser definidas utilizando JPQL (Java Persistence Query Language)
ou SQL. E por serem estticas, tm a vantagem de poderem ser validadas pelo
container na inicializao da aplicao.
- Como a criao de interfaces para Session Beans no EJB 3.1 no obrigatria, o
CRUD Facade pode ser mais simplificado caso a arquitetura da aplicao necessite,
abnegando-se das interfaces local e/ou remota.
Alternativas para o caso de uso CRUD
Caso seja necessria a especializao do CRUD Facade para
atender outras funcionalidades de negcio da aplicao, este pode
ser utilizado como Generic DAO (veja a Figura 3) ou Abstract DAO
(veja a Figura 4). Estas so estratgias de implementao do padro
DAO que visam simplificao do acesso a dados, desacoplando
a aplicao da fonte de dados, e tambm primam pela reutilizao
de cdigo. A principal diferena entre as duas estratgias a for-
ma de utilizao: herana no caso do Abstract DAO e injeo de
dependncia para o Generic DAO. Outra diferena significativa
a possibilidade de utilizar mais de uma fonte de dados no Abstract
DAO, pois o EntityManager no est injetado na classe abstrata.
O Generic DAO consiste em uma nica classe responsvel por
encapsular o acesso a dados, que consegue gerenciar qualquer
entidade JPA da aplicao. Esta estratgia bem adequada para ser
utilizada em operaes de CRUDs, pois todas as funcionalidades
bsicas so cobertas pelo padro.
Para aplicaes onde a maior parte da lgica de negcios consiste
em acessar a base de dados, a estratgia Abstract DAO apresenta
uma abordagem bem pragmtica, com os mtodos de acesso a
dados disponveis, sem a necessidade de injetar outro compo-
nente, mesmo quando h a necessidade de utilizarmos mais de
uma fonte de dados.
 Listagem 1. Cdigo de CRUD Facade.

import java.util.*; @Override

import javax.ejb.*; public List findWithNamedQueryPaginated(String namedQueryName,
import javax.persistence.*; int firstResult, int resultLimit) {
@Stateless return findWithNamedQueryPaginated(namedQueryName,
@Local(CrudService.class) new HashMap<String, Object>(),
@TransactionAttribute(TransactionAttributeType.REQUIRES_NEW) firstResult, resultLimit);
}
public class CrudServiceBean implements CrudService { @Override
@PersistenceContext public List findWithNamedQueryPaginated(String namedQueryName,
private EntityManager em; Map<String, Object> parameters,
@Override int firstResult, int resultLimit) {
public <T> T create(T t) { Query query = em.createNamedQuery(namedQueryName);
em.persist(t); if (firstResult > 0) {
em.flush(); query.setFirstResult(firstResult);
em.refresh(t); }
return t; if(resultLimit > 0) {
} query.setMaxResults(resultLimit);
@Override }
public <T> T update(T t) { for (Map.Entry<String, Object> entry : parameters.entrySet()) {
return em.merge(t); query.setParameter(entry.getKey(), entry.getValue());
} }
@Override return query.getResultList();
public <T> void delete(Class<T> type, Object id) { }
Object ref = em.getReference(type, id); @Override
em.remove(ref ); public Integer countResultsOfNamedQuery(String namedQueryName) {
} return countResultsOfNamedQuery(namedQueryName,
@Override new HashMap<String, Object>());
public <T> T find(Class<T> type, Object id) { }
return em.find(type, id); @Override
} public Integer countResultsOfNamedQuery(String namedQueryName,
@Override Map<String, Object> parameters) {
public List findByNamedQuery(String namedQueryName) { Query query = this.em.createNamedQuery(namedQueryName);
return findWithNamedQueryPaginated(namedQueryName, 0, 0); for (Map.Entry<String, Object> entry : parameters.entrySet()) {
} query.setParameter(entry.getKey(), entry.getValue());
@Override }
public List findByNamedQuery(String namedQueryName, return query.getResultList().size();
Map<String, Object> parameters) { }
return findWithNamedQueryPaginated(namedQueryName, parameters, 0, 0); }
}

Um possvel questionamento de utilizar as estratgias Generic
DAO e Abstract DAO o fato de que elas violam o princpio de
separao de interesses, que deu origem camada de persis-
tncia separada da camada de negcios, ou servios. Porm, na
plataforma Java EE 6, o EntityManager pode ser considerado uma
implementao do padro DAO, no havendo mais a necessidade
de encapsular todo acesso a dados em uma camada distinta.
no mandatrias, so: mover o Generic DAO para um pacote supe-
rior ou especfico, permitindo um acesso padronizado para todos
os seus clientes; e a criao de uma interface para desacoplar dos
clientes os diferentes tipos de acesso aos dados, caso a arquitetura
da aplicao necessite.

Figura 3. Utilizao da Estratgia Generic DAO para uma CRUD

Para refatorar um CRUD Facade para um Generic DAO, devemos

alterar o tipo de transao para MANDATORY (veja a Listagem 2)
e implementar os clientes do DAO com o tipo de transao RE-
QUIRES_NEW, j que estes passam a ter agora a funo de Service
Facade (veja a Listagem 3). Outras refatoraes desejveis, porm Figura 4. Utilizao da estratgia Abstract DAO para uma CRUD

Edio 101 Java Magazine 55

Aplicaes Java EE lightweight

J a refatorao do CRUD Facade para o Abstract DAO envolve Listagem 2. Cdigo de Generic DAO.
um pouco mais de mudanas estruturais neste componente,
import java.util.*;
visto que quem possui o EntityManager como atributo agora so as
import javax.ejb.*;
classes concretas que herdam de Abstract DAO. O SessionBean import javax.persistence.*;
passa a ser uma classe abstrata com a adio de um mtodo abs-
trato para recuperar o EntityManager dos clientes concretos (veja as @Stateless
Listagens 4 e 5). @Local(CrudService.class)
@TransactionAttribute(TransactionAttributeType.MANDATORY)
public class CrudServiceBean implements CrudService {
- Os tipos de transaes da plataforma Java EE (MANDATORY, REQUIRED, REQUI-
RES_NEW, SUPPORTS, NOT_SUPPORTED e NEVER) definem como ser o comporta- @PersistenceContext
mento da transao. Por exemplo, caso um mtodo ou classe anotada com o tipo private EntityManager em;
de transao MANDATORY seja chamada por outro mtodo que j esteja dentro de
(...)
uma transao, a mesma transao utilizada. Porm, caso o mtodo chamador
no esteja dentro de uma transao, a exceo TransactionRequiredException ser }
lanada ao chamar o mtodo anotado com o tipo de transao MANDATORY.
Listagem 3. Cdigo do Cliente de Generic DAO.

Java EE e o padro ECB import java.util.*;

Em muitas aplicaes corporativas, construdas sobre a platafor- import javax.ejb.*;
import javax.persistence.*;
ma Java EE, cada componente separado claramente em fronteira,
controle e entidade, onde: a camada de fronteira so as Facades; @Stateless
na camada de controle so implementadas as lgicas do negcio, @TransactionAttribute(TransactionAttributeType.REQUIRED_NEW)
public class EmpresaServiceBean {
geralmente utilizando EJBs; e na camada de entidades esto con-
tidas as representaes do domnio da aplicao, implementadas (...)
com JPA. Desta forma cada componente uma implementao do
}
padro ECB, sigla do ingls Entity Control Boundary, apresentado
na Figura 5. Listagem 4. Cdigo de Abstract DAO.

import java.util.*;
import javax.ejb.*;
import javax.persistence.*;

@Stateless
@TransactionAttribute(TransactionAttributeType.MANDATORY)
public abstract class CrudServiceBean {

public abstract EntityManager getEntityManager();

Figura 5. Padro ECB (retirada do livro Real World Java EE - Night Hacks) (...)

}
Este padro tem como objetivo principal prover uma clara
Listagem 5. Cdigo do Servio Concreto de Abstract DAO.
separao entre a lgica de negcios e a lgica de apresentao,
reduzindo o acoplamento entre as camadas, e, como consequncia, import java.util.*;
facilitando a utilizao da aplicao por clientes de diferentes import javax.ejb.*;
import javax.persistence.*;
tecnologias, como por exemplo: JSF 2, GWT ou REST.
Alm de prover um fraco acoplamento entre as camadas de uma @Stateless
aplicao, o padro ECB no indivisvel. Casos de uso mais sim- @TransactionAttribute(TransactionAttributeType.REQUIRED_NEW)
public class EmpresaServiceBean extends CrudServiceBean {
ples, como CRUDs, podem ser implementados utilizando apenas
uma camada Boundary acessando vrias entidades, como foi @PersistenceContext
mostrado neste artigo. Isso se deve, principalmente, facilidade private EntityManager em;
e flexibilidade da plataforma Java EE 6, com as especificaes do
public EntityManager getEntityManager() {
JPA 2, EJB 3.1 e CDI. return em;
}
A camada de apresentao (...)
A utilizao de um SessionBean na plataforma Java EE 6 to
simples como injetar um EntityManager em um EJB. Para isto, basta }
utilizar a anotao @EJB, como mostrado na classe CrudController

56 Java Magazine Edio 101

(Listagem 6). Esta classe abstrata define o comportamento comum
para os controladores de CRUDs do sistema. Um exemplo de con-
trolador concreto que herda o comportamento da classe controla-
dora abstrata a classe EmpresaController, exibida na Listagem 7.
Como o ManagedBean EmpresaController tem o escopo de viso
@ViewScoped, podemos utilizar a tag <ajax> (demonstrada na
Listagem 8) para realizar a paginao de dados na pesquisa, em
conjunto com uma classe abstrata utilitria PaginationHelper (mos-
trada na Listagem 9). Esta implementao com escopo de viso
evita trafegar vrias informaes em um escopo de request, ou
ficar controlando manualmente o tempo de vida dos objetos no
escopo de sesso. Ou em um caso mais complexo, evitamos a
utilizao de um pesado Stateful SessionBean, para implementar
uma simples paginao ou ordenao de dados.
- Com a especificao JSR-299 para CDI (Context and Dependency Injection), a
anotao @EJB pode ser substituda pela anotao @Inject, com a vantagem de
poder utilizar herana nos componentes injetados.

Listagem 6. Cdigo do JSF Controlador Abstrato.

import com.openarch.webrh.entities.EntidadeBase; try {

import com.openarch.webrh.services.CrudService; entidade = crudService.create(entidade);
import java.io.Serializable; JsfUtil.addSuccessMessage(CrudEntityCreated,
import javax.ejb.EJB; entidade.getClass().getSimpleName());
import javax.faces.model.DataModel; } catch (Exception e) {
public abstract class CrudController<T extends EntidadeBase> JsfUtil.addErrorMessage(e, CrudEntityCreatedError,
implements Serializable { entidade.getClass().getSimpleName());
@EJB }
protected CrudService crudService; }
protected T entidade; public void update() {
protected DataModel items = null; try {
protected PaginationHelper pagination; entidade = crudService.update(entidade);
public T getEntidade() { JsfUtil.addSuccessMessage(CrudEntityUpdated,
return entidade; entidade.getClass().getSimpleName());
} } catch (Exception e) {
public abstract PaginationHelper getPagination(); JsfUtil.addErrorMessage(e, CrudEntityUpdatedError,
public void next() { entidade.getClass().getSimpleName());
getPagination().nextPage(); }
items = getPagination().createPageDataModel(); }
} public String delete() {
public void previous() { try {
getPagination().previousPage(); crudService.delete(entidade.getClass(), entidade.getId());
items = getPagination().createPageDataModel(); JsfUtil.addSuccessMessage(CrudEntityDeleted,
} entidade.getClass().getSimpleName());
public DataModel getItems() { } catch (Exception e) {
if (items == null) { JsfUtil.addErrorMessage(e, CrudEntityDeletedError,
items = getPagination().createPageDataModel(); entidade.getClass().getSimpleName());
} }
return items; return List;
} }
public void create() { }

Listagem 7. Cdigo do Controlador de Empresa.

import com.openarch.webrh.entities.Empresa; @Override

import com.openarch.webrh.entities.Contato; public PaginationHelper getPagination() {
import com.openarch.webrh.entities.Endereco; if (pagination == null) {
import java.util.List; pagination = new PaginationHelper(5) {
import javax.annotation.PostConstruct; @Override
import javax.faces.bean.*; public int getItemsCount() {
import javax.faces.model.*; return crudService.countResultsOfNamedQuery(Empresa.FIND_ALL);
@ManagedBean(name = empresaController) }
@ViewScoped
@Override
public class EmpresaController extends CrudController<Empresa> {
public DataModel createPageDataModel() {
@PostConstruct
public void init() { List lista = crudService.findWithNamedQueryPaginated(Empresa.FIND_ALL,
String id = JsfUtil.getRequestParameter(id); getPageFirstItem(), getPageSize());
if (AppUtil.isBlank(id)) { return new ListDataModel(lista);
entidade = new Empresa(); }
entidade.setContato(new Contato()); };
entidade.setEndereco(new Endereco()); }
} else { return pagination;
entidade = crudService.find(Empresa.class, Long.parseLong(id)); }
} public SelectItem[] getListaEmpresas() {
} List lista = crudService.findByNamedQuery(Empresa.FIND_ALL);
public Empresa getEmpresa() { return JsfUtil.getSelectItems(lista, true);
return entidade; }
} }

Edio 101 Java Magazine 57

Aplicaes Java EE lightweight

Listagem 8. Exemplo de utilizao da tag ajax. Concluses

A plataforma Java EE 6 nos prov a infraestrutura necessria
<h:form styleClass=jsfcrud_list_form>
<h:panelGroup rendered=#{empresaController.items.rowCount > 0}> para que as aplicaes sejam desenvolvidas muito mais focadas
<h:panelGroup layout=block style=text-align: center;> na resoluo dos problemas de negcio, sem nos preocupar tanto
<h:commandLink action=#{empresaController.previous}
value=#{msgs.PaginacaoAnterior} com problemas de infraestrutura da plataforma como era neces-
disabled=#{not empresaController.pagination.hasPreviousPage}> srio antes. Deste modo, muitas das boas prticas e padres J2EE
<f:ajax render=@form/>
</h:commandLink> utilizados anteriormente caram por terra e devem ser evitados,
&nbsp; pois estes padres geram um nvel de complexidade desnecess-
<h:outputText value=#{empresaController.pagination.pageFirstItem + 1}
.. #{empresaController.pagination.pageLastItem + 1} rio para aplicaes construdas na atual plataforma, sem trazer
/ #{empresaController.pagination.itemsCount}/>&nbsp; nenhum benefcio ao processo de desenvolvimento, ou mesmo
<h:commandLink action=#{empresaController.next}
value=#{msgs.PaginacaoProximo} s aplicaes.
disabled=#{not empresaController.pagination.hasNextPage}>
<f:ajax render=@form/>
Com foco no desenvolvimento de aplicaes Java EE mais
</h:commandLink> simples e enxutas, mostramos neste artigo como implemen-
</h:panelGroup>
<h:dataTable value=#{empresaController.items} var=item border=0
tar as funcionalidades de casos de uso do tipo CRUD, que
cellpadding=2 cellspacing=0 rules=all> so muito corriqueiros em aplicaes corporativas. Para isso,
<h:column>
<f:facet name=header>
uma CRUD genrica foi implementada utilizando a estratgia
<h:outputText value=#{msgs.EmpresaTituloNome}/> CRUD Facade, derivada do padro Session Facade. Alm dis-
</f:facet>
<h:outputText value=#{item.nome}/> so, apresentamos implementaes alternativas desta mesma
</h:column> CRUD, utilizando as estratgias Generic DAO e Abstract DAO,
</h:dataTable>
</h:panelGroup> derivadas do padro DAO. Por fim, mostramos como utilizar
<h:commandButton action=/empresa/Crud herana e recursos do JSF 2, como o escopo de viso e AJAX,
value=#{msgs.PesquisaEmpresaAcaoNovo}/>
</h:form>
para implementar a camada de apresentao, que funciona
como um cliente da CRUD.
Listagem 9. Cdigo da classe auxiliar para paginao. Duas timas fontes, presentes nas referncias deste artigo, para
import javax.faces.model.DataModel; se aprofundar na utilizao de padres Java EE so: o livro Real
public abstract class PaginationHelper {
private int pageSize;
World Java EE Patterns Rethinking Best Practices, indicado
private int page; tambm na pgina de referncias da plataforma Java EE da Oracle,
public PaginationHelper(int pageSize) {
this.pageSize = pageSize;
e o repositrio de implementaes dos Padres Java EE no projeto
} Kenai, mantido por Adam Bien, autor desse mesmo livro.
public abstract int getItemsCount();
public abstract DataModel createPageDataModel();
public int getPageFirstItem() {
return page * pageSize;
Oscar Costa
} oscarcosta@gmail.com, @oscarcosta
public int getPageLastItem() { bacharel em Cincias da Computao e ps-graduando em Arqui-
int i = getPageFirstItem() + pageSize - 1;
int count = getItemsCount() - 1; tetura de Sistemas. Vem atuando como desenvolvedor Java EE a mais
if (i > count) { de cinco anos. Possui as certificaes SCJP 5, SCWCD 5 e SCBCD 5. pai da
i = count; Daniela (2), pratica mountain bike e toca contra baixo nas horas vagas.
}
if (i < 0) {
i = 0;
} oracle.com/technetwork/java/javaee/blueprints
return i; Pgina de referncia da plataforma Java EE
}
public boolean isHasNextPage() {
return (page + 1) * pageSize + 1 <= getItemsCount(); adam-bien.com
} Site do autor, arquiteto e Java Champion, Adam Bien
public void nextPage() {
if (isHasNextPage()) { kenai.com/projects/javaee-patterns/
page++;
} Coleo das implementaes dos Padres Java EE descritos no livro
} Real World Java EE Patterns Rethinking Best Practices.
public boolean isHasPreviousPage() {
return page > 0;
}
public void previousPage() { D seu feedback sobre esta edio! Feedback
eu
if (isHasPreviousPage()) {
s

A Java Magazine tem que ser feita ao

D

page--;
seu gosto. Para isso, precisamos saber
sobre e

}
} o que voc, leitor, acha da revista!
s

ta
public int getPageSize() {
edio

return pageSize; D seu voto sobre este artigo, atravs do link:

}
} www.devmedia.com.br/javamagazine/feedback

58 Java Magazine Edio 101

Edio 101 Java Magazine 59
 Seo Boas Prticas: Nesta seo voc encontra artigos sobre as tecnologias que podero aumentar

Maven 3, Sonar e Hudson

Descobrindo uma maneira mais gil de d

Resumo DevMan
De que se trata o artigo:
Neste artigo vamos abordar a integrao das ferramentas Maven 3, Sonar e Hudson com a inteno de criar
um ambiente de desenvolvimento mais gil por meio do estmulo eliminao de atividades repetitivas,
reduo na incidncia de defeitos e aumento da qualidade do cdigo produzido.

Em que situao o tema til:

Uma das principais causas da mortalidade prematura de projetos de software est ligada diminuio da
qualidade do cdigo. Assim, um dos principais objetivos deste artigo estimular a criao de um ambiente
continuamente integrado e que seja capaz de irradiar importantes informaes, alertando a equipe quanto
a problemas existentes no projeto.

Maven 3,Sonar e Hudson:

O objetivo deste artigo mostrar o caminho das pedras paraa utilizao e integrao das ferramentas
Maven, Sonar e Hudson. Juntas, elas so capazes de automatizar uma srie de atividades repetitivas exis-
tentes no dia-a-dia de qualquer ambiente de desenvolvimento de software, fornecerimportantes mtricas
e indicadores de qualidade de cdigo, evitando o acmulo de dbito tcnico, e ainda integrar o projeto
continuamente para proporcionar feedback constante para o cliente.

P
ara desenvolver software de forma
cada vez mais gil importante es-
tar sempre atento aos desperdcios
existentes no processo de desenvolvimen-
to, buscando estratgias para elimin-los e,
se possvel, fazer com que eles no voltem
a ocorrer.
Nesse sentido importante compreen-
der dois conceitos muito fortes na cultura
oriental e que podem ajudar nessa difcil
tarefa. Eles so conhecidos como Hansei
e Kaizen.
O Hansei est diretamente ligado hu-
mildade. Ter um comportamento humilde
a base para que possamos assumir e
reconhecer os problemas existentes em
nosso ambiente de desenvolvimento
atual. Sem isso extremamente difcil
promover qualquer tipo de melhoria mais
profunda e efetiva.
Para o Kaizen sempre possvel fazer
melhor e nenhum dia deve passar sem que
alguma melhoria tenha sido observada,
sugerida ou implantada. Essas melhorias
podem ser feitas tanto na estrutura da
empresa e em seus processos, quanto no
prprio indivduo.
Taiichi Ohno, um dos grandes prota-
gonistas do Toyota Production System,
aplicava o Kaizen de forma sistemtica
e consistente nas fbricas da Toyota. Ele
costumava desenhar um crculo no cho
da fbrica, que mais tarde ficou conhecido
como Crculo de Ohno, e pedia para que
supervisores e gerentes entrassem nele
apenas para observar enquanto seus lide-
rados trabalhavam. Aps algum tempo
ele perguntava se estava tudo bem. Caso
a resposta fosse positiva, a pessoa era
convidadaapermanecer observando por
mais tempo at que conseguisse identi-
ficar problemas no processo. Para Taiichi
Ohno, sempre era possvel melhorar, e foi
essa obsessoque tornou a Toyota uma
empresa reconhecida mundialmente pela
alta qualidade de seus produtos. Segundo
ele: No ter problema o maior de todos
os problemas!.

60 Java Magazine Edio 101

a qualidade do desenvolvimento de software
esenvolver software
Aplicados juntos, estes conceitos proporcionam um ambiente
preparado para evoluir e melhorar constantemente.
Neste contexto, o objetivo deste artigo mostrar como instalar,
utilizar e extrair valor de ferramentas como: Maven, para auto-
matizar uma srie de atividades repetitivas; Sonar, para visua-
lizar mtricas e indicadores de qualidade de cdigo, evitando o
acmulo de dbito tcnico (uma espcie de dvida acumulada
por conta de problemas tcnicos no resolvidos); e Hudson,para
integrar tudo continuamente e proporcionar feedback constante
para o cliente.
Descobrindo seu prprio ambiente
Costumamos realizar uma srie de atividades diferentes em
meio correria do nosso dia-a-dia e muitas vezes no nos damos
conta de que algumas delas so extremamente repetitivas.
Pense em quantas vezes precisamos realizar algumas dastarefas
abaixo:
Criar e configurar um projeto em determinada tecnologia;
Configurar o ambiente de desenvolvimento seja para novos
desenvolvedores ou mesmo em casos onde precisamos trocar de
computador por algum motivo;
Incluir e atualizar verses e dependncias de bibliotecas do
projeto;
Preparar e empacotar uma verso do projeto antes de coloc-lo
em produo;
Executar o procedimento de implantao de uma nova verso
do projeto.
Quanto tempo poderia ser economizado automatizando esse
tipo de atividade?
A importncia do feedback
Pesquisas feitas pelo The Standish Group, uma importante orga-
nizao americana sediada em Boston e responsvel por realizar
pesquisas sobre a performance de projetos de TI,revelam que boa
parte das funcionalidades implementadas raramente utilizada
pelos clientes. Isso acontece, em grande parte das vezes, pela falta
de feedback e principalmente de envolvimento do cliente durante
o processo de desenvolvimento do projeto.
Desenvolver software de forma gil no significa programar
mais rpido, mas sim reconhecer funcionalidades desnecessrias
e evit-las. A simplicidade um dos princpios do Manifesto gil.
Ela definida como a arte de maximizar a quantidade de software
no desenvolvido.
Neste artigo vamos
mostrar como utilizar as
ferramentas Maven 3, Sonar
e Hudson para desenvolver
software com mais
qualidade e agilidade
Rodrigo Branas
Os mtodos geis se baseiam no desenvolvimento iterativo e
incremental. Em pequenos intervalos de tempo, pequenas partes
das funcionalidades do software so planejadas, desenvolvidas
eentregues ao cliente. Dessa forma possvel proporcionar retorno
de investimento antecipado e ainda guiar o desenvolvimento de
novas funcionalidades com base na experincia adquirida com a
utilizao das partes j entregues.
No entanto, uma das grandes dificuldadespode estar relaciona-
da justamentecom o ambiente de desenvolvimento.Este deve ser
capaz de disponibilizar, em tempo real, a ltima verso do projeto
para que o cliente possa utilizar e testar, se envolvendo com mais
profundidade no processo de desenvolvimento. Infelizmente, pela
dificuldade de gerar uma verso adequada para testes por conta
do ambiente, o feedback acaba sendo constantemente adiado.
Em seu livro de Extreme Programming, escrito h mais de 10
anos, Kent Beck rene prticas imprescindveis para o sucesso de
um projeto, como a automao de build e a integrao contnua.
Essas prticas ajudam a desenvolver software de alto valor agre-
gado e com menos desperdcios.
Reduo no nmero de defeitos
Um dos maiores desperdcios no desenvolvimento de projetos
de software est relacionado ocorrncia de defeitos. A maior
dificuldade muitas vezes no est na sua correo, mas sim na
dificuldade de reproduo e identificao do trecho de cdigo
que ocasiona o erro.
Pense em quantas vezes voc j ficou horas tentando entender
o que poderia estar causando o problema e apenas uma ou duas
linhas de cdigo foram necessrias para corrigir efetivamente o
defeito. A analogia abaixo ilustra bem essa situao:
Imagina por um minuto que voc est andando na rua e per-
cebe que sua chave caiu do bolso. Ao ouvir o barulho do choque
da chave com o cho, voc prontamente olha para trs e localiza
facilmente sua chave cada, recuperando e seguindo novamente
o caminho.
E se voc no tivesse ouvido a chave cair no cho e continuasse
andando por cerca de 10 minutos? Ser que seria to fcil assim
encontrar a chave?
Muitas vezes o tempo gasto para localiz-la, dependendo do
quanto se tenha andado, acaba sendo to grande que mais fcil
e rpido chamar um chaveiro para abrir a porta de casa e trocar
a fechadura.
Quanto mais cedo for descoberto o problema, maior ser a eco-
nomia, pois menos tempo precisar ser investido na correo!
Edio 101 Java Magazine 61
Maven 3, Sonar e Hudson
Maven 3
O Maven, atualmente na verso 3.0.3,
uma poderosa ferramenta para automao
e gerenciamento de configurao de pro-
jetos em Java. Entre suas principais carac-
tersticas esto a gesto de dependncias,
a padronizao da estrutura de diretrios,
o ciclo de vida bem definido, a gerao
de documentao, alm de uma imensa
quantidade de plugins disponveis que
permitem estender suas funcionalidades.
Para montar nosso ambiente de desenvolvi-
mento gil, o Maven ser fundamental, ser-
vindo como ferramenta base para gerenciar
todo o processo de implantao do projeto.
Processo de Instalao
O processo de instalao do Maven ex-
tremamente simples. Basta entrar na seo
Figura 1. Verso do Maven sendo exibida no console
Figura 2. Lista de Archetypes disponveis no Maven
62 Java Magazine Edio 101
de downloads no site do projeto (http://
maven.apache.org/download.html), locali-
zado dentro do site da Apache Software
Foundation, e baixar a ltima verso. Aps
realizar o download do arquivo, descom-
pacte o contedo dentro de um diretrio
de sua preferncia.
Para finalizar a instalao, ser necess-
rio criar uma varivel de ambiente com
o nome M2_HOME, apontando para o
diretrio de instalao do Maven. Tam-
bm importante modificar a varivel
PATH, adicionando o caminho%M2_
HOME%/bin.
Verifique se o procedimento foi realiza-
do corretamente executando o seguinte
comando no console:
mvn --version
O resultado esperado pode ser verificado
na Figura 1.
Vale lembrar que imprescindvel ter o
Java corretamente instalado e configurado
na mquina. Assim, verifique tambm a
existncia da varivel de ambiente JAVA_
HOME e da referncia %JAVA_HOME/
bin no PATH.
Com o Maven instalado corretamente,
podemos seguir adiante e criar o nosso
primeiro projeto!
Criando seu primeiro projeto com o Maven
O Maven oferece uma formaextrema-
mente simples paracriar novos projetos.
No entanto, para entender como fazer isso,
ser necessrio compreender melhorum
recurso conhecido como Archetypes.
De forma resumida, Archetype um
template para gerao rpida daestrutura e
configurao bsica de projetos. O grande
diferencial deste recurso a possibilidade
de criar projetos baseado em uma deter-
minada tecnologia sem a necessidade de
criar diretrios, arquivos de configurao
e nem baixar bibliotecas para ter seu pro-
jeto pronto para uso.
Imagine que voc precisa criar um
projeto com base em algum framework,
como o Spring, Apache Wicket, Google
Web Toolkit (GWT) ou qualquer outro.
Normalmente seria necessrio ler a docu-
mentao de instalao, baixar uma srie
de bibliotecas, configur-las no projeto e
ainda criar alguns arquivos de configura-
o especficos at ter o mnimo necessrio
para criar um simples Hello, World!.
Para criar seu primeiro projeto com o
Maven, basta executar o comando:
mvn archetype:generate
Em seguida, o Maven ir mostrar uma
lista conforme a Figura 2 indicando os
Archetypes disponveis, e ento s sele-
cionar um nmero com base na lista de
tecnologias suportadas.
Caso a tecnologia desejada no seja
encontrada, recomendada a utilizao
do Archetype padro (sugerido pelo pr-
prio Maven), para criar a estrutura bsica
do projeto. Nesse caso, a configurao
das bibliotecas precisar ser realizada
manualmente.
Configurando as propriedades bsicas de um projeto Maven
Aps selecionar o Archetype padro, ser necessrio configurar
as propriedades bsicas para finalizar a criao do projeto. Estas
propriedades so obrigatrias e servem para identificar o projeto
de forma nica.So elas:
groupId: Representa a estrutura bsica (raiz) de pacotes do projeto;
artifactId: Representa o nome do projeto;
version: Determina a verso do projeto.
Realizada a configuraodas propriedades bsicas, o Maven
ir solicitar a confirmao dos parmetros informados antes de
proceder com a criao da estrutura do projeto.
Finalizado o processo, o Maven criar a estrutura do projeto
dentro de uma pasta com o mesmo nome do artifactId. Na Figura 3
temos a estrutura de pastas criada pelo Maven sendo exibida
dentro do Eclipse.
Figura 3. Estrutura de diretrios padro gerada pelo Maven
Entendendo a estrutura de diretrios padro
Uma caracterstica interessante do Maven a padronizao
que ele proporciona. No incomum encontrar nas empresas a
utilizao de diferentes estruturas de diretrio para armazenar os
fontes de projetos Java. Com o tempo, isso pode causar, alm de
confuso, uma sensao de falta de organizao. O Maven utiliza,
por padro, a estrutura de pastas detalhada na Tabela 1.
No entanto, existem alguns casos em que h uma conveno pr-
pria que define a estrutura de pastas. Nesse caso, ser necessrio
sobrescrever a estrutura padro do Maven, alterando o arquivo
pom.xml localizado no diretrio raiz do projeto.
Project Object Model, o corao do projeto
O Project Object Model, tambm conhecido como pom.xml,
o principal arquivo de configurao de um projeto que utiliza
o Maven. Dentro dele esto as configuraes bsicas, definio
das dependncias necessrias, configurao dos plugins utiliza-
dos e demais especificaes importantes referentes gesto de
configurao do projeto.
Estrutura de diretrio Tipo de contedo
src/main/java Pasta principal, onde fica localizado o cdigo fonte da
aplicao.
src/main/resources Arquivos de configurao e demais recursos.
src/main/webapp Fontes relacionados Web.
src/test/java Cdigo fonte dos testes da aplicao.
src/test/resources Arquivos de configurao e demais recursos necess-
rios aos testes.
src/site Documentao do projeto.
Tabela 1. Detalhes sobre a padronizaoda estrutura de diretrios
O POM tem como uma de suas grandes vantagens a concen-
trao de informaes em um local nico e seu alto nvel de
abstrao,permitindo configurar rapidamente estratgias de
implantao e empacotamento para o projeto.
Na Listagem 1, podemos observar o pom.xml resultante do
processo de criao do projeto utilizando o Archetype padro do
Maven, contendo alm das propriedades bsicas, algumas confi-
guraes que veremos a seguir.
Listagem 1. Contedo do arquivo pom.xml.
<Project xmlns=http://maven.apache.org/POM/4.0.0 xmlns:xsi=
http://www.w3.org/2001/XMLSchema-instancexsi:schemaLocation=
http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-
v4_0_0.xsd>
<modelVersion>4.0.0</modelVersion>
<groupId>br.com.rodrigobranas</groupId>
<artifactId>ProjetoJavaMagazine</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>ProjetoJavaMagazine</name>
</project>
Gesto de Dependncias
A utilizao de bibliotecas e frameworks ajuda a evitar a criao
desnecessria de cdigo e ainda permite que os desenvolvedores fo-
quem no que gera mais valor de negcio para o projeto. No entanto,
a gesto dessas dependncias pode se tornar difcil, com o passar
do tempo, por conta de mudanas e atualizaes constantes.
Normalmente, essas bibliotecas ficam armazenadas e configu-
radas dentro do prprio projeto em que so utilizadas, gerando
duplicao nos casos em que diferentes projetos utilizam as mes-
mas dependncias. Outro problema que, alm de ocupar mais
espao em disco, tanto na maquina do desenvolvedor quanto no
repositrio de cdigo fonte, aumentam o trfego da rede sempre
que necessrio baixar novamente todo o projeto.
O Maven muda esse cenrio ao introduzir o conceito de reposit-
rio local, ou seja, todas as dependncias, independente do projeto
Edio 101 Java Magazine 63
Maven 3, Sonar e Hudson
em que so utilizadas, so armazenadas de forma centralizada e
podem ser reutilizadas em todo o ambiente de desenvolvimento.
Esse repositrio fica localizado na pasta .m2/repository dentro do
home do usurio.
Ao executar o ciclo de vida de construo do projeto, o Maven
procura pela dependncia dentro do repositrio local e, caso ela
no seja encontrada, ser automaticamente baixada de um repo-
sitrio pblico, na internet.
Incluindo novas bibliotecas ao projeto
Para incluir bibliotecas no projeto basta editar o arquivopom.xml
e adicionar a configurao da dependncia. Essa configurao
feita dentro da tag <dependency>, onde necessrio informar,
tambm por meio de tags, o groupId, artifactId e version da depen-
dncia desejada. Na Listagem 2 temos um exemplo feito com a
biblioteca JUnit 3.8.1.
Listagem 2. Configurao de dependncias no arquivo pom.xml.
<Project xmlns=http://maven.apache.org/POM/4.0.0 xmlns:xsi=
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation=http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd>
<modelVersion>4.0.0</modelVersion>
<groupId>br.com.rodrigobranas</groupId>
<artifactId>ProjetoJavaMagazine</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>ProjetoJavaMagazine</name>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
</dependency>
</dependencies>
</project>
Dependncias transitivas
O sistema de gesto de dependncias do Maven funciona de
forma transitiva, ou seja, identificando e obtendo todas as depen-
dncias das dependncias. Isso simplifica imensamente o processo
de construo do projeto, j que no necessrio se preocupar com
as bibliotecas necessrias para fazer a aplicao funcionar.
O funcionamento desse mecanismo determinado conforme o
escopo escolhido na configurao de cada dependncia.
Escopo da dependncia
Muitas vezes, s necessrio utilizar uma determinada biblio-
teca durante a execuo de testes. Em outros casos, acaba sendo
desnecessrio empacotar a dependncia junto com a aplicao,
pois ela j fornecida pelo servidor. Por esse motivo, importante
conhecer a configurao do escopo da dependncia.
Na Listagem 3, temos um exemplo da dependncia JUnit 3.8.1
configurada para o escopo de teste.
A seguir, seguem os principais tipos de escopo:
64 Java Magazine Edio 101
compile o escopo padro e ser sempre utilizado caso a
propriedade no seja definida. As dependncias estaro dispo-
nveis em todos os ambientes do projeto;
provided A dependncia estar disponvel em tempo de
compilao, no entanto, ser fornecida externamente em tempo
de execuo. Ou seja, no precisar ser empacotada junto com
o projeto;
r untime Semelhante ao provided, a dependncia no
necessria em tempo de compilao, somente em execuo;
test Indica que a dependncia estar disponvel apenas
durante a compilao e execuo dos testes. Um exemplo
interessante a utilizao de bibliotecas de mock, utilizadas
apenas pelos testes, no entanto, desnecessrias para o resto do
projeto.
Listagem 3. Configurao do escopo da dependncia no arquivo pom.xml.
<Project xmlns=http://maven.apache.org/POM/4.0.0 xmlns:xsi=
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation=http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd>
<modelVersion>4.0.0</modelVersion>
<groupId>br.com.rodrigobranas</groupId>
<artifactId>ProjetoJavaMagazine</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>ProjetoJavaMagazine</name>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
Ciclo de vida
O Maven possui um ciclo de vida bem definido para gerenciar
as fases de construo de um projeto. Todas as etapas do ciclo
so executadas com base nas configuraes feitas no pom.xml
do projeto.
O ciclo de vida, utilizado para realizardesde a compilao at
a implantao do projeto, define as seguintes etapas:
validate Verifica se o projeto est correto e se todas as infor-
maes necessrias esto disponveis;
compile Compila o cdigo fonte do projeto;
t est Testa o cdigo fonte compilado com base em um
framework de testes;
package Empacota o cdigo compilado no formato especificado;
integration-test Processa e implanta o pacote em um am-
biente onde possvel executar testes de integrao;
verify Executao processo de validao do pacote com base
em critrios de qualidade;
install Instala o projeto no repositrio local para ser utilizado
como dependncia em outros projetos;
deploy Executa o procedimento de implantao do projeto
no servidor.
 Por exemplo, para executar o processo de compilao de um
determinado projeto, basta executar o seguinte comando (a partir
do diretrio raiz do projeto):
mvn compile
Em seguida o Maven ir compilar todo o cdigo fonte do pro-
jeto, buscando dependncias caso necessrio e disponibilizando
o cdigo compilado dentro do diretrio target/classes, conforme
mostrado na Figura 4.
Figura 4. Detalhes do diretrio target, gerado aps a compilao
Um detalhe importante que as etapas so executadas em se-
quncia, ou seja, caso seja executada a etapa de deploy, todas as
anteriores a ela tambm sero executadas pelo Maven.
Outro exemplo interessante o processo de empacotamento do
projeto, que realizado atravs do comando:
mvn package
Observe na Figura 5 o arquivo empacotado no formato JAR. O nome
dele foi gerado com base no artifactId juntamente com o version.
Figura 5. Detalhes do projeto empacotado dentro do diretrio target aps o processo de
empacotamento
Limpando o projeto
O Maven tambm define um ciclo de vida de limpeza que uti-
lizado para apagar o diretrio target, excluindo as classes e testes
compilados juntamente com os pacotes gerados durante o ciclo
de vida principal. Para isso, utilizamos o comando:
mvn clean
Esse ciclo pode ser executado inclusive em conjunto com etapas
do ciclo de implantao.Por exemplo, para executar o processo de
limpeza e implantao do projeto, invoque o comando:
mvn clean deploy
Criando a documentao do projeto
Outra funcionalidade interessante do Maven a possibilidade de
gerar documentao a partir de definies e configuraes feitas
no projeto. Essas definies no sero abordadas neste artigo, no
entanto extremamente interessante estudar esses recursos para
automatizar tambm etapas de documentao do projeto.
Para executar o ciclo de vida de criao da documentao do
projeto basta executar o comando abaixo:
mvn site
Deste modo o Maven ir disponibilizar a documentao dentro
do diretrio target/site.
Integrao com o Eclipse
Para integrar um projeto criado pelo Maven com o Eclipse
necessrio ter os arquivos de configurao .project e .classpath.
Eles so utilizados pelo Eclipse para identificar adequadamente
o projeto e ainda disponibilizar corretamente suas dependncias
para que o processo de compilao funcione corretamente. Esses
arquivos podem ser gerados com a utilizao do comando:
mvn eclipse:eclipse
Aps a execuo os arquivos so criados e o projeto estar pronto
para ser importado dentro do Eclipse. Um detalhe importante
gerar novamente esses arquivos sempre que houver qualquer
atualizao de dependncia no pom.xml. Isso faz com que o Eclipse
reconhea corretamente as dependncias recm-includas, caso
contrrio, ele no conseguir compilar o projeto adequadamente.
Qual o problema com a qualidade do cdigo?
Escrever cdigo com baixa qualidade, de forma ilegvel e bagun-
ada pode at funcionar! No entanto, esse tipo de atitude, seja ela
consciente ou no, resulta na contrao de uma dvida que cobra
juros altos, pagos com a perda constante de produtividade. Essa
perda pode ser observada na Figura 6.
Com o tempo, os custos de desenvolvimento e manuteno do
projeto aumentam, ficando cada vez mais caro e demorado criar
novas funcionalidades e realizar qualquer tipo de modificao,
sem falar na quantidade de defeitos.
Edio 101 Java Magazine 65
Maven 3, Sonar e Hudson

capazes de ajudar toda a equipe a identificar falhas e evitar o

acmulo de dbito tcnico.
Tornar visvel mtricas como cobertura de testes, complexi-
dade, violaes de boas prticas, duplicao de cdigo, nvel de
comentrios, entre outras informaes pode ajudar a criar uma
cultura onde as pessoas se preocupam e lutam para manter nveis
saudveis de qualidade.
Na Figura 7, temos o dashboard do Sonar e o tipo de informaes
que podemos visualizar durante todo o tempo.
Figura 6. Evoluo da produtividade ao longo do tempo

Esse tipo de problema pode trazer prejuzos financeiros e at

afetar a imagem da empresa no mercado. Outro reflexo negativo
a rotatividade da equipe, que em muitos casos acaba desistindo do
projeto por no aguentar mais a presso e o ambiente catico.
Muitas vezes, a melhor opo realmente acaba sendo jogar tudo
fora e fazer novamente.

A importncia do profissionalismo
Nos tempos de faculdade, a principal preocupao dos jovens
aspirantes a desenvolvedores de fazer com que o software pedido
pelo professor simplesmente funcione, no importando a qualida-
de do cdigo, seu desempenho ou mesmo durabilidade.
J no mercado de trabalho, absurdo que desenvolvedores
profissionais tenham a mesma postura. A iluso do imediatismo
a principal causa da mortalidade de projetos de software que
poderiam ter mais sucesso se critrios mnimos de qualidade
fossem adotados. Figura 7. Dashboard do Sonar
Em 1982, James Q. Wilson e George L. Kelling escreveram
um famoso artigo chamado Janelas Quebradas que dizia o
seguinte: Processo de Instalao
Pense em um edifcio com apenas algumas janelas quebradas. Como no podia deixar de ser, o processo simples. Basta
Se as janelas no forem reparadas, a tendncia para que vndalos fazer o download da ltima verso do Sonar em http://www.
quebrem mais janelas. Eventualmente, podero inclusive entrar sonarsource.org/downloads/ e descompactar no diretrio de sua
no edifcio, e se este estiver desocupado, pode ser tomado ou at preferncia.
mesmo incendiado. Aps esse procedimento, s iniciar o Sonar executando o
No desenvolvimento de software, a teoria das janelas quebradas arquivo StartSonar.bat para os usurios da plataforma Windows
pode ser entendida de uma forma at pior.Se o cdigo est ruim, ou Sonar.sh para outras plataformas. Em seguida, o servidor web
o projeto no tem testes, as excees no so tratadas da forma interno do Sonar ser iniciado e poder ser acessado em http://
correta, a tendncia que as pessoas no tenham a mnima von- localhost:9000.
tade de melhorar e simplesmente continuam programando da
mesma forma, agravando ainda mais a situao. Utilizando o Sonar pela primeira vez
Em meio a esse cenrio o Sonar fundamental pois fornece At que ponto chega a simplicidade? Apenas digitando o co-
visibilidade a todos sobre a qualidade do cdigo que est sendo mando abaixo j ser possvel se conectar ao Sonar e executar a
produzido! verificao de qualidade:

Descobrindo o Sonar mvn sonar:sonar

Em um submarino, para detectar a presena de inimigos, mesmo

que escondidos na imensido do oceano, o uso de um sonar fun-
damental. No mundo do desenvolvimento de software tambm.
No entanto, nesse caso, o inimigo outro!
O Sonar uma ferramenta open source dedicada ao controle e
medio da qualidade do cdigo. Funcionando de maneira inte-
grada ao Hudson, ela possibilita fornecer continuamente mtricas
Aps a verificao de qualidade ser possvel visualizar as
mtricas recolhidas em http://localhost:9000.
Mtricas de cdigo
O Sonar capaz de fornecer uma srie de mtricas que revelam
diversos detalhes importantes sobre a situao tcnica do projeto.

66 Java Magazine Edio 101

Com a anlise dessas mtricas possvel
descobrir pontos importantes de melhoria
para a reduo do dbito tcnico, manten-
do o projeto saudvel e manutenvel.
importante conhecer alguns dos prin-
cipais indicadores do Sonar:
C obertura de testes (Code Coverage):
Revela o ndice de cobertura de testes
existente no projeto. Quanto mais alto,
mais confiana e segurana teremos para
fazer alteraes no cdigo sem ter medo
de introduzir novos bugs;
Complexidade (Complexity): A Comple-
xidade Ciclomtica, tambm conhecida
como mtrica de McCabe, representa o
quanto um mtodo se torna complexo con-
forme aumenta a quantidade de estruturas
de controle de fluxo como ifs, fors, whiles
entre outras. Quanto mais alto, mais difcil
ser entender e dar manuteno;
Duplicaes (Duplications): Representa o
nvel de duplicao de cdigo existente no
projeto. Normalmente, esse nmero pode
ser melhorado com o aumento do reuso
das funcionalidades;
Comentrios (Comments): Mostra a
quantidade de comentrios existentes no
projeto;
Violaes (Violations): Nmero de viola-
es de regras ocorridas dentro do cdigo.
Esse nmero calculado com base na
utilizao de plugins como o Checkstyle,
PMD e Findbugs e pode ser configurado
de acordo com as necessidades do projeto.
uma importante fonte de informaes
que pode determinar onde o cdigo pode
ser melhorado.
Integrao Contnua com o Hudson
O processo de integrao contnua
fundamental para detectar a ocorrncia de
inconsistncias no momento da integrao
do cdigo produzido pela equipe. Anteci-
paresses problemas por meio da execuo
de testes em um ambiente de integrao
importante para proporcionar e garantir um
feedback de qualidade para os clientes.
O funcionamento simples. O servidor
de integrao fica constantemente tentan-
do baixar atualizaes do cdigo fonte no
repositrio (SVN, CVS ou Git) e assim que
consegue inicia o processo de integrao.
Com base em uma ferramenta como o Ma-
Figura 8. Tela inicial do Hudson. Detalhe para o link de Nova Tarefa
ven, o ciclo de vida executado passando
por etapas como compilao, execuo
dos testes, empacotamento e por fim a
implantao em um servidor de testes ou
homologao caso todas as etapas sejam
completadas com sucesso.
Caso algum problema ocorra, os desen-
volvedores so notificados imediatamente
e tm a oportunidade de eliminar erros
recm-inseridos, aumentando a qualidade
do produto final.
Hudson, muito prazer!
O Hudson um servidor de integrao
contnua de cdigo aberto e escrito em
Java, extremamente fcil de instalar e
configurar e ainda com uma disponibili-
dade grande de plugins. Ele tem suporte
a diversos tipos de repositrios de cdigo
fonte como SVN, CVS e Git e tambm a
ferramentas como Ant e Maven. Por esses
motivos o Hudson est se tornando cada
vez mais famoso e utilizadoentre os de-
senvolvedores.
Processo de Instalao
Baixe a ltima verso diretamente do site
do Hudson (http://hudson-ci.org/), dentro
da seo de downloads.Para instalar o
Hudson necessrio ter disponvel um
servidor Apache Tomcat ou similares.
Feito isso, basta copiar o arquivo de
distribuio do Hudson (Hudson.war)
para dentro da pasta de webapps, no caso
do Apache Tomcat, ou seguir o processo
padro de implantao de aplicativos do
servidor de aplicao escolhido.
Aps esse procedimento, basta acessar o
contexto /hudson dentro do servidor e a tela
de inicializao do Hudson aparecer.
Configurando um projeto no Hudson
O Hudson trabalha com o conceito de
tarefa para realizar o procedimento de
construo do projeto. As tarefas so se-
melhantes a receitas de bolo e nelas esto
configurados todos os detalhes que permi-
tem ao Hudson saber exatamente quando
e como fazer para construir um projeto em
um determinado ambiente.
O processo de configurao iniciado
por meio do link Nova Tarefa, como apre-
sentado na Figura 8.
Aps clicar em Nova Tarefa ser neces-
srio definir o tipo de projeto desejado.
Entre as opes de configurao dispo-
nveis, conforme descrito na Figura 9, foi
selecionada a opo de Construir um projeto
Maven 2/3 por ser mais simples quando
o objetivo configurar um projeto que
utilize apenas o Maven. Para os casos
onde seja necessrio um nmero maior
de configuraes, diferentes ambientes e
plataformas, mais recomendado que seja
escolhida a opo de Construir um projeto
com mltiplas configuraes.
Agora vamos configurar as proprie-
dades principais do projeto, conforme
mostrado na Figura 10, como o reposi-
trio de cdigo fonte,e o projeto estar
Edio 101 Java Magazine 67
Maven 3, Sonar e Hudson
Figura 9. Tela de configurao inicial do projeto
Figura 10. Detalhes da tela de configurao do projeto
Figura 11. Tela principal do Hudson
Figura 12. Tela de gerenciamento do Hudson
68 Java Magazine Edio 101
pronto para ser integrado continuamente
pelo Hudson.
Com a configurao finalizada ser
possvel iniciar o processo de construo
do projeto. Para isso, ser necessrio clicar
no link Construir Agora, como pode ser ob-
servado na Figura 10, no menu de opes
disponveis para o projeto.
Na Figura 11 possvel visualizar deta-
lhes importantes como o momento da lti-
ma construo de sucesso e de fracasso.
Integrando o Hudson com o Sonar
J vimos como utilizar o Sonar por meio
do Maven e agora a hora de aprender a
configurar o Sonar para ser utilizado em
conjunto com o Hudson. Dessa forma ser
possvel manter as estatsticas sobre a qua-
lidade do cdigo sempre atualizadas (aps
cada construo do projeto). Para realizar
essa integrao ser necessrio instalar o
plugin do Sonar. O primeiro passo, por-
tanto, entrar na tela de gerenciamento
do Hudson, como indicado na Figura 12,
clicando no link Gerenciar Hudson e em
seguida entrar na tela de gerenciamento
de plugins, por meio do link Gerenciar
Plugins.
Na guia de plugins disponveis, sele-
cione o checkbox Sonar plugin (verifique
a Figura 13) e depois clique no boto Ins-
talar, localizado no canto inferior direito
da tela.
Aps o Hudson realizar a atualizao dos
plugins ser necessrio reiniciar o servidor
de aplicao e configurar a integrao no
projeto.
Configurando o Sonar no projeto
Na tela de configuraes do projeto
existem outras configuraes disponveis,
taiscomo: ativar notificaes por e-mail;
definir a periodicidade da construo do
projeto; e uma das funcionalidades mais
importantes para a construo do nosso
ambiente gil, a integrao com o Sonar.
Para ativar a integrao, basta selecionar o
checkbox Sonar dentro do grupo de Aes-
Ps-Construo, conforme a Figura 14.
Pronto! Agora s ac e s sa r htt p://
localhost:9000 e observar as informaes
atualizadas pelo servidor de integrao
contnua.
Concluso
Este artigo apresentou como utilizar o
Maven para realizar a gesto de configura-
o do projeto e automatizar importantes
atividades, muitas vezes trabalhosas, do
nosso dia-a-dia de trabalho. Para estimular
o aumento da qualidade e ganhar segu-
rana no cdigo, vimos que o Sonar pode
ser um grande aliado na difcil tarefa de
encontrar problemas no cdigo que antes
acabavam ficando esquecidos, aumen-
tando o dbito tcnico do projeto e ainda
podendo causar muitas dores de cabea
no futuro. Para integrar tudo e manter a
casa sempre em ordem, o Hudson atua
como um integrador, executando todo o
Figura 13. Tela de plugins disponveis
processo de construo e validao do
projeto constantemente, mostrando para
a equipe os problemas no momento em
que acontecem, evitando que eles cheguem
at o cliente.
Este um grande passo rumo criao
de um ambiente mais gil, capaz de evitar
que as pessoas permaneam na zona de
conforto e se sintam sempre estimuladas
a melhorarem continuamente a qualidade
do software que esto produzindo.

Rodrigo Branas
rodrigo.branas@gmail.com
Formado em Computao na UFSC
e MBA em Gesto de Projetos na
FGV, atua no mercado de desenvol-
vimento de softwareh 10 anos, se Figura 14. Ativando a integrao entre o projeto configurado no Hudson e o Sonar
especializando em projetos baseados na arquitetura
Java. Possuias certificaes SCJA, SCJP, SCJD, SCWCD
e SCBCD e PMP. Atualmente trabalha como consultor
na rea de desenvolvimento de software e tambm http://maven.apache.org/
instrutor das Academias Java e Agile da Globalcode, Site oficial do Maven.
onde j acumula cerca de 1.000 horas em sala de aula. http://www.sonarsource.org/
Para mais informaes, visitewww.rodrigobranas.com.
Site oficial do Sonar.
br ou siga no twitter @rodrigobranas.
http://hudson-ci.org/
Site oficial do Hudson.
D seu feedback sobre esta edio! Feedback
eu http://visaoagil.wordpress.com/2009/01/06/
s

A Java Magazine tem que ser feita ao

D

seu gosto. Para isso, precisamos saber melhoria-continua-e-efetiva-atraves-do-

sobre e

o que voc, leitor, acha da revista! hansei-e-kaizen/

s

ta
PIMENTEL, MEDEIROS - Blog Viso gil
edio

D seu voto sobre este artigo, atravs do link: Melhoria contnua efetiva atravs do
www.devmedia.com.br/javamagazine/feedback Hansei e Kaizen.

Edio 101 Java Magazine 69

 Seo Engenharia de Software: Nesta seo voc encontra artigos relacionados a anlise, modelagem,
Processo de Teste de Soft
Garantindo mais qualidade com a implant
A Resumo DevMan
o contrrio do que muitos ima-
ginam, testar um software vai
muito alm de executar testes
explorando as funcionalidades de um
sistema j desenvolvido. Na realidade,
para que seja possvel avanar diante
desse estigma, o primeiro obstculo a ser
enfrentado fazer com que o Processo de
Teste e o Processo de Desenvolvimento
sejam executados em paralelo, desde o
incio do ciclo de vida do software.
Um Processo de Teste de Software tem
como objetivo estruturar as etapas, as
atividades, os artefatos, os papis e as
responsabilidades do teste, permitindo
organizao e controle de todo o ciclo do
teste, minimizando os riscos e agregando
valor ao software.
A estrut urao do processo tem o
propsito de reduzir o nmero de er-
ros apresentados no projeto. Mas para
que isso seja possvel, a definio dos
objetivos do teste deve ser bem clara, as
melhores tcnicas devem ser seleciona-
das, e uma equipe de pessoas treinadas
e qualificadas deve estar apta para de-
sempenhar os respectivos papis dentro
do processo.
Aps estruturar os objetivos, o prximo
passo implantar o processo. A implan-
tao permite que o teste deixe de ser
tratado como uma atividade secundria,
passando a ser um processo prprio, con-
dutor do fluxo das atividades do teste e
gerador de artefatos que tornam possvel
a avaliao da qualidade do software.
Neste contexto, apresentaremos nesse
artigo as principais fases do ciclo de vida
do Processo de Teste, com os referentes
artefatos gerados por cada uma delas.
Abordaremos tambm a hierarquia e
a definio dos papis envolvidos no
teste, com suas respectivas responsabi-
lidades. Por fim, sero listadas algumas
70 Java Magazine Edio 101
De que se trata o artigo:
Explicar como a utilizao de um Processo de Teste pode melhorar a efetividade dos testes, controlando
as atividades e garantindo mais credibilidade e valor ao produto.
Em que situao o tema til:
Para evitar que o teste seja uma mera etapa do ciclo de desenvolvimento, a implantao de um pro-
cesso relacionado a este garante um maior controle das atividades de teste e, consequentemente, mais
qualidade ao software.
Processo de Teste de Software:
Nesse artigo apresentamos o Processo de Teste de Software com as suas principais etapas e respectivos
artefatos gerados. Abordamos tambm os papis e as responsabilidades de cada membro da equipe
envolvida. Por fim, citamos algumas boas prticas que podem contribuir para obter sucesso na utilizao
de um Processo de Teste.
prticas que podem contribuir para a Conforme indicado na Tabela 1, a exe-
melhoria do software com a implantao cuo de cada etapa do ciclo de vida tem
do processo. um tempo estimado de durao. Assim,
recomendvel seguir essa estimativa para
Ciclo de Vida do Processo de Teste que seja possvel executar todas as fases
O ciclo de vida consiste em uma srie do processo, minimizando riscos e conse-
de etapas dependentes, consideradas quentemente garantindo mais qualidade
como o esqueleto do Processo de Teste, ao software.
que visam estruturar as atividades defi- A seguir, sero apresentadas as princi-
nindo como os testes sero conduzidos pais etapas do ciclo, juntamente com as
no projeto. suas respectivas responsabilidades dentro
Essas etapas podem variar de acordo do Processo de Teste:
com a metodologia utilizada, e con- a) Planejar: esta a atividade inicial do
forme apresentado na Figura 1, sero processo, onde definido o objetivo dos
demonstradas nesse artigo as principais testes, registrado atravs do artefato Plano
etapas do ciclo de vida de um processo de Teste. Essa etapa tambm responsvel
de teste. pela identificao das tcnicas de teste
que sero aplicadas ao projeto, como por
exemplo:
Teste de Conformidade;
Teste de Contingncia;
Teste de Desempenho;
T este de Estresse;
Teste de Funcionalidade;
Teste de Integrao;
Teste de Regresso;
Figura1. Ciclo de Vida do Processo de Teste de Software Teste de Segurana;
projeto, testes, entre outros temas relacionados a ES

A elaborao de um processo

ware
prprio estrutura as
atividades e impede que o
teste seja tratado como uma
etapa secundria do projeto
ao de um novo processo
Renata Eliza e Vivian Lagares

Etapa Do Processo de Teste Distribuio do Tempo Estimado
Planejar Testes 10%
Projetar Testes 40%
Executar Testes 45%
Entregar 5%
Tabela 1. Estimativa de tempo para cada etapa do ciclo
Durante o Planejamento so executadas as seguintes atividades:
D efinio do Escopo dos Testes;
D efinio dos Mtodos e Tcnicas de Teste;
Planejamento das Atividades de Teste;
Planejamento do Ambiente de Testes;
D esignao dos Recursos envolvidos no Teste;
D efinio dos Riscos do Projeto de Teste;
Definio das mtricas para monitorar e controlar os Testes.
b) Projetar: depois de realizado o planejamento, o prximo passo
colocar em prtica tudo que foi especificado. o momento de
projetar os Casos de Teste, Roteiros de Teste e Procedimentos de
Teste do Software.
Durante a segunda etapa do ciclo so executadas as seguintes
atividades:
I dentificao dos requisitos planejados;
Elaborao (e reviso) dos Casos de Teste;
Elaborao dos Scripts de Teste;
Preparao do Ambiente de Teste;
Preparao da Gesto de Defeitos;
Refino das Estimativas de Teste;
Preparao da Massa de Teste;
Acompanhamento dos riscos do projeto de Teste.
c) Executar: o objetivo dessa fase colocar em prtica tanto o que
foi planejado quanto o que foi projetado no processo. o momento
de executar os testes. Um cuidado especial deve ser tomado antes
de iniciar essa etapa. preciso verificar se o ambiente est propcio
e estvel, para que a execuo dos testes seja possvel.
Conforme programado nas primeiras etapas do ciclo, utilizar
uma ferramenta de Gesto de Defeitos durante a execuo dos
testes fundamental. Afinal, ela possibilitar o registro coerente
dos problemas encontrados, condizentes com a sua categoria
(melhoria, erro ou sugesto), prioridade (baixa, normal ou
urgente) e claro, gravidade (trivial, mdia ou obstculo). Alm
disso, a Gesto de Defeitos proporcionar uma visualizao
completa de todo o escopo do projeto, permitindo que sejam
extrados indicadores e rastreadas todas as mudanas aplicadas
ao software.
Durante a terceira etapa do ciclo so executadas as seguintes
atividades:
Execuo dos Casos de Teste;
Execuo dos Scripts de Teste;
G esto de Defeitos;
Atualizao da Massa de Teste;
Avaliao do Plano de Teste;
Avaliao dos Resultados do Teste;
Formalizao da Evidncia dos Testes.
d) Entregar: o objetivo da ltima etapa assegurar que os testes
foram executados conforme projetado, permitindo assim que o
sistema esteja apto para entrega e garantindo que os objetivos
planejados foram alcanados.
Essa etapa conta com a participao direta do cliente, que tem a
funo de executar os testes de aceitao, validando se o que foi
desenvolvido realmente atende ao que foi solicitado.
Nesse momento provavelmente surgiro defeitos, fazendo com
que seja necessrio continuar utilizando a ferramenta para con-
trole de bugs. A Gesto de Defeitos nessa fase permitir que os
problemas encontrados pelo cliente sejam analisados e corrigidos
por prioridade.
Durante a ltima etapa do ciclo so executadas as seguintes
atividades:
Elaborao e Anlise dos Indicadores de Teste;
Elaborao do Sumrio de Teste;
Entrega do Sistema para o Cliente;
A poio ao Cliente na Execuo dos Testes de Aceitao;
Gesto de Defeitos;
Momento de aprendizado para utilizar o conhecimento adqui-
rido em novos projetos.
Artefatos
Os artefatos so produzidos durante a execuo das respectivas
etapas do ciclo de vida do processo, com o propsito de registrar
e acompanhar a evoluo do projeto, e inclusive verificar se os
resultados obtidos esto de acordo com o que foi especificado.
A Figura 2 destaca os principais artefatos gerados por todas as
etapas apresentadas do processo: Planejar, Projetar, Executar e
Entregar.
a) Planejar: a primeira fase do ciclo gera como artefato o Plano
de Teste. Vejamos uma anlise sobre ele:

Edio 101 Java Magazine 71

Processo de Teste de Software
Figura 2. Artefatos de um Processo de Teste de Software
Plano de Teste: o documento que define o nvel de cobertura,
completo ou reduzido, que dever ser alcanado pelos testes. Tem
como finalidade fornecer uma viso geral do projeto, contendo as
diretrizes que possibilitaro a execuo do Processo de Teste. Ele
responsvel pela definio de todo o escopo dos testes, possibi-
litando que os mesmos possam ser repetidos e controlados.
Esse artefato representa todo o planejamento para a execuo do
teste, incluindo os recursos (pessoas, software, hardware), estratgias,
cronograma das atividades e as funcionalidades que sero testadas.
Ao passar dos anos algumas normas surgiram com o objetivo
de definir padres para a documentao de um Plano de Teste,
estipulando a estrutura e as sees que este artefato deve conter,
por exemplo: QAI, PMBOK e IEEE829. A mais utilizada a norma
IEEE829, que possui as sees relacionadas na Tabela 2.
Sees da Norma IEEE829
1) Identificador 6) Introduo 11) Itens de Teste
2) Features a testar 7) Abordagem 12) Critrios de Liberao
3) Critrios de Suspenso 8) Entrega do Teste 13) Tarefas do Teste
4) Ambiente 9) Responsabilidades 14) Treinamentos
5) Cronograma 10) Risco e Contingncia 15) Aprovao
Tabela 2. Sees da Norma IEEE829
Para elaborar um Plano de Teste, verifique as sees sugeridas
pelas normas e guias, e monte o modelo que mais se enquadra s
necessidades do seu projeto.
b) Projetar: a fase onde testes so criados, sendo responsvel
pela gerao dos artefatos discutidos a seguir:
C asos de Teste: um conjunto de entradas, sadas e resultados
esperados que tem como objetivo identificar as condies que
sero verificadas e validadas no projeto. Em outras palavras, o
artefato que estabelece o que ser testado no software.
Os Casos de Teste so utilizados basicamente para listar um nme-
ro adequado de testes que englobem as principais funcionalidades
do software, e possuem basicamente a seguinte estrutura:
- Ttulo: nome sucinto que define o que ser executado no Caso
de Teste;
- Pr-Condio: estado obrigatrio do sistema antes do incio
do teste. Isto , o que precisa ser realizado para que seja pos-
72 Java Magazine Edio 101
svel colocar em prtica os Passos e chegar ao Resultado
Esperado;
- Passos: so as aes que devero ser executadas para verificar
se o software cumpre com o que foi especificado;
- Resultado Esperado: o resultado que se deseja obter ao final
da execuo dos passos do Caso de Teste.
Massa de Teste: um conjunto de valores inserido na base de
dados que propicia um ambiente apto para a execuo dos testes.
Esta massa pode ser inserida manualmente ou automaticamente,
atravs da utilizao de scripts de carga;
Roteiro de Teste: formado pela organizao de um ou mais
Casos de Teste que devem ser executados em uma sequncia
lgica. recomendvel que para cada Especificao de Caso de
Uso um roteiro seja elaborado. Alm disso, cada Caso de Teste
representado no Roteiro de Teste deve exibir o seu respectivo Re-
sultado Esperado, para que o testador confronte com o resultado
obtido na execuo dos testes.
c) Executar: durante a execuo da terceira fase do ciclo de vida
do processo so gerados os artefatos Relatrio de Bugs e Resultado
do Teste, detalhados a seguir:
Relatrio de Bugs: utilizado para registrar qualquer ocorrn-
cia no projeto de teste que requeira algum tipo de investigao.
O uso mais comum desse relatrio para controlar os defeitos
ocorridos durante os testes, e deve ser encaminhado para a equipe
de desenvolvimento tomar as providncias cabveis;
Resultado do Teste: utilizado para a formalizao dos resul-
tados obtidos na execuo dos testes a cada iterao do ciclo de
desenvolvimento do sistema.
d) Entregar: na ltima etapa do ciclo, as informaes relevantes
extradas durante a execuo dos testes so armazenadas atravs
do artefato comentado a seguir:
Sumrio de Teste: este artefato organiza e apresenta uma anlise
resumida dos Resultados do Teste, juntamente com as principais
medidas para reviso e avaliao do projeto. Normalmente esse
relatrio finaliza os testes.
Durante a execuo das atividades do Processo de Teste, os
artefatos produzidos devem ser armazenados em um repositrio
nico, acessvel a todos os envolvidos no projeto. Isso possibilitar
um acompanhamento da evoluo dos trabalhos realizados por
todos os participantes da equipe testes.
Papis
A rea de Teste de Software possui nomenclaturas definidas para
os principais papis envolvidos no Processo de Teste, como pode
ser verificado na Figura 3. Os papis tm a funo de organizar
as responsabilidades de execuo de cada atividade, alm de
definir quem ir gerar os artefatos do teste. No entanto, para que
seja possvel colocar em prtica todas as atividades do processo,
importante levar em considerao as habilidades exigidas por
cada um. Faamos uma anlise sobre eles:
Gerente de Teste: o responsvel por todos os assuntos rela-
cionados ao Teste de Software. Normalmente quem define a
poltica de teste adotada na organizao, incluindo planejamento,
documentao, controle e monitoramento dos testes, aquisio de
ferramentas, participao em inspees e revises do trabalho de
teste. Para exercer esse papel algumas caractersticas so funda-
mentais, como por exemplo:
- Bom conhecimento dos aspectos do Processo de Teste de
Software;
- Habilidades de planejamento e gerenciamento de atividades.
funo inicial da hierarquia do teste. ele quem elabora os Casos
de Teste que sero executados pelo Testador. Em alguns casos,
pe a mo na massa e executa os testes. Para exercer esse papel
algumas caractersticas so fundamentais, como por exemplo:
- Boa capacidade de visualizar, articular e resolver problemas;
- Conhecimento em falhas comuns em softwares.
Testador: tambm conhecido como Homologador ou Tester, o
profissional que tem como responsabilidade principal executar os
testes planejados pelo Analista de Teste e, se for o caso, reportar os
erros encontrados. Para exercer esse papel algumas caractersticas
so fundamentais, como por exemplo:
- Conhecimento das abordagens e das tcnicas de teste;
- Capacidade para diagnosticar e resolver problemas.

A definio dos papis bem clara, mas vlido frisar que os pa-
pis do Teste de Software so adaptveis realidade das empresas.
Alm disso, apesar de no ser recomendvel, no existe objeo
para que uma pessoa assuma mais de um papel no projeto.

Figura 3. Hierarquia dos Papis do Processo de Teste de Software
Lder de Teste: tambm intitulado Coordenador de Teste, o
profissional responsvel pela organizao dos testes. ele quem
estima os esforos, os recursos e o tempo de teste. tambm quem
cria e mantm o artefato Plano de Teste e atribui as tarefas para
os demais membros da equipe. Para exercer esse papel algumas
caractersticas so fundamentais, como por exemplo:
- Experincia em liderana e vasto conhecimento sobre tcnicas
e ferramentas de teste;
- Habilidades interpessoais, principalmente diplomacia e defesa.
Arquiteto de Teste: tambm chamado de Engenheiro de Teste,
responsvel pela criao e manuteno de toda a infraestrutura
de teste, que inclui o ambiente, a arquitetura e as ferramentas.
Para exercer esse papel algumas caractersticas so fundamentais,
como por exemplo:
- Capacidade em diagnosticar e resolver problemas do ambiente;
- Conhecimento sobre a instalao e configurao das ferramen-
tas voltadas para o Teste.
Automatizador: conhecido tambm como Analista de Teste
de Automao, quem transforma os Casos de Teste elaborados
pelo Analista de Teste em scripts automatizados. Alm de auto-
matizar os testes funcionais, tambm responsvel pelos testes
de desempenho, performance e carga. Para exercer esse papel
algumas caractersticas so fundamentais, como por exemplo:
- Domnio sobre linguagens de programao;
- Conhecimento de diversas tcnicas e tipos de teste.
Analista de Teste: tambm intitulado Analista de Homologao
ou Projetista de Teste, tem como premissa ser mais experiente que
o Testador, ou seja, chega a ser primordial que tenha exercido a
Responsabilidades
A definio das responsabilidades de execuo das atividades
de teste vem logo aps a seleo dos papis participantes do ciclo
de vida do processo. O objetivo determinar as atribuies de
cada componente da equipe.
Essa estruturao permite que as atividades estejam bem dividi-
das entre o time do teste. A Tabela 3 lista a matriz de responsabi-
lidades de acordo com cada papel do Processo de Teste.
Papel Responsabilidade
- Executar os Casos de Teste
Testador - Registrar os bugs
- Elaborar o relatrio dos defeitos encontrados
- Identificar o objetivo do teste
Analista de
- Elaborar os Casos de Teste e o Roteiro de Teste
Teste
- Preparar a Massa de Teste
Automatiza-
- Elaborar os Scripts de Teste
dor
- Definir e manter a Arquitetura de Automatizao dos Testes
Arquiteto de
- Identificar os mecanismos de Testabilidade
Teste
- Preparar e manter o Ambiente de Teste
- Elaborar o Plano de Teste
Gerente de - Assegurar o Gerenciamento e o Planejamento apropriados
Teste para os testes
- Elaborar o Sumrio de Teste
Tabela 3. Matriz de Responsabilidades dos Papis do Processo de Teste
Uma grande vantagem de atribuir a responsabilidade a cada papel
evitar incertezas na execuo das atividades por parte dos envolvidos.
Pensando nisso, a Tabela 4 apresenta a responsabilidade de cada
papel distribuda pelas fases do ciclo de vida do Processo de Teste.
Ademais, para que seja possvel obter sucesso, a equipe envolvida
nos Testes deve ser devidamente capacitada para exercer a funo
definida. A competncia tcnica precisa ser avaliada e determinada
de acordo com o nvel e a complexidade do projeto. Caso contrrio,
poder impactar negativamente no resultado final do processo.

Edio 101 Java Magazine 73

Processo de Teste de Software
Etapas
Papel
Planejar Projetar Executar
Testador Apia Apia Executa
Analista Apia Executa Executa
Automatizador Apia Executa Executa
Arquiteto Executa Executa Apia
Gerente Executa Apia Apia
Tabela 4. Papis responsveis pela execuo das etapas
Melhores Prticas
Determinadas prticas so consideradas boas ou at mesmo mais
teis que outras, no entanto, essa definio depende diretamente do
contexto do projeto. Em funo disso, visando melhoria do processo,
a busca pelas melhores prticas deve ser contnua e permanente.
Para exemplificar, foram selecionadas algumas boas prticas j
carimbadas no mercado de teste que podem ser teis em diferentes
realidades de projeto, como demonstradas a seguir:
Checklists: ao longo de todo o Processo de Teste de Software, a
utilizao de um checklist pode trazer grandes vantagens, agre-
gando qualidade e tornando mais fcil a realizao dos testes. O
objetivo evitar o esquecimento, os erros e as falhas durante a
execuo das tarefas atribudas;
Estimativas: apesar de muitos taxarem como uma atividade
complexa de se realizar, a estimativa tem fundamental importncia
dentro do Processo de Teste. Afinal, para garantir a execuo dos
testes necessrio que haja tanto um planejamento quanto um ge-
renciamento dos mesmos. Para isso, importante que seja definida
uma estimativa mais prxima do tempo realmente necessrio para
realizao dos testes, o que ir propiciar um melhor gerenciamento
das atividades, possibilitando um maior controle do processo;
Metodologias: busque agregar a utilizao de normas, tcnicas,
modelos e metodologias no Processo de Teste. Isso ir contribuir
bastante na busca pela melhoria contnua;
Anlise de Riscos: analisar os possveis riscos do processo en-
volve a identificao das ameaas mais provveis em conjunto com
o exame das vulnerabilidades relacionadas ao software. Combina
a probabilidade de ocorrncia de uma falha com a gravidade e o
grau de prejuzos que os danos podero acarretar. Visando mi-
nimizar os possveis problemas, a utilizao da anlise de riscos
pode reduzir os custos do projeto e garantir mais qualidade ao
software, ao priorizar os testes nos pontos mais relevantes;
Gesto de Defeitos: para um bom desempenho dos testes,
um importante fator o registro e o acompanhamento dos bugs.
Porm, apenas descobrir os defeitos no suficiente, preciso
administr-los. Utilizar o gerenciamento de defeitos no Processo
de Teste possibilita que os riscos sejam minimizados, controlados,
evidenciados e o seu impacto no seja grande para o projeto;
Equipe: deixe os papis e responsabilidades claramente definidos
dentro do processo, para que cada membro do time saiba a sua fun-
o. Alm disso, lembre-se das caractersticas que um profissional de
teste deve ter. Algumas delas so fundamentais para o desempenho
de um bom trabalho. Priorize os profissionais com perfil investigador,
criativo, questionador, detalhista, proativo e comprometido;
74 Java Magazine Edio 101
Lies Aprendidas: realizar um balano geral dos testes execu-
tados, analisando as conquistas e desafios, possibilita que as lies
Entregar
aprendidas e armazenadas sejam utilizadas em projetos futuros,
Apia
Apia
evitando que os erros sejam repetidos e permitindo que os acertos
Apia sejam aprimorados, aumentando a qualidade e diminuindo os
Apia custos e os riscos do software.
Executa
Concluso
A utilizao de um Processo de Teste contribui para melhorar a
efetividade e eficincia do teste em um projeto, agregando confian-
a e credibilidade ao software. No entanto, para que seja possvel
colher esses frutos, preciso um acompanhamento prximo de
todas as fases do ciclo de vida. Pode ser que mesmo conduzindo
de perto os testes, surjam presses que impactaro diretamente no
rumo do processo implantado. Essa situao possivelmente far
com que nem todas as atividades planejadas sejam executadas. Para
amenizar o impacto na qualidade final do projeto, a anlise de riscos
e a definio de estimativas tornam-se imprescindveis.
Aprender com os erros, aprimorar os acertos, adotar uma gesto
de defeitos, ter uma equipe qualificada, utilizar tcnicas e ferra-
mentas voltadas para a necessidade do projeto, tambm so fatores C
fundamentais para obter o sucesso no processo.
M
vlido ressaltar que independente dos percalos encontrados
ao longo do caminho, a implantao de um Processo de Teste Y
contribui bastante para a melhoria do software, tornando o teste CM
organizado e controlado atravs da definio de um escopo pr- MY
prio. No entanto, para que seja possvel garantir o xito, alm de
CY
caminhar em paralelo com o ciclo de desenvolvimento, o processo
deve ser revisto continuamente. O objetivo ampliar a sua atuaoCMY
e aprimorar as lies aprendidas, possibilitando cada vez mais K
controle das atividades de teste no projeto.
Renata Eliza
renataeliza@gmail.com - @RenataEliza
Atua na rea de Teste de Software h mais de seis anos. Tecnloga em
Processamento de Dados, MBA em Teste de Software e ISTQB Certified
Tester Foundation Level. Mantm o blog www.asespecialistas.blog.com.
Vivian Lagares
vivian.lagares@gmail.com - @VivianLagares
Atua na rea de Teste de Software h mais de sete anos. Tecnloga
em Processamento de Dados, ps-graduada em Gesto de Projetos
pelo IETEC, MBA em Teste de Software e ISTQB Certified Tester Founda-
tion Level. Tambm mantm o blog www.asespecialistas.blog.com.
D seu feedback sobre esta edio! Feedback
eu
s
A Java Magazine tem que ser feita ao
D
seu gosto. Para isso, precisamos saber
sobre e
o que voc, leitor, acha da revista!
s
ta
edio
D seu voto sobre este artigo, atravs do link:
www.devmedia.com.br/javamagazine/feedback
Edio 101 Java Magazine 75