l

AJAX Avançado com GWT     a

      i
    c
    e
    p
    s
Criação de componentes e acesso a dados       E

A Revista da Comunidade Java Brasileira

Edição 39 - Ano V - R$ 9,90

 JGoodies Binding
Ligue componentes gráficos a objetos
de negócio mantendo a abstração OO

 JavaMail Aplicado Dicas na We

Webb
Criando uma mala direta em HTML Recapitulando técnicas essenciais
com anexos, fazendo personalização na programação com servlets e JSPs
através de expressões regulares

RIA com OpenLaszlo SWT com Visual XP

Torne suas aplicações gráficas mais
Crie Rich Internet Applications e traga integradas ao sistema operacional
interatividade de desktop às suas
aplicações web, com Flash, XML e Java
J ava

 JAVA EE 5
 JA Explorando a Plataforma
Conheça a fundo todas as novidades,
 Javaa Persistence
 Jav Persistence API
A nova API de persistência do EJB 3.0
de motivações a efeitos práticos – com que muda as bases do mapeamento
um tutorial no GlassFish objeto-relacional em Java

 jm39.indb 1 15/8/2006 18:11:24

 jm39.indb 2 15/8/2006 18:11:30
 jm39.indb 2 15/8/2006 18:11:30
 Conteúdo
CAFEÍNA
News & Bits 06
LEONARDO GALVÃO
Novos produtos wireles s, TestNG
TestNG 5, repositório open source do Google,
Subversive 1.0

SWT com visual nativo do XP

FERNANDO LOZANO
Faça o Eclipse e outras aplicações SWT assumirem o visual do Windows XP

    s
    e RECAPITULANDO: DICAS NA WEB
      õ
    ç
FELIPE LEME
10
    e Obtendo as versões suportadas de JSP e servlets, usando forward e redirect,
      S manipulando JavaBeans em taglibs e alterando o nome de arquivos para download

JAVA EE 5
OSVALDO PINALI DOEDERLEIN
16
Explorando a nova versão do Java corporativo: anotações, injeção de dependên-
cias, novas JSRs e um exemplo prático usando o servidor open source GlassFish

PERSISTÊNCIA NO JAVA EE 5
AVA
    a ANDRÉ DANTAS ROCHA E SÉRGIO OLIVEIRA KUBOTA
28
    p
    a Aprenda a utilizar a nova Java Persistence API, de conceitos de mapeamento
      C objeto-relacional, a um exemplo completo usando Toplink
Toplink Essentials e MySQL

AJAX AVANÇADO COM GWT

ARI DIAS NETO
38
Explore a API do Google Web Toolkit e crie novos componentes,
desenvolvendo aplicações altamente interativas com AJAX e Java

UMA MALA DIRETA COM JAVAMAIL
YARA SENGER E ANA ABRANTES
62
Utilize a API JavaMail para enviar e-mails em HTML com anexos para múltiplos
destinatários, e personalize mensagens usando expressões regulares

RIA COM OPEN LASZLO
      b ANDRÉ LUÍS MONTEIRO
70
    e Turbine suas interfaces gráficas e maximize a interatividade com o usuário
      W utilizando uma plataforma open source baseada em Flash, XML e Java

    p
    o
     t
INTERFACES GRÁFICAS COM QUALIDADE – PARTE 2
      k
    s
HUGO VIDAL TEIXEIRA
Descubra como aplicar o pattern Presentation Model e a API Binding do
50
    e JGoodies para construir GUIs com produtividade, favorecendo os testes unitários
      D
 jm39.indb 3 15/8/2006 18:12:15
 Direção
Ano V • Edição 39 • 2006 • ISSN 1676-8361
Diretor Editorial Leonardo Galvão
Diretor de Marketing Gladstone Matos
Diretor Comercial Casseano Filho
Edição
Publisher e Editor-Chefe
Leonardo Galvão (leonardo@javamagazine.com.br )
Editores-Adjuntos
Fernando Lozano (lozano@javamagazine.com.br )
Osvaldo Doederlein ( osvaldo@javamagazine.com.br )
Colaboraram nesta edição
Ana Abrantes, André Dantas Rocha, André Luís Monteiro,
C
Ari Dias Neto, Fernando Lozano, Hugo Vidal, Leonardo Galvão,
Osvaldo Doederlein, Sérgio Kubota, Yara Senger
Arte
Diretor de Arte Tarcísio Bannwart ( phdesign@phdesign.com.br )
Diagramação Jaime Peters Junior, Lais Pancote e Tersis Zonato
Ilustrações Felipe Machado e Francisco Peixoto
Capa Felipe Machado
Produção
Gerência de Marketing Kaline Dolabella
Distribuição
Fernando Chinaglia 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 dúvidas sobre serviços, enviar críticas e sugestões e falar com um
de nossos atendentes.Através da nossa central t ambém é possível 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 através do telefone 21 2283-9012.
Edições anteriores
Adquira as edições anteriores da revista Java Magazine ou de qualquer outra
publicação do Grupo DevMedia de forma prática e segura, em
www.devmedia.com.br/anteriores.
Publicidade  
 publicidade@javamagazine.com.br , 21 2213-0940
Anúncios – Anunciando nas publicações e nos si tes 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 preços e formatos de anúncios.
Reprints Editoriais – Se foi publicado na Java Magazine um artigo que
possa alavancar as suas vendas, multiplique essa oportunidade! Solicite a
reimpressão da matéria junto com a capa da edição em que s aiu, e distribua
esse reprint personalizado entre seus clientes.
Encarte de CDs – Faça como nossos maiores anunciantes.Encarte um CD
com uma amostra de seus produtos na Java Magazine e atinja um público
segmentado e formador de opinião.
Realização
Apoio
Parceiros
 jm39.indb 4
Esp
om o Java Enterprise Edition 5.0, entramos em numa nova e importante
geração do desenvolvimento corporativo. O foco na facilidade de uso, a ab-
sorção de técnicas utilizadas em produtos open source, uma participação sem
precedentes da comunidade e uma implementação de referência que já rivaliza com
os melhores servidores de aplicações... Talvez pela primeira vez na história do Java
corporativo vemos lançada uma versão que é sucesso entre as mais diversas castas
de desenvolvedores Java. O Java EE 5.0 faz grandes correções de rumo, criando novas
tecnologias que tornam obsoletas áreas problemáticas da especificação como os tão
polêmicos Entity Beans, incorpora mais do que nunca os web services, e já olha adiante
integrando-se com várias novidades que virão no Java SE 6.0 (Mustang). Quem diria
que uma especificação do JCP, envolvendo gigantes do mercado com visões e perfis
tão distintos como Sun, IBM, Oracle, BEA, Motorola, Cisco e SAP, chegaria a um con-
senso de tal solidez, criando uma especificação tão eficaz e alin hada às necessidades
do mercado? Mas foi o que aconteceu, em mais uma demonstração da efetividade do
Java Community Process e da força da comunidade Java.
Nesta edição, o Java EE 5 é tratado em dois artigos aprofundados. Em uma visão
geral da plataforma, você conhece todas as grandes novidades, com diversos exem-
plos funcionais, e ainda um tutorial mostrando como criar uma aplicação usando
uma seleção dos novos recursos da especificação, além do GlassFish, o servidor que
é a base da implementação de referência do novo Java EE. Em um segundo artigo, é
vista em detalhes a API que tem chamado mais atenção no Java EE 5, a Java Persis-
tence API (JPA). Parte da especificação do EJB 3.0, mas planejada como especificação
independente na sua próxima versão, a JPA se inspira fortemente em ferramentas
de mapeamento objeto-relacional como Hibernate e iBatis, padronizando uma área
fundamental do desenvolvimento corporativo. Você vai conhecer os fundamentos da
JPA, e criar um exemplo completo usando vários tipos de associações e herança.
 Ainda nesta edição, confira um artigo sobre desenvolvimento AJAX que explora a
API do Google Web Toolkit para criar componentes altamente interativos e integrá-
los em uma aplicação sofisticada com acesso a dados. Veja também como melhorar
suas aplicações desktop usando o pattern Presentation Model e a API JGoodies Bin-
ding, que permite vincular os seus modelos OO à interface gráfica de forma eficaz
e organizada.
Em outra matéria passo a passo, é mostrado como criar uma mala direta completa
usando a API JavaMail e expressões regulares. E mais um artigo voltado à internet
mostra como usar o OpenLaszlo para criar Rich Internet Applications, baseadas em
Flash, XML e Java. Finalmente, nesta edição retomamos a seção “Recapitulando”, dessa
vez trazendo dicas sobre o desenvolvimento com JSP e servlets; também incluímos
um artigo especial no Cafeína mostrando como fazer sua aplicação
SWT se integrar perfeitamente ao visual do Windows XP.
Boa leitura!
Leonardo Galvão
15/8/2006 18:12:21
 aço do Leitor
Diálogos modais para a área de trabalho
E  stou desenvolvendo uma aplicação Swing
usando NetBeans 5 e JDK 1.5, a qual solicita
login e senha. Ela deveria bloquear todas as janelas
da área de trabalho, só liberando-as após a autenti-
cação. Mas não consigo descobrir como configurar
um diálogo modal para a área de trabalho como
um todo, como seria possível usando Delphi ou
Visual Basic.
Eloir Cortes
Infelizmente nem o Swing nem o AWT forne-
cem o recurso conhecido como “system modal”
no Windows, que permite bloquear todas as
aplicações na área de trabalho até que o diálogo
seja fechado. Até o Java SE 5.0, é possível criar
SOA
Sou assinante da Java Magazine e gostaria
 primeiramente de parabenizá-los pela excelente
qualidade do material apresentado. Também
gostaria de saber de vocês se há possibilidade de
 publicar na revista um artigo falando sobre SOA e
web services, visto que o assunto é cada vez mais
comentado na comunidade Java.
Michel Pires da Silva
Web Services e SOA (Service-Oriented Archi-
tecture) foi um dos assuntos de capa da Java
Magazine 34. O artigo de Osvaldo Doederlein
cobriu desde as tecnologias precursoras dos web
services como RPC, até o atual enfoque na criação
de arquiteturas orientadas a serviços.
 Java EE 5
Gostaria de ver as novidades do Java EE 5 nas
 próximas edições. Afinal de contas, a especificação
 já foi aprovada , e a Java Magazine sempre nos
apresenta as novidades em primeira mão.
Michel Zanini
Esta edição atende ao seu pedido! Além de
um artigo fornecendo uma visão geral da nova
plataforma destacando as prin cipais mudanças,
você verá uma matéria sobre uma das mais
 jm39.indb 5
diálogos modais apenas com respeito à própria
aplicação que o criou. No Java 6 (Mustang),
haverá um controle mais fino sobre diálogos
modais, mas ainda assim o máximo será restringir
todas as aplicações Java na área de trabalho, não
afetando as aplicações nativas. Veja mais sobre
as mudanças em diálogos modais no Java 6 em
 java.s un.com /develo per/te chnical Artic les/J2 SE/  de “system mo-
Desktop/mustang/modality .
É possível, pelo menos no Windows, configurar
diálogos Swing como “system modal” mas isto
envolve o uso da tecnologia JNI (Java Native
Interface) para chamar funções da API nativa
do Windows (Win32 API). Lembrando que uma
aplicação usando este recurso, é claro, não seria
importantes novidades do Java EE 5: a Java
Persistence API.
Ferramentas
Parabenizo a Java Magazine pelas excelentes
edições. Sou iniciante em Java e uma das grandes
dificuldades para um iniciante é, além de aprender
a linguagem, saber utilizar as ferramentas exis-
tentes. E a Java Magazine sabe nos mostrar como
utilizar essas ferramentas de forma muito didática,
o que facilita bastante a vida dos iniciantes.
Rubens Renato Lima
Autenticação integrada no Java EE
Tenho várias aplicações Java EE e preciso que elas
trabalhem com um único login. Ou seja, quando
o usuário efetuar o login em uma das aplicações,
será necessário que todas as outras trabalhem
com essa autenticação. Existe alguma forma de
compartilhar as informações de autenticação entre
as aplicações?  comentário, correção ou
Everton Trindade
Os dois artigos “Segurança no J2EE”, publicados
nas Edições 22 e 23 respondem em detalhes à sua
pergunta. De forma resumida, se sua aplicação utili-
za os recursos de autenticação e controle de acesso
baseados em roles  definidos pelo Java EE, uma
portável. O site para desenvolvedores da Borland
tem um bom artigo explicando como fazer isso:
community.borland.com/article/0,1410,20679,00.
html .
Por outro lado,
aplicações SWT
têm o recurso
dal” disponível:
basta confi-
gurar o estilo
SWT.SYSTEM_MODAL
na criação de
um Dialog ou
de um Shell.
simples configuração do container web (no caso
do Tomcat,a ativação da válvula “SingleSignOn”) faz
com que o login em uma aplicação seja automati-
camente repassado para todas as outras aplicações
dentro do mesmo servidor de aplicações, ou do
mesmo cluster de servidores de aplicações.
As dificuldades surgem quando o desenvol-
vedor, em vez de adaptar seus programas aos
recursos de segurança previstos pelo Java EE,
cria sua própria solução “personalizada” de
autenticação. Mas não há motivos para se fugir
aos recursos padrões do Java EE, pois qualquer
servidor de aplicações com um mínimo de qua-
lidade é capaz de usar senhas armazenadas em
vários locais, como bancos de dados, diretórios
LDAP ou mesmo as senhas de rede em Windows,
Linux e Netware.
Participe!
Envie sua dúvida,
sugestão, com nome completo, cidade e
estado, para:
cartas@javamagazine.com.br
Cartas publicadas podem ser editadas por
motivos de clareza ou extensão.
Edição 39 •  Java Magazine 5
15/8/2006 18:12:31
 Cafeín
News & Bits
Nokia Carbide.j 1.5
O Carbide.j é um conjunto de ferramentas integradas voltado
à criação, depuração e testes de aplicações Java para dis-
positivos Nokia, que pode ser executado independentemente
ou de forma integrada a um IDE (são suportados o Eclipse 3.0 e
3.1, JBuilder Mobile Edition, NetBeans 4.x e 5.0, e IBM WebSphere
Studio Device Developer 5.6 e 5.7). Com o Carbide.j, você pode
criar aplicações baseadas nos perfis MIDP e Personal Profile, assi-
nar pacotes de aplicações MIDP, configurar e gerenciar SDKs da
6  Java Magazine • Edição 39
 jm39.indb 6
Nokia (há um SDK da empresa para cada série de dispositivos), e
realizar a instalação/deployment usando conexões RS232 (serial),
IrDA (infra-vermelho) e Bluetooth, assim como FTP. Há ainda um
designer de interfaces gráficas com suporte a dez tamanhos de
telas, entre outras funcionalidades.
A novidade mais importante da versão 1.5 é o suporte ao cha-
mado “on-device debugging”, que permite realizar a depuração
de aplicações em execução no próprio dispositivo. Há também
suporte a novos dispositivos e várias melhorias, especialmente na
integração com o Eclipse e no designer de interfaces. forum.nokia.
com/main/resources/tools_and_sdks/carbide .
SNAP Mobile SDK 1.2
A plataforma Scalable Network Application Package (SNAP)
da Nokia suporta a criação de jogos móveis conectados e
comunidades de jogadores, através de uma API cliente e
uma infra-estrutura de serviços. Para comunidades, são
oferecidos recursos para conversas on-line e criação
de listas de amigos, indicadores de presença (on-
line, offline, jogando) e rankings, para estimular
a competição. Há funcionalidades para jogos
“ponto a ponto”, nos quais dois adversários
 jogam um contra o outro do começo ao fim,
e também a possibilidade de pesquisar e
escolher adversários e montar salas virtuais.
Outro ponto forte são os recursos para a
criação de sites com notícias e eventos,
quadros de mensagens moderados e
páginas de apresentação dos jogos. A
plataforma SNAP roda sobre o MIDP
2.0 e é baseada na plataforma Arena
criada para o N-Gage (os primeiros ce-
lulares da Nokia com suporte especial
a jogos), que já conta com mais de 500
mil usuários cadastrados. Um atestado
da importância do SNAP é a sua inclu-
são no novo Wireless Toolkit 2.5 da Sun.
snapmobile.nokia.com.
15/8/2006 18:12:40
 a LEONARDO GALVÃO
TestNG 5.0
O framework de testes TestNG é o principal
concorrente do JUnit, e se posiciona como
uma alternativa mais capaz e mais moderna
(NG é uma abreviação de “New Generation”).
Primeiro framework de testes a suportar
anotações (mesmo antes do Java 5), o Tes-
tNG inclui suporte a métodos dependentes
e parâmetros, distribuição de testes e testes
orientados a dados.
O TestNG segue um modelo de execução que
dispensa o uso do tradicional TestSuite e traz
o BeanShell embutido. Há também plug-ins
para várias ferramentas, entre elas o Eclipse e
o Apache Maven. A versão 5.0 tem melhorias
importantes nos relatórios de testes gerados,
com uma estrutura mais organizada e mudan-
ças visuais. Outro destaque é o trabalho com
stack traces, que agora podem ser mostrados
interativamente nos relatórios HTML, sendo
possível também filtrá-los. testng.org
Subversive 1.0.0
Um dos mais populares plug-ins Eclipse
para integração com o sistema de controle de
versões Subversion, o Subversive chegou à
versão 1.0.0. O Subversion é considerado em
muitos pontos melhor e mais moderno que o
CVS e hoje é adotado como sistema de controle
de versões oficial da Fundação Apache, entre
outras organizações. O objetivo do plug-in
Subversive é trazer para o Eclipse o mesmo
 jm39.indb 7
nível de suporte oferecido no IDE para o CVS.
 polari on.org .
LimpidLog
A nova API de logging open source
LimpidLog tem uma proposta radical, que
pode simplificar o log de informações sobre
classes durante a execução. Em vez de codificar
chamadas à API de logging, você registra a
classe a ser monitorada e o LimpidLog acom-
panha e loga informações importantes sobre
o que está sendo feito na classe (isso vale
para mensagens do tipo TRACE e ERROR; para
outros casos, ainda será necessário chamar
uma API de logging comum). A API usa a classe
 java. lang .ins trume nt.In stru menta tion  para instru-
mentar classes e é capaz de logar eventos de
chamada/entrada/saída de métodos, atribui-
ção de variáveis e levantamento de exceções.
acelet.com/limpidlog.
 Jahia Community Edition
Mais um produto importante liberado como
open source, o Jahia Community Edition torna
disponível sob uma licença CDDL modificada,
80% do código do produto. São mais de 2.200
classes e arquivos.
O Jahia é uma “plataforma web unificada”,
que integra tecnologias como ECM ( Enterprise
Content Management) e portlets, bem como
um gerenciador de documentos baseado
no Apache Slide e um mecanismo de buscas
construído sobre o Apache Lucene. Recursos
enterprise não disponíveis na versão Commu-
nity, como Single Sign-On e suporte a clusters
estão acessíveis sob uma licença baseada na
idéia de “contribuição ou pagamento”, pela
qual empresas ou indivíduos podem escolher
pagar royalties pelos recursos adicionais, ou
trocá-los por contribuições para o projeto.
 jahia.o rg.
Google lança repositório open source
O Google lançou um novo repositório de
projetos open source, baseado no sistema de
controle de versões Subversion, e subordinado
ao portal “Google Code” (que hospeda pro-
 jetos como a Go ogle Search API). O cadastro
de novos projetos é simples e há recursos
completos de busca, além de navegação por
palavras-chave. Para registrar um projeto, é
necessário ter uma conta no Google, o que
abre a possibilidade de se usar diversos ou-
tros serviços da empresa juntamente com o
repositório.
Um detalhe interessante é que apenas algu-
mas licenças open source são acei tas. Diz o FAQ
do Google, “A comunidade open source está
cheia de licenças praticamente iguais. Gostarí-
amos que projetos fossem padronizados com
as licenças mais populares e maduras”. O repo-
sitório inclui ainda recursos de issue tracking,
em um módulo que foi criado inteiramente
pelo Google. code.google.com/hosting.
Edição 39 •  Java Magazine 7
15/8/2006 18:12:41
 Cafeína • Especial
SWT com visual
nativo do XP
M
uito se fala que uma das grandes
vantagens do SWT sobre o Swing
é a aderência ao visual nativo da
plataforma, obtido graças ao uso dos com-
ponentes gráficos nativos. Entretanto, desen-
volvedores de aplicações SWT e usuários do
Eclipse em geral devem ter percebido que,
no Windows XP, é assumido o visual nativo
do Windows 98 e 2000, em vez do visual mais
moderno do Windows XP.
Veja na Figura 1, por exemplo, o exemplo
EnderecoTerrestre.java publicado original-
mente no artigo da Edição 31 sobre desen-
volvimento SWT. A Figura 2  ilustra como
deveria ser a aparência da aplicação com o
visual nativo do XP.
A boa notícia é que as duas figuras foram
geradas pela mesma aplicação. Não foi ne-
cessário modificar uma única linha do código
Java, nem recompilar a aplicação contra uma
versão diferente do SWT.
A solução exige que o arquivo  javaw.exe.
manifest , apresentado na Listagem 1, seja
copiado para a mesma pasta que contém o
8  Java Magazine • Edição 39
 jm39.indb 8
manifest  à instalação padrão do JRE ou JDK.
Assim sendo, o arquivo deve ser instalado
manualmente pelos próprios usuários.
Do lado da Microsoft, este arquivo tem
sua razão de ser, pois ele permite que apli-
cações criadas para versões anteriores do
Windows executem sem modificações no
XP. Ao mesmo tempo, ele torna fácil para os
desenvolvedores adequarem suas aplicações
ao novo visual, sem esforço adicional de
FERNANDO LOZANO
programação.
Em versões anteriores do Windows, a
Microsoft simplesmente forçava todas as
executável  javaw.exe utilizado para rodar as
aplicações a assumirem o novo visual (por
aplicações SWT em seu computador.
exemplo, do Windows 3.1 para o Windows
95). Entretanto, isto criava problemas quando
 Os programas javaw.exe e java.exe são ambos
a aplicação utilizava componentes customi-
alternativas para a execução de uma máquina
virtual Java (JVM). A única diferença entre eles é
zados que não se adequavam bem ao novo
que o cabeçalho do javaw.exe diz ao Windows que visual. Por isso, no XP, qualquer aplicação
ele é uma aplicação gráfica, e assim sua execução pode ser configurada para o visual “antigo”
não provoca a abertura de uma janela de console ou para o novo.
ou prompt do MS-DOS.
Uma vez criado (ou copiado) o arquivo, a
linha de comando a seguir executa o exemplo
conforme visto na Figura 2 :
 javaw EnderecoTerrestre
A criação do arquivo irá afetar todas as apli -
cações SWT executadas neste computador,
inclusive o próprio Eclipse. As Figuras 3 e 4
mostram o próprio Eclipse antes e depois da
criação do  javaw.exe.manifest .
Fica a pergunta: por que essa “mágica”
não é parte da instalação padrão do Eclipse Figura 1. Exemplo EnderecoTerrestre.java  como exibido na
instalação padrão do SWT no Windows XP, assumindo a
para Windows? Afinal o arquivo  javaw.exe.
manifest   seria simplesmente ignorado em aparência padrão do Windows 98 e 2000.
versões mais antigas do Windows, e assim
não causaria prejuízo algum.
A impossibilidade de o arquivo ser instalado
pelo próprio Eclipse decorre da licença do
Java. A redistribuição do Java da Sun deve ser
feita de modo inalterado, assim não é possível
para o Eclipse (ou para qualquer outro forne-
cedor que não tenha adquirido uma licença
especial junto à Sun) acrescentar o javaw.exe.
Figura 2. Exemplo EnderecoTerrestre.java  com a aparência
nativa do Windows XP.
15/8/2006 18:12:48
 Listagem 1. rqu vo javaw.exe.manifest que l
xml vers on= . encod ng
assem ly xmlns= urn:sc emas
assem lyIdent ty vers on=
  processorArchitecture=”X
  name= . avaw
  type=”win32”/>
<description>Standard Widg
<dependency>
  <dependentAssembly>
<assemblyIde ntity type
  name=”Microsoft.Wind
  vers on= . . .
  processorArchitectur
  publicKeyToken=”6595
  language=”*”/>
  </dependentAssembly>
  </dependency>
</assembly>

Figura 3. Eclipse com sua aparência padrão no Windows XP

Figura 4. Eclipse depois de criado o arquivo  javaw.exe.manifest 

Edição 39 •  Java Magazine 9

 jm39.indb 9 15/8/2006 18:12:56

 Recapi
Para garantir a compatibilidade de suas

Dicas na
aplicações web, portanto, é sempre impor-
tante saber as versões das APIs suportadas
nos containers web utilizados. Os métodos
getMajorVersion() e getMinorVersion() da classe
 javax.servlet.ServletContext  permitem obter a

Web
versão da API de servlets. E sta classe fornece
ainda o método getServerInfo(), que descreve
o nome do servidor e sua versão.
Já para a versão da especificação JSP, é pre-
ciso obter um objeto javax.servlet.jsp.JspEngine e
chamar seu método getSpecificationVersion() . A
Listagem 1 contém uma página JSP que pode

N
este artigo são apresentadas dicas ser usada para obter essas informações.
úteis sobre JSP e servlets, soluções
para problemas recorrentes no de-
senvolvimento web, e esclarecimentos sobre Definindo o nome do
alguns procedimentos comuns. arquivo em downloads
Um uso comum para servlets (e mesmo
para páginas JSP) é a geração dinâmica de
Obtendo as versões de JSP arquivos, tais como planilhas ou documentos
e Servlets PDF. Nessas situações, ao enviar o arquivo
As tecnologias JSP e servlets gerado, é preciso que o servlet especifique
Nesta edição, evoluíram muito desde suas o tipo do conteúdo através do método
recapitulamos um dos primeiras versões. Por exemplo, response.setContentType(String tipo) . O tipo segue
a API de servlets 2.3 introduziu no cabeçalho da resposta HTTP retornada pelo
assuntos mais populares o conceito de filtros (interface servlet e, de acordo com ele, o navegador po-
 java x.sevle t.Fi lter ), e com o JSP derá decidir o que fazer com o arquivo.
na Java Magazine: o
2.0, veio o suporte a uso da Ex- Normalmente o arquivo é exibido através
desenvolvimento com JSP e pression Language dentro das de um plug-in, ou é oferecida a opção de
páginas. salvá-lo no disco, mas nos casos onde a in-
servlets. Foram selecionadas
quatro dicas, ainda
Listagem 1. versoes.jsp , obtendo a versão das APIs web suportadas
totalmente atuais, do artigo <%@ page import=”javax.servlet.ServletContext” %>
<%@ page import=”javax.servlet.jsp.JspFactory” %>
“Dicas na Web” publicado
<%
na Edição 12, que resolvem ServletContex t sc = pageContext .getServletCo ntext();
String servidor = sc.getServerInfo();
String versaoServlet = “” + sc.getMajorVersion() + “.”
dúvidas comuns e exploram + sc.getMinorVe rsion();
String versaoJsp = JspFactory.g etDefaultFact ory().
  getEngineInfo().getSpecificationVersion();
detalhes importantes da %>

programação web com Java. <b>Servidor:</b> <i><%= servidor %></i><br>

<b>Servlet:</b> <i><%= versaoServlet %></i><br>
<b>JSP:</b> <i><%= versaoJsp %></i><br>

10  Java Magazine • Edição 39

 jm39.indb 10 15/8/2006 18:13:03

  tulando
tenção é que o usuário faça o download, esse
procedimento traz alguns problemas:
•Não é garantido que o usuário tenha a
opção de salvar o arquivo em vez de o nave-
gador abrir automaticamente um plug-in.
•Mesmo que o navegador web ofereça a
opção de salvamento, o nome sugerido será
o do servlet ou o da página JSP (por exemplo,
“contador.jsp”), sendo que o ideal seria um
nome mais amigável, ou ao menos com a
extensão correta (como "contador-10.txt").
Para resolver esses problemas, a solução
é definir a propriedade content-disposition do
cabeçalho da resposta HTTP, com o valor
attachment;filename=  nome. extensão, como no
trecho de código a seguir:
response.setHeader(
“content-disposition”,
“attachment;filename =” + nomeArquivo
);
A Listagem 2 inclui uma página JSP que
imprime um contador, de 1 até 10 (ou até
o valor definido no parâmetro limite). Note
que o navegador não exibe o conteúdo da
página; em vez disso abre a janela com a op -
ção de salvar o arquivo, com nome sugerido
“contador- XX .txt” (sendo  XX o limite).
A propriedade content-disposition é definida
no protocolo HTTP (RFC 2183 1), e não na
API de servlets/JSP. Assim o funcionamento
dessa dica depende da compatibilidade do
navegador com os padrões W3C, e pode
não funcionar em navegadores mais antigos
(nesses casos, o nome sugerido continuará
sendo o nome do JSP).
Outra opção é definir no descritor
web.xml   um mapeamento com o nome de-
1
  RFCs (Requests for Comments)   são documentos que
definem protocolos, modelos ou especificações para os
sistemas da internet. De forma ampla, representam para
a internet o que os JSRs (Java Specification Requests)  são
para Java.
 jm39.indb 11
FELIPE LEME
sejado (como “relatorio.pdf” ou “contador. para outra página. Existem duas formas de s e
txt”) para o servlet ou página JSP responsável fazer isso – forward  (encadeamento) e redirect 
pela geração do arquivo, o que funcionará (redirecionamento). Embora o resultado final
independente do navegador utilizado. No pareça muitas vezes ser o mesmo, o funciona-
entanto essa solução não tem a flexibilidade mento é bem diferente sob o ponto de vista
de permitir a definição do nome no momento do navegador web.
de execução do ser vlet/JSP.
Forward 
Forward ou redirect? A primeira forma usa o método forward()
Uma necessidade muito comum na pro- da classe RequestDispatcher, como mostra o
gramação web é passar o fluxo de execução código da Listagem 3.
Listagem 2. contador.jsp , exemplo simples para demonstrar mudança de nome do download
<%
int limite = 10; // valor padrão
try {
limite = Integer.pars eInt(request .getParameter (“limite”));
}
catch(Exception exc) {
// ignora exceção (limite=10)
}
String nomeArquivo = “contador-” + limite + “.txt”;
  response.setContentType(“text/plain”);
  response.setHeader(“content-disposition”,
“attachment;filename=” + nomeArquivo);
for (int i=1; i<=limite; i++) {
  out.println(i);
}
%>
Listagem 3.Forwards em JSPs e servlets
Em páginas JSP:
RequestDispatcher dispatcher =
pageContext.getServletContext().getRequestDispatcher(“/novaPagina.jsp”);
dispatcher.forward(request, response);
Em servlets:
RequestDispatcher dispatcher =
getServletContext().getRequestDispatcher(“/novaPagina.jsp”);
dispatcher.forward(request, response);
Figura 1. Uso de RequestDispatcher.forward() numa arquitetura simplificada
Edição 39 •  Java Magazine 11
15/8/2006 18:13:04
 Recapitulando · Dicas na Web
O método forward() repassa a requisição
para outro recurso – como um ser vlet, página
JSP ou página HTML – dentro do mesmo con-
tainer web. Esse recurso pode fornecer uma
resposta final ao cliente, ou então repassar
novamente a requisição (veja a  Figura 1).
Usar forward() é útil quando o primeiro servlet
precisa fazer algum pré-processamento
(por exemplo, validar se o usuário atual tem
permissões para acessar a URL especificada),
antes de passar a requisição para o servlet ou
JSP que realizará o processamento final. Em
particular, é dessa forma que o Struts e outras
implementações da arquitetura MVC realizam
o trabalho do controller (veja a Figura 2).
Redirect 
A segunda forma de passar o fluxo de exe-
cução para outra página consiste em usar o
método sendRedirect() da classe HttpResponse ,
enviando com isso um comando HTTP SEND
REDIRECT para o navegador web. Nesse caso
a requisição volta para o navegador, que
automaticamente faz a requisição da página
especificada (que não precisa estar localiza-
da no mesmo servidor). A Figura 3 ilustra o
procedimento.
Comparando as técnicas
A Tabela 1 mostra as demais diferenças
entre cada opção, e a  Listagem 4 contém
uma página JSP com exemplos das duas
técnicas. Note que, em ambos os casos,
se o buffer de resposta já tiver recebido
alguma saída, a tentativa de mudar o f luxo
de execução lança uma IllegalStateException .
Assim, é recomendável que chamadas a
forward() ou a sendRedirect() sejam feitas
no começo do código principal do servlet
( doPost() , doGet()  etc.), antes de qualquer
Listagem 4. mudaFluxo.jsp, exemplos de encadeamento e redirecionamento
Teste de forward e sendRedirect<br><br>
<a href=”mudaFluxo.jsp?tipo=forward&flush=false”>
forward válido</a><br>
<a href=”mudaFluxo.jsp?tipo=forward&flush=true”>
forward inválido</a ><br>
<a href=”mudaFluxo.jsp?tipo=sendRedirect&flush=false”>
sendRedirect válido</a><br >
<a href=”mudaFluxo.jsp?tipo=sendRedirect&flush=true”>
sendRedirect inválido</a>< br>
<br><br>
<%
if (“true”.equals(request.getParameter(“flush”))) {
out.println(“ <br>Chamando out.flush()< br>”);
  out.flush();
} }
12  Java Magazine • Edição 39
 jm39.indb 12
chamada a out.print()  ou out.println(), como 1.  O corpo da tag <jsp:useBean> só é exe-
mostrado nos exemplos. cutado quando o JavaBean é instanciado.
Assim, se o escopo do bean for de sessão,
Cuidados com <jsp:useBean> o código de inicialização só será executado
e <jsp:setProperty> uma vez. Códigos como o seguinte são causa
Uma prática muito comum no desenvol- constante de bugs:
vimento de páginas JSP é o uso das tags
<jsp:useBean id=”beanEntrada” scope= ”session”
<jsp:useBean> e <jsp:setProperty> para, respec- class=”jm.dicas.EntradaDadosBean”
tivamente, instanciar JavaBeans e preencher scope=”session”>
suas propriedades com os valores fornecidos <jsp:setProperty name=”beanEntrada” property=”*”/>
</jsp:useBean>
no formulário da página. Embora a prática
seja correta, é preciso tomar alguns cuidados O problema aqui é que os valores do formulário
com o uso dessas duas tags: só são repassados para o bean na primeira vez
Figura 2. Uso de RequestDispatcher.forward() na arquitetura MVC
RequestDispatcher.forward() Response.sendRedirect()
Fl ux o d e e xe cu çã o p er ma ne ce no s er vi do r Fl uxo v ol ta ao cl ie nt e
Atributos definidos no request são acessíveis na O request da nova página não tem nenhum atribu-
nova página to definido
Nova página deve obrigatoriamente estar no Não há restrições quanto à localização da nova
mesmo contexto web página
A URL exibida no navegador continua sendo a da
A URL no navegador muda para a da nova página
página que originou a chamada de forward()
A URL da nova página deve começar com “/”
Endereço da nova página pode ser qualquer URL
válida
Tabela 1. Diferenças entre redirecionamento e encadeamento
String tipo = request.getParameter(“tipo”);
if (tipo != null) {
request.setAttribute(“atributo”, “teste”);
try {
if (tipo.equals(“forward”)) {
RequestDispa tcher dispatcher =
pageContext.getServletContext().
getRequestDispatcher(“/novaPagina.jsp”);
dispatcher.forward(request, response);
}
if (tipo.equals (“sendRedire ct”)) {
  response.sendRedirect(“/jm12/novaPagina.jsp”);
}
}
catch(Throwa ble t) {
out.println(“Exceção: “ + t.getMessage() + “<br>”);
}
%>
15/8/2006 18:13:06
 Edição 39 •  Java Magazine 13

 jm39.indb 13 15/8/2006 18:13:12

 Recapitulando · Dicas na Web

Listagem 5. usoCorreto.jsp, uso correto das tags <jsp:useBean> e <jsp:setProperty> class=”jm.dicas.EntradaDadosBean”

scope=”session”>
Exemplo do uso correto das tags:<br> <jsp:setProperty name=”beanEntrada” property=”*”/>
<jsp:useBean id=”beanEntrada” </jsp:useBean>
class=”jm.dicas.EntradaDadosBean” scope=”session”/>
<jsp:setProperty name=”beanEntrada” property=”*”/> <form>
Nome: <input type=”text” name=”nome”
<form> value=”<jsp:getProperty name=”beanEntrada”
Nome: <input type=”text” name=”nome”   property=”nome”/>”><br>
value=”<jsp:getProperty Email: <input type=”text” name=”email”
name=”beanEntrada” property=”nome”/>”><br> value=”<jsp:getProperty name=”beanEntrada”
Email: <input type=”text” name=”email ”   property=”email”/>”><br><br>
value=”<jsp:getProperty </form>
name=”beanEntrada” property=”email”/>”><br><br>
<input type=”submit” value=”Enviar”>
</form> Listagem 7. EntradaDadosBean.java, JavaBean utilizado nas Listagens 5 e 6

package jm.dicas;
Listagem 6. usoIncorreto.jsp, uso incorreto das tags <jsp:useBean> e <jsp:setProperty>
public class EntradaDadosBean {
Exemplo do uso incorreto das tags private String nome;
(valores dos textfields nunca mudam):<br> private String email;
<jsp:useBean id=”beanEntrada” //... métodos get/set
}

seria equivalente a2:

Object meuBean = (Object) pageContext.getAttribute(

“meuBean”, PageContext .SESSION );

Figura 3. Redirecionamento com Response.sendRedirect()
que o formulário é submetido. Nas submissões
seguintes, o bean já está presente na sessão e
não precisa mais ser instanciado; conseqüente-
mente a tag <jsp:setProperty> não é executada.
A solução para o problema é retirar a tag
<jsp:setProperty> do corpo de <jsp:useBean> :
<jsp:useBean id=”beanEntrada”
class=”jm.dicas.EntradaDadosBean”
scope=”session”/>
<jsp:setProperty name=”beanEntrada” property=”*”/>
Ou então mudar o escopo do bean:
<jsp:useBean id=”beanEntrada”
class=”jm.dicas.EntradaDadosBean”
scope=”request” >
<jsp:setProperty name=”beanEntrada” property=”*”/>
</jsp:useBean>
Os exemplos nas Listagens 5 e 6 demons-
tram o uso correto e incorreto dessas tags (e
a Listagem 7 inclui o bean simples utilizado
por estas).
2. A especificação JSP diz que quando um
parâmetro da requisição é nulo ou vazio,
a respectiva propriedade não é “setada”
através da tag <jsp:setProperty>. É muito
comum, porém, o desenvolvedor criar có-
digo supondo que essa propriedade será
definida com o valor nulo (ou vazio), o que
mais uma vez causa bugs quando o bean
está armazenado em escopo de sessão. A
Figura 4 ilustra o comportamento da tag
<jsp:setProperty>, passo a passo, sobre o
código da Listagem 6.
3. O tipo do bean a ser usado por <jsp:useBean>
pode ser definido através dos atributos type e
class. Embora os significados desses atributos
sejam semelhantes, eles representam concei-
tos ligeiramente diferentes: class define a classe
sendo instanciada, enquanto que type define
o tipo do bean, que, além da classe do bean,
pode ser uma das suas superclasses ou uma
interface implementada por ele. Por exemplo,
o código abaixo:
<jsp:useBean id=”meuBean” scope= ”session”
type=”java.lang.Object” class=”java.util.Date”/>
if (meuBean == null) {
meuBean = new java.util.Date ();
  pageContext. setAtt ribute (“meuBean”, meuBean,
PageContext.SESSION_SCOPE);
}
Ou seja, o código gerado tenta recuperar
um bean existente no escopo de sessão e
associá-lo a uma variável da classe Object
(definida no atributo type). Caso o bean não
exista no escopo, uma nova instância da clas-
se Date (definida no atributo class) é gerada e
atribuída à variável meuBean .
Quando apenas type é usado, o bean precisa
obrigatoriamente estar disponível no escopo,
senão é lançada uma exceção. Por exemplo,
o seguinte trecho de código:
<jsp:useBean id=”meuBean” scope= ”session”
type=”java.lang.Object”/>
seria equivalente a:
Object meuBean = ( Object) pageContext.getAttribute(
“meuBean”, PageContext .SESSION );
if (meuBean == null) {
throw new InstantiationException(
“bean meuBean not found within scope”);
}
2
 O código mostrado aqui é parecido com o gerado pelo
compilador JSP, porém simplificado: além do tratamento
de exceções ter sido omitido, os objetos foram instancia-
dos através do operador new, enquanto que o compilador
JSP usa  java.beans.Beans.instantiate().

14  Java Magazine • Edição 39

 jm39.indb 14 15/8/2006 18:13:17


Assim que a página é acessada, o bean é instanciado, porém nenhu-
ma propriedade é setada (já que não foram passados parâmetros
à requisição).
Após serem preenchidos os valore s do nome e e-mail, o formulário é
submetido. No servidor, o bean já existe na sessão e não é instanciado
novamente. Porém, como os valores dos parâmetros nome e email são
não-nulos, as respectivas propriedades do bean são setadas.
O formulário é submetido co m um novo nome, mas sem o endereço
de e-mail fornecido, então apenas a p roprieda de nome será setada
no bean que está na sessão.
Resultado final: o nome foi alterado, mas o e-mail não.
Figura 4. Exemplo de uso incorreto do tag <jsp:setProperty>
 jm39.indb 15
Usar a variação de <jsp:useBean> apenas
com type é muito útil em alguns casos; por
exemplo, quando um objeto representan-
do um usuário é criado apenas na página
de login e precisa ser acessado em outras
páginas. Mas é preciso se ter em mente que
o tag pode causar uma exceção (se a sessão
expirar, digamos), e dessa forma ter os devi-
dos cuidados. Uma saída seria o uso de tags
JSTL para checar a existência do objeto na
sessão, como no código seguinte:
<c:if test=” ${empty sessionScope.beanEntrada}”>
<c:redirect url=”sessaoExpirada.jsp”/>
</c:if>
<jsp:useBean id=”beanEntrada” scope= ”session”
type=”jm.dicas.EntradaDadosBean”/>
Felipe Leme
(felipeal@gmail.com) é
Engenheiro de Computacão pela
UNICAMP, membro atuante das
comunidades Java brasileira e mundial,
tendo publicado artigos em revistas técnicas e sites
internacionais e palestrado nas principais conferências
sobre Java, além de participar como expert no JCP e
ser committer em projetos da Apache. Atualmente é
Diretor Técnico da Voxblue ( voxblue.com)
e instrutor da Globalcode.
Edição 39 •  Java Magazine 15
15/8/2006 18:13:19
 Byte Code

 Java EE 5
Um Enterprise Edition muito mais fácil

16  Java Magazine • Edição 39

 jm39.indb 16 15/8/2006 18:13:45


A o reler meu primeiro artigo na
 Java Mag az ine, “J2 EE Fu nda-
mental” (Edição 1, julho de 2002),
abordando o então recém-lançado J2EE 1.3,
pude verificar como o status da plataforma
mudou. Eram apresentados fundamentos
como containers, servidores de aplicações
e EJB, até então pouco familiares para
muitos desenvolvedores. Servidores J2EE
eram ferramentas caras e pesadas, e a
portabilidade ainda deixava a desejar para
os padrões do Java. Alguns componentes,
como os Entity Beans, estavam francamen-
te imaturos – isso quando não já tinham
sido descartados por muitos. O artigo ter-
minava com uma seção “Web services: o
futuro”, já anunciando o J2EE 1.4 (lançado
em novembro de 2003), mas apontando os
problemas de compatibilidade de padrões
ainda em definição. Hoje em dia, poderí-
amos reclamar que já existem padrões de
Web Services até em demasia.
Complexidade escalável
É comum que problemas complexos tenham
soluções complexas, e as opções que parecem
mais simples às vezes não escalam com as de-
mandas das aplicações com mais “complexidade
essencial”. A plataforma J2EE foi por muito tempo
vista como “canhão para matar mosca”: aplicações
mais simples, sem necessidades avançadas de
integração, escalabilidade, segurança etc., eram
mais bem servidas por concorrentes mais leves e
produtivos. Mas não deveríamos ter que migrar
para outra plataforma – perdendo investimentos
de código, treinamento e ferramentas – conforme
cada projeto for mais simples ou complexo.
Tanto o velho J2EE quanto os competidores
mais simples (ex. Ruby on Rails) exibem a falta
de uma qualidade que poderíamos chamar de
“escalabilidade de complexidade”: a mesma
plataforma deveria comportar o desenvolvi-
mento de uma grande gama de aplicações, das
mais triviais até as mais sofisticadas. E recursos
 jm39.indb 17
 
OSVALDO PINALI DOEDERLEIN
Passados quatro anos, a plataforma,
agora rebatizada Java EE, dispensa apre-
sentações, tendo se constituído num com-
ponente obrigatório do conhecimento de
qualquer desenvolvedor Java atuando no
“lado do servidor” ( server-side). Mesmo
frameworks que correm por fora e ga-
nharam prestígio e popularidade, como
Spring e Hibernate, têm ocupado um lugar
mais complementar do que alternativo
em relação ao Java EE. E numa exibição
surpreendente de resposta às direções
escolhidas pela comunidade, o novo Java
EE 5 adere a práticas popularizadas por
estas outras soluções, como inversão de
controle, uso mais intenso de metadados,
e persistência baseada em POJOs (Plain
Old Java Objects).
Este artigo inicia com uma discussão
geral sobre esta grande atualização da
plataforma. Diferentemente de outros
artigos desta coluna, não entraremos em
avançados devem estar disponíveis para quem
precisar, mas sem impor esforço de desenvol-
vimento extra para aplicações com requisitos
mais modestos.
O Java EE 5 é bem mais escalável quanto à
complexidade. Por um lado, quando você tiver
problemas muito complexos para resolver, as
qualidades “enterprise” continuam lá: todo o
poder dos EJBs, além de segurança declarativa,
transações distribuídas, conectores, web ser-
vices, JNDI, clusters etc. Já aplicações simples
serão codificadas de forma simples. No J2EE
tradicional, artefatos burocráticos acabavam
constituindo uma fração significativa do código
de aplicações de menor porte, ridicularizando
o J2EE em cenários “alô mundo”. Com o Java
EE 5 isso deixa de acontecer. E mesmo para as
aplicações mais ambiciosas, a facilidade de pro-
gramação do Java EE 5 deverá ser sensivelmente
maior em comparação com o J2EE 1.4.
Explorando a nova versão do
Java corporativo: anotações,
injeção de dependências,
novas JSRs e um exemplo
prático no servidor open
source GlassFish
detalhe sobre APIs e funcionalidades es-
pecíficas, o que seria pouco viável devido
à extensão da plataforma. Esta necessidade
será melhor servida por artigos futuros es-
pecializados em temas como JPA (coberto
nesta edição), EJB etc. Aqui nosso obj etivo
é fornecer uma visão conceitual. Mas agora
assumimos que o leitor já possui familiari-
dade básica com a plataforma J2EE. Assim,
podemos enfocar as novidades, e analisar
e discutir a natureza e as motivações por
trás de cada mudança dessa atualização
que pode mudar radicalmente sua rotina
de desenvolvimento de aplicações “En-
terprise Edition”. E para começar uma
exploração prática, o quadro  “GlassFish:
o Java EE open source” mostra como
instalar a implementação de referência
(RI) desta plataforma, e desenvolver uma
aplicação Java EE 5 simples com o IDE
NetBeans 5.5.
 Java EE 5: Produtividade Corporativa
Se o release anterior, J2EE 1.4, era a versão
dos web services, o Java EE 5 é a versão da
produtividade. Não por coincidência, este
é o mesmo foco do Java SE 5.0, especial-
mente com a nova sintaxe de anotações.
As anotações são o veículo principal
das melhorias de produtividade do
 Java EE 5. Quer que uma classe seja um
Stateless Session Bean ? Basta declarar
“@Session class MinhaClasse {...} ”. Precisa expor
a funcionalidade de uma classe como um
web service? Use a tag @WebService. E para
conectar a um DataSource ? Nada de código
 JNDI – InitialContext, lookup() , narrow() , trata-
mento de exceções – basta usar a anotação
apropriada, como:
@Resource(name= ”jdbc/minhaDS”)
 DataSource minhaDS;
POJOs e anotações versus descritores
O paradigma de programação do Java EE
5 dá um guinada espetacular, abandonan-
Edição 39 •  Java Magazine 17
15/8/2006 18:13:53
  Java EE 5
do boa parte da burocracia do tradicional
 J2EE em favor de uma opção preferencial
pela simplicidade. A “programação base-
ada em POJOs1” é fortemente suportada.
Veja algumas novas características:
•Temos POJOs no lugar de implementa-
ção de interfaces. Não precisam mais ser
escritos centenas de métodos completa-
mente vazios, como ejbActivate(), só porque
uma interface de EJB os exige.
•É usada a Injeção de Dependências em
vez de aborrecidos lookups na JNDI.
•As anotações assumem o lugar de des-
critores XML.
•Há muitos comportamentos default que
evitam a necessidade de especificar op-
ções comuns, seja com descr itores ou com  
anotações. Por exemplo, um @WebMethod
(método de web service) suporta anotações
@WebParam  para os parâmetros, mas estas
são opcionais. Na sua falta, o container
assumirá defaults bons para a maioria dos
usos (como holder=Mode.IN).
Mas será que este paradigma de progra-
mação é sempre melhor? Em relação às
anotações, que são o instrumento funda-
mental do novo modelo, já as questiona-
mos em artigos anteriores, em seções com
títulos como “Cuidados com as anotações”
e “Uma crítica às anotações”. O motivo
de tanta precaução é que uma revisão tão
radical no processo de desenvolvimento
não deve ser abordada sem cuidado e
visão crítica.
Felizmente, com a forma que o Java EE
5 tomou, esses temores não se concretiza-
ram. Em especial, os descritores ainda são  
suportados (o que já é bom por motivo de
compatibilidade) e eles têm prioridade so-
 bre informações declaradas por anotações.
Isso evita que as anotações eliminem a
flexibilidade garantida pelos descritores.
Por exemplo, numa classe persistente você
pode usar uma anotação @Table(name=”TAB”)
para determinar que os objetos da classe  
serão persistidos na tabela “TAB”. Isso é
muito conveniente, mas o que acontece se
um dia o nome da tabela t iver que mudar?
No J2EE tradicional (EJB/CMP), bastaria
alterar o descritor. No Java EE 5 podería-
mos alterar a anotação @Table,mas isto não
é obrigatório. Podemos também criar um
descritor e informar nele o nome atuali-
zado da tabela. No caso de redundância
18  Java Magazine • Edição 39
 jm39.indb 18
(mesma informação em anotações e no
descritor), o container dará preferência ao
descritor. Preserva-se assim a flexibilidade
dos descritores – e só há o trabalho de
manipulá-los quando isso for realmente
necessário.
Mas note que estes casos são a minoria.
Na prática, as oportunidades de adap-
tar aplicações a mudanças no ambiente
externo mexendo apenas no descritor só
costumam ocorrer em casos triviais, como
mudanças nos nomes JNDI de DataSources
ou filas de JMS, causadas talvez por uma
migração de ambiente (ex.: homologação
para produção). E mesmo nestes casos, a
indireção proporcionada pelas resource re-
ferences (J2EE 1.3+) já evita a necessidade de
alterações até nos nomes JNDI “internos”,
usados nos descritores e no código.
Observamos que existem algumas ca-
racterísticas, consideradas “estruturais”,
que se definidas por anotações não são
redefiníveis por descritores. Por exemplo,
novamente com EJBs, anotações como
@Stateless  e @Stateful denotam os diferentes
tipos de Session Beans. Mas se uma clas se
for anotada com @Stateless , não será possí-
vel, pelo descritor, transformá-la num EJB
Stateful. O motivo é simples: a diferença
entre um bean Stateless e um Statefu l não
está apenas no descritor – beans Stateful,
presumivelmente, mantêm algum estado
interno, enquanto beans Stateless não o
fazem, portanto transformar um tipo no
outro exige alterações de código de qual-
quer maneira.
Anotações versus Orientação a Objetos
As anotações constituem uma alter-
nativa a técnicas mais tradicionais na
programação OO, como herança ou
design patterns. O J2EE tradicional,
como sabemos, é fortemente baseado em
herança. Um Entity Bean, por exemplo, é
uma classe que implementa a interface
javax.ejb.EntityBean, o que obriga a definir
sete métodos (como ejbActivate() , ejbLoad()
etc.), que na sua maioria são desneces-
sários para a maior parte dos beans. Há
certamente algo errado numa arquitetura
que obriga as aplicações a definir até sete
métodos vazios para cada entidade de
negócio. (Lembrando que em Java, nem
sempre é uma boa idéia usar classes-base
que forneçam implementações default
destas interfaces de framework, pois isto
“queima” a oportunidade única de herança
de implementação2).
Em oposição à rigidez da herança, as
anotações enriquecem uma classe com
comportamentos de forma muito mais
granular. Há anotações por tipo, atributo,
método, e até por parâmetro ou variável
local. Assim, se o seu bean realmente pre-
cisa executar algum código especial após
a ativação, basta implementar um método
anotado por @PostActivate.
As anotações possuem uma vantagem
crucial: são estaticamente tipadas. Podem
ser verificadas e validadas de forma
offline, o que evita toda uma categoria
de bugs. O  javac só verificará a correção
sintática das anotações, por exemplo re-
clamando se você usar uma propriedade
inexistente numa anotação; não reportará
erros semânticos, ex.: uma propriedade
@EJB.beanInterface  com um valor que não
seja uma interface local/remota de EJB.
Mas as ferramentas de validação incluídas
em IDEs com suporte a Java EE e em ser-
vidores de aplicações poderão fazer estas
validações no momento da implantação
ou antes, evitando que o bug fique ocu lto
e “estoure” somente quando a aplicação já
estiver em operação.
Injeção de Dependências
A persistência de POJOs, no estilo do
Hibernate, tem chamado atenção como
a grande novidade que o Java EE 5 pega
emprestada de outros frameworks. Mas
não menos importante é a Injeção de De-
pendências (ID). Para compreender a idéia
fundamental da ID, podemos classificar as
1
Plain Old Java Objects, algo como “bons e velhos obje-
tos Java”. É uma definição por exclusão: objeto s que não
são obrigados a herdar/implementar nenhuma interface
imposta por uma API. Também se usa POJI para interfaces
que não precisam herdar nenhuma outra interface. Um
framework que suporta POJOs, no lugar de herança, uti-
liza mecanismos mais fracamente acoplados, como ano-
tações ou arquivos de configuração, para interagir com
seus objetos.
2
A exceção fica por conta de casos simplistas como os
listeners da AWT/Swing, ex.: MouseListener, acompanhados
por classes “adapter”, como MouseAdapter, que facilitam a
criação de inner classes   que implementam somente um
dos métodos exigidos por listeners que agrupam vários
eventos. Como tratadores de eventos são simples e rara-
mente se beneficiariam de herança de implementação,
nestes casos não faz mal usar a herança única para deri-
var do adapter. O mesmo não pode ser dito de EJBs que
implementam complexas regras de negócio.
15/8/2006 18:13:54
 aplicações em três graus de evolução:
1. Todas as dependências (de confi-
gurações e de código) estão amarradas
no código.  Neste caso, mudar qualquer
coisa exige alterar código, recompilar e
reiniciar a aplicação. É o grau zero, hoje
em dia só encontrado em aplicações de
iniciantes ou em códigos descartáveis,
como protótipos.
2. Dependências de configuração estão  
fora do código. A aplicação é parametri-
zada por informações carregadas a partir
de arquivos, bancos de dados, diretórios
ou outros locais externos. A alteração
destes parâmetros pode ser feita por um
não-desenvolvedor, não exige mudanças
no código e talvez nem indisponibilidade
do sistema. Por outro lado, dependências
de código continuam amarradas. Em
qualquer circunstância onde a classe A
precisa utilizar a classe B, isto é feito com
código, ex.:
class A {
void m() {
B b = new B();
// usa b...  
} • Finalmente, como estes lookups são
}.
Alguns design patterns, como Abstract
Factory e Service Locator, ajudam a encap-
sular e concentrar num só lugar a decisão
de quais objetos instanciar ou utilizar, e
permitem aos dependentes de um com-
ponente depender apenas de interfaces
abstratas. Mas isso não é uma solução
completa, pois as dependências de código
continuam sendo resolvidas por código,
ainda que de forma mais elegante e sem
repetições. É neste ponto de evolução que
se encontra a maioria das aplicações atuais
 bem escritas.
3. Uso de Injeção de Dependências . As
dependências de código não são respon-
sabilidade do código da aplicação, e sim
de um runtime de Injeção de Dependên-
cias, que “injeta” em cada objeto-cliente
os recursos dos quais ele depende. As
regras que determinam como esta injeção
é feita – qual classe instanciar e com quais
parâmetros – ficam em metadados exter-
nos, que são manipulados pelo runtime
de ID.
O exemplo mais comum de Injeção de
Dependências, em aplicações Java EE, é
 jm39.indb 19
o da comunicação com EJBs. Se você já Por essas e outras, os únicos desenvolve-
programou com EJB, já deve ter visto ou es- dores que acham o EJB simples costumam
crito muito código como o da Listagem 1. ser aqueles que já utilizaram gerações ante-
Neste exemplo, na camada de apresentação riores de componentes distribuídos, como o
de uma aplicação (no caso, uma GUI web COM/COM+ da Microsoft ou o CORBA da
implementada com o Struts), precisamos OMG. Há justificativas para expor algumas
invocar um Session Bean que executa o das etapas que descrevemos, mas nem sem-
login do usuário. Todo o código destacado pre. Por exemplo, nunca entendi a utilidade
em negrito não passa de “burocracia do da interface Home para Stateless Session
J2EE”. Veja quanta coisa precisamos fazer Beans, que só podem ter um método create(),
só para invocar um simples método login() sem parâmetros e cujas invocações retor-
no bean remoto: nam sempre a mesma referência.
• Configurar a conexão com a JNDI (sim- Mais grave é nos obrigar a escrever
plificado, neste código – pode ser preciso código que quase nunca é necessário.
setar propriedades para o InitialContext). Por exemplo, quanta gente trata exceções
• Fazer um lookup na JNDI. como NamingException, com um código de
• Tratar possíveis erros deste lookup. recuperação de falha específico a cada
• Como o que é retornado pelo lookup local de ocorrência? Quase ninguém; o que
é na verdade a interface Home, deve-se todo mundo faz é tratar de forma genérica
invocar um dos seus métodos create() para estas exceções, talvez encapsulando-as em
gerar a referência ao Session Bean que outra exceção que o framework utilizado
realmente desejamos. sabe tratar (como uma ServletException para
• Se estivermos usando uma interface aplicações web). Daí o framework se en-
remota, ainda precisamos usar a operação carrega da exceção, cancelando a operação
narrow() ao invés de um simples typecast do em andamento, roteando a GUI para uma
Java. página de erro configurável, etc. Mas se
é para deixar que o framework ou o con-
relativamente custosos, aplicações preo- tainer trate exceções, não deveríamos ter
cupadas com o desempenho devem tentar que escrever centenas de blocos try/catch
reduzi-los, por exemplo com a estratégia exatamente iguais, nem saber que existe
de cache e inicialização sob demanda a NamingException! Aliás, nem deveríamos
ilustrada com o método lookupLoginServer() precisar lidar com a JNDI, ou as interfaces
e o atributo loginServer. Home, exceto em casos excepcionais.
Listagem 1.Código de exemplo numa Web Application J2EE que acessa um servidor EJB.
public class LoginAction extends DispatchAction // usando Struts
protected LoginServer loginServer ;
protected synchronized LoginServer lookupLoginServer ()
throws ServletExcep tion
{
if (login == null) try
{
InitialContex t ctx = new InitialContex t();
Object obj = ctx.lookup(“ ejb/session/L oginServer”) ;
LoginServerHo me home = (LoginServerH ome)
PortableRemot eObject.narr ow(obj, LoginServer Home.class);
loginServer = home.create();
}
catch (final NamingExcept ion e) { throw new ServletExcept ion(e); }
return login;
}
public ActionForward doLogin (final ActionMapping mapping, final ActionForm form,
final HttpServletRe quest request, final HttpServletR esponse response)
throws ServletExcep tion
{
LoginServer loginServer = lookupLoginServer();
LoginForm f = (LoginForm)form;
boolean ok = loginServer. login(f.getUs er(), f.getPassword ());
// ... etc.
}
}
Edição 39 •  Java Magazine 19
15/8/2006 18:13:54
  Java EE 5
       l
GlassFish:
     a
       i
     r O Java EE 5
 
     o
open source
      t
     uO
Java EE 5 é um padrão formal do JCP, e logo terá muitas implementações
concorrentes. Mas vale a pena dar uma atenção privilegiada para uma
destas implementações, o projeto GlassFish. Trata-se do mais novo servidor
       T
Java EE 5 de fonte aberto. Aliás, o único por ora, já que o JBoss, apesar do pioneirismo
com o EJB 3.0, ainda não parece perto de finalizar o suporte para a Java EE 5 como
um todo, e o Geronimo provavelmente demorará muito mais.
O GlassFish foi baseado em código doado pela Sun, sendo a base
do Sun Java System Application Server 9 (também conhecido  
como Java EE SDK 5), que é a implementação de referência (RI)
do Java EE 5. Tanto a versão open source quanto a da Sun são
certificadas. O GlassFish vem sendo desenvolvido como um
projeto do portal java.net, onde já angariou bastante suporte
da comunidade open source. Resta saber se isso se traduzirá em
ganhos significativos de mercado para es te servidor, que até hoje, a
despeito da liderança da Sun no desenvolvimento da tecnologia J2EE /
Java EE e fortes resultados recentes de benchmarks SPEC jAppServer
2004, tem amargado pouca popularidade, apesar de gratuito para
uso comercial (um apelo que se mostrou insuficiente, já que o
JBoss é tanto gratuito quanto open source).
Testando o Java EE 5 com o Glassfish
Para exercitar um pouco os novos recursos do Java
EE 5 apresentados neste artigo, veremos uma apli-
cação “alô mundo” de duas camadas, com uma
interface web JSF que invoca um Session Bean
– executando no GlassFish.
Para este exercício, utilizare mos o IDE
NetBeans 5.5. Usuários do Eclipse 3.2 /
WTP 1.5 também podem desenvolver
Figura Q1. Criando o projeto de exemplo.
20  Java Magazine • Edição 39
 jm39.indb 20
para o GlassFish, utilizando o plug-in disponível
em glassfishplugins.dev.java.net , mas o WTP (e
versões anteriores do NetBeans) ainda não possui
suporte específico para o Java EE 5.
O NetBeans pode ser baixado numa versão que
já inclui o servido r Java EE, que desta forma é pré-
configurado na instalação, ou se pode instalar o
Glassfish à parte. Neste caso, será preciso ir em
Tools > Server Manager > Add Server  e criar um novo
registro do tipo Sun Java System Application Ser-
ver, entrando com seus parâmetros de instalação
(diretório, login de administrador etc.). (Este mes-
mo tipo de servidor funciona com o Java EE SDK
5.0 / SJSAS 9 e com o Glassfish; par a simplificar, nos
referiremos ao servidor como apenas “GlassFish”.)
Agora vá na janela Runtime do NetBeans e, sob
Servers , encontre o servidor GlassFish e comande
Start in Debug Mode .
Em File | New Project , selecione Enterprise / Enter-
prise App lication na primeira página, e preencha
a segunda conforme a Figura Q1 (modificando
é claro os drives e diretórios), selecionando o
GlassFish e criando um módulo EJB e um módulo
web. O NetBeans criará três projetos, para os mó-
dulos EJB, WAR e EAR.
No projeto EJB, acione New > Session Bean, e crie
um EJB com nome “Alo”, tipo Stateless e interface
apenas Remote. O assistente irá criar os fontes da
interface AloRemote  e da implementação AloBean.
Após customizarmos estes fontes, eles deverão
ficar como nas Listagens Q1 e Q2 .
Examinando o projeto, você verá que temos
apenas estes dois arquivos .java , e além disso
dois descritores – sun-ejb-jar.xml  e MANIFEST.MF .
Mas ambos estão vazios; foram criados apenas
por conveniência. Apague estes dois arquivos do
projeto, para comprovar o que dissemos sobre
serem opcionais.
No projeto do EAR, acione Deploy Project . O
NetBeans irá executar a compilação dos módulos
dependentes, o empacotamento do EAR, e sua
15/8/2006 18:15:03
 instalação no servidor GlassFish que já havíamos
deixado executando.
Vamos agora à interface web com a JSF. Nas
propriedades do projeto WAR, na categoria
Frameworks, comande Add  / Java Server Faces, acei-
tando as opções default; isto configura o projeto
para suportar a JSF. Além disso, como o projeto
WAR precisará utilizar a interface AloRemote do
projeto EJB, você deve configurar o classpath do
projeto WAR: em Libraries / Add Project , selecione
o diretório do projeto EJB.
Nossa GUI terá apenas uma página, que invoca o
Session Bean e exibe a mensagem retornada. Para
fazer esta invocação, vamos usar um managed
bean. Na JSF, “managed beans” são classes equi-
valentes às Forms do Struts (mas com a vantagem
de serem POJOs), normalmente contendo dados
(modelo) manipulados pelas telas (views). O nosso
managed bean só terá uma propriedade “virtual”
cujo getter invoca o Session Bean.
Crie o managed bean com New > File/Folder
> Web > JSF Managed Bean. Modifique o nome
da classe para “Alo”, e aceite os defaults para
as demais opções. Finalmente, edite o código
gerado para ficar como a Listagem Q3. Observe
o uso de Injeção de Dependências para conectar
com o Session Bean. (O assistente de criação
de managed beans é útil principalmente por
registrar o bean na configuração da JSF, o faces-
config.xml ).
A última etapa é criar a página index.jsp , confor-
me a Listagem Q4. Páginas JSF são basicamente
JSPs que utilizam as taglibs da JSF; neste caso, uti-
lizamos as tags ( ou componentes) view, que deve
englobar todo o conteúdo da página gerenciado
pela JSF, e outputText, que exibe dados (equivalente desta funcionalidade. Entre o que utilizamos,
à <c:out> da JSTL). O argumento da nossa outputText está a arquitetura de componentes distribuídos
é uma expressão EL que obtém a propriedade alo do EJB: seria possível fazer o deploy dos módulos
do managed bean. EJB e web em servidores separados e a aplicação
Para executar o exemplo, faça o deploy do funcionaria da mesma forma.
projeto principal (o EAR), e acesse com o browser A Figura Q2 mostra o ambiente de desenvol-
o endereço: http://localhost:8080/AloEE5-war/  vimento do NetBeans 5.5, onde podemos ver a
faces/index.jsp edição de JSP/JSF, o runtime e os logs do servidor
Sendo que 8080 é a porta HTTP default do Glas- Glassfish, e a estrutura dos projetos AloEE . Como
sFish, AloEE5-war  é o nome do projeto do módulo a especificação e as implementações de Java EE
Web, faces/  é o padrão de URL default para acio nar 5 ainda são muito recentes, o suporte de IDEs
o controller da JSF (equivale ao “ *.do ” da Struts), ainda é preliminar (o NetBeans 5.5, no momento
e index.jsp é a nossa página. O resultado do teste em que escrevo, ainda está em beta). Mas até em
não será surpreendente – a mensagem “Alô, Java função das simplifica ções do Java EE 5, a tendência
EE 5!” exibida no seu browser. O surpreendente, é dependermos cada vez menos de ferramentas
em comparação com versões anteriores do J2EE, elaboradas.
é a simplicidade do
código, com menos de
40 linhas (ou menos
de 50 se contarmos
o faces-config.xml ) .
Pode não parecer as-
sim tão pouco para
um programa “alô
mundo”, mas note que
o programa executa
num container Java
EE 5, que disponibili-
za às aplicações um
formidável volume
de funcionalidades
– ainda que isso possa
ser difícil de perceber
para o iniciante, pois
o exemplo usa pouco Figura Q2. O NetBeans 5.5, durante o desenvolvimento de uma aplicação Java EE 5.

Listagem Q1.Interface remota do stateless session bean “Alo”. import javax.ejb.EJB;

package aloee; public class Alo {

private @EJB AloRemote aloServer;
import javax.ejb.Remote; public String getAlo () {
return aloServer.alo ();
@Remote public interface AloRemote { }
String alo (); }
}

Listagem Q2.Implementação do stateless session bean “Alo”. Listagem Q4.Página de teste da JSF.

package aloee; <%@ taglib uri=”http://java.sun.com/jsf/html” prefix=”h” %>

<%@ taglib uri=”http://java.sun.com/jsf/core” prefix=”f” %>
import javax.ejb.Stateless;
<html>
@Stateless public class AloBean implements aloee.Alo {  <head>
public String alo () { <title>Alô, Mundo</title>
return “Alô, Java EE 5!”;  </head>
}  <body>
}   <f:view>
<h:outputTex t value=” #{Alo.alo} ”/>
  </f:view>
Listagem Q3.Managed Bean para a tela de entrada.  </body>
</html>
package aloee;

Edição 39 •  Java Magazine 21

 jm39.indb 21 15/8/2006 18:15:11

  Java EE 5

É para resolver esses problemas que
surgiram design patterns como o Service
Locator, que já comentamos. Estes patterns
reduzem o problema – podemos ter todos
os lookups de EJBs numa única classe, e
não em dezenas de classes Action – mas
não eliminam o problema totalmente.
A solução definitiva é proposta pelo
sistema de Injeção de Dependências, cuja
implementação no Java EE 5 nos permite
escrever código como o da Listagem 2,
na qual foram destacadas as mudanças
em relação à versão anterior. Observe que
não precisamos mais nos preocupar com
 JNDI, lookup, exceções, interfaces Home,
conversões de interfaces remotas, ou mes-
mo otimizações para reduzir os lookups.
Só precisamos declarar uma variável (local
ou atributo) que seja do tipo da interface
de Session Bean desejada, e complementar
esta declaração com a anotação @EJB. Esta
anotação é simples: basta informar o nome
 JNDI do bean desejado, e o runtime de ID
faz o resto.
O código resultante é muito menor. Até
mesmo o método doLogin() foi simplificado.
O funcionamento básico da ID é simples:
quando o artefato que contém a dependên-
cia (no caso, a LoginAction3) for criado, o con-
tainer fará o lookup, a invocação do create()
etc. Se o lookup falhar, ocorrerá um erro
impedindo a inicialização da Action, e este
erro será tratado pelo framework web.
Existem variantes neste comportamento,
que recuperam muito da flexibilidade que
você poderia imaginar ter perdido na tran-
sição da Listagem 1 para a Listagem 2 :
•Ao invés de anotar com @EJB o atributo
loginServer, poderíamos utilizar esta anota-
ção num setter ( setLoginServer(LoginServer)),
que seria invocado pelo container. Isto nos
daria maior grau de controle sobre sua
inicialização.
•A anotação @EJB  suporta outras pro-
Listagem 2.Injeção de Dependências no Java EE 5.
priedades, permitindo escolher a interface
local ou remota, ou o nome lógico ( java:
comp/env ) ou o nome proprietário do con-
tainer EJB (mapped name).
•Há anotações para interagir com o
ciclo de vida do objeto sujeito à Injeção
de Dependências. Por exemplo, poderí-
amos criar um método com a anotação
@InjectionComplete , que seria então invocado
uma única vez, após a inicialização de
todos os recursos que usam Injeção de
Dependências na sua classe.
 A Injeção de Dependências no Java EE 5
Quem já conhece a Injeção de Depen-
dências em frameworks como Spring,
PicoContainer e outros, poderá se pergun-
tar se o suporte a ID do Java EE 5 é melhor
ou pior. As anotações de ID utilizadas
pelo Java EE 5, especif icadas pela JSR-250
(Anotações Comuns para a Plataforma
 Java), são também incluídas no Java SE
6. Isso abre a possibilidade de melhorias
de APIs fundamentais e até otimizações
da JVM, para tirar proveito da Injeção de
Dependências, ou torná-la mais eficiente
e poderosa.
Por outro lado, sistemas de ID mais ma-
duros como o Spring são mais poderosos.
Por exemplo, o Spring pode “injetar” ob-
 jetos arbitrários com construção complexa
(algo que pode exigir arquivos XML bem
grandes...), enquanto o mecanismo do Java
EE 5 é mais orientado a objetos publicados
na JNDI. Entretanto, a nova especificação
torna obsoletos os sistemas anteriores de
ID, pelo menos para as funcionalidades
em comum.
Uma maneira de ver essa diferença é que
a JSR-250 oferece um suporte a ID menos
radical, mais orientado ao desacoplamento
entre código de aplicação e recursos de
deployment (como DataSources, filas etc.),
e entre módulos numa arquitetura com-
ponentizada (neste caso, a ID configura
referências para EJBs ou web services).
 Já framework s esp ecial izados como o
Spring incentivam e permitem o uso de
ID intenso, de alta granularidade. Neste
estilo, praticamente nenhum recurso é
inicializado em código, coisa que para
alguns desenvolvedores parece ser uma
maravilha e para outros um excesso ou
abuso da técnica. Assim, podemos arriscar
que o Java EE 5 satisfará às necessidades de
ID da maioria dos desenvolvedores, mas
os adeptos mais radicais da técnica terão
que avaliar se preferem continuar usa ndo
algo como o Spring4, ou se preferem “mo-
derar” para ter os benefícios de escrever
aplicações “puro-Java EE”.
Os componentes do Java EE 5
Nada menos que 21 JSRs separadas, que
podemos ver na Tabela 1, contribuem
diretamente para o Java EE 5. Novas fun-
cionalidades são poucas, mas importantes:
a Java Persistence API (que sucede os EJB/
CMP) é a única API totalmente nova. Além
disso, temos a incorporação de APIs ante-
riormente independentes, como a StAX e
a JAXB, e atualizações de muitas outras. A
mudança mais sensível ao programador,
que é a introdução de anotações para faci-
litar o uso de muitas APIs, dá uma “cara”
de novidade, mas por si só não cria novas
funcionalidades – só permite fazer com
anotações as mesmas coisas que podíamos
e continuamos podendo fazer invocando
as APIs tradicionais.
Versões do Java EE e SE sempre compar-
tilham algumas novas APIs, e cada versão
do Java EE depende da versão anterior
mais recente do Java SE, ambas tradicional-
mente compartilhando o mesmo número.
O Java EE 5 depende do Java SE 5. Mas as
versões subseqüentes do Java SE sempre
incorporam algumas APIs introduzidas
inicialmente no Java EE. O Mustang ( Java
SE 6) é um exemplo disso, integrando as

public class LoginAction extends DispatchAction // usando Struts 3

Este exemplo é fictício, pois a ID só pode ser usada em
 @EJB(beanName=”ejb/session/Login”) protected LoginServer loginServer; classes que são gerenciadas pelo container, o que inclui-
public ActionForward doLogin (final ActionMapping mapping, final ActionForm form,
final HttpServletR equest request, final HttpServletR esponse response)
ria uma Servlet, mas não uma Action da Struts (que não
{ faz parte do Java EE). Mas confiamos que versões próxi-
LoginForm f = (LoginForm)fo rm; mas de frameworks populares como a Struts suportarão
boolean ok = loginServer.login(f.getUser(), f.getPassword()); integração com o Java EE, dando suporte à ID nos seus
// ... etc. artefatos.
} 4
Note que estes frameworks podem oferecer outras
} funcionalidades além de ID – por exemplo, no Spring, te-
mos os módulos de AOP e Web Flow.

22  Java Magazine • Edição 39

 jm39.indb 22 15/8/2006 18:15:12

 APIs de web services e XML agora incor-
poradas ao Java EE 5.
Um fenômeno importante que podemos
observar no Java EE 5 é o “refactoring”
de algumas especificações. Primeiro foi
a EL (Expression Language). Embora o
padrão JSP já possuísse uma linguagem de
expressões, a JSF criou uma nova e mais
poderosa, parecida mas não totalmente
compatível com a da JSP. Isso confundiu
os desenvolvedores e causou problemas
para a mistura de ambas as tecnologias em
uma mesma aplicação. A JSF também tinha
outras incompatibilidades com a especifi-
cação JSP, gerando páginas incorretas para
certas combinações de funcionalidades.
Estes problemas agora foram resolvidos
pelas últimas versões: temos uma nova EL
unificada que deverá servir igualmente às
necessidades da JSP e da JSF, e talvez de
outros frameworks. (Minha opinião é que
esta funcionalidade é fundamental, e com
as melhorias introduzidas pela nova EL,
deveríamos pensar em abandonar alter-
nativas como a OGNL, usada no Tapestry
e no WebWork.)
O segundo caso é a Java Persistence API
(JPA). Além do suporte a POJOs e anota-
ções, é igualmente importante o fato de a
nova API de persistência do Java EE 5 ser
independente da tecnologia EJB. A JPA é
definida num documento isolado e num
pacote próprio ( javax.persistence), e pode ser
utilizada também na plataforma Java SE
(o artigo “Persistência no Java EE” nesta
edição mostra um exemplo completo). É
um grande contraste com a especificação
EJB/CMP, que obriga a aplicação a su-
portar o peso de um container EJB e dos
Entity Beans.
EJB 3.0
Se existe um patinho feio na história do
 J2EE, sem dúvida é a tecnologia EJB, em
especial os Entity Beans, acusados de baixa
eficiência, alta complexidade e dificuldade
de uso. Por outro lado, os Session Beans
foram um sucesso. Com eles, obteve-se um
excelente equilíbrio entre a sofisticação e
o desempenho do CORBA, a simplicidade
do RMI, e as vantagens de baixo acopla-
mento do COM/COM+. Os EJBs também
implementam facilidades de controle de-
clarativo de segurança e de transações, alta
integração entre todo o “stack” de servidor
 jm39.indb 23
 JSR Descrição Java SE?
JSR-244: Java EE 5 Especificação “guarda-chuva” da plataforma Java EE 5. -
JSR-250: Anotações Comuns
Anotações compartilhadas pelo Java SE 6 e Java EE 5. 6
para a Plataforma Java
JSR-181: Anotações para Web
Especifica as anotações utilizadas pela JAX-WS 2.0. 6
Services
Novo agrupamento de APIs para web services, sucedendo a
JSR-224: JAX-WS 2.0 antiga JAX-RPC. Suporta padrões de web ser vices como SOAP 6
1.2 e WSDL 1.2, e binding pela JAXB 2.0.
Mapeamento automático entre objetos Java e XML. Agora
JSR-222: JAXB 2.0 dirigido por anotações, otimizado com o uso da StA X (JSR-173), 6
e com um runtime portável.
JSR-173: StAX
Nova API para parsing de XML no estilo “streaming” (ou “pull”),
6
mais eficiente que SAX (“push”) ou DOM.
Arquitetura de componentes com funcionalidades “enterprise”
(distribuição, segurança, transações etc.). A persistência agora
JSR-220: EJB 3.0 Não
é uma seção em separado, e introduz a Java Persistence API 1.0
(versões futuras terão JSR própria).
Toolkit orientado a componentes para criação de GUIs para
web. Não possui muitas novas funcionalidades, mas traz um
JSR-252: Java Server Faces 1.2 Não
alinhamento com a JSP, especialmente através da nova lingua-
gem de expressões (EL) unificada.
Não possui muitas novas funcionalidades, exceto pela nova
JSR-245: JSP 2.1 Expression Language, que agora é especificada em separado Não
(na mesma JSR, mas versões futuras terão JSR própria).
É o Maintenance Release 2 da mesma JSR da JSTL 1.0 e 1.1,
JSR-52: JSTL 1.2 Não
contendo só correções.
JSR-154: Servlet 2.5
É o Maintenance Release 1 da mesma JSR da Servlet 2.4, con-
Não
tendo só correções.
Mesma versão do J2EE 1.4. O plano era incluir no Java EE 5 a
JSR-54: JDBC 3.0 JDBC 4.0 (JSR-221), mas devido a atrasos, a nova JDBC foi rea- 5
gendada para o Java SE 6 e versões futuras do Java EE.
Atualização da API para e-mail, com muitas novas funcionalida-
JSR-919: JavaMail 1.4 Não
des e melhorias de desempenho.
Pequena atualização da API que estende os JavaBeans com
JSR-925: JavaBeans Activation
Framework 1.1
suporte a handlers ativados conforme tipos M IME. Usada tradi- 6
cionalmente pela API JavaMail, e agora também pela JAX-WS.
JSR-115: JACC 1.1 Maintenance Release 1 da API para provedores de autorização. Não
JSR-45: Debugging para Mesma versão do J2EE 1.4. Permite a depuração de códigos
Não
Outras Linguagens não-Java que gerem bytecode, por exemplo JSP e SQLJ.
JSR-914: JMS 1.1 Mesma versão do J2EE 1.4. Não
JSR-907: JTA 1.1 Maintenance Release 1 da API para transações. Não
Arquitetura de conectores para sistemas de informação (EIS)
JSR-112: JCA 1.5 Não
não-Java. Mesma versão do J2EE 1.4.
JSR-88: Java EE Application Maintenance Release 2 do padrão de APIs e descritores que
Não
Deployment 1.2 permitem o deployment portável de aplicações Enterprise.
JSR-77: Java EE Management 1.1 Maintenance Release 1 da API para gerenciamento de servidores. Não
Tabela 1. JSRs componentes do Java EE 5.
Edição 39 •  Java Magazine 23
15/8/2006 18:15:12
  Java EE 5
de aplicações (ex.: uma mensagem SOAP
chega num Message-Driven Bean, onde é
automaticamente mapeada, verificações
de segurança são feitas, uma transação
XA é criada etc.).
Este artigo não teria espaço para tratar
igualmente todas as funcionalidades do
 Java EE 5, mas basta dizer aqui que outros
recursos do EJB também são “envenena-
dos” por Injeção de Dependências e por
anotações como @SecurityRoles, @Interceptor ,
@MessageDriven etc.
 A Java Persistence API (JPA)
Qual é a nova prática recomendada para
aplicações Java EE que acessam bancos de
dados? A mesma que muita gente, fugin-
do dos Entity Beans, já vinha praticando
há anos: usar só Session Beans (para a
comunicação remota, controle de transa-
ções, segurança etc.), criar uma camada
de POJOs para as entidades, e persisti-los
com uma ferramenta como o Hiber nate. A
diferença é que agora você pode substituir
a API do Hibernate pela JPA, que funciona
da mesma maneira, mas é um padrão do
 Java EE. E pode esquecer dos DAOs, pois
a persistência direta de POJOs dispensa
códigos de conversão de/para objetos
exigidos pela persistência, e o código de
persistência que você terá que escrever é
tão pouco que não justifica encapsulá-los
numa camada de DAOs.
A Listagem 3  apresenta um exemplo
completo de EJB 3.0 e da Persistence API.
O código é simples, e além disso familiar
para quem já usou o Hibernate. A classe
EntityManager faz as vezes da classe Session
do Hibernate, sendo até mais fácil de usar
– não precisamos implementar uma Fac-
tory para ler a configuração, instanciar a
Session, garantir que cada thread use sem-
pre a mesma Session etc. São as vantagens
da integração com o container Java EE, e
é claro, da Injeção de Dependências. Note
que o método EntityManager.find()  é genérico,
retornando o objeto já com o tipo correto, o
que dispensa o typecast que precisaríamos
com o Session.get() do Hibernate.
O código da Listagem 3 só não constitui
uma aplicação completa porque também
precisamos de um descritor de “unidade
de persistência” ( persistence.xml). Bastaria
então reunir estas classes e o descritor num
arquivo .ear, e instalá-lo no container.
24  Java Magazine • Edição 39
 jm39.indb 24
Aproveite para observar, neste exemplo de um novo projeto que precisa de persistência
concreto, outras simplificações do EJB objeto-relacional, recomendo pensar bem antes
3.0 que já mencionamos: nada de inter- de decidir usar os já obsoletos Entity Beans, seja
faces Home, nem exceções RemoteException com BMP ou com CMP.
(mesmo ao usar a interface remota), nem
herança de interfaces do framework, e
como veremos, um empacotamento mais Qual é a relevância da JPA para os adep-
simples. tos de outras soluções (não-EJB) de persis-
tência? Nenhum sistema O/R será ideal
 As especificações CMP e CMR são agora desa- para todas as aplicações e a concorrência
 provadas (deprecated); não haverá mais evolução deve continuar existindo, mas creio que a
destas tecnologias, e implementações futuras (tal-  JPA tende a se impor como um forte pa-
vez a partir do Java EE 6) não terão que suportá-las drão, ao unificar o status de API oficial do
 para obter certificação. Note que o pacote javax.ejb  Java EE 5 com qualidades de facilidade de
define anotações para Session Beans ( @Stateful e uso e compatibilidade com o Java SE (antes
@Stateless ) e MDBs ( @MessageDriven ), mas nenhuma exclusividades do JDO, Hibernate e outras
anotação para Entity Beans. A minha interpreta- soluções). Até mesmo a API do popular
ção é que além dos CMPs, os próprios Entity Beans Hibernate deve perder terreno; o projeto já
estão “marcados para morrer” num release futuro oferece uma implementação (hoje em beta)
do Java EE. Alguns podem ficar confusos, pois a da Persistence API, o Hibernate Entity
Persistence API possui uma anotação @Entity que Manager (HEM). O HEM é uma “casca”
denota entidades persistentes; mas esta anota- que implementa a nova API padronizada
ção não tem qualquer relação com Entity Beans. pela JSR-220, mas que possui no núcleo o
Resumindo, se você está na fase de prospecção runtime tradicional do Hibernate 5. Pode
Listagem 3.Uma aplicação EJB 3.0 completa, com persistência e Session Bean.
// Entidade persistente simples
import
import
java.io.Serializable;
javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
 @Entity public class Usuario implements Serializable {
private Long id;
private String nome;
private String senha;
 @Id @GeneratedValue(strategy=GenerationType.AUTO)
public Long getId () { return id; }
  public void setId (Long id) { this.id = id; }
public String getNome () { return nome; }
public void setNome (String nome) { this.nome = nome; }
public String getSenha() { return senha; }
public void setSenha (String senha) { this.senha = senha; }
}
// Interface remota do Session Bean
import javax.ejb.Remote;
 @Remote public interface LoginServer {
Usuario find (Long id);
}
// Session Bean que utiliza a entidade persistente
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
 @Stateless public class LoginServerBean implements LoginServer {
 @PersistenceContext EntityManager em;
public Usuario find (Long id) {
return em.find(Usuario.class, id);
}
}
15/8/2006 18:15:14
 Edição 39 •  Java Magazine 25

 jm39.indb 25 15/8/2006 18:15:18

  Java EE 5
ser usado em qualquer servidor Java EE
5 que suporte EJB 3.0 6 e até sem servidor
algum, em aplicações Java SE 5.
Empacotamento
Uma das melhorias de facilidade de
uso mais discretas do Java EE 5, mas nem
por isso pouco importante, está nos seus
padrões de pacotes para deployment, os
arquivos EAR, WAR e outros, que tradicio-
nalmente exigiam uma estrutura bastante
complexa.
A estrutura básica continua existindo.
Por exemplo, uma “enterprise application”
continua sendo empacotada num arquivo
EAR, dentro do qual pode-se ter arquivos
 JAR com os EJBs, um folder META-INF com
descritores e assim por diante. As melhorias
são duas. Primeiro, os descritores tendem a
ser bem menores (e até opcionais), graças
ao novo modelo de anotações + POJOs +
defaults. Segundo, não é mais preciso decla-
rar obviedades ou informar a mesma coisa
duas vezes – o Java EE aprendeu a seguir o
princípio DRY (don’t repeat yourself ).
Um bom exemplo disso é a configuração
de JARs utilitários, que são colocados na
pasta  /lib   de um EAR, mas antigamente
isso não era suficiente: era preciso declarar
todos os JARs no  META-INF/MANIFEST.
 MF, na diretiva Classpath. Agora nada disso
é necessário – o container irá detectar todos
os arquivos lib/*.jar e incluí-los no classpath
do módulo EAR.
Aplicações web (WAR) que usem somente
 JSP e tecnologias relacionadas como JSTL,
mas não servlets, não precisam de nenhum
descritor (WEB-INF/web.xml). O mesmo
vale para WARs expondo web services (não
precisam mais de um webservices.xml , nem
de arquivos da JAX-RPC).
Além disso, os EARs não precisam mais
do application.xml. Os application clients
também dispensam o application-client.xml;
 basta ter no  META-INF/MANIFEST.MF o
 Main-Class apontando para a classe princi-
pal da aplicação. Finalmente, módulos EJB
também não precisam obrigatoriamente do
ejb-jar.xml, bastando que o arquivo JAR do
módulo possua anotações como @Stateless.
Tudo isso não quer dizer que os descrito-
res tenham desaparecido completamente.
Continuam sendo suportados, e às vezes
podem ser necessários. A diferença é que
agora, só é preciso criar descritores quando
são realmente necessários.
26  Java Magazine • Edição 39
 jm39.indb 26
 JavaServer Faces
A inclusão da JSF 1.2 é a única grande
novidade de funcionalidade do Java EE 5 7.
Este anúncio de “grande novidade” pode
parecer uma surpresa para os já adeptos
da JSF, comumente utilizada em servidores
 J2EE 1.4. Mas o fato é que até então, nenhu-
ma versão da JSF fez parte, oficialmente, da
plataforma J2EE (a JSF 1.0, JSR-127 (março
de 2004) é posterior à J2EE 1.4 (novembro
de 2003)).
Mas isto talvez tenha sido bom, pois a
 JSF é uma tecnologia complexa que teve
um período relativamente longo de ama-
durecimento – de reclamações sobre o de-
sempenho das primeiras implementações,
a trapalhadas como problemas de compati-
 bilidade com as especificações JSP e EL, que
só recentemente foram resolvidos. Assim,
pode ser uma boa coisa que somente agora,
 já na sua terceira revisão e com muitas des-
sas “dores de crescimento” superadas, a JSF
tenha sido integrada ao complexo conjunto
de especificações e tecnologias que forma a
plataforma Java EE.
A JSF é um framework orientado a com-
ponentes para geração de GUIs web. Isto se
insere melhor na arquitetura geral do Java
EE, que já possui modelos de componentes
para regras de negócio, serviços, integra-
ção com recursos e sistemas externos etc.
Faltava suportar o mesmo paradigma no
lado do cliente, até então servido apenas
por opções “força-bruta” (Servlets) ou de
templates (JSP – mesmo com extensões
como EL, JSTL, Struts etc.). Por “orientado
a componentes” queremos dizer que a JSF
permite construir GUIs através da compo-
sição de objetos e (em se tratando de GUI)
do tratamento de eventos gerados por estes
objetos. Um benefício desta arquitetura é a
separação entre o comportamento da GUI
e a sua apresentação. Outro é a facilidade
para a construção de ferramentas pura-
mente visuais.
Web services e XML: JAXB 2.0, JAX-WS 2.0, StAX  o JBoss ainda não possua (no momento em que escrevo)
O Java EE 5 incorpora uma segunda gera-
ção de APIs para web services, integradas
inicialmente ao J2EE 1.4. Não há novidades
revolucionárias, mas temos muitas atuali-
zações no suporte às últimas especificações
do W3C, WS-I e OASIS. Melhorias de de-
sempenho críticas, como o suporte a StAX
e Fast Infoset (codificação binária de XML);
aperfeiçoamentos de arquitetura, como o
runtime portável da JAXB 2.0; e é claro,
facilidade de programação com anotações
e suporte a POJOs.
Quanto aos web services, seu principal
atrativo sobre soluções mais maduras
e eficientes – segundo as más línguas,
qualquer outra coisa – sempre foi a inte-
roperabilidade. Um importante anúncio
no JavaOne 2006 foi o Projeto Tango 8, um
esforço conjunto da Sun e da Microsoft
para alinhar as implementações de web
services – de um lado, as APIs do Java Web
Services Developer Pack (JWSDP) e do Java
EE 5; do outro, o Windows Communication
Framework (parte do .NET 3.0). O projeto
Tango foi focado não só na interoperabili-
dade, mas também em eficiência, facilidade
de uso, segurança, suporte a transações e
outras características.
Pode parecer estranho que uma tecnolo-
gia criada sob medida para a interopera-
 bilidade, baixo acoplamento etc., precise
de esforços contínuos para funcionar
corretamente entre as duas principais pla-
taformas de mercado que a implementam.
Mas o problema é que as especificações de
web services continuam se multiplicando e
evoluindo a uma velocidade tão grande que
as implementações estão sempre correndo
atrás, e tendo que corrigir dificuldades cau-
sadas por bugs de implementação ou por
especificação insuficiente. Para mais sobre
o assunto, veja meu artigo “Web services e
SOA”, na Edição 34.
Conclusões
Neste artigo demos as primeiras pince-
ladas no Java EE 5, a plataforma que todos
usaremos em algum ponto para aplicações
5
A API proprietária do Hibernate possui algumas funcio-
nalidades que ainda não existem na JPA (como as queries
“Criteria”), mas isso só afeta usuários mais avançados. A
maioria pode migrar facilmente para a JPA, ganhando
com isso as vantagens de padrões do Java EE, como im-
plementações concorrentes, maior suporte de IDEs etc.
6
É o caso do JBoss 4.0, cujos últimos releases (compatí-
veis com o J2EE 1.4) suportam também o EJB 3.0, embora
uma versão que suporte a plataforma Java EE como um
todo.
7
A JPA é uma nova API , mas não uma nova funcionali-
dade (a não ser qualitativamente), já que as versões an-
teriores do J2EE já suportavam persistência O/R com os
Entity Beans.
8
O codinome “Tango” é específico ao lado da Sun do
projeto, e achei ótimo. Afinal, o Tango é uma dança lenta,
formal e sombria, e das mais difíceis de executar sem es-
corregar para o ridículo (pelo menos no estereótipo que
aprendi no cinema: ver Quanto Mais Quente Melhor   com
Jack Lemmon, e O Baile de Ettore Scola).
15/8/2006 18:15:21
  Java server-side. Como vimos, a principal
promessa desta versão é a mesma do Java
SE 5: facilidade de desenvolvimento. E não
é sem tempo, pois a escalada dos requisitos
das aplicações que temos que construir, e
das tecnologias em voga (SOA, Web 2.0...)
 já torna nosso trabalho difícil mesmo
quando nossas ferramentas são simples
e racionais.
Com o objetivo de cumprir esta pro-
messa, o grupo de experts que defin iu
o Java EE 5 (e suas muitas APIs com-
ponentes) tomou decisões corajosas,
como a substituição total da malfa-
dada especificação de persistência
do EJB, e decisões humildes como a
introdução de técnicas populariza-
das por projetos open source, que
acabaram conquistando a comuni-
dade de desenvolvedores Java.
Procuramos exibir um pouco
destes avanços na facilidade de
desenvolvimento com o tutorial
no quadro “Glassfish: O Java EE
5 open source”. Algumas vanta-
gens só serão sentidas de fato em
aplicações bem mais complexas
do que os limites impostos por
um artigo (mesmo com um
tutorial mais extenso). Mas é
transparente o esforço que o
 JCP fez, nesta última revisão
do Java EE, para renovar o
velho J2EE, reduzindo muito
sua complexidade.

 jcp.org/en/jsr/detail?id=244
JSR-244, padrão do JCP que define a
plataforma JEE 5.
 java.sun.com/javaee
JEESDK 5 / Sun Java System Application Server 9.
 glassfish.dev.java.net 
Projeto GlassFish.
 javamagazine.com.br/downloads/jm39/ 
 jm-jee5.zip

Osvaldo Pinali Doederlein

(opinali@gmail.com) é Mestre em
Engenharia de Software Orienta-
do a Objetos, membro individual
do Java Community Process (tendo par-
ticipado do Expert Group da JSR-170: Tiger/J2SE 5.0), e
trabalha na Visionnaire Informática como arquiteto e
desenvolvedor.

Edição 39 •  Java Magazine 27

 jm39.indb 27 15/8/2006 18:15:26

 Persistência no Java
Iniciando com a Java Persistence API
O principal foco da versão 5 do Java
EE é a facilidade de uso. O novo
 Java EE é bem mais simples que
sua versão anterior e suas novas APIs
aumentam a produtividade dos desenvol-
 
 
vedores, exigindo menos esforço de codi-
ficação. Uma das principais novidades do  
 Java EE 5 é a sua nova API de persistência.
Há muito tempo esperada pela comunidade  
 Java, a Java Persistence API (JPA) padroniza
as operações de persistência sobre entida-
des Java, definindo uma especificação para
mapeamento objeto-relacional. Neste artigo
apresentaremos a JPA através da criação de
um exemplo completo.
Persistência e mapeamento O/R
Como sabemos, a tecnologia de banco
de dados relacionais existe há décadas, e
hoje os SGBDs são robustos e confiáveis.
Os principais problemas relacionados ao
armazenamento e recuperação de dados já
foram solucionados, e o investimento das
empresas nesses sistemas também é imen-
so, o que torna a sua utilização uma regra.
O uso dos bancos de dados relacionais,
no entanto, traz alguns inconvenientes ao
programador de linguagens orientadas
a objetos como Java. As tecnologias OO e
relacional são bastante diferentes, e seu uso
conjunto normalmente implica em enfati-
zar uma tecnologia em sacrifício da outra.
Como os bancos de dados OO ainda estão
muito menos disseminados que os bancos
de dados relacionais, o desafio atual dos de-
senvolvedores é unir dois mundos comple-
tamente distintos, utilizando a tecnologia
relacional para armazenar objetos.
O armazenamento de objetos de uma
aplicação é denominado  persistência de ob-
 jetos. Essa técnica permite que as instâncias
existentes no sistema sejam armazenadas e
posteriormente recuperadas, conservando-
se o seu estado mesmo após a aplicação ter
sido finalizada.
28  Java Magazine • Edição 39
 jm39.indb 28
Abordagens atuais de mapeamento
Desde as suas primeiras versões, a plataforma Java oferece
acesso a bancos de dados através da API JDBC, que tra-
balha no mesmo nível do banco, sendo o acesso às in-
formações armazenadas feito através de comandos
SQL. Em muitos aspectos, a JDBC é uma API de
baixo nível, que muitas vezes exige do desen-
volvedor o conhecimento das “nuances” do
banco de dados. Apesar de ser uma manei-
ra eficiente de acessar dados em SGBDs
relacionais, e a opção que normalmente
oferece melhor performance, a JDBC
oferece uma abstração OO bastante
limitada (trabalha-se com tabelas,
registros e resultsets, ao invés de
objetos).
Para usar os recursos de bancos
de dados relacionais em Java e
ainda assim aproveitar os concei-
tos do paradigma OO, é necessá-
rio fazer o que se conhece como
mapeamento objeto-relacional (ou
simplesmente mapeamento O/R).
No mapeamento O/R as classes
e os atributos do sistema são
mapeados para tabelas e cam-
pos/colunas, e a persistência
é feita de forma transparente
pela aplicação. Assim, objetos
em memória são armazenados
no banco, e objetos do banco são
trazidos para a memória sempre
que necessário. Com paradigmas
tão diferentes, diversas questões
surgem durante o mapeamento:
Como mapear herança? E agregação?
Cada classe deve virar uma tabela?
Como aproveitar os recursos do banco
sem perder a abstração de objetos?
Para suprir essas necessidades, surgiram
diversos frameworks e tecnologias de persis-
tência, a exemplo do Hibernate e do iBatis. Essas
ferramentas facilitam o trabalho do desenvolvedor
e aumentam sua produtividade, fornecendo poderosas
APIs de manipulação de dados. Apesar de cada ferramenta
15/8/2006 18:16:30
 EE 5
Aprenda a utilizar a nova API
de persistência do Java através
de um exemplo completo,
ANDRÉ DANTAS ROCHA E SÉRGIO OLIVEIRA K UBOTA
possuir uma forma distinta de efetuar o mapeamento O/R, os
conceitos são semelhantes e relativamente simples, baseando-
se em POJOs (Plain Old Java Objects).
O termo Plain Java Old Object (ou simplesmente POJO)
foi criado por Mar tin Fowler, Rebecca Parsons e Josh Ma-
cKenzie em 2000. A tradução é algo como “velho e bom
objeto Java” e refere-se a objetos/classes Java simples,
não atrelados a ferramentas ou frameworks.
A Java Persistence API
Até o J2EE 1.4 a plataforma Java
não possuía uma forma simples de
mapear objetos no banco de dados.
A única opção era a utilização de
Entity Beans, que exigem um
container EJB e possuem uma
complexidade razoável 1. Apli-
cações cuja arquitetura não en-
volvia EJBs precisavam utilizar
ferramentas não padronizadas
como o Hibernate para fazer
a persistência, ou fazer a im-
plementação de persistência
manualmente.
A Java Persistence API, de-
finida na  JSR-220 (Enterprise
 JavaBeans,Version 3.0), padroni-
za o mapeamento objeto-relacio-
nal na plataforma Java. Apesar
de descrita na especificação do
novo EJB, a JPA não depende de
um container para funcionar, sen-
do possível usar e testar soluções
apenas com o Java SE 2.
A JPA é uma especificação baseada
no conceito de POJOs, que incorpora
idéias de renomados frameworks de per-
sistência para padronizar o mapeamento
O/R em Java. A API oferece uma solução
completa para mapeamento e persistência de
objetos:
• Um modo declarativo de descrever mapeamen-
tos O/R
• Uma linguagem de consulta
 jm39.indb 29
com foco no uso em
aplicações Java SE
Um conjunto de ferramentas para
•
manipular entidades
Em se tratando de um padrão do Java
Community Process, a JPA traz diversos
 benefícios. O uso de um padrão para a per-
sistência de objetos permite que diversos
fabricantes trabalhem sobre os mesmos
conceitos e que o desenvolvedor escolha
a implementação de sua preferência. A
padronização também traz outra impor-
tante vantagem: pode-se alternar entre
implementações de fabricantes distintos,
que estejam em conformidade com a
 JSR-220, sem nenhum esforço adicional.
Dessa forma, uma aplicação codificada de
acordo com o novo padrão irá funcionar
com qualquer implementação da JPA, não
havendo necessidade de se conhecer (a
princípio) qual tecnologia será utilizada
para essa implementação.
Conceitos básicos
Na JPA os objetos persistentes são deno-
minados entidades ( entities). Uma entidade
é um objeto simples (POJO), que representa
um conjunto de dados persistido no banco.
Como entidades são definidas por classes
 Java comuns, sem relação com frameworks
ou bibliotecas, elas podem ser abstratas ou
herdar de outras classes, sem restrições.
Um conceito importante é que as entida-
des possuem um identificador (descrito
pela chave primária) e estado, sendo seu
tempo de vida independente do tempo
de vida da aplicação. Assim, aplicações
distintas podem compartilhar a mesma
entidade, que é referenciada através de
seu identificador.
1
 No Java EE 5.0, os “Entity Beans” foram revistos e se tor-
naram bem mais simples de usar
2
 A independência do container trouxe uma grande me-
lhoria na testabilidade das aplicações que mapeiam dados
do banco
Edição 39 •  Java Magazine 29
15/8/2006 18:17:25
 Persistência no Java EE 5
Para que uma entidade se torne persisten-
te é necessário associá-la a um  persistence
context (contexto de persistência), que
fornece a conexão entre as instâncias e
o banco de dados. A manipulação das
entidades é feita, a partir desse contexto,
por meio do entity manager (gerenciador
de entidades), que é responsável por
executar as operações básicas sobre a
entidade (criação, atualização, exclusão,
localização, consultas etc.). O  entity ma-
nager na JPA é uma instância da interface
 javax.persistence.EntityManager.
A implementação da JPA é feita por um
 persistence provider (provedor de persistên-
cia). O provedor define “como as coisas
funcionam”, através da implementação de
todas as interfaces definidas pela especifi-
cação da JPA. Dessa forma, cada provedor
decide a maneira e o momento de carre-
gar, atualizar e armazenar as entidades,
assim como sincronizar os dados com o
 banco. As configurações utilizadas pelo
provedor em uma determinada aplicação
(conexão com o banco de dados, entidades
que serão gerenciadas, tipo de transação
etc.) são descritas em uma persistence unit,
que é configurada num arquivo especial
denominado persistence.xml.
 Mapeamento
As classes e interfaces da JPA estão
localizadas no pacote  javax .persiste nce. A
API faz uso intensivo de anotações 3; por
isso não é necessário criar descritores
XML para cada uma das entidades da
aplicação4. Uma entidade é uma classe
 Java comum, rotulada através da anota-
ção @Entity. Não é preciso implementar
interfaces ou estender outras classes
para tornar uma classe “persistível”; a
única exigência é que a classe da entidade
possua um construtor sem parâmetros,
pois a instanciação da classe é feita por
reflexão.
No código a seguir a classe Pessoa re-
presenta uma entidade. O atributo cpf  é o
identificador da entidade (chave primária),
especificado através da anotação @Id :
@Entity
public class Pessoa {
@Id
private String cpf;
} Essa linguagem pode ser usada como
30  Java Magazine • Edição 39
 jm39.indb 30
Grande parte da produtividade trazida
pela JPA deve-se à utilização de valores
default de mapeamento, que facilitam
 bast ante o trabalho do desenvolvedor.
Assim, o que não é definido explicitamente
assume a configuração padrão da API. Por
exemplo, por padrão a JPA considera o
nome da entidade o mesmo nome da tabela
no banco de dados e o nome da proprie-
dade o mesmo nome da coluna. No código
anterior, a entidade Pessoa será salva na
tabela PESSOA e a propriedade cpf  na coluna
CPF. Caso seja necessár io alterar a forma de
mapeamento, devem-se utilizar as anota-
ções @Table e @Column, por exemplo:
@Entity
@Table(name=”TB_PESSOA”)
public class Pessoa {
@Id
  @Column(name=”DS_CPF)”
private String cpf;
}
Outro padrão utilizado pelo JPA é con-
siderar todas as propriedades de uma en-
tidade como persistentes (o mapeamento
segue as regras descritas anteriormente).
Caso seja desejável excluir alguma pro-
priedade do mapeamento (ex.: no caso
de ela poder ser criada a partir de outras
propriedades), basta marcá-la com a ano-
tação @Transient :
@Entity
public class Pessoa {
@Id
private String cpf;
  @Transient
private String nomeCompleto;
}
Os dados de uma única entidade po-
dem estar distribuídos em mais de uma
tabela, e diversos tipos de relacionamen-
tos entre entidades são possíveis. Os
mais comuns são os de agregação (ano-
tações @OneToOne, @OneToMany, @ManyToOne,
@ManyToMany, etc.) e herança (anotação
@Inheritance ), que serão vistos mais adiante.
Consultas
A JPA oferece suporte a consultas es-
táticas e dinâmicas. A API fornece uma
linguagem própria de consulta, que é
uma extensão bastante poderosa da EJB
QL (a linguagem de consultas do EJB).
uma alternativa ao SQL, que também é
suportado. As consultas suportam poli-
morfismo, o que significa que quando uma
entidade é consultada, todas as entidades
descendentes que atendam ao critério da
consulta também são retornadas. A criação
de consultas é feita através do EntityManager,
que fornece métodos específicos para
instanciar consultas estáticas e dinâmicas,
além de permitir a execução das operações
CRUD5.
As consultas estáticas possuem nomes e
são descritas pela anotação @NamedQuery.
Elas são definidas nas entidades corres-
pondentes e ficam “pré-compiladas”. Veja
um exemplo de consulta estática para
localizar uma pessoa pelo seu CPF:
@NamedQuery(name = “consultarPorCPF”,
query = “SELECT p FROM Pessoa p WHERE p.cpf = :cpf”)
O EntityManager utiliza o nome da consul-
ta para instanciá-la, o que é feito através
do método createNamedQuery(). Depois que
a consulta é criada, basta setar os parâ-
metros e executá-la. A execução pode
ser feita pelos métodos getSingleResult()
ou getResultList(), a depender do resultado
esperado. Por exemplo, para localizar uma
pessoa pelo CPF (supondo que o retorno
será único), basta executar a consulta con-
forme o exemplo abaixo:
Query consulta =
manager.createNamedQuery(“consultarPorCPF”);
consulta.s etParameter (“cpf”, “111.111.111-11”);
Pessoa pessoa = consulta.getSingleResult();
As consultas dinâmicas não possuem
nome, e podem ser construídas em tem-
po de execução. A criação desse tipo
de consulta é feito através do método
createQuery() :
Query consulta = manager.createQuery(
“SELECT p FROM Pessoa p WHERE p.cpf = :cpf”);
3
 As anotações surgiram da versão 5.0 do Java e estão
presentes na maioria das APIs do novo JEE.
4
Mesmo não sendo obrigatório o uso de XML para
descrever o mapeamento, ainda é possível utilizar essa
opção. Um exemplo típico é o arquivo  persistence.xml ,
que guarda as configurações da unidade de persistência
e é utilizado neste artigo.
5
 As principais operações executadas sobre dados são
conhecidas através da sigla CRUD ( Create, Read, Update,
e Delete).
15/8/2006 18:17:25
 É interessante notar que a execução de
ambas as consultas é idêntica, uma vez
que as duas são objetos do t ipo Query.  
Um exemplo completo
Agora que os conceitos básicos da JPA
foram apresentados, partiremos para
um exemplo completo, onde a API será
demonstrada na prática.
Enquanto a maioria dos artigos sobre
 JPA foca no uso de EJBs, aqui faremos
uma abordagem distinta. No exemplo
deste artigo implementaremos uma apli-
cação desktop sem nenhum víncu lo com
um container EJB. O objetivo é mostrar
que a JPA pode ser utilizada no Java SE
facilmente. Usaremos na camada de per-
sistência o TopLink Essentials e o MySQL.
O TopLink Essentials é a versão open
source do TopLink, uma ferramenta de
mapeamento objeto-relacional da Oracle.
O TopLink Essentials implementa a JPA e
é utilizado no projeto GlassFish, que é a
 base da implementação de referência do
 Java EE 5.0. Por simplicidade, e para focar
melhor na API, não implementamos uma
interface gráfica. O código completo da
aplicação está disponível no site da Java
Magazine. Veja mais sobre o ambiente
utilizado e como executar a aplicação
de exemplo no quadro “Configurando o
ambiente”.
A aplicação implementa um sistema
(bastante simplificado) para gerencia-
mento de uma locadora de veículos. Na
Figura 1 é exibido seu diagrama de clas-
ses e na Figura 2 o modelo ER (Entidade-
Relacionamento) utilizado.
 Mapeamento do cliente
Começaremos com o mapeamento da
classe Cliente, a mais simples da aplica-
ção. O código da classe é mostrado na
Listagem 1. Como vimos, a anotação
@Entity torna a classe “persistível”, permi-
tindo a sua manipulação pela JPA.
Note que não foi necessário utilizar a
anotação @Table para especificar a tabela
utilizada para persistência, uma vez que
uma tabela de mesmo nome é usada para
persistir os clientes ( CLIENTE). A identida-
de de cada cliente é definida através da
propriedade codigo. A anotação  @Id indica
que esse campo é utilizado como iden-
 jm39.indb 31
tificador ou chave primária, e @Column pecificado pela anotação @GeneratedValue(
especifica a coluna correspondente no strategy = GenerationType.IDENTITY) :
banco (CD_CLIENTE ). No nosso caso, a chave
@Id
primária da entidade será gerada auto- @Column(name = “CD_CLIENTE”)
maticamente pelo banco através de um @GeneratedValue(strategy = GenerationType.IDENTITY)
campo de auto-incremento, o que é es- private Integer codigo;
Configurando o ambiente
P ara executar o exemplo disponível no
site da Java Magazine, será necessário ter
instaladas as ferramentas Eclipse 3.2, MySQL e
pode variar.) Isso extrai , entre outros, o arquivo
toplink-essentials.jar , que deve ser adicionado
ao projeto no Eclipse.
TopLink Essentials.
Executado a aplicação
Eclipse 3.2 Após esses passos, a aplicação estará pron-
O Eclipse 3.2 foi o IDE escolhido para imple- ta para ser iniciada. O projeto já contém a
mentar o exemplo. O download pode ser feito configuração do  persis tence unit , localizada
a partir de eclipse.org/downloads . Para quem no arquivo META-INF/persistence.xml . Para
ainda não usa o Eclipse, a instalação é simples, rodar a aplicação basta executar a classe
bastando extrair o conteúdo do arquivo com- br.com.jm.locadora.Principal . Durante a execução,
pactado para o diretório de sua preferência. o console mostrará as seguintes mensagens:
Após a instalação do Eclipse, o projeto de exem-
Populando tabelas... OK
plo deve ser importado para o IDE. A estrutura
Listando todas as reservas...
do projeto é mostrada na Figura Q1.
 Sérgio - BMW
 André - ECO SPORT
 MySQL Listando todas as locacoes...
O MySQL é usado no exemplo devido à sua  André - ECO SPORT
facilidade de instalação e configuração. O Listando reservas entre 01/06/2006 e 01/08/2006...
download do MySQL e do MySQL Connector/J  André - ECO SPORT
(driver JDBC) podem ser feitos em dev.mysql. Listando dados do veículo ABC1234...
com/downloads. Escolha a versão adequada  ECO SPORT - ABC1234 [Utilitario]
ao seu sistema operacional e siga as instruções
fornecidas no help. Após instalar, crie um data-
base com nome “locadora” e execute o script
de criação das tabelas.
O arquivo compactado do dri-
ver Connector/J contém a biblioteca
mysql-connector-java-3.1.12-bin.jar (a versão
pode variar), que deve ser adicionado ao pro-
 jeto do Eclipse.
Toplink Essentials
O Toplink Essentials é a implementação da
JPA utilizada no projeto GlassFish (glassfish.dev.
 java.net ). O download pode ser feito a partir
da página do projeto: oracle.com/technology/ 
 products/ias /toplink/jpa /download.html . Após
baixar o arquivo execute o comando:
java –jar glassfish-persistence-installer-v2-b11.jar
(Lembrando mais uma vez que a versão Figura Q1. Estrutura do projeto.
Edição 39 •  Java Magazine 31
15/8/2006 18:17:26
 Persistência no Java EE 5

O mapeamento das propriedades nome
e endereco  é muito simples. Ambas as pro-
priedades possuem a anotação @Column,
contendo dois atributos: name, que define a
coluna correspondente no banco; e nullable,
Veiculo
{ From model }
 Attributes
private String placa
private String modelo
private Integer ano
private String cor
private Double diaria
Esportivo
{ From model }
 Attributes
private Integer velocidade
Figura 1. Diagrama de classes do sistema de locação de veículos.
que define se a propriedade em questão A propriedade reservas é um pouco mais
pode ser nula: complexa, pois ela determina um rela-
cionamento um-para-muitos. No nosso
@Column(name = “DS_NOME”, nullable = false) modelo, um cliente pode estar relacionado
private String nome; a diversas reservas, sendo que cada reserva
relaciona-se a um único cliente.
A anotação @OneToMany  é usada para
indicar o relacionamento entre as enti-
Reserva Cliente
dades (um cliente para muitas reservas).
{ From model } { From locadora } As reservas do cliente são armazenadas
veiculo  Attributes
cliente Attributes na propriedade reservas (uma lista de
private String codigo
private Date inicio
private String codigo
private String nome
instâncias da entidade Reserva), que é po-
private Date fim private String endereco pulada automaticamente pelo TopLink.
Dois atributos da anotação são utilizados
reserva nesse mapeamento: cascade = CascadeType.ALL
indica que alterações na entidade Cliente
Utilitario Locacao serão refletidas automaticamente nas
{ From model } { From model } entidades Reserva relacionadas. O atributo
 Attributes  Attributes mappedBy = “cliente” indica que na classe
private Integer passageiros private Integer codigo
Reserva  existe uma propriedade denomi-
nada cliente, que mapeia o cliente do rela-
cionamento (veremos mais sobre a classe
Reserva adiante).

@OneToMany(cascade =
CascadeType.ALL, mappedBy = “cliente”)
private List<Reserva> reservas;

 Mapeamento do veículo
Na modelagem OO da aplicação decidi-
mos especializar a classe Veiculo, guardan-
do as particularidades de cada veículo em
classes específicas (veja a Figura 1). Veiculo
é uma classe abstrata, que possui duas
Figura 2. Modelo Entidade-Relacionamento para o sistema de locação de veículos. subclasses: Esportivo e Utilitario.
No modelo relacional a abordagem foi
distinta. Para evitar o custo de  joins, to-
Listagem 1.Cliente.java
dos os veículos foram mapeados em uma
package br.com.jm.locadora.model; única tabela, que contém propriedades
import java.util.List; tanto genéricas quanto específicas. Como
import javax.persistence.*; veremos a seguir, o nosso mapeamento
@Entity deve contemplar essa decisão arquitetural
public class Cliente { e permitir que os objetos sejam instan-
@Id ciados corretamente (de acordo com sua
@Column(nam e = “CD_CLIENTE”)
@GeneratedValue(strategy = GenerationType.IDENTITY)
classe), mesmo com todos residindo em
private Integer codigo; uma tabela genérica.
@Column(nam e = “DS_NOME”, nullable = false)
Vamos analisar o código da entidade
private String nome; Veiculo (Listagem 2). Como já conhecemos
@Column(nam e = “DS_ENDERECO” , nullable = false) as anotações @Entity, @Id e @Column, veremos
private String endereco; apenas as novas construções.
@OneToMany( cascade = CascadeType .ALL, mappedBy = “cliente”) O mapeamento da herança de entidades
private List<Reserva> reservas; é descrito através da anotação @Inheritance,
// ... gets e sets omitidos que define a estratégia usada no mape-
} amento. De forma semelhante a outros

32  Java Magazine • Edição 39

 jm39.indb 32 15/8/2006 18:17:28

 frameworks O/R, a JPA oferece três tipos
de mapeamento de herança. Estes são
descritos na enumeração InheritanceType :
SINGLE_TABLE, TABLE_PER_CLASS e  JOINED.
A estratégia SINGLE_TABLE  é a mais comum,
sendo a opção default da JPA. Nessa es-
tratégia todas as entidades da hierarquia
são persistidas em uma única tabela, que
deve conter todos os campos necessários.
Na estratégia TABLE_PER_CLASS cada entidade
é mapeada em uma tabela específica, en-
quanto na estratégia  JOINED uma associação
de tabelas é usada para persistência de
cada entidade.
A estratégia de mapeamento deve ser
especificada na entidade raiz da hierar-
quia, através do atributo strategy. Seguindo
o nosso modelo, a hierarquia de veículos
seguirá a estratégia SINGLE_TABLE:
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
O mesmo mapeamento pode ser de-
finido de forma simplificada, visto que
SINGLE_TABLE é a estratégia de mapeamento
default da JPA:
@Inheritance
Como todas as entidades da hierarquia
são armazenadas em uma única tabela, é
necessário determinar a correspondência
entre registros e entidades. A anotação
@DiscriminatorColumn  define a regra utilizada
pela JPA para “reconhecer” cada registro
e instanciar a entidade correspondente.
O atributo name especifica a coluna que
armazena o descritor da entidade, enquan-
to o atributo discriminatorType  define o tipo
dessa coluna:
@DiscriminatorColumn(name = “CD_TIPO”,
discrim inatorType = Discri minatorType.STRING )
Durante a persistência, a JPA lê o valor
armazenado na coluna CD_TIPO (uma string)
e escolhe a entidade com a qual irá traba-
lhar. Essa escolha é feita a partir de uma
outra anotação, especificada nas entidades
descendentes: @DiscriminatorValue.
Nas Listagens 3 e 4 são exibidos os có-
digos das entidades Esportivo e Utilitario. A
anotação @DiscriminatorValue(“E”), contida na
entidade Esportivo, especifica que sempre
 jm39.indb 33
que o valor “E” for encontrado no campo pela anotação @DiscriminatorValue(“U”) da
CD_TIPO da tabela VEICULO, uma entidade etintidade  Utilitario.
Esportivo  será criada. Quando o campo É importante notar que, como as entida-
CD_TIPO contiver o texto “U” uma entidade des Esportivo  e Utilitario  derivam de Veiculo, só
Utilitario  será criada, como especificado é necessário mapear as novas propriedades
Listagem 2.Veiculo.java
package br.com.jm.locadora.model;
import java.util.List;
import javax.persistence.*;
@Entity
@Table(name = “VEICULO”)
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = “CD_TIPO”, discriminatorType = DiscriminatorType.STRING)
public abstract class Veiculo {
@Id
@Column(name = “DS_PLACA”, nullable = false)
private String placa;
@Column(name = “DS_MODELO”, nullable = false)
private String modelo;
@Column(name = “NR_ANO”, nullable = false)
private Integer ano;
@Column(name = “DS_COR”, nullable = false)
private String cor;
@Column(name = “VL_DIARIA”, nullable = false)
private Double diaria;
@OneToMany(c ascade = CascadeType. ALL, mappedBy = “veiculo”)
private List<Reserva> reservas;
@Column(name = “CD_TIPO”, nullable = false)
public abstract String getTipo();
// ... gets e sets omitidos
}
Listagem 3.Esportivo.java
package br.com.jm.locadora.model;
import javax.persistence.*;
@Entity
@DiscriminatorValue(“E”)
public class Esportivo extends Veiculo {
@Column(name = “VL_VELOCIDADE”, nullable = false)
private Integer velocidade;
// ... gets e sets omitidos
}
Listagem 4.Utilitario.java
package br.com.jm.locadora.model;
import javax.persistence.*;
@Entity
@DiscriminatorValue(“U”)
public class Utilitario extends Veiculo {
@Column(name = “NR_PASSAGEIROS”, nullable = false)
private Integer passageiros;
// ... gets e sets omitidos
}
Edição 39 •  Java Magazine 33
15/8/2006 18:17:29
 Persistência no Java EE 5

especificadas nessas entidades ( velocidade  Mapeamento da reserva

e passageiros). Além disso, é possível espe-
cificar a obrigatoriedade dos campos das
entidades descendentes ( nullable = false)
mesmo com todas compartilhando uma só
tabela. A obrigatoriedade só será avaliada
para registros correspondentes à entidade
em questão.
 Já apre se nt am os a entidade Reserva
(Listagem 5), que descreve a reserva de um
veículo, relacionando-se com as entidades
Veiculo e Cliente. Reserva  representa o lado
“filho” dos relacionamentos veiculo-reserva
e cliente-reserva, e armazena o cliente e o ve-
ículo nas propriedades cliente e veiculo. Para

Listagem 5.Reserva.java

package br.com.jm.locadora.model;

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

@Entity
@NamedQueries({
@NamedQuery( name = “Reserva.lis tarPorPeriodo ”,
query = “SELECT r FROM Reserva r WHERE “ +
“r.inicio >= :inicio AND r.fim <= :fim”),

@NamedQuery(name = “Reserva.ultima”,
query = “SELECT r FROM Reserva r WHERE r.codigo = “ +
“(SELECT MAX(r1.codigo ) FROM Reserva r1)”)

})
public class Reserva {
@Id
@Column(name = “CD_RESERVA”)
@GeneratedVa lue(strategy = GenerationTy pe.IDENTITY)
private Integer codigo;

  @ManyToOne
@JoinColumn( name = “CD_CLIENTE” , nullable = false)
private Cliente cliente;

  @ManyToOne
@JoinColumn( name = “DS_PLACA”, nullable = false)
private Veiculo veiculo;

@Column(name = “DT_INICIO”, nullable = false)

  @Temporal(TemporalType.DATE)
private Date inicio;

@Column(name = “DT_FIM”, nullable = false)

  @Temporal(TemporalType.DATE)
private Date fim;

// ... gets e sets omitidos

}

Listagem 6.Locacao.java

package br.com.jm.locadora.model;

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

@Entity
public class Locacao {
@Id
@Column(name = “CD_LOCACAO”)
@GeneratedVa lue(strategy = GenerationTy pe.IDENTITY)
private Integer codigo;

@OneToOne
@JoinColumn( name = “CD_RESERVA” )
private Reserva reserva;

// ... gets e sets omitidos

}

34  Java Magazine • Edição 39

 jm39.indb 34 15/8/2006 18:17:37

 mapear o relacionamento entre as ent ida-
des são usadas anotações @ManyToOne, que
definem que “muitas reservas estão rela-
cionadas a um cliente” e “muitas reservas
estão relacionadas a um veículo”. A ano-
tação @JoinColumn é usada para especificar
a coluna que contém a chave estrangeira
de cada relação. O relacionamento com a
entidade Cliente é exibido a seguir:
@ManyToOne
@JoinColumn(name = “CD_CLIENTE”, nullable = false)
private Cliente cliente;
Vale lembrar que as propriedades cliente
e veiculo  são referenciadas nas entidades
“pai” da relação ( Cliente e Veiculo ), atra-
vés dos atributos mappedBy = “cliente” e
mappedBy = “veiculo”, como é possível ver nas
Listagens 1 e 2.
A entidade Reserva possui duas proprie-
dades de data/hora ou “temporais”: fim e
inicio. Na JPA, todas as propriedades tempo-
rais (do tipo  java.util.Date ou java.util.Calendar )
devem ser marcadas com a anotação
@Temporal, que especifica o tipo no banco
de dados usado para persistência.
@Column(name = “DT_INICIO”, nullable = false)
@Temporal(TemporalType.DATE)
private Date inicio;
A entidade Reserva  também apresenta
uma particularidade em relação às ou-
tras entidades descritas anteriormente.
Em Reserva  estão codificadas algumas
consultas estáticas, que podem ser exe-
cutadas sobre a entidade. A anotação
@NamedQueries  é usada para agrupar todas
as consultas estáticas da entidade, que são
descritas individualmente em anotações
@NamedQuery .
 Mapeamento da locação
O mapeamento da entidade   Locacao
(Listagem 6) é simples. Além das ano-
tações @Id e @GeneratedValue   abordadas
anteriormente, essa entidade apresenta
um relacionamento um-para-um com
a entidade Reserva, pois uma locação só
pode existir para uma reserva criada
anteriormente.
O relacionamento é descrito pela anotação
@OneToOne, e possui uma sintaxe semelhante
à de um mapeamento um-para-muitos:
 jm39.indb 35
@OneToOne gurações da  persistence unit do arquivo
@JoinColumn(name= “CD_RESERVA”)  persistence.xml (Listagem 7). Esse arquivo
private Reserva reserva;
possui um significado especial, arma-
O mapeamento está especificado em zenando as configurações de conexão e
apenas um lado da relação (na entidade a descrição das entidades. O arquivo de
Locacao) e, por isso, é dito unidirecional. Isso configuração deve residir numa pasta
significa que a locação “conhece” a reserva, com nome  META-INF, na raiz do projeto
mas a reserva “não conhece” a locação. (veja o quadro “Configurando o ambiente”
para conhecer a estrutura do projeto de
Persistindo dados e executando consultas exemplo).
Como explicado anteriormente, a inter- A classe EntityManager  define os principais
face EntityManager  é a responsável pelas métodos para incluir, localizar e salvar
operações de persistência. A estratégia de entidades. Os métodos de persistência
criação da instância desse gerenciador vai não declaram exceções checadas, portan-
variar de acordo com o padrão de arquite- to não é obrigatório declarar exceções no
tura escolhido. Se a implementação de JPA código.
for executada a partir de um servidor de Com o objeto EntityManager criado, basta
aplicações Java EE, o EntityManager deve ser executar o método correspondente sobre
declarado pela anotação @PersistenceContext a entidade. Por exemplo, para localizar
e será criado automaticamente pelo contai- um veículo através da sua placa (chave
ner (via injeção de dependência). Já no Java primária), basta chamar o método find()
SE o EntityManager  deve ser instanciado pela passando como parâmetros a classe da
aplicação, o que é feito através da fábrica entidade e sua chave:
abstrata EntityManagerFactory:
Veiculo veiculo = manager.find(Veiculo.class, “ABC1234”);
EntityManagerFactory factory =
  Persistence.createEntityManagerFactory(“locadora”);
EntityManager manager = A inserção e atualização da entidade são
factory.createEntityManager(); feitas através do método persist(). A primei-
ra chamada ao método torna a entidade
A classe EntityManagerFactory  é criada persistente, associando-a ao contexto de
pela classe Persistence, que lê as confi- persistência:
Listagem 7.persistence.xml
<?xml version=”1.0” encoding=”UTF-8”?>
<persistence xmlns=”http://java.sun.com/xml/ns/persistence”
  xmlns:xsi=”http ://www.w3.or g/2001/XMLSch ema-instance ” version=”1.0”
  xsi:schemaLocation=”http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd”>
<persistence-unit name=”locadora”>
  <provider>
  oracle.toplink.essentials.ejb.cmp3.EntityManagerFactoryProvider
  </provider>
  <class>br.com.jm.locadora.model.Cliente</class>
  <class>br.com.jm.locadora.model.Reserva</class>
  <class>br.com.jm.locadora.model.Locacao</class>
  <class>br.com.jm.locadora.model.Veiculo</class>
  <class>br.com.jm.locadora.model.Utilitario</class>
  <class>br.com.jm.locadora.model.Esportivo</class>
  <properties>
<property name=”topli nk.logging.le vel” value=”INFO ” />
<property name=”topli nk.jdbc.drive r” value=”com. mysql.jdbc.Dr iver” />
<property name=”topli nk.jdbc.url”
value=”jdbc:m ysql://127.0 .0.1:3306/loc adora” />
<property name=”topli nk.jdbc.user” value=”root ” />
<property name=”toplink.jdbc.password” value=”” />
  </properties>
  </persistence-unit>
</persistence>
Edição 39 •  Java Magazine 35
15/8/2006 18:17:37
 Persistência no Java EE 5

Dali JPA Tools

O Dali JPA Tools é um plug-in da Fundação Eclipse que oferece

suporte ao JPA. Além de views que auxiliam no mapeamento
entre propriedades e colunas, o plug-in também fornece ferramen-
tas para a geração das entidades a partir do modelo relacional e
para geração do modelo relacional a partir das entidades. Aqui
demonstraremos como instalar o plug-in e gerar as entidades a
partir do banco de dados.
Supondo que o ambiente já está configurado (veja o quadro
“Configurando o ambiente”), o primeiro passo consiste em efetuar
o download do Dali de eclipse.org/dali . A instalação é simples,
bastando extrair o arquivo compactado para o diretório raiz do
Eclipse e reiniciar o IDE. Após a instalação, a perspectiva de per-
sistência estará disponível.
Em seguida é necessário criar um novo proj eto Java e adicionar

Figura Q3. Configurando a conexão.

Clique novamente em Finish para finalizar a configuração. Com

a conexão funcionado, a última etapa é gerar as entidades. Para
isso, clique com o botão direito sobre o projeto e selecione  Java
Perspective>Generate Entities. A tela de geração de entidades será
exibida ( Figura Q4 ) listando todas as entidades encontradas
no banco. Selecione as entidades que deseja gerar e clique em
Finish.
Todas as entidades e mapeamentos serão gerados automatica-
mente, assim como o arquivo  persistence.xml . Para mapeamentos
mais complexos é provável que algum ajuste manual ainda seja
necessário.

Figura Q2. Adicionado persistência ao projeto.

os JARs do Toplink Essentials e do driver do MySQL. Após a criação

do projeto, deve-se torná-lo “persistível”. Para isso clique com o
botão direito sobre o projeto e selecione  Java Perspective>Add
 Java Persistence. Uma caixa de diálogo semelhante à da Figura Q2
será exibida.
Preencha os dados conforme a figura e clique em  Add Connec-
tions para criar uma nova conexão ao MySQL. A tela de configu-
ração de conexão será exibida ( Figura Q3). Preencha os dados
conforme ilustrado e clique em Finish. Figura Q4. Gerando as entidades.

36  Java Magazine • Edição 39

 jm39.indb 36 15/8/2006 18:17:42

 Veiculo veiculo = new Veiculo(“ABC1234”);
manager.persist(veiculo);
A exclusão da entidade é feita através do
método remove():
manager.remove(veiculo);
Consultas mais complexas são efetuadas
através da interface Query. Como visto an-
teriormente, o EntityManager é responsável
por instanciar as consultas, que podem ser
tanto dinâmicas quanto estáticas. A seguin-
te consulta estática lista todas as reservas
existentes em um determinado período:
@NamedQuery(name = “Reserva.listarPorP
“Reserva.listarPorPeriodo”
eriodo”,,
query = “SELECT r FROM Reserva r WHERE “ +
“r.inicio >= :inicio AND r.fim <= :fim”)
Para exibir as reservas do período basta
criar a consulta, preencher os parâmetros
e executar o método getResultList() . Não é ne-
cessário efetuar joins com as tabelas VEICULO
e CLIENTE, pois a JPA já faz as agregações
agregaçõe s auto-
maticamente a partir do mapeamento:
Query query = manager.createNamedQuery(
  “Reserva.listarPorPeriodo”);
query.setParameter(“inicio”
query.setP arameter(“inicio”,, formataData(“01/06/2006
formataData(“01/06/2006”));
”));
query.setParameter(“fim”,
query.setP arameter(“fim”, formataData(“01/08/2006
formataData(“01/08/2006”));
”));
List<Reserva> reservas = query.
query.getResultList();
getResultList();
for (Reserva reserva : reservas) {
System.out.println(“
System.ou t.println(“ “ + reserva);
} sistência de objetos. A criação de um
A JPA também permite criar consultas
complexas, incluindo sub-consultas e fun-
ções agregadas. A consulta Reserva.ultima,
por exemplo, seleciona a última reserva
cadastrada (a que possui maior código):
@NamedQuery(name = “Reserva.ultima”,
“Reserva.ultima”,
query = “SELECT r FROM Reserva r WHERE r.codigo = “ +
“(SELECT MAX(r1.codigo) FROM Reserva r1)”)
 Apoio de ferramentas
É possível perceber que a JP
JPA
A específico
oferece recursos avança-
dos de consulta
 jm39.indb 37
e facilidades na execução de operações
CRUD.. Mas a extensão da JP
CRUD JPAA e o número
de anotações e opções suportadas podem
tornar a API muitas vezes difícil de usar;
não é fácil, por exemplo, conhecer todas
as anotações e atributos envolvidos em
um mapeamento O/R. Além disso, a co- uma questão de tempo até que a JPA esteja
dificação manual de mapeamento (anotar disponível para qualquer aplicação. Agora
entidades e propriedades) é um trabalho é aprofundar os conceitos e estar preparado
geralmente maçante e propenso a erros. para o futuro quando ele chegar.
Embora seja uma API nova, diversas
ferramentas já oferecem
ofere cem apoio ao desenvol-  jcp.org/aboutJava/communityprocess/ 
 jcp.org/aboutJava/communityprocess/ 
vimento com JPA, fornecendo comandos final/jsr220
para mapeamento automático e recursos Especificação do EJB 3.0 e JPA
para edição de anotações. Essas ferra-
mentas aumentam a produtividade do  java.sun.com/developer/ 
desenvolvedor
desenvolved or e diminuem
dimi nuem a possibilidade technicalArticles/J2EE/jpa
de erros. Introdução à JPA
O NetBeans 5.5, atualmente em beta,
inclui vários wizards que auxiliam na eclipse.org/dali 
criação de entidades e na definição do Dali JPA Tools
mapeamento e a geração do persisten ce.xml.
 persistence.xml
oracle.com/technology/products/ias/toplink 
 Já o Eclipse Dali, um projeto da Fundação
Página do Oracle Toplink
Eclipse, adiciona suporte a JP
J PA no Eclipse.
Veja um tutorial sobre o Dali no quadro  glassfish.dev.java.net/javaee5/persistence/ 
“Dali JPA Tools”.
Tools”. entity-persistence-support.html 
Sobre o suporte à persistência no projeto
Conclusões GlassFish
A Java Persistence API traz diversos bene-
fícios para o desenvolvedor Java e para os  javamagazine.com.br/downloads/jm39/ 
fabricantes de produtos relacionados à per-  jm-jpa.zip
u m padrão
 baseado
 basea do em framew
frameworks
orks líde
líderes
res de merca
mercado
do
incentiva o uso da API e facilita a migração André Dantas Rocha
(ad-rocha@uol.com.br ) é mestre
de softwares existentes. Desenvolvedores
em Engenharia de Software pela
com alguma vivência em ferramentas como USP e arquiteto da Fidelity SA.
Hibernate e TopLink
TopLink não
n ão terão dificuldades
em utilizar a nova API.
Com um padrão de persistência, a escolha Sérgio Oliveira Kubota
de uma determinada implementação passa ( sergio_kubota.@hotmail.co
 sergio_kubota.@hotmail.comm) é Pós-
a ser guiada por critérios como preço, ro- Graduado em Objetos Distribuídos com
 bustez e tradição do fabricante,
fabricante, e não mais Java pela FIAP e atua como arquiteto
por operações suportadas por um fabricante de sistemas corporativos baseados nas
específ ico ou simplicidade de mapeamento tecnologias Java SE e EE, no segmento de inovações
O/R provida por um framework. tecnológicas da Caixa Econômica Federal.
Os servidores de aplicações já iniciaram
a incorporação do novo padrão e é só
Edição 39 •  Java Magazine 37
15/8/2006 18:17:55
 AJAX
AJA X Av
Avanç
ançad
ado
o
Criando componentes e serviços com

H á algum tempo houve uma mudança

significativa na forma como interagi-
mos com as aplicações web. Uma nova
tendência, denominada Web 2.0, tem mudado
nossas concepções sobre o paradigma request/wait/ 
response , usado na maioria dos sites t radicionais .
O conjunto de tecnologias AJAX ( Async  Asynchronous
hronous
 Java Scr ipt and XM L) tornou possível trazer às
Script
aplicações web recursos de aplicações desktop
com que sonhávamos desde nossos
primeiros websites
websites..
Uma grande divulgação
do AJAX aconteceu atra-
vés de aplicações criadas
pelo Google, como Google
Maps e GMail, e a em-
presa empresa vislum-
 brou a necessidade de se
construir um framework
para facilitar o desen-
volvimento de aplicações
com AJAX. Foi assim que
nasceu o Google
Goog le Web Toolkit
Toolkit
(GWT).
Neste artigo abordaremos a
construção
constr ução de uma aplicação AJAX
AJAX que
utiliza diversos componentes perso-
nalizados estendendo a API
do GWT. Veremos como
criar uma tabela pa-
ginada com campos
editáveis e uma cai-
xa de diálogo per-
sonalizada, além
de demonstrar
o gerenciamen-
to de eventos e
chamadas de
serviços para
acesso a da-
dos. Para cada
componente
abordaremos
particularidades
da API e dicas sobre

38  Java Magazine • Edição 39

 jm39.indb 38 15/8/2006 18:18:05

 Explorando a API do GWT

com GWT para criar aplicações

AJAX sofisticadas e novos
componentes

o Goo
Google
gle Web Toolkit
ARI DIAS NETO

sua utilização. Para uma introdução ao • A tabela terá campos editáveis, sensí- • br.com.jm.gwt.server   – Onde estarão a
GWT,, sua API básica e a estrutura
GWT estrutu ra utiliza- veis a cliques do mouse e à tecla Enter. implementações dos serviços, como código
da para projetos, recomendo a leitura do • A persistência é feita de forma trans- de acesso a dados e classes de negócio.
artigo “Google Web Toolkit”
Toolkit” na Edição 38 parente: assim que o campo editável não • br.com.jm.gwt.public  – Contendo imagens,
da Java Magazine. possuir mais o foco, os dados serão atua- arquivos CSS, páginas HTML etc.
lizados na base de dados, sem necessidade
Preparação de intervenção do usuário. Note que alguns arquivos também foram
Para a construção do exemplo, vamos • A caixa de diálogo pode ser fechada criados:
utilizar o IDE
I DE Eclipse com dois plug-ins:
plug-ins: tanto com o mouse como com o teclado •

WTP (Web Tools Project) e Googlipse. No (Enter ou Esc). br.com.jm.gwt.public.JMListaContatos.html  –

site do WTP ( eclipse.org/webtools ) existe Arquivo HTML com tags indicando as
uma versão do Eclipse com este plug-in Iniciando o projeto posições onde serão incluídos os com-
incluso. Se você já tem o Eclipse instalado, Começamos criando um projeto GWT. ponentes AJAX, e onde é importada a
pode baixar e instalar
insta lar o WTP pelo próprio No Eclipse (com o WTP e o Googlipse  biblioteca JavaScript do GWT ( gwt.js). Esse
IDE, acessando o site de atual izações do instalados), acione File|New>Project> arquivo, que é chamado na documentação
Callisto (veja um artigo sobre o Callisto Web>Dynamic Web Project . Na primeira do GWT de Host Page
Page, possui também um
na edição anterior). tela (Figura 2) preencha apenas o nome elemento <meta> definindo qual módulo
Tendo instalado o WTP, faça o down- do projeto (“ComponentesGWT”) e clique será carregado.
load do JAR do Googlipse (em  googlipse. em Next.   Marque a op-
com) e coloque-o dentro da pasta eclipse/  ção Googlipse e finalize. O
 plugins. Depois, dentro do Eclipse, abra projeto criado já possuirá Listagem 1.Script para criação do banco de dados.Apenas uma tabela será
o menu Window|Preferences , escolha a as bibliotecas do GWT no necessária.
opção Googlipse  e defina a pasta onde classpath. CREATE TABLE artigogwt.contato (
está instalado o GWT (download em Para começar a cons- contato_id BIGINT NOT NULL AUTO_INCREME NT,
nome VARCHAR(45),
code.google.com/webtoolkit). Com isso sua truir nossos componen- telefone VARCHAR(45),
IDE fica preparada para o desenvolvimen- tes precisamos criar um celular VARCHAR(45),
email VARCHAR(45),
to dos exemplos mostrado neste artigo. GWT Module. Clique com endereco VARCHAR(150)
VARCHAR(150), ,
Como banco de dados usaremos o o botão direito sobre o PRIMARY KEY(contato_ id)
)
MySQL. A Listagem 1  mostra o script nome do projeto, navegue
para a criação da única tabela que preci- até New>Other>Googlipse
samos. Todo o código aqui demonstrado e escolha a opção GWT
está disponível no site da Java Magazine.  M o d u l e . Na próxima
Para facilitar os testes, o download inclui tela configure o campo
também uma classe
clas se que carrega o banco de Location: clique no botão
dados com nomes e endereços aleatórios.
a leatórios. Create, e em Name forneça
br.com.jm.gwt ; depois cli-
Construção de componentes que em Finish. Em Name
O exemplo que construiremos será uma digite “JMListaContatos”
lista de contatos (veja a Figura 1), formada para o nome do módulo.
por uma tabela com paginação e uma área Após finalizar, três paco-
de exibição de fotos. Além disso, criaremos tes serão criados:
uma caixa de diálogo que mostra mais • br.com.jm.gwt.client – Com
informações sobre umu m contato selecionado código Java que será trans-
na tabela. Veja algumas particularidades formado em JavaScript e
do exemplo: executará no browser. Figura 1. Lista de contatos com paginação, DialogBox, campos editáveis e fotografia.

Edição 39 •  Java Magazine 39

 jm39.indb 39 15/8/2006 18:18:12

 AJAX Avançado com GWT

• br.com.jm.gwt.client.JMListaContatos. <table> chamado quando houver algum proble-

 java  – Classe responsável por inicializar   <tr> ma no carregamento da imagem, por
<td id=”contatos”></td>
os componentes e posicioná-los dentro <td id=”fotografia” valign=”top”></td> exemplo, quando ela não existir. É nele
do HTML. É chamada pelo GWT de   </tr> que carregamos uma imagem padrão.
Entry Point. </table>  Já o método onLoad()  é chamado quando
br.com.jm.gwt.JMListaContatos.gwt.xml
• a imagem é carregada corretamente; ele
– Documento que define as configurações Com a organização do projeto concluída está vazio porque não precisamos de ne-
do módulo GWT e seus serviços. (veja a Figura 3), podemos passar à cons- nhum tratamento caso a imagem tenha
trução dos nossos componentes. Todos sido carregada com sucesso. Note ainda
Deixe a classe  JMListaContatos  e o arqui- os componentes serão criados dentro do que no construtor é definida a própria
vo  JMLi staC ontatos.g wt.x ml inalterados pacote br.com.jm.gwt.client . instância da classe como listener, com
por enquanto. Mas modifique o arquivo addLoadListener(this) .
 JMListaCo ntatos. html   deixando-o igual Componente Fotografia O componente Fotografia será utilizado em
à Listagem 2 . Este arquivo inclui dois O primeiro componente que vamos criar dois lugares na nossa aplicação. Ao lado
componentes que são referenciados pelos mostra a fotografia do contato seleciona- da tabela de contatos e na caixa de diálogo
seus ids (contatos e fotografia ) dentro de uma do, e estende a classe Image do GWT. Uma mostrada ao se selecionar um contato.
tabela HTML: funcionalidade adicional da nossa classe
Fotografia  (mostrada na Lista- Componente MeuDialogBox
gem 3) é que se não houver A API do GWT inclui o componente
imagem cadastrada para o DialogBox, que permite mostrar janelas
contato, será mostrada uma popup com informações ou avisos. Em
imagem padrão. A classe nosso exemplo vamos criar uma classe que
também demonstra o trata- estende DialogBox , para aproveitar caracte-
mento de eventos na leitura rísticas desse componente, como a exibi-
de imagens. ção de uma área de título, a possibilidade
Observe que o constru- de arrastá-lo e sua característica modal
tor de Fotografia recebe um (enquanto a janela estiver ativa o resta nte
objeto da classe Contato da aplicação fica bloqueado).
(Listagem 4). Na instancia- A Figura 1 mostra como ficará o layout da
ção já é definido o tamanho, nossa caixa de diálogo. Utilizamos um pouco
o estilo CSS e qual a URL da de CSS para ajudar na formatação do título e
imagem. Outro fato impor-  bordas. Colocamos a definição dos estilos no
tante está na implementação arquivo estilosListaContatos.css (Listagem 5),
da interface LoadListener, atra- dentro da pasta br.com.jm.gwt.public. O CSS
Figura 2. Criando de um Dynamic Web Project 
vés dos métodos onError() e é importado pela página  JMListaContatos.
onLoad() . O método onError() é html.
A maioria dos componentes gráficos
(widgets) do GWT possui um estilo CSS
Listagem 2.HTML que define onde ficarão nossos componentes - JMListaContatos.html
pré-definido, ou seja, você precisa ape-
<html> nas defini-lo no seu arquivo CSS, que
<head>
<title>JavaM agazine - Lista de Contatos</ti tle>
o componente já o usará. O DialogBox
<meta name=’gwt:mo dule’ content=’br .com.jm.gwt.J MListaContat os’> utiliza dois estilos, um para a janela e
<link rel=”stylesh eet” href=”estilo sListaContato s.css” type=”text/ css”>
</head> outro para a área de título: gwt-DialogBox e
gwt-DialogBox .Caption.
<body>
<script language=”ja vascript” src=”gwt.js ”></script> A Listagem 6 mostra o código do com-
<h1>Lista de contatos</h1 > ponente MeuDialogBox . No construtor foram
  <table>
  <tr> definidos o título, o tamanho e a locali-
<!-- lista de contatos --> zação da caixa de diálogo. A fotografia,
<td id=”contatos”></td>
<!-- fotografia do contato --> o conteúdo e o botão foram posicionados
<td id=”fotografia” valign=”top”></td>
  </tr>
dentro de um componente DockPanel. Para
  </table> entender mais sobre painéis como este e
</body> outros componentes gráficos do GWT, veja
</html>
o quadro  “Panels e Widgets”.

40  Java Magazine • Edição 39

 jm39.indb 40 15/8/2006 18:18:13

 Note também que na criação do botão Observe que um Composite  pode ter é gerenciar os cliques nos botões de pró-
de fechar já instanciamos um ClickListener, outros objetos Composite . Esse é o caso da ximo e anterior, e mostrar a mensagem
que no evento de clique ( onClick()) fechará a ListaContatos   e da TabelaEditavel . A seguir, “Carregando...” enquanto a tabela é popu-
caixa de diálogo através do método hide() , veremos detalhadamente como criar os lada. A barra será exibida acima da lista de
herdado da superclasse. E por último, o três componentes citados. contatos, como já mostrado na Figura 1 e
método onKeyDownPreview(), que trata dos seu layout é definido como a seguir:
eventos do teclado, define que ao pressio- Componente BarraNavegacao
nar Enter ou Esc a caixa de diálogo seja A barra de navegação, cujo código é mos- horizontalPanel.add(mensagemStatus);
horizontalPanel.setCellWidth(mensagemStatus, “100%”);
fechada, também usando hide() . trado na Listagem 7, terá três elementos: horizontalPanel.add(btnAnterior);
dois botões (próximo e anterior) e um horizontalPanel.add(btnProxima);
Trabalhando com Composites Label. Seu construtor configura o posi-
A classe Composite do GWT tem a função cionamento dos elementos dentro de um Para capturar os cliques de próximo
de organizar a construção de compo- HorizontalPanel, e recebe uma fonte de dados. ou anterior, o componente BarraNavegacao
nentes mais complexos. Ela funciona Não se preocupe com a fonte de dados por implementa ClickListener e se registra como
como um “wrapper” de componentes , enquanto; veremos mais sobre ela ao tratar listener no momento da instanciação
escondendo os métodos públicos do dos serviços do GWT. dos botões (passando this como segundo
componente “embrulhado”. Normal- A principal função da barra de navegação parâmetro):
mente configuramos o Composite  com
um  panel (ex. DockPanel ) contendo vários
componentes, pois dessa ma neira é pos-
sível tratá-los como um elemento único.
Criaremos três componentes baseados na
classe Composite :
•BarraNavegacao   – Composto de um
HorizontalPanel, que contém dois Button s e
um Label.
•TabelaEditavel – Composto de um DockPanel
com a barra de navegação no topo e um Grid
centralizado.
•ListaContatos  – Que instancia um compo-
nente TabelaEditavel com uma fonte de dados
e nomes das colunas.

Figura 3. Estrutura de pacotes e arquivos de um projeto GWT

Edição 39 •  Java Magazine 41

 jm39.indb 41 15/8/2006 18:18:15

 AJAX Avançado com GWT

Listagem 3.Componente Fotografia – Fotografia.java {

  setText(titulo);
import com.google.gwt.user.client.ui.*;
//posicao do DialogBox
public class Fotografia extends Image implements LoadListener {   setPopupPosition(DESLOCAMENTO_ESQUERDA,
public Fotografia(Contato contato) { DESLOCAMENTO_SUPERIOR);

//configura o endereço da foto   setWidth(TAMANHO_JANELA);

setUrl(“foto s/” + Long.toString (contato.get ContatoId())
+ “.jpg”); //Criando o botão para fechar o DialogBox, e o seu listener
Button btnFechar =
//configurando o tamanho da imagem new Button(“Fechar”, new ClickListener() {
  setWidth(“110”); public void onClick(Widg et sender) {
  setHeight(“110”);   hide();
}
//configurando o estilo/css da imagem });
  setStyleName(“fotografia”);
//cria um DockPanel e define o layout do DialogBox
//configura a própria instância como o loadListener DockPanel panelBase = new DockPanel();
  addLoadListener(this); panelBase.a dd(imagem, DockPanel.WE ST);
} panelBase.add(btnFechar, DockPanel.SOUTH);
panelBase.a dd(new HTML(conteud o), DockPanel.CEN TER);
public void onError(Widge t sender) {
  setUrl(“fotos/foto_padrao.jpg”); //configura a distância entre os componentes deste panel
} panelBase.setSpacing(4);
public void onLoad(Widget sender) {}
} //configura o conteudo do DialogBox como sendo o DockPanel
  add(panelBase);
Listagem 4.Contato.java }

public boolean onKeyDownPrev iew(char key, int modifiers) {

public class Contato implements IsSerializable {
//caso o usuário tecle ESC ou ENTER o DialogBox se fechará
public long contatoId;
public String nome; switch (key) {
case KeyboardListe ner.KEY_ENTE R:
public String telefone;
case KeyboardListe ner.KEY_ESCA PE:
public String celular;
  hide();
public String email;
public String endereco;   break;
}
return true;
public Contato() {}
}
//getters e setters ... }
}
Listagem 7.BarraNavegacao.java
Listagem 5.Arquivo CSS com estilos utilizados pelos componentes GWT – estilosListaContatos.css
public class BarraNavegacao extends Composite
implements ClickListener
.gwt-TextBox {
{
border-width : 0px;
height: 15;
width: 140; public Button btnProxima = new Button(“&gt;”, this);
public Button btnAnterior = new Button(“&lt;”, this);
font-size: 12;
public Label mensagemStatu s = new Label();
}

.gwt-DialogBox { //... outros atributos

border: 2px solid #AAAAAA;
public BarraNavegaca o(FonteDeDad os fdContatos) {
background-c olor: white;
}
this.fdContatos = fdContatos;
.gwt-DialogBox .Caption {
  this.horizontalPanel.add(btnAnterior);
  backgr ound-image: url(‘imagens/ back_degrad. gif’);
background-repeat: repeat-x;   this.horizontalPanel.add(btnProxima);
padding: 4px;   this.btnAnterior.setEnabled(false);
  setWidget(horizontalPanel);
padding-bott om: 8px;
font-weight: bold;
cursor: default; //… definição do layout da barra de navegação
} }

public void onClick(Widget sender) {

.gwt-Button {
border: 1px solid #8E8E8E; if (sender == btnProxima) {
width: 70;   paginaAtual++;
}
}
else if (sender == btnAnterior) {
  paginaAtual--;
Listagem 6.Componente personalizado para o endereço do contato – MeuDialogBox.java }
setStatus(“ Carregando ...”);
public class MeuDialogBox extends DialogBox {   fdContatos.setPagina(paginaAtual);
}
private final static int DESLOCAMENTO _ESQUERDA = 80;
private final static int DESLOCAMENTO _SUPERIOR = public void setStatus(String status) {…}
(Window.getClientHeight() - 256) / 2;
private final static String TAMANHO_JAN ELA = “400px”; public void enable(boolean ultimaPagina) {…}
public MeuDialogBox(Image image, String titulo, }
String conteudo)

42  Java Magazine • Edição 39

 jm39.indb 42 15/8/2006 18:18:15

 Listagem 8.TabelaEditavel.java

public class TabelaEditavel extends Composite

implements TableListener
{
public TabelaEdita vel(FonteDeDa dos fonteDeDados,
String[] nomesColunas,int nroRegistrosPagina)
{
//... config. dos atributos com os valores dos parâmetros

// configura esta instância como o Listener do Grid

// para receber informações sobre o clique, linha e coluna
  grid.addTableListener(this);

//adiciona a barra de navegação e o Grid ao DockPanel

panelBase.ad d(barraNavega cao, DockPanel.N ORTH);
panelBase.add(grid, DockPanel.CENTER);

//configura o Composite com o DockPanel

  setWidget(panelBase);

//... métodos para layout – tamanho, cabeçalho, css, etc

}

/* trata os eventos de cliques na tabela */

public void onCellClicked (SourcesTabl eEvents
sender, int row, int cell)
{
//retornar se clique for no cabeçalho
if (row == 0) return;

//se clicado na primeira coluna, mostra a caixa de diálogo

if (cell == 0) {
  mostraDialogBox(row);
  return;
}
//troca o conteúdo da célula por um campo editável
if (cell > 1) {
editaCelula( row, cell, widget);
}
//… definições de layout - destacar linha selecionada
} //ao perder o foco atualiza a base de dados com o novo valor
textBox.addF ocusListener( new FocusListener (){…});
private void mostraDialog Box(int row) { }
Contato contato = getContato(ro w);
Fotografia fotografia = new Fotografia(contato); private void atualizaRegi stro(
int row, int coluna, String conteudoCelul a)
//instancia o DialogBox que criamos {
MeuDialogBox dialogBox = new MeuDialogBox( //substitui o TextBox por um Label
fotografia, “Contato: “ Label label = new Label();
+ contato.getN ome(), “<b>Endereco : </b> <br />” TextBox textBox = (TextBox) grid.getWidg et(row, coluna);
+ contato.getEndereco());   label.setText(textBox.getText());
grid.setWidget(row, coluna, label);
  dialogBox.show();
} //busca o registro alterado
Contato contato = getContato(row);
private void editaCelula( final int row,
final int cell, Widget labelCelula) // como o GWT não possui suporte para reflection,
{ // usamos um switch
//troca o conteúdo da célula - de Label para TextBox switch (coluna) {
final TextBox textBox = new TextBox(); case 2:
textBox.setT ext(((Label) labelCelula) .getText());   contato.setTelefone(conteudoCelula);
grid.setWidget(row, cell, textBox);   break;
case 3:
//ao pressionar Enter atualiza o registro com a alteração   contato.setCelular(conteudoCelula);
textBox.addK eyboardListen er(new KeyboardList ener() {   break;
public void onKeyDown(Wid get sender, case 4:
char keyCode, int modifiers) {}   contato.setEmail(conteudoCelula);
public void onKeyPress(Widget sender,   break;
char keyCode, int modifiers) {} }

public void onKeyUp(Widge t sender, //atualiza base de dados

char keyCode, int modifiers)   fontDeDados.updateContato(contato);
{ }
switch (keyCode) {
case KeyboardListener.KEY_ENTER: private void mostraFoto(i nt row) {…}
atualizaRegistro(row, cell, textBox.getText()); public void atualizaDados (List contatos) {…}
  break; private void configuraGri dLayout() {…}
} private Contato getContato(in t row) {…}
} private void marcarLinha( int row) {…}
}); }

Edição 39 •  Java Magazine 43

 jm39.indb 43 15/8/2006 18:18:20

 AJAX Avançado com GWT
public Button btnProxima = new Button(“&gt; ”, this);
public Button btnAnterior = new Button(“&l t;”, this);
Assim que um dos botões é clicado, é
chamado o método onClick(). Em seqü-
ência, o componente atualiza o atributo
paginaAtual, muda a mensagem do Label
para “Carregando...”, e chama o método
setPagina() da fonte de dados.
Veja que a barra de navegação não possui
referência ao componente TabelaEditavel ,
interagindo apenas com a fonte de dados.
É a fonte de dados que é responsável por
atualizar os objetos conectados a ela.
Componente TabelaEditavel
O componente TabelaEditavel  é o mais
complexo que criaremos neste artigo.
Veja seu código na Listagem 8. A estru-
tura interna do componente é construída
dentro de um DockPanel, com um compo-
nente BarraNavegacao  na posição NORTH, e um
Grid (da API do GWT) no centro, onde serão
exibidos os dados dos contatos.
O construtor instancia a barra de navega-
ção já com uma fonte de dados, guarda o
número de registros por página, configura
a própria instância como o listener do Grid
(para capturar os cliques sobre ele), e de-
termina o layout dos componentes dentro
do DockPanel.
O método onCellClicked() é chamado quan-
do algum evento de clique ocorre na gra-
de. Caso o clique tenha sido na primeira
coluna, é mostrada uma caixa de diálogo
com o endereço do contato. Um clique nas
outras colunas tornará a célula correspon-
dente editável.
O método mostraDialogBox()   instancia a
caixa de dialogo já com uma fotografia
e o endereço do contato configurados.
A caixa de diálogo é exibida através do
método show() . E editaCelula() substitui
o Label  na célula clicada por um TextBox
(da API do GWT) para edição do valor.
Este TextBox  terá dois listeners. Um para
eventos de foco, FocusListener, e outro para
eventos de teclado, KeyboardListener . Quan-
do o TextBox  perder o foco ou o usuário
pressionar Enter, será chamado o método
atualizaRegistro() para persistir no banco de
dados a alteração efetuada.
Por fim, o método atualizaRegistro() substi-
tui o TextBox por um Label, atualiza o campo
44  Java Magazine • Edição 39
 jm39.indb 44
correto do objeto Contato e persiste a altera- de explicarmos seu código, veremos uma
ção através da fonte de dados.  breve introdução sobre esses serviços.
Além disso, para saber qual registro foi O GWT já traz pronta uma infra-estru-
selecionado, é mantido um mapeamento tura para trabalhar com RPCs ( Remote
interno entre as linhas da grade e os con- Procedure Calls ) facilitando a troca de
tatos exibidos. Assim, quando uma linha objetos Java entre o cliente (o browser)
é selecionada, o objeto Contato correspon- e o servidor. Todas as chamadas são
dente também o é. assíncronas, logo a interface gráfica fica
Componente ListaContatos
O componente ListaContatos , com código
mostrado na Listagem 9, reúne uma fonte
de dados (objeto FonteDeDados ) e um com-
ponente TabelaEditavel. A fonte de dados
recebe o número de registros por página,
e a tabela editável recebe os nomes das
colunas, o número de registros por página
e a própria fonte de dados.
Serviços no GWT
Para fazer acesso aos dados dos contatos
no banco, utilizaremos a classe FonteDeDados.
Esta classe faz uso da infra-estrutura de
serviços remotos do GWT, assim antes Figura 4. Configurando o serviço remoto
Listagem 9.ListaContatos.java: componente que reúne a tabela editável e a fonte de dados
public class ListaContatos extends Composite {
private TabelaEditavel tabelaEditavel;
private FonteDeDados fdContatos;
public ListaContatos Widget(int nroRegistros Pagina) {
String[] nomesColuna s = new String[] { “”, “Nome”, “Telefone”, “Celular”,
“E-mail” };
this.fdConta tos = new FonteDeDados( nroRegistros Pagina);
this.tabelaE ditavel = new TabelaEditave l(fdContatos , nomesColunas,
  nroRegistrosPagina);
  setWidget(tabelaEditavel);
}
}
Listagem 10.ContatosService.java: interface de serviço
package br.com.jm.gwt.client.service;
//… imports
public interface ContatosService extends RemoteService {
//métodos de serviços
public List getContatos( int posicaoInicia l, int nroRegistros Pagina)
throws Exception;
public void updateContat o(Contato contato) throws Exception;
public static final String ENTRY_POINT = “/contatosService”;
public static class Util {
public static ContatosServ iceAsync getInstance( ) {
ContatosServiceAsync instance = (ContatosServiceAsync) GWT
  .create(ContatosService.class);
ServiceDefTa rget target = (ServiceDefTa rget) instance;
  target.setServiceEntryPoint(ENTRY_POINT);
return instance;
}
}
}
15/8/2006 18:18:21
 Panels e Widgets

N este artigo utilizamos vários painéis ( panels)

e componentes gráficos (widgets ) da API do
GWT. Aqui apresentamos uma breve explicação
seguir um pouco sobre os componentes utiliza-
dos neste artigo.

sobre cada um deles. TextoBox 

Panels
Os  panels são “recipientes” de componentes
gráficos utilizados para facilitar o posiciona-
mento e o agrupamento. Utilizamos três tipos
de painéis no exemplo: HorizonalPanel , DockPanel
e RootPanel .
HorizontalPanel  campo;
Este tipo de painel organiza seus componentes
da esquerda para direita em uma mesma linha,
e o utilizamos para organizar os Button s e o Label
de mensagem na barra de navegação.
DockPanel  • addTableListener(): adiciona um listener para
O DockPanel  possiciona os seus elementos
seguindo a numeração da Figura Q1 (extraída
da documentação do GWT). Após colocar um
widget na posição central nenhum outro wid-
get deve ser adicionado ao DockPanel . Se não
for indicado o posicionamento ao adicionar os
componentes, o último a ser adicionado ocupa-
rá a posição central. No exemplo, utilizamos o
DockPanel para fazer o layout da caixa de diálogo
e da tabela editável.
RootPanel  gwt-Image{} . Principais métodos:
O RootPanel  é o último painel no qual um com-
ponente deve ser adicionado. Sua localização é
definida dentro do HTML principal ( Host Page ) ,
normalmente utilizando-se um id. O RootPanel
é instanciado pelo GWT e obtido através de dois
métodos estáticos:
• RootPanel.get() : retorna o RootPanel   padrão
da aplicação.
• RootPanel.get(String id) : retorna o RootPanel  as-
sociado a um elemento/id definido no HTML.
O RootPanel  não possui um layout definido.
Sua função é apenas receber componentes e
exibi-los.
Campo simples para entrada de texto. Seu
estilo CSS padrão é: gwt-TextBox . Principais
métodos:
• getText() : retorna o texto digitado no cam-
po;
• getSelectedText(): retorna o texto selecionado
dentro do campo;
• selectAll() : seleciona todo o texto dentro do
• setText(String): configura o valor do campo;
• addChangeListener() , addClickListener() ,
addKeyboardListener() : adicionam listeners para
mudança do conteúdo, eventos de mouse e
teclado, respectivamente.
Button
Um botão HTML normal. Seu estilo CSS padrã o
é: gwt-Button . Principais métodos:
• click() : equivalente a clicar no botão;
• addClickListener(), addKeyboardListener(): adi-
ciona listeners para eventos de clique e de
teclado.
Image
Componente para exibição de imagens a
partir de uma dada URL. Seu estilo padrão é:
• setUrl() : configura a URL da imagem a ser
exibida;
• addClickListener() , addLoadListener() ,
addMouseListener() : adiciona listeners para eventos
de clique, carregamento de imagem e mouse.
Grid 
Tabela redimensionável que pode
conter texto, html ou widgets. Não
possui estilo padrão. Principais mé-
todos:
• resize(int, int) : redimensiona a
tabela;
•
• setHTML(int linha, int coluna, String str) : adiciona
um código HTML em uma determinada célula;
• getWidget() , getText() , getHTML() : retornam o
widget , a string ou código HTML de uma deter-
minada célula;
eventos de clique sobre a tabela.
DialogBox 
Caixa de diálogo que possui área de título e a
possibilidade de arrastá-la. O DialogBox utiliza dois
estilos, um para a janela e outro para a área de
título: gwt-DialogBox e gwt-DialogBox .Caption .
  No nosso exemplo, estendemos este com-
ponente para customizá-lo conforme nossas
necessidades de layout, e para tratar eventos de
teclado. Principais métodos:
• setText() : configura o título da caixa de di-
álogo.
• setHTML(): configura o conteúdo da caixa de
diálogo com um código HTML.
• addWidget() : configura o conteúdo da caixa
com um widget.
north (0)
west west center east
(1) (2) (5)  (3)

setWidget(int linha, int coluna, Widget w) :

Widgets adiciona um widget  em uma determi-
A API do GWT fornece componentes gráficos nada célula; south (4)
(widgets ) para vários fins, por exemplo campos • setText(int linha, int coluna, String str) :
de texto, checkboxes, tabelas, menus, janelas adiciona uma String em uma determina Figura Q1. Ordem de posicionamento de componentes em um
popup, árvores de navegação e grades. Veja a célula; DockPanel 

Edição 39 •  Java Magazine 45

 jm39.indb 45 15/8/2006 18:18:25

 AJAX Avançado com GWT

Complete
a sua     1
   o
    2
   o
    3
   o

coleção!
    ã     ã     ã
   ç    ç    ç
    i     i     i
    d     d     d
    E     E     E

- Ferramentas livres - Multimídia no celular - Dados em J2ME

- Introdução ao J2EE 1.4 - Automação com Ant - JavaServer Faces
- Introdução a J2ME - Robocode - Jogos wireless
- J2EE Fundamental - Tag Libraries JSP - Certificação J2EE
- Dados com JDBC - Processando XML em Java - Montando um ambiente Java

    0     1     2     3

    9     1     1     1     1
   o    o    o    o    o
    ã     ã     ã     ã     ã
   ç    ç    ç    ç    ç
    i     i     i     i     i
    d     d     d     d     d
    E     E     E     E     E

- Java no Governo - Códigos no Eclipse - Tutorial de NetBeans - Eclipse para Web - Relatórios Corporativos
- Apache FOP - New I/O Fundamental - API New I/O (java.nio) - Fome Zero com Java - Gráficos com Java 2D
- JSTL – Guia Completo - Game API - Cesta de compras com Struts - Tags Customizadas em JSP 2.0 - Java.net na Prática
- Cocoon Inicial - Criando Plug-ins para Eclipse - Testes de carga com JMeter - Tiger: A Evolução do Java - Raio-X do Tiger
- Pacotes WAR e JAR - Preferences API - Concorrência e a JVM - Dicas para Web - Paginação na Web

    

    

    



  
    

  
  



  

   
 
    


 
    9
    1
   o
    ã
   ç
    0
    2
   o
    ã
    1
    2
   o 
    ã  
   ç  
    2
    2
   o
    ã
   ç
    3
    2
   o
    ã
   ç
    i    ç     i     
    i     i
    d     i  
    d  

     d     d
    E     d     E     E     E
    E

- JSTL aplicado no Tomcat 5 - Relatórios avançados - Criptografia aplicada - O Projeto Eclipse

- Threads no Java 5.0
- Modularizando páginas com Tiles - Mais design patterns - XML de alto desempenho - Segurança no JBoss
- Cadastros com Struts
- Componentes View do Struts - Gerenciamento com JMX - Segurança em apllicações web - JSF Avançado
- MVC na web
- O rugido do Java livre - Java Web Start - JSF Passo a Passo - Começando com Java
- Servlet API Avançada
- Padrões de projeto - Dúvidas de classpath - Datas e Horas em Java - Tira-dúvidas

    9     0     1     2     3

    2     3     3     3     3
   o    o    o    o    o
    ã     ã     ã     ã     ã
   ç    ç    ç    ç    ç
    i     i     i     i     i
    d     d     d     d     d
    E     E     E     E     E

- JavaMail - HSQLDB - SWT no Eclipse - NetBeans 5.0 - Hibernate em aplicações web

- Por Dentro do Apache Derby - Internacionalização de MIDlets - Eclipse Web Tools Project - Aprendendo Groovy - Java 6 (Mustang)
- Clusters com Tomcat e Apache - Performance na JVM - Validação avançada com Struts - Test-Driven Development - Programação em par
- Mais HttpClient - Caso de sucesso: Procon - Fronteiras do Java - Debate Internacional Sou+Java - Processos ágeis
- Examinando o Mustang - Benchmarks JME - CD do NetBeans - Java Business Integration (parte 1) - Java Business Integration (parte 2)

46  Java Magazine • Edição 39

www.javamagazine.com.br devmedia.com
 jm39.indb 46 15/8/2006 18:18:38
     4     5     6     7     8
   o    o    o    o    o
    ã     ã     ã     ã     ã
   ç    ç    ç    ç    ç
    i     i     i     i     i
    d     d     d     d     d
    E     E     E     E     E

- Eclipse inicial - JBoss Inicial - Introdução ao Tomcat - Bancos de dados livres - JavaOne 2003
- O mercado J2ME - Introdução ao JMX - Conectivade com MIDP - Testes unitários com JUnit - Conhecendo o CVS
- Segurança em aplicações web - Java no Lego Mindstorms - Struts, primeiros passos - JSTL- Guia Completo: tags Core - JSTL- Guia completo SQL e Format
- Interfaces ricas com Flash - Logging - Automação com XDoclet - Java na Droga Raia - Tomcat e o Servidor Apache
- Expressões regulares no J2SE 1.4 - Memória e desempenho - Jakarta Velocity - Validação na Web

    4     5     6     7     8

    1     1     1     1     1
   o    o    o    o    o
    ã     ã     ã     ã     ã
   ç    ç    ç    ç    ç
    i     i     i     i     i
    d     d     d     d     d
    E     E     E     E     E

- Genéricos no Tiger - SwingWT - JSP 2 e Servlets no Tomcat 5

- Formulários com Swing - Otimização de EJBs no JBoss
- JBuilder para web - Java 2D: Animação e impressão - Primeiros passos com wireless
- ANT - Automatizando Java - Processamento de imagens
- MIDP 2.0 - Anotações no Java 5 - Collections avançado
- JBoss e Entity Beans - Programação com regras
- JavaOne 2004 - Projeto Looking Glass - Conhecendo o JDeveloper 10g
- Extreme Programming - Jakarta Taglibs
- Segurança com JAAS - Java 2D: Animações e Impressão - Servlets: do básico ao avançado
- Metaprogramação e Reflection - Case J2ME

              Java 5 Impressão  Java Content Repository Caches e JDBC NetBeans  JavaOne
                     
• • • •
       •

      
  Imprimindo com Java
       
 ConheçaduasAPIsdeimpressãodo
 J2SEeobtenhacontrolefino
sobrelayouteformatação
 
  
  
   
Gerência deConteúdo
Edição24-AnoIII-R$9,90 DetalhessobreaNovíssimaAPI
 JCRea CriaçãodeRepositórios
  deConteúdonaWeb
  
 
Uma Aplicação Java Tira-Dúvidas Especial
 CacheseDAOscomJDBC, Usando
  Completa com NetBeans
      Partefinal–Acessoa Banco
 JVMsAlternativas,Relatóriose
DriblandoRestrições
      deDadoseGerênciade
    PreferênciasdeUsuários
daMáquina


 Java:

  Futuro
Presente

    4
    5     6     7
&     8
    2
    2     2     2  JavaOne 2005     2
   o Grandesnovidadesem
    ã    o    o    o produtoseAPIs,planose Migrando para o Java 5    o
   ç             ã     ã     ã comemoraçõesno evento Conheça na prática eem detalhes     ã
    i           ç    ç    ç mundialda tecnologia Java como,porquee quando fazero    ç
    i     i     i     i
    d           upgradepara o J2SE 5.0
    E     d     d     d     d
    E     E     E     E

- Novo NetBeans - Aplicação Completa - Parte 1 - Aplicação Completa - Parte 2 - Aplicação Completa - Parte 3 - Hibernate Fundamental
- Máquinas virtuais alternativas - Desempenho com JDBC e DAOs - Mais Desempenho com JDBC - Migrando para o Java 5 - Apache Geronimo na Web
- Gráficos com JFreeChart - Portlets - Fundamentos - Portlets - Recursos Avançados - Impress ão com Java - Ajax: Interatividade Turbinada
- SuperWaba Inicial - JFreeChart Avançado - Jakarta Commons Inicial - Gerenciamento de Conteúdo - Tutorial de Genéricos
- Tag Files do JSP 2.0 - O Novo Extreme P rogramming - Números: Conceitos e Formatação - JavaOne 2005 - De Volta aos Patterns

    4
    3
    5
    3
    6
    3
    7
    3
Leia uma vez,
   o
    ã
   ç
    i
   o
    ã
   ç
    i
   o
    ã
   ç
    i
   o
    ã
   ç
    i
use em todos
    d
    E
    d
    E
    d
    E
    d
    E os lugares
- Para onde vai o Struts - Frameworks de Logging - Conhecendo o Ant - Criação de Plug-ins
- Teste com J2MEUnit - Otimização de Código - Acessando Código Nativo - Os 10 Mais do Eclipse 3.2
- Web Services - Ajuda com JavaHelp - Qualidade Aplicada - JavaOne 2006
- Scripting na JVM - Maven 2 Essencial - Migrando para o Maven 2 - Relatórios Passo a Passo
- Aspectos no Mundo Real - Java ME no Eclipse - Logging no Java SE - Testes com mock objects

Edição 39 •  Java Magazine 47

.br/anteriores 21 2283 9012
 jm39.indb 47 15/8/2006 18:18:46
 AJAX Avançado com GWT
livre para eventuais mudanças enquanto
os dados não chegam. Isso aumenta a
performance da aplicação e faz com que
se consiga paralelismo mesmo sem usar
múltiplos threads – já que uma parte do
código é executada no servidor e a outra,
que trata dos eventos da interface gráfica,
executa no cliente.
Listagem 11.ContatosServiceAsync.java: interface assíncrona
package br.com.jm.gwt.client.service;
//… imports
public interface ContatosServiceAsync {
public void getContatos(int posicaoInicial,
int nroRegistrosPagina, AsyncCallback callback);
public void updateContato (Contato contato,
AsyncCallback callback);
}
Listagem 12.Implementa os serviços de acesso a dados – ContatosServiceImpl.java
package  br.com.jm.gwt.server;
//… imports
public class ContatosServiceImpl extends RemoteServiceServlet
implements
  ContatosService
{ public void setPagina(in t pagina) {
public ContatosSer viceImpl() {}
public List getContatos(int posicaoInicial,
int nroRegistrosPagina) throws Exception
{ public void setTabelaEdi tabel(Tabela Editavel tabelaEditab el) {
List temp = new ArrayList();
String sql =
“select contato_id, nome, telefone, celular, email,”
+ “endereco from contato limit “
+ posicaoInicial + “,” + nroRegistrosPagina);
Connection conn = getConnection ();
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery(sql);
while (rs.next()) {
  temp.add(buildContato(rs));
} public void onSuccess(Object result) {
return temp;
} }
public void updateContato (Contato contato) throws Exception {
String sql = “update contato set nome = ?,
telefone = ?, celular = ?,
email = ? where contato_id = ?”;
Connection conn = getConnection ();
PreparedStat ement stmt = conn.prepare Statement(sql );
stmt.setStri ng(1, contato.getNo me());
stmt.setStri ng(2, contato.getTe lefone());
stmt.setStri ng(3, contato.getCe lular());
stmt.setStri ng(4, contato.getEm ail());
stmt.setLong (5, contato.getCo ntatoId());
  stmt.execute();
}
private Contato buildContato( ResultSet rs)
throws Exception {...}
public Connection getConnection ()
throws ClassNotFoundException, SQLException {...}
} }
48  Java Magazine • Edição 39
 jm39.indb 48
Para criar um serviço remoto no GWT te- da API do GWT.
mos que definir uma interface de serviço, Outra interface também deve ser criada: a
na qual são escritos os métodos a serem interface assíncrona. Seus métodos serão os
expostos. A implementação dos métodos mesmos da interface de serviço, porém terão
fica a cargo de uma classe que será exe- um parâmetro a mais: um objeto de callback,
cutada no servidor como um servlet. Esta que receberá o retorno do serviço assim que
classe além de implementar a interface de ele for processado. Outra diferença é que
serviço estende a classe RemoteServiceServlet todos os seus métodos retornam void.
Listagem 13.JMListaContatos.gwt.xml: arquivo de configuração do módulo GWT
<module>
<inherits name=’com.google.gwt.user.User’ />
<!-- Especifica o Entry Point do módulo -->
<entry-poin t class=’br.com .jm.gwt.clie nt.JMListaCon tatos’ />
<!-- Serviço criado para acesso a dados -->
<servlet path=’/contat osService’
class=’br.c om.jm.gwt.ser ver.Contatos ServiceImpl’ />
</module>
Listagem 14.FonteDeDados.java
public class FonteDeDados {
private int nroRegistrosPagina;
private TabelaEditavel tabelaEditabel;
public FonteDeDados( int nroRegistros ) {
this.nroReg istrosPagina = nroRegistros ;
  setPagina(0);
}
ContatosServiceAsync service =
ContatosService.Util.getInstance();
service.getContatos(pagina * nroRegistrosPagina,
nroRegistrosPagina, new ContatosCallBack());
}
this.tabela Editabel = tabelaEditab el;
}
public void updateContat o(Contato contato) {
ContatosServiceAsync service =
ContatosService.Util.getInstance();
service.updateContato(contato, new UpdateCallBack());
}
private class ContatosCallBack implements AsyncCallback {
public void onFailure(Th rowable caught) {
  Window.alert(caught.getMessage());
}
tabelaEdita bel.atualizaD ados((List) result);
}
private class UpdateCallBack implements AsyncCallback {
public void onFailure(Th rowable caught) {
Window.aler t(“Erro ao atualizar o banco de dados”);
}
public void onSuccess(Object result) {}
}
}
Listagem 15.Inici aliza os componentes do módulo – JMListaContatos.java
public class JMListaContatos implements EntryPoint {
public void onModuleLoad() {
//lista os contatos com 15 registros por página
RootPanel.g et(“contatos” ).add(new ListaContatos (15));
}
15/8/2006 18:18:46
 Criando nosso serviço
Para criar nosso serviço utilizaremos o
plug-in Googlipse que facilita a criação
e sincroniza os métodos entre a interface
de serviço e a interface assíncrona. Clique
com o botão direito sobre o nome do pro-
 jeto, siga New>Other>Googlipse  e escolha
GWT Remote Service. No campo  Module,
clique em Browse, navegue até o pacote
br.com.jm.gwt   e escolha o XML do nosso
módulo; em Service Name, forneça Lista-
ContatosService, digite contatosService em
Service URI  (veja Figura 4), e finalize.
Serão geradas a interface de serviço
ContatosService, a interface assíncrona
ContatosServiceAsync e a classe de implemen-
tação ContatosServiceImpl .
Definiremos na nossa interface de
serviço dois métodos: getContatos() , para
 buscar a lista de contatos; e updateContato() ,
para atualizar o contato que foi editado.
Veja as mudanças na Listagem 10. Ao
salvar a interface alterada, você verá que o
Googlipse atualiza a interface assíncrona
criando dois métodos semelhantes aos de
ContatosService (veja a Listagem 11).
Na classe ContatosServiceImpl  implemen-
tamos os métodos de serviço definidos
em ContatosService , como mostrado na
Listagem 12. Observe que fizemos acesso
direto ao banco de dados; em uma apli-
cação real seria recomendado o uso do
pattern DAO (por exemplo).
Devemos também adicionar os serviços
Figura 5. Criando uma configuração para executar o exemplo
 jm39.indb 49
criados ao arquivo de configuração do
nosso módulo, br.com.jm.JMListaContatos.
 gwt.xml . Deixe esse arquivo como na
Listagem 13.
Montando o quebra-cabeça
Com os serviços e os componentes
prontos, vamos agora uni-los. Chegou
a hora de falar da fonte de dados, cujo
código é mostrado na Listagem 14. A
classe FonteDeDados   é bem simples; ela
contém duas inner classes, ContatosCallBack
e UpdateCallBack . Ambas possuem dois mé-
todos: onFailure() , para tratamento de erros
na chamada do serviço, e  onSuccess() , para
receber o retorno.
A classe ContatosCallBack  será usada para
receber o resultado da pesquisa de conta-
tos e configurar a tabela com os dados re-
tornados. A segunda não possui nenhuma
implementação específica pois o serviço
se trata de um update, não havendo neste
exemplo retorno do servidor. Em ambas
tratamos os erros de maneira simples,
monstrando um PopUp com uma mensa-
gem. Os métodos updateContato()  e setPagina()
fazem as chamadas de serviços.
Vamos voltar agora à classe  JMListaContatos ,
a classe que é o “ponto de entrada” (En-
try Point) do módulo GWT. Altere esta
classe e deixe-a como na Listagem 15.
Em seu método onModuleLoad()  buscamos
um RootPanel com id “contatos”. Lembre
que definimos este mesmo id no arquivo
 JMListaContatos.html eé
 justamente lá que colo-
caremos nossa lista de
contatos. Então adicio-
namos um componente
ListaContatos ao RootPanel.
Com isso, assim que
o arquivo HTML for
exibido, o GWT iniciará
o módulo e carregará
nossa lista de contatos.
Visualizando
o exemplo
Para visualizar a
aplicação de exemplo,
abra o menu de confi-
gurações de execução
(Run|Run). Na árvore
de configurações escolha a opção GWT
 Application  e crie uma nova configuração.
Preencha a tela como a Figura 5 e clique
em Run. Sua aplicação será exibida e de-
verá estar semelhante à Figura 1.
Conclusões
O GWT é uma excelente opção para
tornar o desenvolvimento web mais
produtivo na criação de aplicações AJAX.
Alguns sites já se especializara m em com-
ponentes para GWT, o que pode salvar
muito tempo de desenvolvimento (veja
links). Há inclusive IDEs que já trazem
suporte nativo ao GWT, como o IntelliJ e
o VistaFei (este último já possui suporte
a “arrastar-e-soltar” para os widgets).
 google.com/options
Links para os produtos do Google, como Google
Maps.
www.googlipse.com
Plugin do Eclipse para o GWT.
eclipse.org/webtools
Plugin do Eclipse para desenvolvimento Web.
 intellij.net 
IDE para desenvolvimento Java com suporte
nativo ao GWT.
www.wirelexsoft.com/VistaFei.html 
IDE com desenvolvimento “arrastar-e-soltar” para
o GWT.
 gwtpowered.org
Site com tutoriais, artigos e links para download
de componentes GWT.
 java.sun.com/blueprints/corej2eepatterns/ 
Patterns/DataAccessObject.html 
Artigo sobre o design pattern Data Access Object
(DAO)
 javamagazine.com.br/downloads/jm39/
 jm-componentesgwt.zip
Ari Dias Neto
(aridiasneto@gmail.com) é
consultor Java/J2EE com expe-
riência de mais de sete anos em
tecnogias para web. Atualmente atua
em projeto internacional para IBM. Certificados: SCJP,
SCWCD, EA(I) e Borland CaliberRM Certified.
Edição 39 •  Java Magazine 49
15/8/2006 18:18:49
 Interfaces Gráficas co
Parte 2: Presentation Model e a API Binding

N a primeira parte desta

série apresentamos técni-
cas básicas para um bom
projeto visual de interfaces grá-
ficas (GUIs), discutindo questões
de organização e posicionamento
de elementos que compõem as te-
las. Criamos também um exemplo
demonstrando como a API Forms do
 JGoodies pode ajudar na construção
de GUIs que utilizam componentes
Swing.
Nesta segunda e última parte,
iremos nos aprofundar no código
que está por trás da interface e
que se comunica com o núcleo
do software. Nossa discussão
começa tratando de algumas
questões que envolvem pro-
 blem as e ne ce ss idades do
desenvolvimento de GUIs.
Apresentamos o pattern Pre-
sentation Model, como uma das
estratégias mais eficazes atual-
mente para o desenvolvimento de
aplicações desktop, e vemos seu fun-
cionamento detalhado e a con-
tribuição trazida pela API
Binding do JGoodies.
Ao longo de todo
o processo,

50  Java Magazine • Edição 39

 jm39.indb 50 15/8/2006 18:18:56


m Qualidade
do JGoodies
construímos um exemplo que apresenta
diversas características desejadas em
aplicações modernas.
Patterns e testes em GUIs
A alta produtividade no desenvolvi-
mento de GUIs em aplicações desktop
pode ser alcançada com a ajuda de dois
elementos importantes no nível do código:
a separação de interesses e a eficácia de
testes unitários.
 Separação de interesses
A separação de interesses, no nosso caso,
significa separar o estado e a lógica da GUI,
dos componentes gráficos utilizados. Você
provavelmente já deve ter ouvido falar em
patterns que fazem essa separação, como
o  Model-View-Controller (MVC), que vem
sendo usado tanto no desenvolvimento de
aplicações desktop quanto web.
Embora a separação de interesses traga
muitas vantagens ao desenvolvimento,
ela exige código específico para sincro-
nizar as variáveis que guardam o estado
da GUI com os componentes gráficos.
Normalmente as telas recebem objetos
de negócio (JavaBeans, por exemplo) do
backend e precisam transferir seus dados
para os componentes gráficos, e vice-versa.
Para que essa conexão entre os dois lados
possa ser programada sem muito esforço,
precisamos da ajuda de um framework
genérico que interligue objetos de
negócio e componentes gráficos.
Esse é papel da API Binding do
 JGoodies, que estudaremos nesse
artigo.
Eficácia de testes unitários
Outro problema que atinge o
desenvolvimento de GUIs é a
dificuldade de se construir testes
unitários abrangentes e eficazes,
que simulem as interações do Figura 1. Estrutura dos principais patterns para GUIs desktop
 jm39.indb 51
usuário com a GUI, reproduzindo cliques
do mouse e eventos de teclado 1.
Mas será que a separação de interesses
não poderia ajudar nesses testes, já que
a lógica está separada dos componentes
gráficos? Para responder essa pergunta,
vamos examinar a Figura 1, que apresenta
os três principais patterns para o desenvol-
vimento de GUIs em aplicações desktop.
Observe a estrutura do  Mod el-Vie w-
Presenter (MVP) que é uma pequena varia-
ção do MVC. O importante a ser observado
aqui é o fato de que tanto no MVC quanto
no MVP, o controlador ( Controller/Presenter)
possui uma referência para a visão ( View).
Assim, para instanciar um controlador
dentro de um teste unitário, precisamos
da visão com seus componentes gráficos
também. Isso faz com que o desenvolvi-
mento de testes unitários ainda continue
 bastante difícil.
Existe uma solução para contornar esse
problema: adicionar uma interface entre o
controlador e a visão. Mas não vale a pena
explorar essa alternativa quando temos
uma terceira opção como o Presentation
 Model, descrito a seguir.
O pattern Presentation Model
O pattern Presentation Model, também
ilustrado na Figura 1, é bastante diferente
dos outros dois porque quem detém a lógica
e o estado da GUI – a classe Presentation
Model-View-Controller Model-View-Presenter
Model
View Controller View
 Referêcia
 Notificação por Eventos
Descubra como aplicar o
padrão Presentation Model
e a API Binding do JGoodies
para construir GUIs de
alta produtividade que
favorecem os testes unitários
HUGO VIDAL TEIXEIRA
 Model – não possui uma referência para a
classe View. Ocorre exatamente o contrário:
é a classe View que guarda uma referência
para a classe Presentation Model. Isso é extre-
mamente valioso na criação de testes.
Estrutura e classes
Quando aplicamos o pattern Presenta-
tion  Model  no desenvolvimento de uma
GUI, precisamos criar basicamente três
classes:
• View – Classe simples que contém os
componentes gráficos da GUI. Os dados
apresentados na tela refletem o estado
mantido pela classe Presentation Model.
• Presentation Model  – Classe que con-
tém o estado e a lógica da GUI. Os dados
e variáveis são manipulados em memória,
independentemente da existência de com-
ponentes e formas de apresentação.
• Service Layer   – Classe que oferece à
classe Presentation Model uma comunica-
ção com o mundo exterior, onde serviços
externos podem existir (como EJBs, bancos
de dados etc.)
A separação em classes com diferen-
tes responsabilidades traz vantagens
1
 Um dos fatores que torna isso muito difícil é a exis-
tência de somente uma thread para executar o código do
teste e o código que renderiza os componentes na tela. A
thread única é um requisito imutável de APIs como Swing
e AWT.
Presentation Model
Model View
Presenter Presentation Model
Service Layer
Edição 39 •  Java Magazine 51
15/8/2006 18:19:00
 Interfaces Gráficas com Qualidade – Parte 2
importantes para a implementação e a
manutenção da GUI. Quando trabalha-
mos assim, as classes ficam mais “finas”
e consequentemente mais simples, o que
facilita o entendimento do código e sua
manutenção.
Na verdade, essas vantagens também
existem no MVC e no MVP. A grande
vantagem no Presentation Model é que não
precisamos da classe View  para testar a
lógica da GUI. Isso permite a criação de
testes unitários simples, eficientes e sem
a presença de componentes gráficos para
atrapalhar.
A API JGoodies Binding
A API Binding do JGoodies oferece um
conjunto de classes que simplifica muito
a aplicação do pattern Presentation Model.
Essa API foi desenvolvida para trabalhar
com o JFC/Swing e possui mecanismos
para conectar componentes gráficos a
variáveis que podem ser manipuladas
independentemente de suas formas de
apresentação.
Para entender essa idéia, imagine, por
exemplo, uma variável booleana que está
conectada a um  JCheckBox  (Figura 2). Sem-
pre que trocarmos o valor dessa variável, o
 JCheckBox  irá refletir a mudança e vice-ver-
sa. Ao mesmo tempo, poderíamos conectar
outros componentes gráficos a essa mesma
variável, por exemplo um  JToggleButton .
Assim, podemos ter quantos componentes
quisermos ligados a uma mesma variável,
sendo que a mudança feita em um dos
componentes é refletida nos outros.
Uma variável pode conter tanto um valor
simples quanto uma lista de objetos. Va-
mos analisar cada caso separadamente.
Conectando componentes a valores simples
Entre os componentes que podem ser
conectados a um valor simples, os princi-
pais são  JLabel,  JTextField,  JTextArea,  JCheckBox,
View
JToggleButton
JCheckBox
JCheckBox JToggleButton
Figura 2. Variável booleana conectada a um  JCheckBox e a um  JToggleButton.
52  Java Magazine • Edição 39
 jm39.indb 52
 JRadioButton, JPasswordField e JFormattedTextField.
A variável que pode ser conectada a eles é
uma implementação da interface ValueModel
(pacote com.jgoodies.binding.value ), que arma-
zena um valor e o mantém sincronizado
com o que é apresentado pelo compo-
nente. Ao mudar o valor do ValueModel, o
componente refletirá essa mudança. Da
mesma forma, se o usuário editar esse
valor pela GUI, o ValueModel   receberá o
valor fornecido.
Existem duas formas de conec-
tar um ValueModel  a um componente.
Uma opção é utilizar o método está-
tico bind () da classe Bindings  (do pacote
com.jgoodies.binding.adapter ):
JTextField textField = new JTextField();
ValueModel valueModel = new ValueHolder();
Bindings.bind(textField, valueModel);
Repare que criamos um ValueModel   ins-
tanciando a classe ValueHolder (do mesmo
pacote de ValueModel ), que é a implementa-
ção que precisamos para esse caso.
A segunda maneira de fazer a conexão
é utilizando uma classe de conveniência
chamada BasicComponentFactory  (também
de com.jgoodies.binding.adapter), que possui
métodos prontos para criar componentes.
Assim, podemos fazer:
ValueModel valueModel = new ValueHolder();
JTextField textField =
BasicComponentFactory.createTextField(valueModel);
Essa segunda alternativa será utilizada
pelo nosso exemplo por ser mais simples.
Duas questões importantes ainda pre-
cisam ser discutidas. Primeiro, o valor
mantido pelo ValueModel pode ser lido e
alterado através dos métodos getValue () e
setValue (). É importante lembrar que para
conectar um componente a um ValueModel, o
componente precisa conhecer o valor guar-
dado por ele. Portanto, um  JCheckBox  pode
se conectar sem problemas a um ValueModel
Presentation Model
true
Variável
Booleana
false
que guarda um valor booleano, mas não a
um que contém um String, por exemplo. Se
o ValueModel receber um valor incompatível
com o valor esperado pelos componentes
conectados a ele, uma exceção será lançada
durante a tentativa de conversão.
A outra questão é a emissão de eventos
PropertyChangeEvent, que acontece quan-
do é alterado o valor guardado pelo
ValueModel . Isso permite que o valor seja
“observado” com PropertyChangeListeners.
Demonstraremos esse recurso na prática
mais adiante.
Conectando componentes a listas de objetos
Os componentes que podem ser conec-
tados a listas de objetos são  JComboBox, JList
e  JTable. A lista de objetos, por sua vez, é
representada por um objeto da interface
 javax.swing.ListModel   do Swing, que define
métodos para a manipulação da lista e emi-
te eventos quando ela for modif icada.
A contribuição do JGoodies Binding foi
criar implementações que combinassem
a interface ListModel  com a simplicidade
da interface  java.uti l.List , resultando em
duas classes: ArrayListModel   (que herda
de ArrayList  e implementa ListModel ) e
LinkedListModel (que herda de LinkedList e
implementa ListModel). Dessa forma, po-
demos atuar sobre essas classes dentro
da classe Presentation Model, enquanto os
componentes gráficos refletem as mudan-
ças na classe View.
Entretanto, ainda existe um problema.
Sabemos que os componentes desta
categoria guardam, além da lista de
objetos, um item selecionado 2. Portanto,
o ListModel   sozinho não resolve nosso
problema. Precisamos da ajuda da classe
SelectionInList (em com.jgoodies.binding.list ), que
guarda um ListModel  e também contém um
ValueModel  que aponta para o item selecio-
nado. Veja um exemplo:
ListModel listModel = new ArrayListModel();
ValueModel itemSelecionadoHolder = new ValueHolder();
SelectionInList selectionInList =
new Selecti onInList(listModel, itemSelecionadoHolder);
Com isso, podemos conectar o objeto
2
Os casos em que há mais de um item selecionado são
normalmente raros, e por isso não serão tratados neste
artigo.
15/8/2006 18:19:00
 SelectionInList aos componentes da View da
seguinte forma:
 JComboBox comboBox =
new JComboBox(new ComboBoxAdapter(selectionInList));
JList list = BasicComponentFactory.createList(selectionInList);
Repare que precisamos da classe
ComboBoxAdapter  (pacote com.jgoodies.binding.
adapter ) para conectar o  JComb oBo x ao
SelectionInList . O caso do  JList é mais simples,
pois podemos usar a fábrica de compo-
nentes da API Binding. Para a classe  JTable,
precisaríamos implementar um TableModel
que defina as colunas e exiba os objetos do
ListModel . Esse caso não será tratado neste
artigo, mas há exemplos dele dentro do ZIP
de distribuição da API Binding.
A aplicação de exemplo
Apresentaremos a partir de agora um
exemplo de uso do pattern Presentation
 Model  com a API JGoodies Binding. O
código completo está disponível para
download no site da Java Magazine (para
rodar o exemplo, basta executar a classe
Programa ).
Além da API Binding você vai precisar
das APIs Forms e Looks do JGoodies. Para
obtê-las, no site do projeto ( jgoodies.com) vá
até a seção Download e clique em Libraries.
Lá você terá acesso aos arquivos zipados
de todas as APIs, contendo exemplos, do-
cumentação, código-fonte e os JARs que
devem ser incluídos no classpath da sua
aplicação.
 Apresentando a aplicação
O exemplo que vamos construir é um
cadastro de usuários conforme apresen-
tado na Figura 3. É mostrada uma lista
contendo todos os usuários cadastrados;
as informações do usuário selecionado
são exibidas à direita. Cada usuário possui
quatro atributos: o nome, o cargo, e dois
indicadores definindo se é administrador e
se tem acesso ao controle de permissões da
aplicação. O acesso ao controle de permis-
sões só é possível para administradores.
Um título no lado direito apresenta qual
usuário estamos editando. Se nenhum
estiver selecionado, é apresentado o texto
“Nenhum usuário selecionado” e todos
os componentes de edição ficam desabi-
litados.
 jm39.indb 53
 A classe Usuario Ainda no construtor, repare a cha-
Começaremos construindo o exem- mada de dois métodos: iniciaModelos() e
plo pela classe Usuario, mostrada na iniciaLogicaApresentacao(). É nesses métodos
Listagem 1. Para essa classe JavaBean, que o estado e a lógica da GUI começam a
o ponto mais importante a destacar é surgir. Para entender o código, acompanhe
a emissão de eventos, que é realizada a Figura 4 e veja como a API Binding está
quando os dados do usuário são alterados. sendo usada. A Tabela 1 apresenta um
Precisamos implementar isso porque as resumo dos objetos citados a seguir.
classes da API Binding exigem que os O método iniciaModelos() começa criando
objetos manipulados sejam observáveis3. o objeto usuarioSelectionInList, a partir de um
Assim sendo, o primeiro passo é fazer a ListModel (usuarioListModel) e um ValueModel
classe Usuario herdar da classe Model (pa- (usuarioSelecionadoHolder ):
cote com.jgoodies.binding.beans ); em seguida usuarioListModel = new ArrayListModel();
alteramos todos os métodos setXxx() para usuarioSelecionadoHolder = new ValueHolder(null, true);
que chamem firePropertyChange() e, dessa usuarioSelectionInList = new SelectionInList((ListModel)
usuarioListModel, usuarioSelecionadoHolder);
forma, avisem que a propriedade em
questão mudou seu valor. Embora ainda não tenhamos explicado a
 A classe Presentation Model 
A segunda classe que vamos desenvolver Basicamente, um objeto é observável   quando mudan-
3
ças nele emitem eventos. O objeto que escuta esses even-
chama-se CadastroUsuarioPresentationModel tos chama-se observador . Esses são conceitos trazidos pelo
(Listagem 2). Conforme vimos na Figura 1, pattern Observer  do livro “Design Patterns” [Gamma et al.].
essa classe deve possuir
uma referência para a clas-
se Service Layer, que é o
único meio de comunica-
ção da GUI com o resto do
software. Assim, o cons-
trutor da classe recebe e
guarda um objeto do tipo
CadastroUsuarioServiceLayer,
que é explicado mais
adiante. Figura 3. Tela de cadastro de usuários.
Listagem 1.Classe de modelo Usuario.
import com.jgoodies.binding.beans.Model;
public class Usuario extends Model {
public static final String PROPERTY_NOME = “nome”;
public static final String
public static final String
PROPERTY_CARG O = “cargo”;
PROPERTY_ADMI NISTRADOR = “administrado r”;
public static final String PROPERTY_CONTROLE_PERMISSAO = “controlePermissao”;
private String nome;
private String cargo;
private boolean isAdministr ador;
private boolean isControleP ermissao;
public String getNome() {
return nome;
}
public void setNome(Str ing nome) {
String valorAntigo = this.nome;
this.nome = nome;
// Todos os metodos set lançam eventos...
this.fireProp ertyChange(P ROPERTY_NOME, valorAntigo , this.nome);
}
}
/*...Os outros metodos get/set são similares */
Edição 39 •  Java Magazine 53
15/8/2006 18:19:01
 Interfaces Gráficas com Qualidade – Parte 2

Listagem 2.Classe CadastroUsuarioPresentationModel, onde fica o estado e a lógica da GUI.

import com.jgoodies.binding.beans.*; Usuario novoUsuario = new Usuario(“Novo Usuário”, null);
import com.jgoodies.binding.list.*;   usuarioListModel.add(novoUsuario);
import com.jgoodies.binding.value.*; }
import javax.swing.*;
import java.awt.event.ActionEvent; private void removeUsuario() {
import java.beans.*; int indice = usuarioSelectionInList.getSelectionIndex();
import java.util.*; if (indice != -1) {
  usuarioListModel.remove(indice);
public class CadastroUsuarioPresentationModel extends Model { }
public static final String TITULO_SEM_SELECAO = }
“Nenhum usuário selecionado.”;
public static final String TITULO_COM_SELECAO = “Detalhes de “; private void salvaUsuarios() {
List lista = Collections.unmodifiableList(usuarioListModel);
private CadastroUsuarioServiceLayer serviceLayer;   serviceLayer.salvaUsuarios(lista);
private ArrayListModel usuarioListModel; }
private BeanAdapter usuarioSelecionadoBeanAdapter;
private SelectionInList usuarioSelectionInList; private void habilitaCampos() {
private SelectionInList cargoSelectionInList; boolean enabled =
private ValueHolder usuarioSelecionadoHolder; usuarioSelecionadoHolder.getValue() != null;
private ValueHolder tituloHolder;   usuarioDisponivelHolder.setValue(enabled);
private ValueHolder usuarioDisponivelHolder;   habilitaCampoControlePermissao();
private ValueHolder campoPermissaoDisponivelHolder; }
private Action adicionarAction;
private Action removerAction; private void habilitaCampoControlePermissao() {
private Action salvarAction; Usuario selecionado = (
Usuario) usuarioSelecionadoHolder.getValue();
public CadastroUsuarioPresentationModel( boolean enabled = selecionado !=
CadastroUsuarioServiceLayer serviceLayer) { null && selecionado.isAdministrador();
this.serviceLayer = serviceLayer;   campoPermissaoDisponivelHolder.setValue(enabled);
  iniciaModelos(); }
  iniciaLogicaApresentacao();
}
/* Inner classes de ações */
private void iniciaModelos() { private class AdicionarAction extends AbstractAction {
usuarioListModel = new ArrayListModel(); public void actionPerformed(ActionEvent e) {
usuarioSelecionadoHolder = new ValueHolder(null, true);   adicionaUsuario();
usuarioSelectionInList = new SelectionInList( }
(ListModel) usuarioListModel, usuarioSelecionadoHolder); }
usuarioSelecionadoBeanAdapter = new BeanAdapter(
usuarioSelecionadoHolder, true); private class RemoverAction extends AbstractAction {
public void actionPerformed(ActionEvent e) {
ArrayListModel cargoListModel = new ArrayListModel(   removeUsuario();
  Arrays.asList(Cargos.TODOS)); }
cargoSelectionInList = new SelectionInList( }
(ListModel) cargoListModel, getCargoHolder());
private class SalvarAction extends AbstractAction {
tituloHolder = new ValueHolder(); public void actionPerformed(ActionEvent e) {
usuarioDisponivelHolder = new ValueHolder();   salvaUsuarios();
campoPermissaoDisponivelHolder = new ValueHolder(); }
}
adicionarAction = new AdicionarAction();
removerAction = new RemoverAction();
salvarAction = new SalvarAction(); /* Inner classes de observadores */
}
private class ObservadorNomeUsuario implements
private void iniciaLogicaApresentacao() { PropertyChangeListener {
ObservadorSelecaoUsuario observadorSelecao = public void propertyChange(PropertyChangeEvent evt) {
new ObservadorSelecaoUsuario(); if (getUsuarioSelecionadoHolder().getValue() == null) {
  usuarioSelecionadoHolder.addValueChangeListener(   getTituloHolder().setValue(TITULO_SEM_SELECAO);
  observadorSelecao); } else {
  observadorSelecao.propertyChange(null); getTituloHolder().setValue(TITULO_COM_SELECAO +
  getNomeHolder().getValue());
ObservadorNomeUsuario observadorNome = }
new ObservadorNomeUsuario(); // Emite um evento de mudança para que a GUI reflita o novo
  this.getNomeHolder().addValueChangeListener(observadorNome); // nome.
  observadorNome.propertyChange(null);   usuarioListModel.fireContentsChanged(
  usuarioSelectionInList.getSelectionIndex());
ObservadorCampoAdmin observadorAdmin = }
new ObservadorCampoAdmin(); }
  this.getAdminHolder().addValueChangeListener(
  observadorAdmin); private class ObservadorSelecaoUsuario implements
  observadorAdmin.propertyChange(null); PropertyChangeListener {
public void propertyChange(PropertyChangeEvent evt) {
PropertyConnector connector = new PropertyConnector(   habilitaCampos();
usuarioDisponivelHolder, “value”, removerAction, “ }
  enabled”); }
  connector.updateProperty2();
private class ObservadorCampoAdmin implements
List usuarios = serviceLayer.buscaUsuarios(); PropertyChangeListener {
  usuarioListModel.addAll(usuarios); public void propertyChange(PropertyChangeEvent evt) {
}   habilitaCampoControlePermissao();
}
/* Metodos get omitidos */ }
}
private void adicionaUsuario() {

54  Java Magazine • Edição 39

 jm39.indb 54 15/8/2006 18:19:04

 Eventos Java
Agende-se!

O Maior Evento Java do Brasil De Competições a Workshops

30/Nov a 2/Dez Outubro
São Paulo - SP Várias Cidades

E para o primeiro semestre de 2007

A Conferência Interna- A Tecnologia  Java e o Governo

cional do SouJava  Java, Livre Brasileiro
Edição 39 •  Java Magazine 55
www.soujava.org.br
 jm39.indb 55 15/8/2006 18:19:11
 Interfaces Gráficas com Qualidade – Parte 2
classe View do exemplo, podemos adiantar
que o objeto usuarioSelectionInList conecta-se
ao JList que apresenta os usuários na tela
(usuariosList).
O próximo objeto a ser criado chama-se
usuarioSelecionadoBeanAdapter :
usuarioSelecionadoBeanAdapter =
new BeanAdapter(usuarioSelecionadoHolder, true);
CadastroUsuarioView
Figura 4. Conexão entre os modelos da classe Presentation Model  com os componentes da classe View .
Modelo
usuarioListModel
usuarioSelecionadoHolder
usuarioSelectionInList
usuarioSelecionadoBeanAdapter
nomeHolder,
cargoHolder,
administradorHolder,
controlePermissaoHolder
cargoListModel
cargoSelectionInList
usuarioDisponivelHolder
campoPermissaoDisponivelHolder
tituloHolder
Tabela 1. Resumo dos objetos mantidos pela classe CadastroUsuarioPresentationModel .
56  Java Magazine • Edição 39
 jm39.indb 56
Para que você entenda o significado desse gerenciando as mudanças de valores quan-
objeto, considere a nossa situação: temos do a seleção na lista de usuários mudar,
uma lista de objetos JavaBeans (usuários) podemos usar a classe BeanAdapter.
e precisamos amarrar as propriedades do A classe BeanAdapter   funciona como
 JavaBean que está selecionado aos com- uma “caixa”, na qual podemos colocar
ponentes da tela: nome, cargo, adminis- um objeto JavaBean. Essa classe fornece
trador e controle de permissões. Para não um ValueModel  para cada propriedade do
termos que declarar um ValueModel para  JavaBean – justamente o que precisamos.
cada propriedade desse JavaBean e ficar Assim, quando mudamos o usuário sele-
cionado na lista, os ValueModel s fornecidos
CadastroUsuarioPresentationModel pelo BeanAdapter  irão refletir os valores do
usuarioSelectionInList usuarioListModel novo usuário.
usuarioSelecionadoHolder
Repare que passamos o objeto
usuarioSelecionadoHolder   como parâmetro
usuarioSelecionadoBeanAdapter
na criação do BeanAdapter . Isso faz com
nomeHolder
cargoSelectionInList que o BeanAdapter  sempre exiba os dados
cargoListModel cargoHolder do usuário selecionado. Observe ainda
administradorHolder
o valor true como segundo parâmetro do
construtor, o que indica que as mudanças
controlePermissaoHolder
no JavaBean precisam ser observadas. No
nosso caso, isso é importante porque temos
que atualizar certas partes da GUI quando
Classe Descrição
os valores do usuário mudarem (ex.: para
habilitar/desabilitar o  JCheckBox  “Controle
ArrayListModel Lista observável que guarda todos os usuários. de Permissões” quando a propriedade
 Administrador for alterada).
Mantém uma referência para o usuário sele- Por fim, para adquirir os ValueModels
ValueModel
cionado na lista. fornecidos pelo BeanAdapter, utilizamos
o método getValueModel() , passando o
Une o usuarioListModel e o nome da propriedade em que estamos
SelectionInList
usuarioSelecionadoHolder em um mesmo objeto.
interessados. Assim, para conectar o
Fornece um ValueModel para cada propriedade
BeanAdapter
do usuário selecionado.
ValueModels (fornecidos pelo
usuarioSelecionadoBeanAdapter) que
contém, para o usuário selecionado, o nome,
ValueModel
o cargo, um booleano indicando se é um
administrador, e um booleano indicando se
pode controlar as permissões do sistema.
Lista observável com os possíveis cargos de
ArrayListModel
um usuário.
Une o cargoHolder e o cargoListModel em um
SelectionInList
mesmo objeto.
Contém um booleano que indica se existe um
ValueModel
usuário disponível para edição.
Contém um booleano que indica se o campo
ValueModel “Controle de Permissões” deve estar habilita-
do ou não.
Contém o texto que é apresentado no topo
ValueModel
da tela.
15/8/2006 18:19:14
  JTextField nomeTextField à propriedade Nome do
usuário selecionado na lista, a classe View
utiliza o método getNomeHolder()  da classe
CadastroUsuarioPresentationModel :
// Definido na classe CadastroUsuarioPresentationModel
public ValueModel getNomeHolder() {
  return usuarioSelecionadoBeanAdapter.getValueModel(
  Usuario.PROPERTY_NOME);
}
// Na classe View…
JComponent nomeTextField = BasicComponentFactory.
createTextField(
pm.getNomeHolder(), false);
O parâmetro false passado para o método
createTextField()  significa que o valor editado
pelo usuário será transferido ao ValueModel
a cada tecla pressionada. Se o parâmetro
fosse true, o valor só seria transferido
quando o componente  JTextField perdesse
o foco.
O caso do  JComboBox   de cargos segue
um estilo diferente, porque é um com-
 jm39.indb 57
ponente que contém uma lista de objetos
e uma seleção (da mesma forma que o
 JList de usuários). Portanto precisamos
criar o objeto cargoSelectionInList a partir do
cargoListModel   e do ValueModel que aponta
para o cargo selecionado (o cargoListModel é
um ListModel preenchido com uma lista for-
necida pela classe  Cargos4 ):
// Na classe CadastroUsuarioPresentationModel...
ArrayListModel cargoListModel = new ArrayListModel(
  Arrays.asList(Cargos.TODOS));
cargoSelectionInList = new SelectionInList(
(ListModel) cargoListModel, getCargoHolder());
// Na classe View...
JComboBox cargoComboBox = new JComboBox(
new ComboBoxAdapter(pm.getCargoSelectionInList()));
Continuando no método iniciaModelos() ,
vemos a criação do objeto tituloHolder,
que guarda o texto apresentado no topo
da tela, informando o usuário sendo
editado. Depois temos a criação de dois
outros ValueHolder s: usuarioDisponivelHolder e
campoPermissaoDisponivelHolder . O primeiro
guarda um booleano que indica se existe
um usuário disponível para edição, e o se-
gundo contém outro booleano que indica
se o  JCheckBox “Controle de Permissões”
está habilitado. Esses valores são mani-
pulados pelos observadores descritos
mais adiante.
Ainda nesse método temos a criação de
três ações (objetos que implementam a
interface  javax.swing.Action ): adicionarAction,
removerAction e salvarAction. Essas ações
são usadas pela classe View para criar
os botões da tela (com exceção do botão
“Fechar” que é implementado na própria
classe View  por não possuir lógica de
negócio). A implementação dessas ações
é bem simples, por exemplo:
4
A classe Cargos, não listada, é bem simples e define ape-
nas um array de strings.
Edição 39 •  Java Magazine 57
15/8/2006 18:19:17
 Interfaces Gráficas com Qualidade – Parte 2

Classe Interface Implementada Descrição

Observa o usuarioSelecionadoHolder: qualquer mudança de seleção na lista de usuários resulta

Obser va dorSelecaoUsua rio Prope rt yChangeLis tener
numa chamada ao método habilitaCampos() .

ObservadorNomeUsuario PropertyChangeListener Observa as mudanças no nome do usuário selecionado e preenche o valor dotituloHolder.

Observa a propriedade Administrador  do usuário selecionado para inferir se o campo “Con-

ObservadorCampoAdmin PropertyChangeListener
trole de Permissões” deve estar habilitado (chama o métodohabilitaCampoControlePermissao() )

Tabela 2. Observadores definidos na classe CadastroUsuarioPresentationModel.

usuarioDisponivelHolder nos indica se há um

Listagem 3.CadastroUsuarioServiceLayer: classe  Service Layer  com dados fixos de teste.
usuário disponível para edição. Só se
import java.util.*; houver, habilitamos a remoção.
public class CadastroUsuarioServiceLayer {
 A classe Service Layer 
public List buscaUsuarios () {
// Retorna dados fixos para nosso exemplo... A classe CadastroUsuarioServiceLayer,
// O primeiro usuário é um administrador (true no terceiro parâmetro) mostrada na Listagem 3, é a fronteira
ArrayList usuarios = new ArrayList();
usuarios.add (new Usuario(“Deo doro da Fonseca”, Cargos.GERE NTE_PROJETO, true)); através da qual passam os dados do exem-
usuarios.add (new Usuario(“Flo riano Peixoto”, Cargos.DESE NVOLVEDOR));
usuarios.add (new Usuario(“Pru dente de Moraes”, Cargos.LIDE R_EQUIPE));
plo. Temos dois métodos: buscaUsuarios() e
usuarios.add (new Usuario(“Cam pos Salles”, Cargos.SUPOR TE)); salvaUsuarios(). Para o nosso caso, criamos
return usuarios; o método buscaUsuarios() , que retorna um
}
conjunto fixo de objetos Usuario  para que
public void salvaUsuarios (List listaUsuarios ) {
// Aqui você coloca seu código para salvar na base de dados.
a GUI possa ser testada sem depender de
} qualquer outra coisa.
}
Em sistemas mais robustos, recomendo
a adoção de duas práticas importantes. A
private class AdicionarAction extends AbstractAction { Para fazer o ObservadorSelecaoUsuario  obser- primeira é criar uma interface para a Ser-
public void actionPerformed(ActionEvent e) { var o objeto usuarioSelecionadoHolder, deve- vice Layer que resume todos os métodos de
  adicionaUsuario(); mos adicioná-lo como sendo seu listener: manipulação de dados. A idéia é que haja
}
} duas implementações para ela: uma de
ObservadorSelecaoUsuario observadorSelecao = teste e uma real. A implementação de teste
new ObservadorSelecaoUsuario();
E para criar um botão a partir de uma usuarioSelecionadoHolder. é igual à nossa, onde dados fixos ajudam no
ação, basta passar uma instância da ação   addValueChangeListener(observadorSelecao); desenvolvimento e nos testes. A implemen-
ao construtor do  JButton : Assim, quando o valor guardado pelo tação real é a que acessa verdadeiramente o
usuarioSelecionadoHolder   mudar, o método backend do sistema (bancos de dados, EJBs,
JButton botaoAdicionar = new JButton(pm.getAdicionarAction());
habilitaCampos() será invocado.
Agora que os modelos estão criados e co- Logo após criar e configurar os ob-
nectados, o método iniciaLogicaApresentacao() servadores, utilizamos a classe
(ainda na Listagem 2) adiciona mais vida PropertyConnector para habilitar/desabilitar
à GUI. Começamos com a criação de obje- a ação removerAction. Isso é feito conec-
tos “observadores” – que implementam a tando-se a propriedade value  do objeto
interface PropertyChangeListener. A Tabela 2 usuarioDisponivelHolder  com a propriedade
explica os três observadores presentes no enabled  da ação:
final da classe Presentation Model. A imple-
mentação deles é bastante simples e segue PropertyConnector connector = new PropertyConnector(
este estilo: usuarioDis ponivelHold er, “value”, removerAction, “enabled”) ;

private class ObservadorSelecaoUsuario Assim, sempre que o valor boolea-

implements PropertyChangeListener
{ no em usuarioDisponivelHolder   mudar, o
public void propertyChange(PropertyChangeEvent evt) { PropertyConnector  vai transmitir esse valor
  habilitaCampos(); ao enabled  da ação (via setEnabled()). Fa-
}
} zemos isso porque o valor mantido pelo

58  Java Magazine • Edição 39

 jm39.indb 58 15/8/2006 18:19:19

 etc). Recomendo manter ambas as imple-
mentações juntas no código e utilizar uma
ou outra conforme o objetivo. A segunda
prática recomendada é criar, dentro da
classe Service Layer, uma outra thread para
comunicação com o restante do sistema.
Normalmente, chamadas ao backend demo-
ram alguns segundos; assim disparar uma
nova thread para processar as chamadas
evita o travamento da GUI e possíveis irri-
tações por parte dos usuários.  
 A classe View  Além disso, o método conectaHabilitacao()  es-
A classe CadastroUsuarioView (Listagem 4)
contém os componentes gráficos da nos-
sa GUI. Ela possui uma referência para
Listagem 4.CadastroUsuarioView: classe View  com os componentes gráficos.
import com.jgoodies.binding.adapter.*;
import com.jgoodies.binding.beans.PropertyConnector;
import com.jgoodies.forms.builder.DefaultFormBuilder;
import com.jgoodies.forms.factories.ButtonBarFactory;
import com.jgoodies.forms.layout.*;
import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.io.File;
import java.net.URL;
public class CadastroUsuarioView {
private CadastroUsuarioPresentationModel pm;
private JFrame frame;
public CadastroUsuarioView(CadastroUsuarioPresentationModel pm) {
this.pm = pm;
} private Component montaBarraBotoes() {
protected Component createViewComponent() {
JList usuariosList = BasicComponentFactory.createList(
  pm.getUsuarioSelectionInList());
JLabel tituloLabel = BasicComponentFactory.createLabel(
  pm.getTituloHolder());
  tituloLabel.setFont(tituloLabel.getFont().deriveFont(
Font.BOLD, 14f));
JComponent nomeTextField = BasicComponentFactory
.createTextField(pm.getNomeHolder(), false);
  conectaHabilitacao(nomeTextField);
JComboBox cargoComboBox = new JComboBox(
new ComboBoxAdapter(pm.getCargoSelectionInList()));
  conectaHabilitacao(cargoComboBox);
JCheckBox administradorCheckBox =
BasicComponentFactory.createCheckBox(
pm.getAdminHolder(), “Administrador”);
  conectaHabilitacao(administradorCheckBox);
JCheckBox controlePermissaoCheckBox =
BasicComponentFactory.createCheckBox(
pm.getControlePermissaoHolder(), “Controle de Permissões”);
PropertyConnector connector = new PropertyConnector(
pm.getCampoPermissaoDisponivelHolder(), “value”,
controlePermissaoCheckBox, “enabled”);
  connector.updateProperty2();
/* Aqui são posicionados os componentes no painel... */
} }
 jm39.indb 59
a classe CadastroUsuarioPresentationModel , que fizemos com a removerAction  dentro do
que é esperada em seu construtor. A método iniciaLogicaApresentacao()). No caso
montagem da tela é feita dentro do do controlePermissaoCheckBox, amarramos o
método createViewComponent() , onde os enabled  ao valor do controlePermissaoHolder.
componente gráficos são instanciados e Dessa forma, a lógica que controla a habili-
conectados aos modelos mantidos pela tação desses componentes fica inteiramen-
classe CadastroUsuarioPresentationModel, con- te dentro da classe Presentation Model.
forme foi visto na Figura 4. Como a classe View   é a responsável
Repare que não há necessidade de manter pela apresentação visual da GUI, é nela
referências para os componentes criados, que colocamos os textos e ícones da tela:
já que os valores mostrados neles vêm dos veja os métodos criaBarraFerramentas() e
modelos com os quais estão conectados. montaBarraBotoes() . Poderíamos ter colocado
essas informações dentro das ações, mas
tabelece uma ligação entre o valor mantido estaríamos introduzindo in formações
pelo usuarioDisponivelHolder e a propriedade visuais em classes que não deveriam ter
enabled dos componentes (da mesma forma esse conhecimento.
private void conectaHabilitacao(JComponent component) {
PropertyConnector connector = new PropertyConnector(
  pm.getUsuarioDisponivelHolder(
), “value”, component, “enabled”);
  connector.updateProperty2();
}
private Component criaBarraFerramentas() {
JButton botaoAdicionar = new JButton(pm.getAdicionarAction());
  botaoAdicionar.setIcon(getIcon(“add.png”));
JButton botaoRemover = new JButton(pm.getRemoverAction());
  botaoRemover.setIcon(getIcon(“remove.png”));
/* Aqui a toolbar é montada e retornada */
}
JButton botaoSalvar = new JButton(pm.getSalvarAction());
  botaoSalvar.setText(“Salvar”);
JButton botaoCancelar = new JButton(new FecharAction());
  botaoCancelar.setText(“Fechar”);
return ButtonBarFactory.buildCenteredBar(
botaoSalvar, botaoCancelar);
}
public JFrame criaFrame() {
if (frame == null) {
frame = new JFrame(“Exemplo do Padrão Presentation Model”);
  frame.getContentPane().add(createViewComponent());
  frame.pack();
  frame.setLocationRelativeTo(null);
  frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
}
return frame;
}
private Icon getIcon(String fileName) {
String path = “images” + File.separator + fileName;
URL url = CadastroUsuarioView.class.getResource(path);
return new ImageIcon(url);
}
private class FecharAction extends AbstractAction {
public void actionPerformed(ActionEvent e) {
  frame.hide();
  System.exit(0);
}
}
Edição 39 •  Java Magazine 59
15/8/2006 18:19:20
 Interfaces Gráficas com Qualidade – Parte 2

Desenvolvendo testes método testAdicionarUsuario() , que mede campoPermissaoDisponivelHolder contêm o valor

unitários sobre a GUI o tamanho da lista de usuários antes e false. Ainda nesse caso, a ação removerAction
Como vimos no início do artigo, uma depois de executar a ação adicionarAction deve estar desabilitada. Depois disso,
das maiores vantagens do pattern da classe CadastroUsuarioPresentationModel.  O selecionamos o primeiro usuário da lista
Presentation Model é a facilidade de cria- tamanho final da lista deve ser o tamanho e checamos se tudo está habilitado (con-
ção de testes unitários sobre a GUI. Para inicial mais uma unidade. Da mesma siderando que o primeiro usuário é um
ilustrar isso, criamos diversos testes na forma, temos o teste testRemoverUsuario() , administrador).
classe CadastroUsuarioPresentationModelTest que começa selecionando o primeiro usu- Outros três testes foram omitidos da lis-
(Listagem 5), utilizando o JUnit. ário (índice zero) e depois executa a ação tagem, mas seus códigos estão bem docu-
Essa classe cria no méto- removerAction . mentados na versão completa disponível
do setUp()   uma instância da classe O objetivo do terceiro teste – no site da Java Magazine.
CadastroUsuarioPresentationModel e outra de testHabilitacaoControles() – é verificar se a
CadastroUsuarioServiceLayer , que contém nos- habilitação dos controles está funcio- Conclusões
sos dados de teste. Conforme dito antes, nando corretamente. Para isso, lim- Apresentamos nesse artigo a combina-
não precisamos da classe View para testar pamos a seleção da lista de usuários ção do padrão Presentation Model com a
a lógica da GUI. com o método clearSelection()   e depois API Binding do JGoodies, que nos permite
O nosso primeiro teste é feito pelo verificamos se o usuarioDisponivelHolder e o construir GUIs pela simples conexão de
modelos e propriedades. Dentre as vanta-
Listagem 5.CadastroUsuarioPresentationModelTest.java: Testes sobre a lógica da GUI.
gens dessa abordagem, temos um código
mais limpo, separado em responsabilida-
import junit.framework.TestCase; des, e a simplificação da c riação de testes
public class CadastroUsuarioPresentationModelTest extends TestCase { unitários eficazes sobre a GUI.
private CadastroUsuar ioServiceLay er serviceLayer ;
Assim terminamos a série sobre quali-
private CadastroUsuar ioPresentati onModel pm; dade de interfaces gráficas que abordou
protected void setUp() throws Exception { os dois lados do desenvolvimento de
serviceLayer = new CadastroUsua rioServiceLay er(); GUIs: a aparência das aplicações, na
pm = new CadastroUsuarioPresentationModel(serviceLayer);
} Parte 1, e o código escondido por trás das
telas nesta segunda parte.
public void testAdicionaU suario() {
int tamanhoInici al = pm.getUsuari oListModel(). getSize();
  pm.getAdicionarAction().actionPerformed(null);
int tamanhoFinal = pm.getUsuari oListModel(). getSize();
assertEquals(“Deveria ter mais um usuário na lista”,  martinfowler.com/eaaDev/ 
tamanhoInicial + 1, tamanhoFinal);
} OrganizingPresentations.html 
Página escrita pelo autor Martin Fowler
public void testRemoveUsu ario() {
  pm.getUsuarioSelectionInList().setSelectionIndex(0); que discute os diferentes padrões para o
int tamanhoInici al = pm.getUsuari oListModel(). getSize(); desenvolvimento de GUIs em aplicações desktop.
  pm.getRemoverAction().actionPerformed(null);
int tamanhoFinal = pm.getUsuari oListModel(). getSize();
assertEquals (“Deveria ter menos um usuário na lista”,  jgoodies.com
tamanhoInicial - 1, tamanhoFinal);
}
Site do JGoodies com tutoriais, artigos, aplicações
e APIs para download.
public void testHabilitac aoControles( ) {
  pm.getUsuarioSelectionInList().clearSelection();  javamagazine.com.br/downloads/jm39/
assertEquals (“Os controles devem estar desabilitad os”,
pm.getUsuarioDisponivelHolder().getValue(), Boolean.FALSE);  jm-gui2.zip
assertEquals (“O campo ‘controle de permissões’ deve estar desabilitado” ,
pm.getCampoPermissaoDisponivelHolder().getValue(), Boolean.FALSE);
assertFalse( “A ação de remover deve estar desabilitada ”,
pm.getRemoverAction().isEnabled());

  pm.getUsuarioSelectionInList().setSelectionIndex(0); Hugo Vidal Teixeira

assertEquals (“Os controles devem estar habilitados ”, (hugo.tech@gmail.com ) é Bacharel
pm.getUsuarioDisponivelHolder().getValue(), Boolean.TRUE);
assertEquals (“O campo ‘controle de permissões’ deve estar habilitado”,
em Informática pela UFRJ,mestre
pm.getCampoPermissaoDisponivelHolder().getValue(), Boolean.TRUE); em Engenharia de Software pela
assertTrue(“A ação de remover deve estar habilitada”, COPPE/UFRJ e pesquisador da área de
pm.getRemoverAction().isEnabled());
} componentes e GUI Design.Atua como
consultor integrado à Sakonnet Technology,onde trabalha
public void testHabilitac aoCampoPermi ssao() {...}
public void testLabelTitu lo() {...} diretamente com Karsten Lentzsch (criador do JGoodies) e
public void testConexaoNo meTitulo() {...} empresas especializadas em GUI design,como Ergosign
} (.de),Centigrade(.de)e OculusInfo(.com).

60  Java Magazine • Edição 39

 jm39.indb 60 15/8/2006 18:19:23

 Edição 39 •  Java Magazine 61

 jm39.indb 61 15/8/2006 18:19:26

 Uma Mala Direta com
Mensagens Personalizadas e Expressõ
N este artigo, vamos demonstrar a
API JavaMail criando uma apli-
cação completa. Iniciamos com
conceitos básicos sobre a API, depois mos-
tramos passo a passo o desenvolvimento
de uma aplicação de mala direta funcional,
na qual lemos informações sobre clientes
de uma tabela em um banco de dados
MySQL e enviamos e-mails personaliza-
dos para cada cliente. Também apresenta-
mos o conceito de expressões regulares e
as funcionalidades relacionadas oferecidas
pela plataforma Java, usando-as para per-
sonalizar as mensagens enviadas.
62  Java Magazine • Edição 39
 jm39.indb 62
A API JavaMail
A API JavaMail é utilizada para leitura e
envio de e-mails, e oferece diversos recur-
sos essenciais para aplicações corporativas,
entre os quais destacamos:
• Suporte a vários protocolos de envio e
leitura de e-mail (ex.: POP3, SMTP, IMAP)
• Suporte a mensagens em HTML
• Suporte a envio de mensagens com
anexos
A API JavaMail não é incluída com o
 JDK, portanto é necessár io fazer o down-
load e disponibilizá-la para a aplicação.
Além disso, será necessária a API Java-
Beans Activation Framework (JAF). Os
downloads podem ser feitos em  java.sun.
com/products/javamail/downloads
e  java.sun.com/ products/javabe-
ans/jaf/downloads. Será preciso
adicionar dois JARs ao class-
path da aplicação: mail.jar e
activation.jar.
Se você está desenvolven-
do aplicações Java EE, não
há nenhuma preocupação
adicional, pois as APIs JavaMail
e JAF fazem par te do Java EE.
Visão geral das classes da API
Apresentamos a seguir uma breve
descrição de algumas clas-
ses fundamentais do
 JavaMail.
 javax.mail.Session
A classe Session re-
presenta uma sessão
de e-mail. É através
dela que obtemos os
objetos responsáveis
pelo envio e leitura de e-mails,
como por exemplo Transport , Store e
Folder. Para obter um Session precisa-
mos de informações sobre o servidor de
15/8/2006 18:19:52
 Aprenda como utilizar a API
 JavaMail para enviar e-mails

  JavaMail com HTML, enviar anexos e

ainda personalizar o e-mail com
os dados dos clientes utilizando
expressões regulares
es Regulares
YARA SENGER E ANA ABRANTES

e-mails, que podem ser passadas através
de um objeto  java.util.Properties .
 javax.mail.Transport  uma mensagem no corpo do e-mail solici-
A classe abstrata Transport   encapsula
o protocolo de envio de e-mails (geral-
mente SMTP) e contém métodos para
envio de mensagens. Um objeto do
tipo Transport   é obtido através do objeto
Session   informando-se o protocolo uti-
lizado. A API JavaMail fornece apenas
uma subclasse concreta de Transport :
 javax.mail.internet.SMTPTransport .
 javax.mail.Store e javax.mail.Folder  construtor do objeto, como implementa-
Apesar de não utilizarmos estas classes
no nosso exemplo pois são usadas apenas
para leitura/transferência de mensagens,
vale a pena citá-las. A classe abst rata Store
é utilizada para a leitura de mensagens de
um servidor de e-mail. Ao obter um objeto
Store através da sessão indicamos qual o
protocolo utilizado, por exemplo POP3
ou IMAP (há duas subclasses concretas
de Store na API: POP3Store e IMAPStore). Então
nos conectamos ao servidor informando
os dados para autenticação e recebimento
das pastas ( javax.mail.Folder) que contêm os
e-mails do usuário autenticado.
A classe abstrata Folder  representa uma
pasta de e-mails do usuário autenticado.
Objetos Folder (há as subclasses POP3Folder
e IMAPFolder na API) são obtidos através de
um objeto Store fornecendo seu nome.
 javax.mail.internet.MimeMessage
A classe MimeMessage  representa uma
mensagem a ser lida ou enviada por e-mail,
e estende a classe abstrata  javax.mail.Message.
Para criarmos uma MimeMessage  é necessá-
rio termos um objeto Session. A mensagem
fica associada à sessão de e-mail.
 javax.mail.internet.InternetAddress
A classe InternetAddress  representa um en-
dereço de e-mail, incluindo opcionalmente
um nome.
 javax.mail.Authenticator e
 javax.mail.PasswordAuthentication
Um objeto da classe Authenticator   sabe
como obter os dados para autentica-
ção do usuário, retornando um objeto
PasswordAuthentication . Não há restrição para
as formas de se obter esses dados, que
podem vir de um arquivo, de entradas do
usuário em um prompt, de uma conexão
a uma fonte de dados externa, ou mesmo
informando-se o usuário e a senha no
mos no exemplo deste artigo.
O projeto de Mala Direta
A aplicação de exemplo é formada por
quatro classes. A classe EnviadorDeEmail
(Listagem 1) é responsável por criar a
mensagem, anexar um arquivo e fazer
o envio (e numa segunda etapa, por
personalizar as mensagens). A classe
MalaDireta (Listagem 2) é a classe execu-
tável da aplicação; ela cuida da leitura
dos clientes do banco de dados e chama
os métodos da classe EnviadorDeEmail  para
cada cliente recuperado. Cada destina-
tário da mala direta é representado por
um objeto Cliente (Listagem 3), com nome,
endereço de e-mail, telefone e id. A classe
Autenticador (Listagem 4) faz a autenticação
no servidor de e-mails, necessária para o
envio. Na Listagem 5 é mostrado o coman-
do SQL para criação da tabela de clientes
no banco de dados (chamamos o banco de
“maladireta”).
Inicialmente iremos mostrar como en-
viar e-mails em formato HTML com um
anexo. Depois veremos a personalização
do conteúdo do e-mail. A Listagem 7 e a
Listagem 8 exibem as alterações nas clas-
ses EnviadorDeEmail e MalaDireta  necessárias
para a personalização das mensagens.
Nessa segunda etapa, é feita a substituição
do nome do cliente, e caso o telefone esteja
em um formato incorreto, será adicionada
tando a atualização cadastral.
As próximas seções descrevem o proces-
so passo a passo e apresentam detalhes de
cada classe.
Classe EnviadorDeEmail: enviando
mensagens em HTML com um anexo
A classe EnviadorDeEmail tem apenas um
método público: enviarEmail() . Neste método
é obtido um Session e criado um Message  já
com o destinatário e o assunto. Em segui-
da, o método adiciona o conteúdo e anexa
um arquivo à mensagem. São usados vá-
rios métodos auxiliares para modularizar
o código.
Obtendo a sessão
O método obterSessao() é o primeiro a ser
chamado em enviarEmail(). Ele configura
um objeto da classe Properties indicando,
através de propriedades pré-estabeleci-
das pela API, o nome do servidor SMTP
(propriedade mail.smtp.host ), e se o servidor
exige ou não autenticação (propriedade
mail.smtp.auth). No nosso caso consideramos
que a autenticação é necessária.
Properties props = new Properties();
props.put(“mail.smtp.host”, SERVIDOR_SMTP);
props.put(“mail.smtp.auth”, “true”);
Depois, obterSessao() obtém o objeto Session
usando Session.getDefaultInstance() . Como
indicamos que o servidor exige auten-
ticação, é necessário passar um objeto
que implementa a interface Authenticator.
Passamos um objeto da nossa classe
Autenticador (Listagem 4), que é instancia-
da informando o usuário e a senha para
autenticação no servidor SMTP.
sessao = Session.getDefaultInstance(
props, new Autenticador(EMAIL, SENHA));

Edição 39 •  Java Magazine 63

 jm39.indb 63 15/8/2006 18:19:53

 Uma Mala Direta com JavaMail

Criando o objeto Message
Em seguida, o método enviarEmail() cria
uma mensagem chamando criarMensagem(),
que retorna um MimeMessage . Note que é
passado como parâmetro o objeto Session;
dessa forma a mensagem fica vinculada
a esta sessão.
MimeMessage mensagem =
criarMensagem(sessao, assunto, destinatario);
É possível enviar mensagens para um
ou mais destinatários, que podem ser
configurados com CC  (Carbon Copy), BCC
(Blind Carbon Copy) e TO  (Destinatário
principal). Além disso, cada destinatário
pode ter um nome e um e-mail (um objeto
InternetAddress ). Os tipos do destinatário são
representados por atributos da inner class
RecipientType  da classe Message .
No trecho a seguir de criarMensagem() é
criado um InternetAddress  com o e-mail e o
nome do destinatário, e depois este ende-
reço é associado à mensagem, informan-
do que será utilizado como destinatário
principal (TO).
enderecoDestinatario = new InternetAddress(
destinatario.getEmail(), destinatario.getNome());
message.addRecipient(Message.RecipientType.TO,
  enderecoDestinatario);
O remetente também é representado por
uma instância da classe InternetAddress , que
é associada à mensagem através do método
setFrom().
enderecoRemetente = new InternetAddress(
EMAIL_REMETENTE, NOME_REMETENTE);
message.setFrom(enderecoRemetente);
O assunto e a data de envio são confi-
gurados através dos métodos setSubject() e
setSentDate(), que são bastante simples.
message.setSubject(assunto);
message.setSentDate(new Date()) ;
E por fim o método criarMensagem()  retorna
a mensagem criada.
Definindo o conteúdo do e-mail 
O próximo método a ser executado é
anexarConteudoEAnexo() . O conteúdo do e-
mail é representado por um objeto Multipart,
sendo que nossa mensagem terá duas

Listagem 1.EnviadorDeEmail.java sem personalização

package maladireta; throw new AddressException(ex.getMessage());

}
import java.io.*;   mensagem.addRecipient(Message.RecipientType.TO,
import java.util.*;   enderecoDestinatario);
import java.util.regex.*;   mensagem.setFrom(enderecoRemetente);
import javax.activation.*;   mensagem.setSubject(assunto);
import javax.mail.*; mensagem.setSentDate(new Date());
import javax.mail.internet.*; return mensagem;
}
public class EnviadorDeEmail {
private static String EMAIL_REMETENTE = “yara@globalcode.com.br”; private void adicionarConteudoEAnexo(Message message,
private static String NOME_REMETENTE = “Yara”; String conteudo, Cliente destinatario, String arquivo)
private static String SERVIDOR_SMTP = “smtp.globalcode.com.br”; throws MessagingException, AddressException
private static String SENHA = “senha”; {
// Cria um Multipart que será composto pelo conteudo e pelo anexo
public void enviarEmail(String assunto, String conteudo, Multipart multipart = new MimeMultipart();
Cliente destinatario, String arquivo) throws AddressException,
  MessagingException
// Cria a parte do corpo da mensagem (texto do conteúdo do e-mail)
{
BodyPart messageBodyPartConteudo = new MimeBodyPart();
Session sessao = obterSessao();
messageBodyPartConteudo.setContent(conteudo, “text/html”);
Message mensagem = criarMensagem(sessao, assunto, destinatario);
  adicionarConteudoEAnexo(
// Adiciona o corpo da mensagem ao Multipart
mensagem, conteudo, destinatario, arquivo);
  multipart.addBodyPart(messageBodyPartConteudo);
  mensagem.saveChanges();
Transport transport = null; // Cria uma segunda parte do corpo (anexos do contéudo do e-mail)
try { BodyPart messageBodyPartAnexo = new MimeBodyPart();
transport = sessao.getTransport(“smtp”); // Cria o anexo
  transport.send(mensagem); DataSource source = new FileDataSource(arquivo);
} // Define o data handler para o anexo
finally { messageBodyPartAnexo.setDataHandler(new DataHandler(source));
  transport.close(); // Define o nome do arquivo
} String nomeArquivo = new File(arquivo).getName();
}   messageBodyPartAnexo.setFileName(nomeArquivo);
// Adiciona o anexo ao Multipart
private Message criarMensagem(Session session, String assunto,   multipart.addBodyPart(messageBodyPartAnexo);
Cliente destinatario) throws MessagingException, // Adiciona o Multipart a mensagem
  AddressException   message.setContent(multipart);
{ }

MimeMessage mensagem = new MimeMessage(session); private Session obterSessao() {

Address enderecoRemetente = null; Session sessao = null;
Address enderecoDestinatario = null; Properties props = new Properties();
try { props.put(“mail.smtp.host”, SERVIDOR_SMTP);
enderecoDestinatario = new InternetAddress( props.put(“mail.smtp.auth”, “true”);
destinatario.getEmail(), destinatario.getNome()); sessao = Session.getDefaultInstance(props, new Autenticador(
enderecoRemetente = new InternetAddress(EMAIL_REMETENTE, EMAIL_REMETENTE, SENHA));
  NOME_REMETENTE); return sessao;
} }
catch (UnsupportedEncodingException ex) { }

64  Java Magazine • Edição 39

 jm39.indb 64 15/8/2006 18:19:54

 partes, uma com o corpo do e-mail e outra
com o arquivo a ser anexado. As partes são
representadas por objetos MimeBodyPart .
 O corpo do e-mail deve estar em HTML,
por isto a instância de MimeBodyPart é
configurada informando o tipo como
“text/html”:
Multipart multipart = new MimeMultipart();
BodyPart messageBodyPartConteudo = new MimeBodyPart();
messageBodyPartConteudo.setContent(conteudo, “text/html”);
Depois associamos esta parte ao objeto
Multipart que representa todo o conteúdo
da mensagem.
multipart.addBodyPart(messageBodyPartConteudo);
 Anexando um arquivo
O anexo do e-mail também é repre-
sentado por uma instância da classe
MimeBodyPart, criada com seu construtor
default:
BodyPart messageBodyPartAnexo = new MimeBodyPart();
Para anexar o arquivo ao e-mail é neces-
sário realizar os seguintes passos:
1. Criar um FileDataSource  a partir do ca-
minho completo do arquivo que queremos
anexar:
DataSource source = new FileDataSource(arquivo);
2 .   Criar um DataHandler   a partir do
FileDataSource  instanciado, e associá-lo
ao objeto da classe MimeBodyPart   que
representa o anexo através do método
setDataHandler() :
messageBodyPartAnexo.setDataHandler(
new DataHandler(source));
3.   E
indicar qual o nome do arquivo
anexo para o objeto MimeBodyPart , através
do método setFileName(String nome):
String nomeArquivo = new File( arquivo).getName();
messageBodyPartAnexo.setFileName(nomeArquivo);
Depois, mais uma vez, associamos esta
parte da mensagem ao objeto Multipart, que
representa todo o conteúdo da mensagem:

Listagem 2. MalaDireta.java sem personalização

package maladireta; }
catch (MessagingExcepti on e) {
import java.io.*; System.out.prin tln(“Erro ao enviar email para “
import java.sql.*; + cliente.getNome ());
import java.util.*;   e.printStackTrace();
import javax.mail.MessagingException; }
}
public class MalaDireta { }
private final static String STRING_CON = “ catch (Exception e) {
jdbc:mysql://localhost/maladireta”; System.out.printl n(“Erro ao ler clientes do banco de dados.\n”);
private final static String USUARIO_BD = “root”; throw e;
private final static String SENHA_BD = “root”; }
private final static String ANEXO = “C:\\temp\\teste.txt”; }

public static void main(String[] args) throws Exception { public static List obterClientes() throws SQLException,
String assunto = “Teste de envio de e-mail do projeto MalaDireta”;   ClassNotFoundException
{
StringBuilder conteudo = new StringBuilder(); Connection con = obterConexao();
  conteudo.append(“ Statement st = null;
<!DOCTYPE html PUBLIC ‘-//W3C//DTD HTML 4.01 Transitional//EN’>”); ResultSet rs = null;
  conteudo.append( List listaClientes = new ArrayList();
“<html><head><title>Teste de envio de e-mail</title></head>”); try {
conteudo.append(“<body> Caro(a) cliente,<br> <br>”); st = con.createStat ement();
  conteudo.append( rs = st.executeQuer y(“select * from clientes”);
“Voc&ecirc; est&aacute; cadastrado(a) no nosso sistema e esta“); while (rs.next()) {
conteudo.append(“&eacute; uma mensagem que testa o envio de” Cliente cliente = new Cliente(rs.getL ong(“id”), rs
+ “ e-mail para a sua conta.<br>”); .getString(“nome ”), rs.getString(“e mail”), rs
conteudo.append(“<br> Se voc&ecirc; n&atilde;o quer mais”   .getString(“telefone”));
+ “ receber nossos e-mails, por “);   listaClientes.add(cliente);
  conteudo.append( }
“favor escreva para <a href=’mailto:contato@globalcode.com.br’>”); return listaClientes;
  conteudo.append( }
“contato@globalcode.com.br</a> solicitando descadastramento.<br>”); finally {
conteudo.append(“Pedimos a gentileza de responder este ”
if (rs != null)
+“e-mail confirmando o recebimento.<br>”);
  rs.close();
  conteudo.append(
if (st != null)
“<br>Atenciosam ente,<br><br>Equ ipe Globalcode<br>< br>”);
  st.close();
conteudo.append(“<a href=’http://www.globalcode.com.br’>”
if (con != null)
+ “www.globalcode.com.br</a><br>”);
  con.close();
conteudo.append(“Telefone: (11) 3171-1987<br> </body></html>”);
}
}
EnviadorDeEmail enviadorDeEmail = new EnviadorDeEmail();
try {
public static Connection obterConexao() throws SQLException,
List clientes = obterClientes();
  ClassNotFoundException
// envia o e-mail para todos os clientes
{
for (Iterator it = clientes.iterator(); it.hasNext();) {
Cliente cliente = (Cliente) it.next();   Class.forName(“com.mysql.jdbc.Driver”);
try { Connection con = DriverManager.g etConnection(STRI NG_CON,
enviadorDeEmail.enviarEmail(assunto, conteudo.toString(), USUARIO_BD, SENHA_BD);
cliente, ANEXO); return con;
System.out.println(“e-mail enviado com sucesso para “ }
+ cliente.getNome()); }

Edição 39 •  Java Magazine 65

 jm39.indb 65 15/8/2006 18:19:55

 Uma Mala Direta com JavaMail

multipart.addBodyPart(messageBodyPartAnexo); inteiramente na classe MalaDireta ; em um (o código HTML do corpo da mensagem).

projeto real haveria uma separação de Obtemos a lista de clientes do banco de
Finalmente, colocamos as duas partes na responsabilidades muito maior. O acesso dados através da chamada ao método
mensagem: é feito através dos métodos obterConexao() e obterClientes() e enviamos um e-mail para
obterClientes(), que retornam respectivamen- cada cliente recuperado utilizando o méto-
mensagem.setContent(multipart); te uma conexão ao banco de dados e uma do enviarEmail() da classe EnviadorDeEmail  dis-
lista de objetos Cliente criados a partir dos cutida anteriormente. Veja o código com-
Classe MalaDireta: dados na tabela de clientes. pleto da classe MalaDireta na Listagem 2. A
controlando a aplicação No método main() criamos um String com Figura 2 mostra o e-mail enviado.
Por simplicidade, no nosso exemplo o o assunto da mensagem e um StringBuilder Até aqui mostramos como enviar e-mails
acesso ao banco de dados foi realizado para armazenar o conteúdo a ser enviado para múltiplos destinatários, mas sem per-
sonalizar as mensagens para cada cliente.
No nosso exemplo, essa personalização
Listagem 3. Cliente.java será feita usando expressões regulares.
package maladireta;
Por isso, antes de continuar com o código,
vamos apresentar conceitos gerais sobre
import java.io.Serializable;
este tema e suas diversas aplicações.
public class Cliente implements Serializable {
private long id;
private String nome = “”; Conceitos gerais de
private String email = “”;
private String telefone = “”;
expressões regulares
Expressões regulares são muito utili-
public Cliente() {} zadas para localização de informações
public Cliente(String nome, String email, String telefone) { dentro de textos e para validação de dados
this.nome = nome;
this.email = email;
textuais que devem seguir formatos espe-
this.telefone = telefone; cíficos, como URLs, datas, endereços de
}
e-mail, CEPs, números de telefone etc.
public Cliente(long id, String nome, String email, String telefone) { Na API do Java SE, o pacote  javax.util.regex
this(nome, email, telefone);
this.id = id;
contém duas classes principais voltadas
} ao trabalho com expressões regulares.
//… get/set Pattern representa uma expressão regular
} compilada, e Matcher é capaz de verificar
se uma dada str ing está de acordo com a
Listagem 4. Autenticador.java expressão regular em um objeto Pattern.
package maladireta;
A documentação JavaDoc da classe
Pattern inclui um resumo dos principais
import javax.mail.PasswordAuthentication;
símbolos utilizados para expressões
public class Autenticador extends javax.mail.Authenticator { regulares. Veja alguns exemplos de ex-
private String user;
private String senha;
pressões usando esses símbolos e o que
elas representam:
public Autenticador() {}
• \d  – um digito [0-9]
public Autenticador(String user, String senha) { • [a-zA-Z] – qualquer letra
this.user = user;
this.senha = senha; • [a-z] – qualquer letra minúscula
} • ?  – o símbolo antes do ?  aparece zero
public PasswordAuthentication getPasswordAuthentication() { ou uma vez
return new PasswordAuthentication(user, senha);
}
• *  – o símbolo antes do * aparece zero
} ou mais vezes
• + – o símbolo antes do + aparece uma
Listagem 5. Script para criação da tabela no banco de dados ou mais vezes
• {n}  – o símbolo antes do {n}  aparece exa-
CREATE TABLE `clientes` (
`id` int(11) NOT NULL auto_increment, tamente n vezes
`nome` char(40) NOT NULL default ‘’, • {n,m} – o símbolo antes do {n,m} aparece
`email` char(40) NOT NULL default ‘’,
`telefone` char(20) NOT NULL default ‘’, no mínimo n vezes e não mais do que m
PRIMARY KEY (`id`) vezes
) ENGINE=MyISAM DEFAULT CHARSET=latin1 ROW_FORMAT=FIXED;
• {n,}  – o símbolo que está antes do {n,}

66  Java Magazine • Edição 39

 jm39.indb 66 15/8/2006 18:19:55

 aparece no mínimo n vezes
• X|Y  – ou  X ou  Y  \\s[A-Z][a-z]+
• \s  – espaço em branco [A-Z] [a-z] + Um espaço, seguido de
O texto deve começar com Seguido de uma ou uma letra maiúscula e uma |
uma letra maiuscula mais letras minusculas ou mais letras minúsculas ou
Na  Figura 1  é analisado um exemplo
complexo de expressão regular. A figura
inclui também uma tabela com nomes
que estão ou não de acordo com essa
expressão. [A-Z][a-z]+((\\s[A-Z][a-z]+)|\\s[a-z]{2}|\\s[A-Z].)+
O trecho de código na Listagem 6 ilustra
a utilização das classes Pattern e Matcher + Uma ou mais vezes
para verificar vários nomes com a expres-
são regular detalhada na Figura 1.
\\s[a-z]{2} \\s[A-Z] .
As classes Pattern e Matcher atendem das Um espaço, seguido de duas letras minúsculas Um espaço, seguido de uma letra
mais simples às mais complexas situações maiúscula, seguido de um ponto
envolvendo expressões regulares. No en-
tanto, outras classes do Java SE também
suportam essas expressões, como a própria No me s válidos de aco rdo com a exp ress ão N ome s invá lidos de acord o co m a expre ssã o
classe String, que oferece funcionalidades
Maria Aparecida
suficientes em muitos casos. Veja alguns Maria A. Soares
maria aparecida
MARIA APARECIDA
Maria Aparecida Soares
métodos da classe String   que suportam Maria da Silva
Maria A Soares
expressões regulares:
•   Strin g replaceAll (String regex, Strin g Figura 1. Um exemplo de expressão regular
replacement)  – Substitui todos os “pedaços”
da string que obedecem ao padrão estabe-
lecido pela expressão regular em regex.
• String replaceFirst (String regex, String
replacement)  – Substitui a primeira ocorrên-
cia dentro da string que obedeça o padrão
estabelecido pela expressão regular.

Vamos apresentar agora a aplicação de

expressões regulares no nosso exemplo,
realizando a substituição do nome do
cliente no e-mail e também a verificação
do telefone. Se o telefone for considerado
inválido pela expressão regular constru-
ída, iremos inserir um texto no e-mail
solicitando que o cliente atualize seus
dados cadastrais.

Aplicando as expressões regulares

Para permitir a personalização das men-
sagens vamos fazer algumas alterações im- Figura 2. E-mail enviado em HTML com anexo teste.txt

Edição 39 •  Java Magazine 67

 jm39.indb 67 15/8/2006 18:19:57

 Uma Mala Direta com JavaMail
portantes na classe MalaDireta, mostradas na
Listagem 7. Observe que no texto do e-mail
incluímos no conteúdo HTML do e-mail a
ser enviado “pedaços” de texto para serem
substituídos: %cliente.nome% e %cliente.
telefone% . Vamos utilizar expressões re-
gulares através do método replaceAll() da
classe String para substituir esses pedaços
pelo nome e o telefone do cliente.
Observe que este é o caso mais simples
de uso de expressões regulares, em que
o padrão fornecido é exatamente igual
ao texto que deve ser localizado. Para
demonstrar mais recursos de expressões
regulares, vamos verificar se um tele-
fone de cada cliente segue um padrão
estabelecido, de acordo com a seguinte
expressão:
\\d{2}(-|\\s)??\\d{8}
Essa expressão ve-
rifica se o telefone
contém um DDD
com dois dígitos
e um número
68  Java Magazine • Edição 39
 jm39.indb 68
com oito dígitos, sendo que o DDD pode MalaDireta, que realiza a substituição do
estar colado ao número, ou separado por nome e a verificação do telefone.
um espaço ou hífen. De acordo com essa
expressão, os seguintes números seriam 1.   Utilizamos o método replaceAll() da
considerados válidos: classe String. Este método recebe uma string
• 11-31711987 contendo uma expressão regular e a string
• 11 31711987 que deve substituir o texto localizado. Neste
• 1131711987 caso a expressão contém apenas caracteres,
ou seja, não utilizamos símbolos espe-
 Já os números a seguir não estariam de ciais como  /d, ou [A-Z] , apenas uma string
acordo com a expressão: %cliente.nome% (note que a porcentagem
• 31711987 não é um símbolo especial de expressão
• 222323 regular).
• 7632323r34
conteudo = conteudo.replaceAll(
  “%cliente.nome%”,destinatario.getNome());
Agora vamos analisar passo a passo o
novo método personalizarConteudo()  da classe 2.  Compilamos a expressão regular que
Listagem 6. Trecho demonstrando o uso da expressão regular ilustrada na Figura 1.
Pattern p = Pattern.compile(
“[A-Z][a-z]+((\\s[A- Z][azz]+)|\\s[a-z]{2}|\\s[A-Z].)+”);
String nomeCorreto = “Maria Aparecida da Silva”;
String nomeCorreto1 = “Maria Aparecida Silva”;
String nomeCorreto2 = “Maria A. Soares”;
String nomeIncorreto = “maria aparecida”;
String nomeIncorreto2 = “MARIA APARECIDA”;
String nomeIncorreto3 = “Maria”;
String[] nomes = {nomeCorreto, nomeCorreto1, nomeCorreto2,
nomeIncorreto, nomeIncorreto2, nomeIncorreto3};
for (String nome: nomes){
Matcher m = p.matcher(nome);
if (m.matches()){
System.out.println(nome+”: está no padrão”);
}
  else{
System.out.println(nome+”: não está no padrão”);
}
Listagem 7. Alterações na classe MalaDireta para personalização das mensagens
public class MalaDireta {
  //...
public static void main(String[] args) throws Exception {
String assunto = “Teste de envio de e-mail do projeto MalaDireta”;
StringBuilder conteudo = new StringBuilder();
conteudo.append(“<!DOCTYPE html PUBLIC ‘-//W3C//DTD HTML 4.01 Transitional//EN’>”);
conteudo.append(“<html><head> <title>Teste de envio de e-mail</title></head>”);
conteudo.append(“<body> Caro(a)   %cliente.nome% ,<br> <br>”);
conteudo.append(“Voc&ecirc; est&aacute; cadastrado(a) no nosso sistema e esta “);
conteudo.append(“&eacute; uma mensagem que testa o envio de e-mail para a sua conta.<br>”);
conteudo.append(“<br> Se voc&ecirc; n&atilde;o quer mais receber nossos e-mails, por “);
conteudo.append(“favor escreva para <a href=’mailto:contato@globalcode.com.br’>”);
conteudo.append(“contato@globalcode.com.br</a> solicitando descadastramento.<br>”);
  conteudo.append(“<br> %corrigir_telefone% <br>”);
conteudo.append(“Pedimos a gentileza de responder este e-mail confirmando o”
+“recebimento.<br>”);
  //...
}
15/8/2006 18:20:16
 irá validar o telefone com um método
estático da classe Pattern.
Pattern p = Pattern.compile(“\\d{2}(-|\\s)??\\d{8}”);
3. Depois Verificamos se o telefone do
destinatário está de acordo com a expres-
são regular compilada. Esta operação
retorna um objeto da classe Matcher, sobre
o qual podemos chamar o método matches()
que retorna verdadeiro ou falso.
String telefone = destinatario.getTelefone();
Matcher m = p.matcher(telefone);
4. Se o telefone estiver no padrão, a cadeia
de caracteres “%corrigir_telefone%” será
removida do e-mail, através da substituição
por uma string vazia. Se o telefone não es-
tiver no padrão esperado, será substituído
por um texto que solicita que o cliente entre
em contato para atualização do cadastro.
if (m.matches()){
System.out.println(“O “+telefone+” está no padrão”);
conteudo = conteudo.replaceAll(“%corrigir_telefone%”,””);
} else {
System.out.println(“O “+telefone+” não está no padrão”);
conteudo = conteudo.replaceAll(“%corrigir_
telefone%”,”<br>Seu telefone “+ telefone+
“ parece estar incorreto /*... */ “);
}
O método personalizarConteudo()  deve ser
chamado na classe EnviadorDeEmail. Veja na
Listagem 8 o trecho alterado nesta classe.
A Figura 3 mostra um exemplo de e-mail
enviado com o conteúdo personalizado.

Conclusões
Neste artigo, vimos como usar recursos
essenciais da API JavaMail aplicando-os
em uma situação real. Usamos também
expressões regulares, um recurso podero-
so que é suportado por classes específicas
da API do Java SE, bem como a classe
String.

 java.sun.com/products/javamail/ 
Página oficial do JavaMail.
 java.sun.com/docs/books/tutorial/extra/ 
 regex/intro.html 
Figura 3. E-mail com conteúdo personalizado
Tutorial sobre Expressões Regulares
Listagem 8. Alterações na classe EnviadorDeEmail para personalização
public class EnviadorDeEmail {  javamagazine.com.br/downloads/jm39/
  //...  jm-maladireta.zip
private void adicionarConteudoEAnexo(Message message,
String conteudo, Cliente destinatario, String arquivo)
throws MessagingException, AddressException
{  Yara M. H. Senger
conteudo = personalizarConteudo(conteudo, destinatario); ( yara@globalcode.com.br ) é
//... Igual à Listagem 1 formada em Ciências da Com-
} putação na USP em São Carlos,
private String personalizarConteudo(String conteudo, Cliente destinatario){ especialista em desenvolvimento web;
// personalização do conteúdo possui as certificações SCJA, SCJP e
conteudo = conteudo.replaceAll(“%cliente.nome%”,destinatario.getNome());
SCWCD. Atualmente é Instrutora e Diretora Educacional
Pattern p = Pattern.compile(“\\d{2}(-|\\s)??\\d{8}”);
String telefone = destinatario.getTelefone(); da Globalcode, criadora e coordenadora de diversos
Matcher m = p.matcher(telefone); cursos das carreiras Academia do Java e Academia do
if (m.matches()){
System.out.println(“O “+telefone+” está no padrão”); Web Developer.
conteudo = conteudo.replaceAll(“%corrigir_telefone%”,””);
}
else {
System.out.println(“O “+telefone+” não está no padrão”); Ana Abrantes
conteudo = conteudo.replaceAll(“%corrigir_telefone%”,
“<br>Seu telefone “+ telefone + “ parece estar incorreto,”
(ana.abrantes@globalcode.com.br ) é
+ “solicitamos a gentileza de entrar em contato” desenvolvedora Java na Globalcode,
+ “para atualização do cadastro<br>”);
} co-autora do curso de JasperReports/
return conteudo; iReport e possui algumas certificações
}
//... em Java (SCJA, SCJP e SCWCD). É formada pela FATEC-
} SP e atua na área de informática há mais de 15 anos.

Edição 39 •  Java Magazine 69

 jm39.indb 69 15/8/2006 18:20:18

 RIA com Open
Construindo Rich Internet Applications
C om o crescimento da internet, a
distribuição e a manutenção de
aplicações tornaram-se muito
mais simples e rápidas. Utilizando um
 brows er, o usuário passou a aces sar o
último release sem ter que se preocupar
com versionamento ou procedimentos
de instalação. Mas um efeito colateral do
paradigma web não tardou a aparecer.
Interfaces mais pobres e menos intuitivas
substituíram os sistemas “fat-client” antes
largamente utilizados, forçando o usuário
a se acostumar com o “clicar e esperar” das
interfaces web.
O conceito de Rich Internet Application
(RIA) é uma das respostas a este problema.
Permitindo que o usuário interaja com a
aplicação como se esta fosse um sistema
desktop tradicional, o RIA baseia-se na
70  Java Magazine • Edição 39
 jm39.indb 70
premissa de rodar na máquina do usu-
ário todo o processamento de interface
gráfica, deixando para o lado do servidor
o processamento da lógica de negócio.
O lado cliente das aplicações RIA pode
ser implementado de diversas maneiras,
dentre elas applets Java, páginas DHTML,
aplicativos Macromedia Flash, JavaScript
e outros.
O OpenLaszlo é uma plataforma madura
de desenvolvimento RIA baseada em Ja-
vaScript e XML com suporte à depuração
de aplicações, que renderiza aplicações
em Macromedia Flash.
Neste artigo va-
mos apresentar os
principais concei-
tos dessa platafor-
ma e construir uma
aplicação de exemplo funcional.
Funcionamento do OpenLaszlo
Aplicações OpenLaszlo são definidas em
documentos na linguagem LZX, baseada
em XML. A engine de renderização do
OpenLaszlo (que chamaremos de “Ser-
vidor OpenLaszlo”) é uma aplicação Java
para web, portanto deve ser instalada em
um container web como o Tomcat, ou num
servidor de aplicações Java EE.
Em tempo de execução, o servidor Open-
Laszlo “compila” os arquivos-fonte LZX
para um aplicativo Flash ( .SWF) que é
enviado ao cliente. Na máquina cliente,
o browser roda o aplicativo (às vezes
chamado de “Cliente OpenLaszlo”)
normalmente, utilizando o plug-in Flash.
A Figura 1 ilustra a organização dos com-
ponentes-chave do OpenLaszlo.
Obtendo e configurando o
OpenLaszlo Server
O download do OpenLaszlo pode ser fei-
to em openlaszlo.org/download, selecionan-
do-se a plataforma desejada (Windows, Li-
nux ou Mac OS). Para outras plataformas,
ou para fazer a instalação manualmente,
obtenha o pacote identificado como “Dev
Kit”. O download já inclui o Tomcat, com o
servlet do Servidor OpenLaszlo configura-
do, bem como documentação e exemplos.
Para verificar a instalação, inicie o
servidor com um duplo-clique no
arquivo server\lps-3.3.3\lps\utils\
startTomcat, dentro do diretório raiz
do OpenLaszlo (ajustando sempre o
15/8/2006 18:20:28
  Laszlo
com Flash e Java
número da versão para o seu caso). Após
iniciá-lo, aponte o browser para: http://  lzx) no diretório server\lps-3.3.3\my-apps,
localhost:8080/lps-3.3.3/examples/hello.lzx.
Se tudo estiver OK, deverá aparecer a
mensagem “Hello Laszlo!”. (Para parar o
servidor, dê um duplo-clique no arquivo
server\lps-3.3.3\lps\utils\stopTomcat. )
Primeiro aplicativo OpenLaszlo
Criar uma aplicação “Olá Mundo” no
OpenLaszlo é muito simples. Comece
criando um arquivo texto com o conteúdo
a seguir:
<canvas width=”200” >
<text>Ola Mundo!</text>
</canvas>
 jm39.indb 71
Turbine suas interfaces gráficas
e maximize a interatividade
uma plataforma open source
Salve-o com extensão . lzx (ex.: OlaMundo.
e teste a aplicação apontando o browser
para http://localhost:8080/lps-3.3.3/my-
apps/OlaMundo.lzx.
Toda aplicação OpenLaszlo começa com
a tag <canvas>, que renderiza o painel
principal. Já a tag <text>  renderiza um
texto qualquer.
Aplicação de exemplo
Como exemplo, iremos desenvolver uma
aplicação simples de calculadora, cujos
cálculos são realizados no lado do servidor
por uma página JSP. Os cálculos a serem
processados são submetidos ao Tomcat
usando parâmetros HTTP, e o resultado é
um documento XML como a seguir:
<resultado>25</resultado>
O objetivo é demonstrar como uma apli-
cação cliente criada com o OpenLaszlo
(a interface gráfica da calculadora) pode
submeter dados para processamento no
servidor e obter o resultado mostrando-o
para o usuário. Com as técnicas mostra-
das, você poderá criar aplicações RIA em
Flash que acessam recursos corporativos
rodando, por exemplo, em um
servidor Java EE.
Componentes gráficos e layout
O primeiro passo é criar um arqui-
vo LZX de acordo com a Listagem 1.
Analisando o código, você verá que os
elementos XML representam compo-
nentes visuais, e definições de classes
e de funções JavaScript (estas últimas
em tags <script>). Outro item que chama
atenção é o fato de as classes usadas como
elementos XML começarem com letra
minúscula, por exemplo button, o que
pode soar um tanto estranho para
quem está acostumado às conven-
ções do Java.
com o usuário utilizando
baseada em XML e Java
ANDRÉ LUÍS MONTEIRO
Como se trata de uma linguagem orien-
tada a objetos, a LZX nos permite definir
classes e métodos e usar herança e poli-
morfismo. Tomemos como exemplo a classe
meuBotao. Ela herda da classe button e define
um método que será disparado pelo evento
onclick. O corpo do método é todo escrito
em JavaScript e faz referência a outros
objetos do documento, através dos seus
respectivos ids. Um id permite que um ob-
 jeto seja referenciado de qualquer parte do
documento LZX. Por exemplo, na chamada
visor.setAttribute(‘text’, ‘ ‘) visor é o id.
Ao desenvolver aplicações OpenLaszlo,
geralmente criamos primeiro toda a es-
trutura estática da aplicação, definindo os
componentes visuais e o layout, e depois
adicionamos o comportamento e o proces-
samento de eventos. Para a calculadora,
definimos uma janela, instanciando uma
classe window. Dentro dela adicionamos
uma caixa de texto edittext (o visor), e os
 botões do tipo meuBotao. Em arquivos LZX,
o layout é definido pela classe lzLayout e
suas classes filhas. No exemplo utilizamos
a classe simplelayout  que estende lzLayout  e
Browser Cliente
Plug-in Flash
Cliente OpenLaszlo
HTTP
Container Web / Servidor Java EE
Servidor OpenLaszlo
Figura 1. Arquitetura da plataforma OpenLaszlo
Edição 39 •  Java Magazine 71
15/8/2006 18:20:40
 RIA com Open Laszlo

organiza os componentes na tela, verti- Definindo o comportamento

cal e horizontalmente.
Além desses componentes gráficos, cria-
mos também as views que são “recipientes”
para outros componentes (similares aos
containers do Swing/AWT) e ajudam na
organização visual. A Figura 2  ilustra
como foi feito o layout da calculadora
– os retângulos em laranja são views. A
Figura 3  mostra a calculadora em sua
versão final.
 Com o layout definido e a parte estática
construída, partimos para o comporta-
mento da aplicação e a interação com
o usuário. A começar com os botões, o
leitor notará que todos são instâncias
da classe meuBotao  criada no início do
arquivo LZX, e que contêm um método
para o evento onclick definido no elemento
<method event=”onclick”>. Ou seja, toda ins-
tância desta classe invocará este método

Listagem 1. calculadora.lzx 

<canvas width=”400” debug=”false”> if (valorVisor == ‘0’) {

 <simplelayout axis=”y” spacing=”5”/> visor.setAttribute(‘text’, ‘ ‘);
 <script> }
<![CDATA[ visor.setAttribute(‘text’, valorVisor + textoBotao);
var param1 = 0; }
var param2 = 0;   </method>
var operacao = “”;  </class>

function chamaServidor() {  <text id=”visorResultado” bgcolor=”#ffcccc” width=”0”>

anm.doStart(); <animatorgroup id=”anm2” start=”false” process=”simultaneous”>
var p = new LzParam(); <animator attribute=”wi dth” to=”150”
p.addValue(“ par1”, param1, true); duration=”2500” motion=”linear”/>
p.addValue(“ par2”, param2, true); <animator attribute=”op acity” from=”0” to=”100”
p.addValue(“ op”, operacao, true); duration=”2000”/>
  myData.setQueryString(p);   </animatorgroup>
myData.doRequest();  </text>
}
 <window id=”janela”>
function mostraResultado() { <animatorgr oup id=”anm” start=”false ” process=”simu ltaneous”>
var resultado = myData.getPointer().xpathQuery( <animator attribute=”x”
  “RESULTADO/text()”); to=”100” duration=”1000” motion=”linear”/>
  Debug.write(resultado); <animator attribute=”y” to=”100” duration=”100 0”/>
  visorResultado.setAttribute(   </animatorgroup>
‘text’, param1 + operacao + param2 + “=” + resultado); <view bgcolor=”#666699” id=”minhaView”>
anm2.doStart(); <simplelayou t axis=”y” spacing=”5”/ >
} <edittext id=”visor” text=” “ enabled=”fal se”/>
<view bgcolor=”#666 699”>
function animaJanela() { <simplelayout axis=”x” spacing=”5”/>
tsp = janela.getAttribute(‘opacity’); <meuBotao text=”1”/>
<meuBotao text=”2”/>
if (tsp < 1) <meuBotao text=”3”/>
janela.animate(‘opacity’,+1,3500,true); <meuBotao text=”X”/>
  else   </view>
  janela.animate(‘opacity’,-1,3500,true); <view bgcolor=”#666 699”>
} <simplelayout axis=”x” spacing=”5”/>
]]> </script> <meuBotao text=”4”/>
<meuBotao text=”5”/>
 <dataset name=”myData” id=”myData” <meuBotao text=”6”/>
src=”http://localhost:8080/calculadora.jsp” <meuBotao text=”+”/>
  ondata=”mostraResultado()”/>   </view>
 <class name=”meuBotao” extends=”button” width=”30”> <view bgcolor=”#666 699”>
<method event=”oncli ck”> <simplelayout axis=”x” spacing=”5”/>
var textoBotao = this.getAttri bute(‘text’) ; <meuBotao text=”7”/>
var valorVisor = visor.getAttribute(‘text’); <meuBotao text=”8”/>
<meuBotao text=”9”/>
if (textoBotao == ‘+’ || textoBotao == ‘-’ ||
<meuBotao text=”-”/>
textoBotao == ‘/’ || textoBotao == ‘X’)
  </view>
{
<view bgcolor=”#666 699”>
operacao = textoBotao;
<simplelayout axis=”x” spacing=”5”/>
param1 = valorVisor.substring(1);
<meuBotao text=”C”/>
visor.setAtt ribute(‘text’ , ‘ ‘);
<meuBotao text=”0”/>
} else if (textoBotao == ‘=’) { <meuBotao text=”=”/>
param2 = valorVisor.substring(1); <meuBotao text=”/”/>
visor.setAtt ribute(‘text’ , ‘ ‘);   </view>
chamaServidor();   </view>
}  </window>
else if (textoBotao == ‘C’) {
visor.setAtt ribute(‘text’ , ‘ ‘);  <button text=”Clique aqui” onclick=”animaJanela()”/>
} else { </canvas>

72  Java Magazine • Edição 39

 jm39.indb 72 15/8/2006 18:20:48

 Edição 39 •  Java Magazine 73

 jm39.indb 73 15/8/2006 18:20:51

 RIA com Open Laszlo
Figura 2. Layout da calculadora.
Figura 3. Versão final da calculadora.
Listagem 2. calculadora.jsp
<%@ page contentType=”text/xml” %>
<%@ taglib prefix=”c” uri=”http://java.sun.com/jstl/core” %>
<c:set var=”par1” value=”${param[‘par1’]}”/>
<c:set var=”par2” value=”${param[‘par2’]}”/>
<c:set var=”op” value=”${param[‘op’]}”/>
<c:if test=”${op==’+’}”>
<c:out value=”<RESU LTADO>${(par1 + par2)}</RESU LTADO>”
</c:if>
<c:if test=”${op==’-’}”>
<c:out value=”<RESU LTADO>${(par1 - par2)}</RESU LTADO>”
</c:if>
<c:if test=”${op==’/’}”>
<c:out value=”<RESU LTADO>${(par1 / par2)}</RESU LTADO>”
</c:if>
<c:if test=”${op==’X’}”>
<c:out value=”<RESU LTADO>${(par1 * par2)}</RESU LTADO>”
</c:if>
74  Java Magazine • Edição 39
 jm39.indb 74
ao receber o evento onclick. O método
seta as variáveis param1, operacao e param2
de acordo com a operação indicada pelo
usuário.
  Para submeter os dados para o JSP,
utilizamos a classe dataset , que permite
enviar parâmetros HTTP e recuperar
a resposta formatada em XML. Note
que na definição do dataset myData, o
evento ondata chama a função JavaScript
mostraResultado() . Dessa forma, assim que o
servidor retornar a reposta, a função será
invocada. O código do JSP é bem si mples,
conforme ilustra a Listagem 2.
Após os dados serem submetidos e a
resposta do cálculo ser rec uperada, uma
animação faz com que a calculadora se
mova para a direita, para que o resultado
seja mostrado no plano de fundo. Isso é
possível graças ao método animate() da
classe lzNode (que é a superclasse de todos
os componentes gráficos). Este método
permite que alterações nas propriedades
de um objeto sejam feitas num espaço de
tempo determinado. A nossa aplicação
contém algumas animações, como a de-
finida no elemento <animatorgroup> . Este
elemento agrupa um conjunto de anima-
ções relacionadas, que são executadas
simultaneamente ou em seqüência.
A função animaJanela() também utiliza
recursos de animação. No código dessa
função, observe que o método animate()
recebe quatro parâmetros: o atributo que
será animado, o valor que o atributo de-
verá receber; o tempo total da animação,
para que o atributo assuma o novo valor;
e um booleano, indicando se a alteração
do atributo deve ser relativa ou não.
escapeXml=”f alse”/>
escapeXml=”f alse”/>
escapeXml=”f alse”/>
escapeXml=”f alse”/>
Para rodar a aplicação, basta copiar o
arquivo calculadora.lzx   para o diretório
server\lps-3.3.3\my-apps de sua instalação
do OpenLaszlo. É necessário também
instalar o JSP no Tomcat. Para simplificar,
vamos colocá-lo no diretório server\tom-
cat-5.0.24\webapps\ROOT (a versão do
Tomcat pode variar). Além disso, como o
 JSP usa a JSTL precisamos do  jstl.jar e do
standard.jar  (disponíveis em  jakarta.apa-
che.org/site/downloads/downloads_taglibs.
html, na seção “Standard 1.1 Taglib”).
Copie estes dois JARs para o diretório
Server\tomcat-5.0.24\webapps\ROOT\
WEB-INF\lib.
Pronto. Basta apontar o browser para
http://localhost:8080/lps-3.3.3/my-apps/ 
calculadora.lzx para ver o exemplo fun-
cionando.
Conclusões
Neste artigo apresentamos o básico do
OpenLaszlo, da instalação à criação de
uma aplicação funcional que faz uso de
código Java no servidor. O OpenLaszlo é
uma plataforma que vem ganha ndo apoio
crescente da comunidade de desenvolve-
dores e integra-se especialmente bem com
a tecnologia Java. A plataforma está em
franca evolução, como atesta o novo pro-
 jeto “Legals” com release final previsto
para o final deste ano, e que suportará a
geração para Flash 9 e DHTML.
OpenLaszlo.org
Site oficial do OpenLaszlo que contém
tutoriais e um fórum com participação da
comunidade.
 laszlosystems.com
Empresa que criou o Laszlo original. Disponibiliza
aplicações comerciais bastante profissionais.
 laszlomail.com
Exemplo de uma aplicação feita em Laszlo.
 javamagazine.com.br/downloads/jm39/
 jm-openlaszlo.zip
André Luís Monteiro
(andre.monteiro@fiveware.com.
br ) é consultor sênior da Fiveware
Solutions e tem as certificações
SCJP, SCWCD e SCEA.
15/8/2006 18:20:52
 jm39.indb 75 15/8/2006 18:20:56