jm6-book.

indb 1 3/4/2003, 17:48:25

jm6-book.indb 2 3/4/2003, 17:48:41
 Contedo
06
Java News Dicas e Solues
Lanamentos de produtos, novas MICHAEL NASCIMENTO SANTOS
tecnologias e especificaes Java Problemas e solues prticas: recuperao 32
de sesses, transaes em EJBs e usos
de final

08
Comunidade
LEONARDO GALVO
JustJava 2003, a participao brasileira no Automao com XDoclet
JavaOne, listas de discusso e PBJUG MARCUS BRITO
Retirar do programador a tarefa entediante 46
de criar cdigo repetitivo, adicionando mais
significado e poder ao cdigo o objetivo
do XDoclet
10
A Vida, o Universo e Tudo Mais
BRUNO SOUZA
Java no desktop, parte 2:
toolkits web, distribuio e instaladores Jakarta Velocity
PAULO SILVEIRA E RAFAEL STEIL
O uso de templates na camada de apresen- 50
tao de aplicaes web simplifica a manu-
teno e a separao de responsabilidades
16
Java Livre
FERNANDO LOZANO
Aprenda o essencial sobre o container web mais
usado no mercado

Asseres no J2SE 1.4

22 FELIPE LEME
Java de Bolso Sintaxe e melhores prticas para o uso
CLUDIO MIRANDA de comandos assert para a deteco
Integrao de aplicaes J2ME e servios de rede antecipada de erros
atravs do Generic Connection Framework
36

28
Alm das Fronteiras
JLIO CSAR LINS
JSP 2.0: linguagem de expresses, JSTL padro,
fragmentos e tag files so algumas extenses Struts: primeiros passos
MIGUEL NGELO GALLINDO,
RICHARDSON OLIVEIRA E DANIEL FREITAS
Conhea a arquitetura e o funcionamento
54 bsico do framework lder para o
Livros desenvolvimento web
DANIEL DEOLIVEIRA
Existem bons escritores brasileiros sobre Java 40

Edio 6 Java Magazine 3

jm6-book.indb 3 3/4/2003, 17:48:55

Direo
Diretor Editorial
Leonardo Galvo
Diretor Comercial
Espao do L
Casseano Filho
Diretor de Marketing
Gladstone Matos

Edio
Publisher e Editor
Leonardo Galvo
Editor Adjunto
Fernando Lozano
Q uando, em 2001, a Sun decidiu oficializar a separao de Java em trs platafor-
mas as hoje to conhecidas J2EE, J2SE e J2ME parecia ser uma delimitao
adequada e suficiente por muitos anos. Mas uma tecnologia rica e dinmica
como Java parece desafiar qualquer categorizao.
Jornalista Responsvel Em que plataforma entraria, por exemplo, o novo J2EE Client Provisioning, para a
Srgio Moraes C. Brando (MTb: 15183-68-148) integrao entre aplicaes servidoras e clientes conectados, tanto os sem-fio quanto os
Corpo Editorial desktop? Micro, Enterprise ou Standard Edition? Um pouco dos trs... E o que dizer de
Alexandre Denes dos Santos, Bruno Souza, Edgar Silva, ferramentas como o XDoclet, para gerao de cdigo, baseada no Javadoc (J2SE, claro...),
Hyalen Caldeira, Jlio Csar Lins, Osvaldo Doederlein mas que se supera na gerao de EJBs (ento no seria J2EE?). E o Jakarta Velocity?
Colaboraram nesta edio Este deixa para trs qualquer delimitao afinal, templates (o corao do Velocity)
Bruno Souza, Cludio Miranda, Daniel deOliveira, Daniel Freitas,
podem ser usados em aplicaes que precisam gerar pginas HTML, documentos XML,
Felipe Leme, Fernando Lozano, Gustavo Nalle Fernandes,
Jlio Csar Lins, Leonardo Galvo, Marcus Brito, componentes EJB, telas MIDP... As linhas que dividem as plataformas realmente esto
Michael Nascimento Santos, Miguel ngelo Gallindo, cada vez menos claras, principalmente devido evoluo e integrao das APIs.
Paulo Silveira, Rafael Steil, Richardson Oliveira A inte(g)rao entre plataformas um tema recorrente nos artigos, colunas e sees
desta edio. Na coluna Java de Bolso demonstrado o framework de conectivida-
Arte de oficial do J2ME/MIDP, para a comunicao de celulares com servios no back-end
Editor de Arte atravs de protocolos wireless e internet o end-to-end chegando maturidade.
Tarcsio Bannwart (tarcisio@javamagazine.com.br)
Ainda dentro do assunto de capa, temos trs textos sobre temas queridos pelos de-
Capa
senvolvedores: o JSP, que na verso 2.0 vem com extenses que prometem aumentar
Ivan Sria Fernandez (ivansf@brturbo.com)
muito a produtividade; o Struts, framework web que faz boa parte do trabalho braal
Ilustraes internas
Felipe Machado (felipe_m@ibest.com.br) e facilita a programao em equipe; e o Tomcat, o container e servidor web que, voc
sabe, referncia para a execuo de servlets e JSPs.
Produo A rede das redes tambm ocupa espao privilegiado na segunda parte do artigo so-
Gerente de produo bre Java no Desktop (coluna A Vida o Universo e Tudo Mais), que mostra tcnicas e
Rosngela Mattos ferramentas para trazer os benefcios da web para o desktop e apresenta idias para
Assessoria de Imprensa
levar algumas vantagens do ambiente local para aplicaes web.
Kaline Dollabella (kalined@hotmail.com)
Focando na linguagem, o artigo sobre asseres explora o uso da palavra-chave
Impresso
Grfica Bandeirantes assert, que simplifica o chamado design-by-contract, criado pelo guru da orientao a
Distribuio objetos Bertrand Meyer. Finalizando, temos uma novidade que deve agradar a muitos:
Fernando Chinaglia Distribuidora S.A. a coluna Dicas e Solues, que soluciona problemas encontrados freqentemente pelos
Rua Teodoro da Silva, 907, Graja - RJ desenvolvedores.
CEP 20563-900, (21) 3879-7766 - (21) 2577-6362 isso. Boa Pscoa e muita paz para todos.
Leonardo Galvo
Publicidade Publisher e Editor
publicidade@javamagazine.com.br

Contato
Assinaturas
assinaturas@javamagazine.com.br , (021) 2213-0941 ou no site
Cartas e informaes gerais
info@javamagazine.com.br Servlets com J2SE
Na web Quando tento acessar a API de servlets, o Eclipse
Estou utilizando o JBoss e o Tomcat como servi-
www.javamagazine.com.br dores em meu micro com o J2SDK 1.3.1.03 insta- reclama como se ela no existisse no meu SDK. O
lado. Uso o 1stPage para a edio de JSP e HTML, que preciso fazer?
e o Eclipse para a gerao de arquivos .class e .jar. Mrcio Alex

Neofcio Editora

jm6-book.indb 4 3/4/2003, 17:49:23

eitor
Edio 5
Desktop
Gostaria de parabenizar a Java Magazine e o sr.
Bruno Souza pelo artigo Java no Desktop (Edi-
o 5). Trabalho com aplicaes comerciais em
outra linguagem e pretendo convert-las para
Java. Lendo o artigo, pude perceber que no se
trata apenas de um sonho Java pode sim rodar
no desktop. Obrigado!
JBoss inicial
J comprei todas as edies dessa revista e,
a cada edio, percebo que cresce mais e mais.
Meus parabns pelo produto. A matria que
mais me encantou foi a JBoss Inicial, que me
fez baixar o JBoss e fazer o cdigo no artigo.
Contudo, encontrei um erro ao conectar ao
JBoss: NoInitialContext....
Udo (m_udo@uol.com.br)
Basicamente, todas as APIs que dependem de ser-
vidores especializados (servidores de nomes, web, e
de aplicao, monitores de transao, servidores de
e-mail etc.) esto includas apenas no J2EE. Servi-
dores J2EE (como o JBoss) ou containers web (como o
Tomcat) fornecem as APIs necessrias em pacotes JAR
que devem ser adicionados ao seu classpath para a
compilao dos programas.
Entretanto, a maioria dos IDEs ignora o classpath
do sistema operacional, de modo que voc deve con-
figurar sua ferramenta para incluir as APIs adicionais.
No Eclipse, voc deve selecionar o cone do seu projeto,
clicar com o boto direito e mostrar a janela de pro-
priedades; depois selecionar a opo Java Build Path
e clicar no boto Add External JAR para adicionar os
pacotes contendo as APIs necessrias.
A API de servlets fornecida pelo JBoss no arquivo
(JBOSS_HOME)/server/default/lib/javax.servlet.jar.
Este o pacote JAR que deve ser adicionado ao seu
Erramos
Na coluna Livros da Edio 5, foram pub-
licadas informaes incorretas sobre o livro
Aprenda Java em 21 Dias, da Editora Campus.
Correo:
Aprenda Java em 21 Dias,
Professional Reference
Laura Lemay e Rogers Cadenhead
531 pginas, R$ 109,00
ISBN 8535208658
jm6-book.indb 5
Esse erro indica que, ou no foi possvel localizar as
classes do pacote javax.naming (da
API JNDI, que padro no J2EE mas
no fornecida com o J2SE), ou que
no foi possvel localizar uma confi-
gurao para acesso ao servidor de
nomes JNDI. Supondo que o cliente
web tenha rodado sem problemas
e que voc conseguiu navegar pelo
console JMX do JBoss (chamando a
URL http://127.0.0.1:8080/jmx-con-
sole), sua instalao est correta; fal-
ta apenas incluir no classpath todos
os pacotes JAR presentes no diretrio
client do JBoss. Os pacotes devem ser
includos um-a-um, com o caminho completo.
Como isso ir gerar um classpath bem grande (so
24 pacotes a serem adicionados), tenha cuidado: fcil
errar na digitao de um caminho, usar dois pontos
projeto no Eclipse para que seja possvel compilar
servlets.
As edies 4 e 5 fornecem instrues detalhadas
sobre a localizao dos pacotes contendo as APIs no
JBoss e como configurar o Eclipse para utilizar APIs
definidas em pacotes externos.
Mudanas em Taglibs
Estou com problemas para montar o exemplo
Frum de Debates da Edio 5. O arquivo citado
jakarta-taglibs-20021014.zip no est mais disponv-
el e os novos no incluem os arquivos utility.tld ou
utility.jar.
Ronaldo Jnior (link_rjr@terra.com.br)
A verso citada no artigo para a biblioteca de
tags JSTL fornecida pelo projeto Jakarta Taglibs
(jakarta.apache.org/taglibs) era um snaphot, uma
verso de desenvolvimento. J esto disponveis
verses de produo no momento de fechamento
desta edio, a mais recente 1.0.3. Voc pode
baixar qualquer verso de produo (release) em
www.apache.org/dist/jakarta/taglibs/standard/
binaries, por exemplo jakarta-taglibs-standard-
1.0.3.zip, pois todas funcionaro sem problemas com o
cdigo nos artigos do frum (e do mural, na Edio 4),
com qualquer verso do Tomcat de 4.0.3 em diante.
As novas verses da JSTL modificaram a distribuio
dos tags em pacotes JAR e passaram a incluir pacotes
externos necessrios para o suporte a algumas tags
(como o Xerces para as tags relacionadas com XML),
no lugar de ponto-e-vrgula (separao entre as
entradas), esquecer de prefixar o
caminho com a letra de drive no
Windows, ou de outro modo gerar
um classpath que contm apenas
parte dos pacotes.
Alm disso, se voc utiliza o
Windows 98, pode ter ficado sem
espao de ambiente. Nesse caso,
adicione o seguinte comando ao
arquivo config.sys e reinicialize o
computador:
shell=\windows\command.com
/e:4096 /p
Concluindo, importante lembrar
que os pacotes no diretrio client do JBoss so
necessrios apenas para executar um cliente da
aplicao, mas no para compilar esse cliente ou
para executar ou compilar um cliente web.
de modo que voc deve copiar todos os pacotes JAR
no diretrio lib da distribuio (jakarta-taglibs/
standard-1.0.3/lib) para o diretrio WEB-INF/lib de
sua aplicao web, ou ento para o diretrio shared/
classes do Tomcat. L elas ficaro visveis para todas
as aplicaes hospedadas pelo servidor.
Importante: no mais necessrio copiar os arquivos
.tld. Eles esto includos nos pacotes JAR e sero local-
izados sem problemas pelas pginas JSP.
100 vezes Java
Acho a revista demais as primeiras edies so
imperdveis. Toro para que a Java Magazine tenha
sucesso, pois faltava um veculo especfico para pro-
gramadores e especialistas na linguagem Java. Meus
parabns. Espero me manter assinante da Revista
at a Edio 100 e o que vier alm!
Rodrigo Ferreira (rodrigo2k@visualnet.com.br)
Participe!
Envie sua dvida, pedido, sugesto ou crtica
para info@javamagazine.com.br, ou para:
Editor - Java Magazine
Av. 7 de Setembro, 4698, Conj.1501-1503
Curitiba-PR, CEP 80240-000
Fax: (041) 242-4580.
Cartas publicadas podem ser editadas por
motivos de clareza ou extenso.
Edio 6 Java Magazine 5
3/4/2003, 17:49:26

Gerenciamento livre com Maven*
O Maven nasceu para facilitar o geren-
ciamento dos subprojetos do Jakarta
Turbine, mas seus desenvolvedores perce-
beram que poderia ir muito mais longe. As-
sim, por uma deciso recente do comit do
Grupo Apache, a ferramenta foi promovida
a Top Level Project . O Maven ainda est em
beta e ainda existe um longo caminho at o
release final, no qual sero eliminados bugs
e instabilidades em alguns plugins impor-
tantes, mas j vale a pena considerar o uso
da ferramenta em seus projetos.
O Maven se prope a automatizar e geren-
ciar vrios aspectos de um projeto, desde a
compilao, at a gerao de relatrios so-
bre a aderncia a convenes de codificao,
passando pela documentao e download
de bibliotecas. A ferramenta se baseia em
um arquivo XML chamado POM (Project Ob-
ject Model), contendo informaes tais como
nome, URL, desenvolvedores envolvidos,
listas de discusso, testes a serem feitos e
dependncias. Para usar completamente as
funcionalidades do Maven, os projetos deve-
ro seguir uma certa estrutura de diretrios
e arquivos (que nem sempre intuitiva mas
bem documentada).
A documentao do projeto tambm
pode ser gerada e gerenciada pelo Ma-
ven. Configurando um arquivo chamado
navigation.xml, voc indica como deve ser
gerado o site do projeto e como associ-
lo aos javadocs. Para auxiliar em projetos
grandes, so identificadas dependncias,
que depois so baixadas de repositrios
na internet.
A flexibilidade do Maven se deve aos seus
muitos plugins, que j passam de 30. A maio-
ria escrita sem usar Java diretamente, mas
sim com Jelly, uma linguagem de scripts do
Jakarta.
Veja mais em maven.apache.org.
*por Paulo Silveira
6 Java Magazine Edio 6
jm6-book.indb 6
Java Ne w
Animais, hacks e livros
V oc f dos livros da OReilly, famosa por
seus animal books? Ento vale a pena
conhecer trs lanamentos importantes
dessa editora norte-americana.
www.oreilly.com
O livro Java Extreme Programming
Cookbook (por Eric Burke e Brian Coyner)
demonstra a popularidade da combinao
de Java com o Extreme Programming (XP),
um processo de desenvolvimento leve es-
pecialmente adequado para projetos com
equipes pequenas ou mdias e adorado
por muitos desenvolvedores ressentidos
com processos burocrticos.
O livro explora as principais ferramentas
usadas no desenvolvimento Java seguindo
os princpios do XP, tais como Ant, JUnit,
Cactus, Tomcat e XDoclet num atestado
da fora da tecnologia na criao de sof-
tware de qualidade. O captulo sobre JUnit
pode ser baixado gratuitamente do site
www.oreilly.com/catalog/jextprockbk.
www.oreilly.com
Com foco mais tcnico, Java Data Objects
(dos autores David Jordan, Craig Russell)
trata da tecnologia para persistncia de ob-
jetos JDO, que vem causando frisson entre
os desenvolvedores e despontando como
alternativa (ou importante complemento)
ao mecanismo de persistncia dos EJBs.
Um dos autores Craig Russel, lder da
especificao de JDO na Sun portanto o
leitor estar em boas mos. Procure por um
captulo de amostra em www.oreilly.com/
catalog/jvadtaobj.
www.oreilly.com
O terceiro lanamento, Google Hacks
(por Tara Calishain e Rael Dornfest), no
animal nem tampouco se concentra na
tecnologia Java, mas igualmente importan-
te, especialmente para o desenvolvedor que
precisa se encontrar na abundncia de APIs,
especificaes e notcias tecnolgicas.
"Google Hacks" inclui 100 dicas sobre o
uso eficaz do Google, o mecanismo de
busca usado para mais de 70% das pesqui-
sas realizadas da internet. So desde dicas
simples sobre configuraes avanadas,
at o uso da API do Google com vrias
linguagens (incluindo Java, claro). O site
hacks.oreilly.com/pub/ht/2 contm um
resumo das cem dicas e libera oito para
acesso gratuito.
3/4/2003, 17:49:27

e ws
X-News*
Novo JAXP
Includa no pacote da Sun para desenvolvi-
mento de web services(JWSDP 1.1), a verso
1.2.2 da implementao de referncia do
JAXP (Java API for XML Processing) tem novi-
dades importantes. A principal a incluso do
XLSTC (Compiling XSLT Processor), e a criao
de novas propriedades no parser XML que
aumentam a segurana no processamento
de mensagens SOAP.
A especificao do JAXP define uma camada
de abstrao para o processamento de XML,
que inclui parsing (usando DOM ou SAX)
e transformaes de documentos usando
uma folha de estilos XSL. A implementao
de referncia inclui vrias bibliotecas do
grupo Apache:
xercesImpl.jar Xerces, parser XML pa-
dro do JAXP. A nova verso includa (2.2.1)
contm vrias correes de bugs e melhorias
de desempenho;
xalan.jar Xalan, processador XSLT
padro do JAXP, suporta XSLT 1.0 e XPath 1.0,
e implementa as interfaces definidas pelo
TraX (Transformation API for XML). A verso
do Xalan foi atualizada da 2.3.1 para a 2.4.1,
que tem maior desempenho e muitos bugs
corrigidos;
xsltc.jar XSLTC, uma alternativa oferecida
pelo Xalan para a realizao de transforma-
es XSLT. Compila a folha de estilo XSL
dando origem a um Translet, formado por
bytecodes Java que realizam a transformao.
A abordagem XSLTC aumenta o desempenho
de transformaes XSLT, visto que uma folha
de estilo compilada uma s vez e todas as
transformaes subseqentes so realizadas
pelo Translet gerado;
dom.jar implementa suporte a DOM
(Document Object Model) level 2. O DOM le-
vel 3, que incluir suporte ao XPath e vrias
melhorias (por exemplo, o tratamento de
eventos de teclado e a possibilidade de alte-
rao dinmica do documento), suportado
experimentalmente no Xalan;
sax.jar implementao do suporte a SAX
2.0 (Simple API for XML);
jm6-book.indb 7
jaxp-api.jar contm as interfaces que
definem as APIs de parsing e transformao
de XML, definidas na especificao final do
JAXP 1.2 (JSR-63). As classes dos diferentes
fornecedores devem implementar essas
interfaces.
O download do JAXP feito como parte
do JWSDP, em: java.sun.com/webservices/
downloads/webservicespack.html.
Caminhos com JXPath
J est disponvel a verso 1.1 do JXPath,
biblioteca do Jakarta Commons que define
um interpretador para a linguagem XPath.
XPath (XML Path Language) uma lingua-
gem de expresses criada pelo W3C para uti-
lizao em folhas de estilos XSL e expresses
XPointer (usadas para referenciar fragmentos
de um documento XML qualquer atravs de
uma URI). Com XPath, possvel selecionar
ns de um documento XML de acordo com
critrios especificados.
Com o JXPath possvel ir alm, usando
XPath sobre JavaBeans, colees, arrays,
ns DOM/JDOM, contextos de servlets, ou
em combinaes desses. Outra vantagem
do JXPath a reduo do nmero de linhas
de cdigo para a navegao em estruturas
complexas, evitando o uso de intenso de
loops aninhados, expresses condicio-
nais e casts.
Entre as novidades do JXPath 1.1
est o suporte completo a JDOM e
a contextos relativos, e a cober-
tura estendida da sintaxe do
XPath para modelos no-XML.
Foram adicionadas tambm
funcionalidades aos objetos
Pointer, que podem armazenar
a localizao de um elemento ou
grupo de elementos dentro de uma hierar-
quia, para uso posterior.
Documentao e download em:
jakarta.apache.org/commons/jxpath
Mapeamento XML/Java
A verso 1.0 final do JAXB (Java Architecture
for XML Bindind) outra importante API que
Lanamentos e atualizaes de
produtos, novas tecnologias,
especificaes e estratgias
faz parte do Java Web Services Developer Pack
1.1. Na nova verso, so suportados subcon-
juntos dos padres XML Schema e XML Na-
mespaces, e oferece recursos mais flexveis
para marshalling e unmarshalling, alm de
novas funcionalidades de validao.
Com o JAXB possvel fazer um
mapeamento bidirecional entre documentos
XML e objetos Java, permitindo a manipulao
de XML atravs de Java em vez das APIs SAX e
DOM, isolando o desenvolvedor de detalhes
internos do XML como parsing, namespaces
e eventos. Para comear a usar a API, deve-se
definir um XML Schema. O schema tem um
objetivo semelhante a um DTD, porm mais
abrangente e escrito em XML.
O suporte a schemas a grande novidade na
nova verso do JAXB as verses anteriores
suportavam apenas DTDs. O desenvolvedor
que usa DTDs em seus sistemas poder fazer
a migrao para schemas usando ferramentas
livres como o Trang (ver nota neste quadro).
O JAXB define trs operaes principais:
Binding, Marshal e UnMarshal :
Binding a partir de um schema, um utili-
trio fornecido pelo JAXB, chamado de bind
compiler, gera automaticamente classes
e interfaces que mapeiam os
elementos definidos;
UnMarshal usando um ob-
jeto UnMarshaller, possvel
criar uma rvore de objetos que
reflete a organizao e a hierarquia
do documento XML so instncias
das classes geradas pelo bind compi-
ler. O JAXB permite que seja feito um
unMarshal em arquivos XML, em
dados XML obtidos de um InputS-
tream, URL ou eventos SAX, entre
outras fontes possveis.
Marshal um objeto Marshaller cria docu-
mentos XML a partir de uma rvore de obje-
tos que representam a estrutura do schema.
possvel fazer uma validao baseada no
schema antes de realizar a converso.
Veja mais em java.sun.com/xml/jaxb.
* por Gustavo Nalle Fernandes
Edio 6 Java Magazine 7
3/4/2003, 17:49:35

Duke do Cangao
O Nordeste ganhou mais um importante
JUG. o PBJUG, Grupo de Usurios
Java da Paraba, inaugurado no dia 15 de
maro no auditrio do CEFET-PB. A primeira
reunio contou com a presena de 80 pes-
soas e se estendeu por um dia inteiro.
A abrangncia das palestras foi grande
no evento de lanamento. Na apresentao
de abertura, foi demonstrada a ferramenta
e-Gen Developer em desenvolvimento por
uma equipe liderada por Ronaldo Costa e
Anderson Teixeira, gerentes das Lojas
Maia. Seguiram-se duas palestras sobre
experincias prticas em projetos Java,
por Marcelo Castro (Politec) e Jos Marco-
ni (Qualiti). Retomando o enfoque tcnico,
o professor Frederico Guedes (CEFET-PB)
tratou da API de Collections, uma das mais
elegantes e ricas do J2SE. A seqncia de
palestras foi concluda com uma viso ge-
ral do mercado Java no Pas, por Rodrigo
Assad do C.E.S.A.R. (Centro de Estudos e
Sistemas Avanados do Recife).
Durante o evento, patrocinado pela
Oracle do Brasil e Connect Solues In-
tegradas, e apoiado pela Java Magazine e
CEFET-PB, ocorreram sorteios de brindes
da Oracle e exemplares da Java Magazine.
Para participar dos sorteios, foi solicitado
um quilo de alimento; o arrecadado foi do-
ado Casa de Apoio Criana com Cncer
de Joo Pessoa.
Os coordenadores Herval Freire (Con-
nect), Marcelo Castro (Politec) e Frederico
Guedes (CEFET-PB) j planejam as prximas
reunies (mensais). Alm das obrigatrias
palestras tcnicas, esto previstas apre-
sentaes sobre casos de sucesso e novos
produtos. O PBJUG mantm uma lista de
discusso em groups.yahoo.com/group/
pbjug. Participe!
8 Java Magazine Edio 6
jm6-book.indb 8
Comunida
A fora de Java no Brasil
Listas SouJava*
Q uando precisamos resolver um problema para
o qual no conseguimos encontrar a soluo,
o ideal contar com um amigo ou colega mais
Java. E a [dicas-list] , com cerca de 2.400 assinan-
tes, fornece dicas gerais sobre a tecnologia Java.
Veja na tabela os assuntos tratados em cada lista,
experiente, para servir de guru. s vezes, um pro- alm do e-mail para inscrio e o nmero de ins-
blema que nos aflige por horas pode ser imedia- cries (em abril de 2003). Para realizar pesquisas
tamente resolvido ou pelo menos encaminhado
com um simples comentrio de quem j passou
por isso. Pena que nem sempre podemos contar
no histrico, use URLs com o formato:
www.mail-archive.com/<lista>@soujava.org.br
Por exemplo:
com algum assim no nosso dia-a-dia. Mas, para www.mail-archive.com/java-list@soujava.org.br
ajudar nessas horas, que existem as listas de dis- A participao nas listas gratuita, e os partici-
cusso, baseadas em e-mail ou fruns na web. pantes so muito colaborativos. Mesmo assim, veja
Na Sociedade de Usurios Java (SouJava), algumas dicas simples que certamente tornaro
milhares de profissionais se renem em algumas sua participao mais produtiva:
das mais importantes listas de discusso sobre a Antes de enviar uma questo para a lista, tente
tecnologia Java no Brasil. Com mais de 10 mil resolver o problema e, ao perguntar, indique o que
inscries, as listas do SouJava so uma opo voc j tentou fazer para resolv-lo;
para voc ajudar e solicitar ajuda nas mais diversas Se voc um usurio novo na lista, participe
tecnologias Java. As listas so segmentadas por por alguns dias como ouvinte. Acompanhe as
rea de interesse, todas as mensagens so arqui- discusses para entender o comportamento e
vadas e possvel realizar pesquisas no histrico os tpicos, sem submeter perguntas. Assim, voc
de cada lista, tendo assim acesso ao conhecimento passa a conhecer melhor os participantes da lista
acumulado nas centenas de milhares de mensa- e evita fazer perguntas que no condizentes com
gens enviadas. o estilo da lista;
O SouJava mantm tambm duas listas de in- Ao enviar uma pergunta, inclua toda a infor-
formao bastante populares. A [noticias-list] , mao relevante, especialmente as mensagens
com mais de 3.900 assinantes, divulga notcias de erros que voc encontrou.
sobre a tecnologia e a comunidade Java, even- Mais informaes sobre as listas do SouJava
tos e atividades do SouJava e de outros grupos podem ser obtidas em www.soujava.org.br/
de usurios de todo o Pas. Atravs dessa lista, listas.html.
publicado o SouJava News, um boletim que traz,
semanalmente, notcias e links importantes sobre *por Bruno Souza
Listas de discusso
Lista Contedo Inscritos Inscrio
Discusses gerais sobre a tecnologia Java: linguagem, java-list-subscribe@
[java-list] 1.800
compilao, ferramentas e APIs soujava.org.br
Uso de Java no ambiente servidor. Acesso a bancos de
enterprise-list-subscribe@
[enterprise-list] dados, servidores de aplicaes, servlets/JSP, EJB e J2EE 910
soujava.org.br
em geral so os principais assuntos
Java em pequenos dispositivos, abordando J2ME, j2me-list-subscribe@
[j2me-list] 570
JavaCard, celulares com suporte a Java e ferramentas. soujava.org.br
Padronizao da tecnologia Java, o processo JCP, padronizacao-list-subscribe@
[padronizacao-list] 450
especificaes soujava.org.br
Discusses sobre o evento JavaOne. Ajuda na submisso javaone-list-subscribe@
[javaone-list] 340
de palestras, formao de caravana para o evento etc. soujava.org.br
Listas de informao
Notcias, eventos, SouJava News, anncios de noticias-list-
[noticias-list] 3.900
empregos subscribe@soujava.org.br
dicas-list-
[dicas-list] Dicas gerais sobre a tecnologia Java 2.400
subscribe@soujava.org.br
3/4/2003, 17:49:37
 de Pessoas, grupos e
empresas que tornam
forte o Java no Pas

l
LEONARDO GALVO

JustJava se aproxima
O primeiro grande evento de Java do ano j
est com data, local e principais patrocina-
dores confirmados. O JustJava 2003 acontecer
nos dias 26 e 27 de abril, no Centro de Conven-
es Frei Caneca (Rua Frei Caneca, 569, Cerquei-
ra Csar, So Paulo-SP). O evento tem apoio da
SUCESU-SP e j conta com dois patrocinadores
Master: IBM e Oracle. Mais de mil participantes
so esperados e intenso o interesse de empresas
em fazer parte do evento.
As cerca de 40 de palestras tcnicas e geren-
ciais do Evento da Comunidade Java Brasileira
ser dividido em sete tracks : Java no ambiente
servidor, Java em Pequenos Dispositivos, Core
Java: Linguagem e APIs, Ferramentas, Solues e
Produtos; Casos de sucesso; Outras Tecnologias
Relacionadas a Java (Jini, JXTA etc.); e Ossos do
Ofcio (problemas e solues do dia-a-dia do
desenvolvedor).
Funcionando em paralelo s palestras, haver
um Pavilho de Exposies, que incluir, alm
de estandes de empresas, um amplo espao
de convivncia. Um dos principais objetivos do
Pavilho promover o networking
e a troca de conhecimentos entre os
participantes. Para maximizar essa in-
terao, os intervalos entre palestras
tero durao estendi-
da ser reservado pelo
menos meia hora para
cada coffee-break, com
a possibilidade de intervalos maiores. Portanto,
se voc rato de palestra e fica divido entre a
animao dos corredores e a aquisio de conhe-
cimento nas apresentaes, poder fazer os dois
no JustJava 2003 sem peso na conscincia.
Alm das palestras, haver trs keynotes (apre-
sentaes especiais usando o espao de vrias
salas) dois no primeiro dia (manh e tarde) e
um na manh do domingo. Fechando o sbado,
haver um coquetel e um conjunto de
discusses informais, no estilo dos
antigos BOFs das primeiras edies do
JavaOne.
H ainda muitas sur-
pre sas prometidas.
Acom panhe as ltimas
novidades no site
www.justjava.com.br, ou inscreva-se na lista de
notcias do evento, enviando um e-mail para
evento-justjava-subscribe@soujava.org.br.

Brasil 10 no JavaOne 2003

A presena brasileira no JavaOne 2003 (So

Francisco, EUA, de 10 a 13 de junho) ser pelo
menos duas vezes maior neste ano que na ltima
edio do evento. J so 10 palestras aprova-
das, algumas com destaque especial nunca an-
tes conseguido por equipes brasileiras duas
business sessions (abreviadas por BUS), duas
technical sessions (TS) e seis BOFs (birds-of-a-
feather, palestras mais especficas, ministradas
no perodo da noite ou madrugada).
A tabela apresenta os palestrantes e as pales-
tras (com ttulos originais em ingls) observe a
variedade e a relevncia das palestras aprovadas.
mais uma prova da crescimento, tanto quantita-
tivo quanto qualitativo da nossa comunidade.

Ttulo Id. Palestrantes

The Brazilian National Health Card Project: Building the National Health Informatics Rosani Cunha, Beatriz Leo (Ministrio da Sade); Manoel Lemos
BUS-2680
Infrastructure (Singularity Systems)

Webhosting JavaServer Pages (JSP)/Servlets Securely Using open-source products BUS-1771 Renato Weiner (LocaWeb)

Felipe Leme, Antonio Gois (Seed Technology Solutions) e Wladimir

Java Technology Logging: The Past, the Present and the Future TS-2148
Domingues (SeedTS Technology Solutions)
Beyond Web Services: Combining Jini Network Technology and Project JXTA to take Bruno Souza (SouJava); Carlos Queiroz (IME/USP); Einar Saukas (Summa
TS-2220
Advantage of Edge Computing Technology)

Automatic Internationalization using Web Services BOF-1205 Diueine Monteiro (Bluebox Technologies); Cludio Teixeira (Procwork)

Java Technology and Financial Systems Integration in Brazil BOF-1610 Diueine Monteiro e Carlos Villela (BlueBox Technologies)

Enterprise Java Technology-Based Projects that Fail: What Can We Learn from Them? BOF-1824 Michael Santos (Tesla Tecnologia)

Real-Time Human Motion Capture Using Java Technology BOF-2059 Nilton Guedes (Sun Microsystems do Brasil); Analvia Cordeiro (PUC-SP)

Introduction to Enterprise Application Integration (EAI) and the J2EE Connector

BOF-2534 Rodrigo Abreu (Beng Informtica); Yara Hornos (Globalcode)
Architecture
Gustavo de Paula (C.E.S.A.R); Fernando Nascimento (Motorola Brazil Design
Considerations in Implementing a MIDP IM Client BOF-2985
Center)

Edio 6 Java Magazine 9

jm6-book.indb 9 3/4/2003, 17:49:42

 A Vida, o Univeso e Tudo Mais

Java no De s
Parte 2: Toolkits, distrib u

controle. Nesses casos, quais as al- todo um modelo de tratamento de eventos

ternativas para gerar aplicaes que
paream locais? Aplicaes que se pa-
ream mais com uma srie de janelas,
com botes e menus, do que um conjunto
de pginas? A maioria segue o caminho
de criar aplicaes usando uma mistura de
HTML e (toneladas de) JavaScript.
que no faz parte do mundo web.
Mas no se desespere Java pode vir em
seu socorro. Existem alguns toolkits que
se propem a fazer exatamente isso: dis-
ponibilizar uma interface local usando
tecnologias web e fornecendo o suporte
necessrio para faz-lo corretamente. Es-

N
a primeira parte deste artigo (In-
terfaces, usurios e alternativas,
Edio 5) tratamos dos tipos de
usurios de uma aplicao e vimos como
diferenciar os usurios internet, intranet
e extranet. Vimos tambm quais tecnolo-
gias nos permitem criar aplicaes locais
(desktop) sofisticadas com a tecnologia
Java.
Mas existe muito mais em fornecer uma
aplicao local do que apenas criar jane-
las com o Swing. A tecnologia Java traz
o suporte necessrio para a integrao
de clientes e servidores em uma soluo
nica. Como distribuir e atualizar essas
aplicaes? Mas como podemos distribuir
essas aplicaes, e a prpria JVM? Vamos
juntos conhecer as tecnologias que resol-
vem essas questes.
E o que fazer quando uma aplicao local
no uma opo, mas sua aplicao tem muitas vezes tornam obrigatria a instala-
muito mais caractersticas de aplicao
local do que web? Vimos na primeira par-
te que essas aplicaes so exigidas pelos
nossos usurios intranet ou extranet, mas
na prtica nem sempre temos a opo de
instalar algo local. Podemos ento comear
por conhecer algumas solues Java que
nos ajudam nessa tarefa.
Toolkits web
Existem situaes nas quais voc precisa
gerar interfaces sofisticadas, mas fica preso
ao browser, prefere no ter a interatividade
de uma aplicao local, ou simplesmente
no tem opo, por motivos fora do seu
muito comum encontrar sistemas nessa ses chamados toolkits so, na verdade,
situao centenas de pginas HTML que frameworks de desenvolvimento web
parecem mais descries do layout de uma que simulam, em uma aplicao baseada
janela do que documentos; milhares de li- no browser, um toolkit de janelamento
nhas de JavaScript, simulando funcionali- completo.
dades bsicas que encontramos em botes e Trabalhando, por trs, com servlets e JSPs,
campos de texto to comuns em aplicaes e com HTML e JavaScript pela frente, mas
locais; e em geral, uma grande confuso de forma componentizada e transparente
para juntar essas duas coisas. para o desenvolvedor, os toolkits web per-
Tudo isso quase sempre feito para criar mitem que voc desenvolva uma aplicao
uma aplicao local que no precisa ser web da mesma forma que desenvolve uma
instalada. E num esforo de criar uma local. Em vez de criar servlets e tratar cha-
aplicao-web-com-cara-de-local, esses madas e parmetros HTTP, permitem que
sistemas acabam num emaranhado de voc desenvolva aplicaes baseadas em
cdigo JavaScript difcil de manter, difcil eventos, como em aplicaes locais tpicas.
de componentizar e, em particular, quase Ao invs de codificar e devolver pginas
impossvel de portar para vrios browsers HTML cheias de cdigo JavaScript escri-
(s vezes, at para verses diferentes de to mo, voc cria janelas, botes, abas,
um mesmo browser). Procurando evitar a checkboxes, todos os componentes com
instalao local da aplicao, esses sistemas os quais voc est acostumado em uma
aplicao local.
o de uma nova verso do browser, sob Assim, o cdigo de aplicaes web fica
pena de excluir usurios. to similar a uma apli-
E o pior, nem ao menos cao tradicional que,
conseguem a interativi- Toolkits web permitem de- pelo menos no wingS
dade desejada! senvolver aplicaes web da (um desses toolkits),
Portanto se voc no mesma forma que locais, base- transform-las de local
tem como evitar fazer ando-se em eventos, como em para web uma questo
uma aplicao baseada aplicaes locais tpicas de trocar Js por Ss
no browser, pelo menos (trocar por exemplo um
no caia na armadilha de JButton do Swing por um
tentar simular uma aplicao local "na mar- SButton do WingS).
ra". Desenvolver uma aplicao baseada em Existem vrios desses toolkits, todos
servlets e JSP, mas com aparncia e interati- voltados para a criao de aplicaes com
vidade quase local, no uma tarefa fcil, aparncia, interao e modelo de desen-
especialmente porque voc precisa simular volvimento de aplicaes locais, mas para

10 Java Magazine Edio 6

jm6-book.indb 10 3/4/2003, 17:49:44


e sktop
b uio e instalao
serem executadas no ambiente web, sem
nenhum tipo de plugin ou instalao. No
so perfeitos para todos os tipos de aplica-
es e certamente no resolvem todos os
problemas citados (afinal, continuam no
sendo uma aplicao local, mas sim uma
aplicao web, rodando no servidor), mas
para quem no tem opo, pode ser uma
excelente opo!
Entre os mais sofisticados toolkits desse
tipo est o j citado wingS, que se posiciona
como Swing na web; segue exatamente a
mesma API do Swing (se voc um progra-
mador Swing, ir se surpreender ao se tor-
nar, do dia para a noite, um programador
web). A aplicao de demonstrao desse
toolkit, por exemplo, reproduz boa parte
das funcionalidades do demo do Swing.
Outro toolkit que vale a pena ser inves-
tigado o Millstone. Ele possui uma API
prpria e no segue o Swing, mas suas
funcionalidades so to impressionantes
quanto s do wingS. As customizaes
dos diversos componentes e a capacidade
de serem executados mesmo em browsers
sem suporte a JavaScript (com um certo
prejuzo em relao apresentao, mas uma interatividade maior? Voc pode for-
no s funcionalidades) fazem do Mills-
tone um toolkit a ser analisado se voc
precisa elevar a inteligncia do browser,
nosso terminal burro colorido.
Se voc precisa de uma aplicao com
mais cara de aplicao web mesmo, tal-
vez queira dar uma olhada no Tapestry,
um framework mais tradicional, voltado
para a gerao de HTML. Mas, em vez
voc ter que lidar com a integrao de
JavaScript com seus servlets, o Tapestry
fornece a noo de componentes que inte-
gram os lados servidor (servlets) e cliente
(HTML+JavaScript) em um componente
reutilizvel. Assim, ao invs de ficar se
debatendo para juntar as duas coisas
froa, como em um desenvolvimento de
jm6-book.indb 11
Tcnicas e ferramentas para
facilitar a disseminao
de Java no desktop
BRUNO SOUZA
servlets/JSP tradicional, voc usa apenas (onde as informaes do usurio no trafe-
um componente integrado. gam na rede, ou no so armazenadas fora
da mquina dele); desempenho (por mais
Distribuio de aplicaes rpida que seja a rede, sempre queremos
Toda essa histria de interatividade pode mais velocidade). E, certamente, olhando
parecer muito interessante no papel, mas suas aplicaes locais, voc vai encontrar
a realidade que de nada adianta ter uma outros motivos para us-las localmente ao
aplicao interativa se for necessrio voltar invs de mant-las rodando sempre no
ao passado e ficar instalando aplicaes servidor.
nas mquinas dos usurios. Relembrando, as aplicaes que precisam
Afinal, no foi para eliminar isso que a dessas funcionalidades so em geral para
web foi inventada? Bem, na verdade, no. o usurio intranet, aquele que usa a aplica-
A web foi inventada o sempre e quer algo
para disponibilizar melhor, mais rpido,
documentos, no apli- A web foi criada para dis- menos repetitivo, mais
caes. Se conseguimos ponibilizar documentos, no interativo, menos co-
chegar aonde estamos aplicaes. Se conseguimos nectado, mais seguro.
porque, como acontece chegar aonde estamos porque Se no o caso do sua
em muitos casos com foramos muito a barra aplicao, tudo bem.
a tecnologia, foramos Se for, mesmo com os
muito a barra. Mas, toolkits web que citei,
ainda assim, muitas aplicaes podem ser voc estar em maus lenis se tentar forar
encaradas como uma srie de documentos. uma aplicao com essas necessidades em
Essas aplicaes so parte importante do um ambiente web. E com certeza voc j
mundo web e funcionam muito bem. viu isso acontecer, seja como usurio, seja
Mas e no caso de aplicaes precisam de como desenvolvedor. Em geral, aquela
nova verso da aplicao que no tem
ar a barra (mas nesse caso, no reinvente a as funcionalidades nem as facilidades que
roda use um toolkit web como os citados). seu usurio contava na verso antiga.
Mas porque no fazer o que o usurio est Mas o fato de uma aplicao rodar local-
realmente pedindo e desenvolver uma mente, no significa que no possa tirar
aplicao local? proveito da rede! Se temos a rede, podemos
Alm de apresentar interatividade com o fazer o processo de instalao automtico;
usurio muito melhor, existem diversas ra- assim, seu usurio faz tudo integrado ao
zes para termos aplicaes locais mani- browser. Ser que isso tambm no um
pulao visual de elementos grficos (gr- tipo de aplicao web?
ficos, diagramas, imagens); processamento
distribudo (onde queremos que algumas Applets e Java Web Start
coisas no rodem no servidor); cache local Com o browser HotJava, a tecnologia Java
de informaes (para acelerar o acesso); uso introduziu, em 1995, a noo de aplicaes
desconectado da aplicao (nem sempre d carregadas automaticamente via rede: os
pra contar com a rede); replicao de infor- applets Java. Foi uma revoluo. Por causa
maes (tanto para velocidade, como para desse conceito, que hoje parece simples, a
diminuir a carga no servidor); segurana web ganhou uma nova expresso e a tecno-
Edio 6 Java Magazine 11
3/4/2003, 17:49:49
A Vida, o Universo e Tudo Mais

logia Java foi parar em todos os jornais. um futuro prximo. tem uma aplicao local que, a partir da
Muitos desenvolvedores Java de hoje O funcionamento do JWS simples e segunda execuo, inicializa imediata-
desconsideram applets como uma soluo afeta muito pouco o trabalho de desenvol- mente (sem download), completamente
vivel para a distribuio de aplicaes, vimento de uma aplicao. Basicamente, interativa, pode funcionar desconectada da
parte disso graas ao esforo que a Micro- uma aplicao gerenciada pelo JWS rede e tirar proveito de todas as vantagens
soft fez para destruir ao mesmo tempo Java automaticamente baixada e instalada lo- da execuo local.
e a Netscape. calmente, na primeira vez que o usurio a Se voc considerar o usurio intranet e o
A Justia norte-americana exps os deta- utiliza. Para instalar a aplicao, o usurio usurio extranet, que usam a aplicao dia-
lhes srdidos e declarou precisa apenas clicar em riamente, o JWS permite que voc fornea a
que essa tentativa foi um um link. A partir da, a aplicao com as funcionalidades que eles
No tente simular uma aplica-
esforo premeditado e aplicao fica em uma precisam: verdadeiramente multiplatafor-
ilegal. Se voc daque-
o local: fornea a aplicao espcie de cache local ma, independente da verso de browser e
les que ouviu dizer que local que seu usurio precisa, e no precisa mais ser livre de milhares de linhas de JavaScript
a Microsoft melhorou mas com as vantagens de uma baixada. A cada execu- (praticamente impossveis de manter). No
a mquina virtual Java, aplicao web o da aplicao, o JWS tente simular uma aplicao local, fornea
sugiro que leia o proces- verifica se necessrio a aplicao local que seu usurio precisa,
so para ver o que eles tentaram fazer com baixar uma nova verso e, caso positivo, mas com as vantagens de uma aplicao
a sua liberdade de escolha jogar no lixo, carrega apenas as diferenas entre a verso web.
como fizeram ao lanar o .NET e de que atual e a nova. Uma vez instalada localmen-
forma eles prejudicaram a JVM. Juntamente te, a aplicao pode ser executada a partir Instaladores
com o grande prejuzo causado aos usu- do browser, ou inicializada a partir de um A criao de instaladores outra pos-
rios em diversas reas, no que diz respeito cone no desktop do usurio, sem qualquer sibilidade para distribuir de aplicaes
a Java tivemos uma estagnao das JVMs dependncia do browser. Java e permitir seu uso em um ambiente
existentes nos browsers, o que afastou os O JWS tambm pode fazer uma atualiza- no necessariamente web. O mais conhe-
desenvolvedores dos applets, exatamente a o automtica da mquina virtual: se sua cido gerador de instaladores e votado o
tecnologia que causou uma das mais revo- aplicao solicitar uma verso especfica da melhor pela comunidade Java o Ins-
lucionrias mudanas de mentalidade no JVM que no esteja disponvel, ela au- tallAnywhere da ZeroG. Suporta vrios
desenvolvimento de aplicaes... tomaticamente baixada e instalada. Alm tipos de instalao e capaz de gerar
Por outro lado, outra parte da culpa recai disso, vrias verses da JVM podem co- instaladores nativos (.exe, .rpm etc.), auto-
sobre ns mesmos desenvolvedores Java, existir em uma mesma mquina. instalar a JVM e realizar a instalao dire-
que, como vimos, decidimos nos refugiar No Windows, se na primeira vez que ten- tamente da web, alm de suportar outras
na utilizao da interface web. Desde a tar executar a aplicao no for encontrado funcionalidades e configuraes teis na
verso 1.2 da tecnologia Java que temos o JWS ou no houver uma mquina virtu- distribuio de aplicaes Java.
primeiro com o Java Plugin e, mais al instalada, o download e a instalao de O InstallAnywere possui uma verso
recentemente, com o Java Web Start as ambos acontecer automaticamente, sem gratuita, o InstallAnywhere Now! , que
ferramentas que precisamos para distribuir a necessidade de interao do usurio. E suporta as funcionalidades bsicas de um
aplicaes Java para qualquer browser, o download da JVM pode ser feito a partir instalador e pode ser utilizada comercial-
mesmo as verses mais antigas. Conhe- de um servidor na sua mente. Com essa ver-
cendo e utilizando o que j temos h tanto prpria rede local, o que so, desenvolvedores
tempo, podemos nos libertar da priso do torna o JWS uma solu- Uma aplicao gerenciada pelo Java no tm desculpa
browser, e em grande estilo. o muito eficiente para Java Web Start automati- de no fornecer uma
O Java Web Start (JWS) uma soluo aplicaes internas. camente baixada e instalada aplicao local fcil
completa de distribuio, atualizao e O Java Web Start pos- localmente. Para fazer a insta- de instalar para seus
gerenciamento de aplicaes. Gratuito, faz sui outras caractersti- lao basta clicar em um link usurios.
parte do Java Runtime Environment (JRE) e cas que esto definidas A ZeroG oferece tam-
instalado automaticamente quando ins- na especificao do Java bm o PowerUpdate,
talada a plataforma Java (1.4.x em diante). Network Launching Protocol (JNLP), uma espcie de concorrente do Java Web
No caso do MacOS X e do Solaris, o JWS j que trata do download e da instalao de Start, que permite atualizar aplicaes
faz parte da instalao do prprio sistema aplicaes atravs da rede veja o quadro automaticamente pela internet. Apesar de
operacional, e pelo menos quatro distri- JNLP. possuir funcionalidades adicionais interes-
buies Linux incluem o JRE contendo o Portanto, utilizando o JWS voc passa a santes, como o registro do uso da aplicao
JWS. Por conta de uma deciso recente da ter as vantagens de uma aplicao web, com (para eventuais cobranas), o PowerUpdate
justia americana, que considerou a Micro- integrao com o browser e acesso via link no gratuito.
soft culpada de aes monopolistas contra no site, sem a necessidade de ter a aplicao
a tecnologia Java, at mesmo possvel que instalada localmente, e acessando a ltima O .NET morde?
o JWS passe a fazer parte do Windows, em verso disponvel. Ao mesmo tempo, voc Muito se tem falado da disputa entre o

12 Java Magazine Edio 6

jm6-book.indb 12 3/4/2003, 17:49:50

 J2EE e .NET, ultimamente. Apesar de ser
um assunto para outro artigo, no contexto
de aplicaes desktop, vale fazer algumas
consideraes. Para quem no lembra, o j
renomeado e mais uma vez adiado .NET
uma reao (ou inao?) da Microsoft, que
passou muito tempo negando a importn-
cia da tecnologia Java e dos servidores de
aplicao J2EE.
Como resposta ao que eles repetiram,
exausto, ser um modelo errado, lana-
ram no mercado um conjunto de tecnolo-
gias que so uma verdadeira rendio ao
modelo Java: existncia de uma mquina
virtual (mas para uma nica plataforma
escreva uma vez e rode s nela mesmo!),
linguagem semelhante a Java e, em par-
ticular, o modelo do servidor .NET, ab-
surdamente semelhante ao modelo J2EE
(semelhante, mas sem funcionalidades
importantes como integrao com outros
sistemas, session beans ou persistncia au-
tomtica). E tudo isso, sendo uma tecnolo-
gia proprietria sobre a qual, s eles (e logo
eles!) tm controle. Em suma, um daqueles
casos patolgicos da indstria onde uma
empresa prope que agora mudamos de
idia, televiso de fato divertida, mas a
nossa preto-e-branco e sem som muito
melhor que a colorida!. Com o histrico
de instabilidade dos ambientes Windows,
a melhor definio que vi at agora do .NET
foi write once, crash everywhere...
Apesar disso, para os desenvolvedores
JNLP
O Java Network Launching Protocol,
definido pela JSR-56, a especifica-
o que permite a mgica do Java Web
Start (JWS). A especificao define como
integrar esse protocolo a um servidor web,
como o cliente deve acessar a informao,
o formato dos arquivos, enfim, tudo o que
necessrio para se criar instaladores em
Java que suportem a atualizao dinmica
de aplicaes. Algumas das funcionalidades
interessantes do JNLP incluem:
Empacotamento padro para aplica-
es, incluindo informaes sobre a apli-
cao, fornecedor, pgina web e cone da
aplicao;
Suporte a recursos externos: bibliotecas
Java, bibliotecas nativas e propriedades
jm6-book.indb 13
Java, importante sair do casulo. No se
iludam. Apesar das bvias deficincias,
.NET tem um ponto a seu favor: a Micro-
soft conhece o cliente e sabe que interfa-
ces meramente web no bastam. Espere
ver no futuro prximo a concorrncia de
aplicaes interativas, baseadas em clientes
Windows e que, por isso mesmo, sero mais
atraentes do que as vitaminadas mas j
no to poderosas interfaces web. O risco
para a nossa liberdade de escolha no o
.NET monopolizar o servidor, mas sim vir
a expandir o monoplio do cliente.
E a verdade que, h muito tempo, Java
possui as tecnologias para tirarmos pro-
veito das interfaces sofisticadas no cliente,
tecnologias muito mais sofisticadas do que
as que o ambiente Microsoft proporciona.
Precisamos apenas conhec-las e comear
a utiliz-las, e as tecnologias apresentadas
neste artigo j indicam o caminho.
Java no backend, sempre!
De tudo que falamos nas duas partes des-
se artigo, fica claro que fundamental que
a sua arquitetura seja capaz de suportar
diferentes tipos de interfaces. Aplicaes
locais em desktops, MIDlets em celulares
e PDAs, interfaces web para clientes no
browser... voc vai precisar delas. Para
isso, a tecnologia Java oferece o suporte no
backend para voc definir e implementar
sistemas que possibilitam suportar diferen-
tes interfaces com o usurio.
itens que estaro disponveis para a exe-
cuo da aplicao, e podem ser baixados
parte;
Suporte para carregamento imediato,
ou somente quando for necessrio, tanto
da aplicao como de bibliotecas exter-
nas, permitindo com que a aplicao seja
carregada aos poucos, e somente as partes
necessrias;
Carregamento de bibliotecas e arquivos
.jar especficos de plataforma, permitindo
que s sejam carregadas as bibliotecas
nativas referentes ao sistema operacional
do usurio;
Versionamento da aplicao e de biblio-
tecas: a aplicao pode ser atualizada para
as verses necessrias, evitando downloads
A separao bem definida que temos no
mundo do J2EE, entre lgica de negcios
e lgica de apresentao, existe com esse
objetivo. Esse o principal ganho dos En-
terprise JavaBeans.
Outras tecnologias Java tambm do su-
porte no backend para diferentes tipos de
interao com o usurio. o caso da tecno-
logia Jini e seu sensacional ServiceUI, que
permite a criao de sistemas camalees,
capazes de fornecer diferentes interfaces
para o mesmo servio, de acordo com
as necessidades e a forma de acesso do
usurio.
Ao contrrio de outros ambientes, em
particular o .NET, que procura transfor-
mar tudo em web services na verdade
engessando seu desenvolvimento , a
tecnologia Java no se limita a um nico
modelo; pode ser utilizada de diferentes
formas. J2EE, Jini, JavaSpaces, P2P, JXTA
e Grid Computing so algumas que j
citamos nesta coluna, e que suportam o
desenvolvimento dos servios que sero
acessados por seus usurios, no impor-
tando o tipo de interao que exijam. Ou-
tros modelos existem como, por exemplo,
o uso de JavaSpeech, JMX, ou mesmo web
services? A tecnologia Java muito mais do
que apenas servidores web turbinados.
Como o suporte a mltiplos tipos de inter-
faces fundamental, dentro da tecnologia
Java a especificao J2EE Client Provisio-
ning (JSR-124), que trata exatamente de for-
de verses que j estejam presentes;
JARDiff: comparao das verses e carre-
gamento de apenas o que for preciso para
completar o .jar da nova verso, diminuindo
drasticamente o tamanho da atualizao;
Suporte ao carregamento e instalao
de JVMs diferentes;
Interao com o ambiente nativo, in-
cluindo manipulao de arquivos, uso do
clipboard e da persistncia local de dados,
mesmo para aplicaes no assinadas;
Segurana: assinatura de aplicaes, do-
wnload seguro, ambiente controlado para
execuo de aplicaes no-assinadas.
O Java Web Start uma implementao
do JNLP; portanto, suporta todas essas
caractersticas.
Edio 6 Java Magazine 13
3/4/2003, 17:49:51
A Vida, o Universo e Tudo Mais
necer clientes diferentes para uma mesma
aplicao de servidor. Com essa especifica-
o que j est disponvel e possui uma
implementao de referncia voc pode
disponibilizar o mesmo backend para v-
rias aplicaes clientes, e o seu servidor de
aplicaes ir escolher a interface adequa-
da, dependendo da forma que seu usurio
acessa a aplicao. O usurio recebe uma
aplicao local atravs do Java Web Start se
estiver utilizando um ambiente de desktop,
ou uma aplicao MIDP se estiver em um
celular, ou ainda uma interface web se esti-
ver em um browser. Alm disso, possvel
programar e expandir seu servidor para
suportar outros tipos de interfaces.
Assim, a tecnologia Java mais uma vez
est anos luz na frente, porque, em vez de
tentar forar o que algum acha melhor
para voc, fornece o suporte e as tecnolo-
gias adequadas para voc escolher o que
precisa.
E agora?
Nossas equipes de marketing dizem que
querem aplicaes web, mas esto apenas
repetindo o que ouviram falar ou leram em
jornais. Mas cabe a ns desenvolvedores,
14 Java Magazine Edio 6
jm6-book.indb 14
consultores, gerentes tcnicos e diretores
de tecnologia o entendimento do que
possvel fazer, alm da capacidade de que gratuito, e colocar Java em todos os
mostrar o melhor caminho.
E, se para isso necessrio fazer um do-
wnload de alguns megabytes da mquina
virtual, uma nica vez, dentro de nossas
redes internas, vamos fazer! Na verdade,
que tal j aproveitar e levar a JVM em um
CD e instalar em todos os lugares que voc
java.sun.com/products/javawebstart
Java Web Start e JNLP
java.sun.com/j2ee/provisioning
J2EE Client Provisioning
wings.mercatis.de
WingS
millstone.org
Millstone
tapestry.sourceforge.net
Tapestry
www.zerog.com
ZeroG
www.jgoodies.com
Exemplos de aplicaes Swing
for? J que j ganhamos a fama de ser o
pas da pirataria, vamos piratear algo
lugares.
Como desenvolvedores Java, temos
condies de dar aos nossos usurios as
aplicaes que eles precisam. No existe
problema nenhum em disponibilizar uma
aplicao web para os usurios espordicos;
apenas no fuja de fornecer uma aplicao
sofisticada para o seu usurio intranet. Ou
ele quem vai fugir de voc!
Bruno F. Souza, o JavaMan (bruno.souza@javaman.
com.br), veterano da tecnologia Java e um dos
lderes do movimento Java no Brasil. fundador da
Sociedade de Usurios Java (SouJava) e membro do Java
Community Process.
3/4/2003, 17:49:52
 Edio 6 Java Magazine 15

jm6-book.indb 15 3/4/2003, 17:50:06

 Java Livre

Tomcat fu
Arquitetura, instalao e

porado a um nmero crescente de Fornece suporte execuo de pginas

servidores de aplicaes e IDEs Java
e continua sendo a implementao
oficial das mais novas especificaes
para aplicaes Java para web.
O Tomcat j nasceu na verso 3.0, trazen-
do novidades como o formato de pacote
WAR (Web Application Archive). Desde a
JSP, gerando e compilando o servlet cor-
respondente a cada pgina. Algumas IDEs
chegam a executar o Jasper em separado do
Tomcat para facilitar a depurao e execu-
o passo a passo de pginas JSP.
Conectores os conectores facilitam a
integrao do Catalina com outros servido-

A
Apache Foundation foi formada
em torno da comunidade de
desenvolvedores e usurios do
Apache, o servidor web mais popular da
internet (tanto acadmica como comercial)
e se tornou um guarda-chuva para dezenas
de projetos de software livre relacionados
com contedo web, em especial os rela-
cionados com gerao de sites dinmicos
a partir de lgica de negcios hospedada
no servidor.
Talvez o mais bem-sucedido desses
projetos seja o Jakarta, voltado para tec-
nologias Java no servidor. O Jakarta foi
iniciado quando o Java ainda estava em
sua infncia, por isso esse projeto precisou
desenvolver uma srie de tecnologias de
infra-estrutura cuja aplicao vai alm de
aplicaes web, como o Ant (apresentado
na Edio 2).
O Tomcat nasceu quando a Sun decidiu
doar ao projeto Jakarta, e Apache Foun-
dation, o cdigo (inacabado) da implemen-
tao de referncia da especificao 2.1 de
servlets e 1.1 de JavaServer Pages (JSP). Esse
foi um movimento sbio da empresa: em
vez de prosseguir no desenvolvimento de
uma implementao de referncia capen-
ga para uma API crucial ao sucesso da
plataforma Java, colaborar com a comuni-
dade de usurios e desenvolvedores para
construir uma implementao robusta,
pronta para produo e liberada como
software livre. Assim toda a comunidade
pde se beneficiar.
Desde ento, o Tomcat vem sendo incor-
verso 4.0, o Tomcat implementa no s as res web ou servidores de aplicao J2EE. O
especificaes de servlets conector HTTP (Coyote)
e JSP, mas tambm todas escrito inteiramente em
as exigncias para con- Java e parte da distri-
O Tomcat nasceu quando a
tainers web definidas nas buio do Tomcat. Este
Sun doou Apache Founda-
especificaes do J2EE. conector efetivamente
Futuros requisitos dessas
tion o cdigo inacabado da transforma o Tomcat em
especificaes costumam implementao de refern- um servidor web e pode
ser implementadas ante- cia de servlets 2.1 e JSP 1.1 ser configurado para
cipadamente no Tomcat, suportar outros recur-
tais como o suporte a JMX sos de um servidor web
(que s ser obrigatrio nas especificaes padro, como a execuo de programas
de servlets 2.4 e J2EE 1.4). CGI e interpretao de SSI (Server-Side In-
cludes). Outros conectores, como o mod_jk
Arquitetura do Tomcat e mod_jk2, devem ser instalados separa-
Nosso foco neste artigo o Tomcat 4.x, a damente e permitem integrar o Tomcat aos
atual srie estvel. A verso 4.x possui trs servidores Apache, IIS e Netscape/iPlanet.
componentes principais: Mais adiante, veremos em que situaes
Catalina a segunda gerao de con- esta integrao desejvel.
tainer web fornecida pelo Tomcat, que deu O Tomcat tambm utiliza vrios outros
origem srie 4.x e continua evoluindo no pacotes desenvolvidos pelo projeto Jakarta
5.x. Sua funo gerenciar o ciclo de vida e pela Apache Foundation, como o Xerces,
dos servlets, decidindo quando gerar no- para o processamento dos arquivos de
vas instncias ou quando descart-las para configurao em XML.
poupar memria. O Catalina tambm o
responsvel por mapear URLs para servlets Tomcat x servidores web
e por devolver o documento gerado (em Muitos desenvolvedores e administra-
geral uma pgina HTML) para o navega- dores de rede perguntam: necessrio
dor. Note, entretanto, que o Catalina no configurar um servidor web para rodar o
interage diretamente com o navegador ou Tomcat?. A resposta inicialmente no,
com o servidor web que requisita a URL; pois o Tomcat capaz de fornecer pginas
em vez disso, deve ser configurado um HTML estticas e outros tipos de documen-
conector para realizar esta interao. tos, como imagens PNG e JPEG ou vdeos,
Jasper um servlet padro que pode desde que eles sejam empacotados no
ser instalado em qualquer container web formato WAR.
aderente especificao 2.2 de servlets. Por outro lado, o Tomcat otimizado

16 Java Magazine Edio 6

jm6-book.indb 16 3/4/2003, 17:50:15


ndamental
e configurao
apenas para lidar com os componentes
Java, e suas capacidades como servidor
web so limitadas. Ele no suporta outras
linguagens de servidor (PHP, Zope, ASP,
Cold Fusion etc.), e no fornece esquemas
elaborados de cache de contedo ou ou-
tros recursos presentes em servidores web
topo-de-linha como o Apache. Tambm
tem desempenho inferior maioria dos
outros servidores web do mercado no for-
necimento de contedo esttico (imagens
e pginas HTML).
Por isso comum configurar o Tomcat
como subordinado a um servidor web na-
tivo (seja hospedado no mesmo host ou em
um n separado da rede), mas possvel
configurar um ambiente de desenvolvi-
mento perfeitamente funcional utilizando
apenas o Tomcat, sem a necessidade de
qualquer software adicional.
Outra situao onde interessante in-
tegrar um servidor web ao Tomcat na
construo de uma fazenda de servido-
res (server farm) para atender a um nico
conjunto de aplicaes web, ganhando em
escalabilidade. Alguns conectores do Tom-
cat, como o mod_jk e sua verso aprimorada
mod_jk2 permitem utilizar o Apache e ou-
tros servidores web como balanceadores de
carga, com suporte a recursos avanados
como session affinity, mas sem recursos
robustos de tolerncia a falhas.
Tomcat x servidores J2EE
H duas situaes onde o Tomcat sozinho
no ser suficiente, mas ser necessrio uti-
lizar um servidor J2EE completo:
Suporte a EJBs ou JMS
Necessidade de clusters com tolerncia
a falhas
Muitas empresas desenvolveram o hbito
pouco recomendado de adquirir e configu-
rar servidores J2EE completos apenas para
hospedar aplicaes web simples, que no
jm6-book.indb 17
Aprenda o essencial sobre
o container web mais
usado no mercado
FERNANDO LOZANO
fazem uso de EJBs e que no necessitam, ou sesses HTTP hospedadas neste servidor
no utilizam de modo adequado, os recur- sero perdidas, gerando efeitos como a per-
sos de clustering destes servidores. da de cestas de compras em sites de comr-
A srie 4.1.x do Tomcat suporta todas as cio eletrnico, enquanto que um servidor
caractersticas previstas para containers J2EE completo ser capaz de replicar estas
web J2EE, como um pool de conexes JDBC sesses em memria, evitando a perda de
e a localizao de recursos via JNDI (Java informaes das sesses dos visitantes.
Naming and Directory Interface), de modo possvel configurar o Tomcat para ar-
que no h necessidade de um servidor mazenar as informaes de sesses HTTP
de aplicaes J2EE completo para desen- em um banco de dados relacional e utilizar
volver aplicaes web avanadas. Mesmo os recursos deste banco para tolerncia a
que seja necessrio interagir com servios falhas, mas o overhead desta soluo
fornecidos por EJBs, basta incluir as classes excessivo, comprometendo o desempenho
de cliente do seu servidor de aplicaes no das aplicaes. Por isso a maioria dos servi-
diretrio WEB-INF/lib do pacote WAR en- dores J2EE opta pela replicao das sesses
tregue para deployment no Tomcat. diretamente entre os containers web.
Separar aplicaes web no Tomcat dos Podemos, por exemplo, configurar um
EJBs em outro servidor de aplicaes pode servidor JBoss sem os servios de EJB e
ter vrias vantagens com relao distri- JMS, de modo a rodar apenas o Tomcat
buio de carga e economia de licenas. incluso em sua distribuio junto com e
Provavelmente o Tomcat ser mais rpido os servios de suporte a clustering. Assim
do que seu servidor de aplicaes para ro- obtemos as vantagens de um ambiente
dar servlets e pginas JSP, devido ao me- mais leve e baseado em software livre,
nor overhead, mesmo porque muitos dos sem abrir mo da tolerncia a falhas.
servidores J2EE comerciais
utilizam o prprio Tomcat Tomcat e especificaes
como container web.
Alguns servidores J2EE
agregam ao Tomcat um re- H duas verses atualmente suportadas do Tomcat
(sries 3 e 4), alm da srie 5 ainda em desen-
volvimento. Todas elas continuam sendo ativamente
curso que no est presente
nele isoladamente: o suporte suportadas (incluindo correes de bugs e melhorias
a clustering com tolerncia de desempenho), pois aplicaes em produo podem
a falhas. Como vimos na exigir verses diferentes das especificaes, que nem
comparao com servidores sempre so compatveis retroativamente.
web, a natureza sem-estado A tabela abaixo indica a correspondncia entre as
(stateless) do protocolo HTTP verses do Tomcat, de servlets e de JSP:
torna possvel atender a
muitas aplicaes web uti- Srie/Verso do Tomcat Verso de servlets/JSP
lizando apenas servidores
3.x (3.3.1) 2.2/1.1
Tomcat espelho, que no
interagem entre si, bastando 4.0.x (4.0.6) 2.3/1.2 ou 2.2/1.1
acrescentar um balanceador 4.1.x (4.1.18) 2.3/1.2
de carga. Caso um dos ns do 5.x (5.0.0 Alpha) 2.4/2.0
Tomcat fique indisponvel, as
Edio 6 Java Magazine 17
3/4/2003, 17:50:21
Java Livre
Figura 1. Mensagens de inicializao do Tomcat
Figura 2. Pgina inicial do Tomcat 4
Distribuies
Na pgina de download do projeto
Jakarta, encontramos, para cada verso
recente do Tomcat, duas distribuies:
tomcat- <verso>.zip e tomcat- <verso> -
LE.zip (os pacotes *.exe e *.tar.gz so apenas
convenincia para usurios de plataformas
Windows e Unix todos contm os mesmos
bytecodes Java do Tomcat).
A verso LE exige o J2SDK 1.4.0 ou supe-
rior, pois no inclui as classes relacionadas
com XML (ausentes em verses anteriores
do Java 2). Tambm no inclui os recursos
voltados para J2EE, como servio de no-
mes JNDI. Por isso um download menor
e fornece um ambiente mais leve para os
interessados apenas em desenvolver e
hospedar aplicaes web independentes,
no estilo pr-J2EE. Note, no entanto, que
isto no significa abrir mo de bibliotecas
de tags e outros recursos avanados das
especificaes mais recentes de servlets
e JSP.
A verso no-LE a distribuio com- renomear para algo mais
pleta do Tomcat e inclui todos os pacotes
necessrios, mesmo que oriundos de ou-
tros projetos da Apache Foundation. Exige
apenas o J2SDK 1.2.2 ou superior e oferece
todos os recursos especificados para con-
tainers web J2EE.
18 Java Magazine Edio 6
jm6-book.indb 18
Note que no suficien-
te fornecer um JRE para
a execuo do Tomcat.
Como pginas JSP so
transformadas em servlets
e compiladas durante o de-
ployment, necessrio que
o Jasper tenha acesso a um
compilador Java. Portanto
no esquea de configurar
seu classpath para incluir o
pacote tools.jar do J2SDK.
Tanto as verses forne-
cidas pela Sun quanto os
portes da IBM (superiores
em vrios benchmarks) so
suportados.
Podemos ainda utilizar
o Tomcat compilado para
cdigo nativo com o GCJ. O
projeto RHUG da Red Hat
fornece binrios pr-compi-
lados para Linux e scripts
de compilao no padro
GNU autoconf para outros
sistemas Unix. Alguns usu-
rios tambm reportam sucesso com as
verses pr-release do GCJ para Windows
disponibilizados pelo projeto MingW. Ser
interessante observar o impacto da compi-
lao no desempenho e na confiabilidade
das aplicaes web em Java.
Instalao e diretrios
Vamos examinar apenas a instalao
do Tomcat 4.1.18 no-LE utilizando o
Java2 SDK 1.4.1. Outras verses do Java ou
do Tomcat seguiro passos similares. Na
verdade no h muito a fazer. Desde que
o seu ambiente de desenvolvimento Java
esteja configurado corretamente (variveis
java_home e classpath), basta
descompactar a distribui-
o, tomando o cuidado de
preservar a sua estrutura de
diretrios.
O resultado a criao
do diretrio jakarta-tomcat-
<verso>, que voc pode
simples como tomcat4. Ele
possui os seguintes subdi-
retrios:
bin contm scripts para o
incio e o trmino do servi-
dor ou para a invocao de Figura 3. ndice da documentao do Tomcat
alguns componentes isoladamente, como
o Jasper;
common classes utilizadas pelo Tom-
cat e disponibilizadas tambm para as
aplicaes web hospedadas por ele, como
o parser XML Xerces;
conf arquivos de configurao do Tom-
cat. Em geral no h necessidade de modifi-
c-los para iniciar o desenvolvimento, mas
deve ser feito um ajuste fino em ambientes
de produo, especialmente com relao
segurana;
jasper classes que compem o Jasper
(compilador de JSP);
logs arquivos de log do Tomcat. onde
devemos buscar informaes quando algo
sai errado;
server classes que compem o Catalina,
o container web em si, alm das aplicaes
de administrao do servidor;
shared diretrio inicialmente vazio
onde devem ser instaladas classes a serem
disponibilizadas para todas as aplicaes
web, como drivers JDBC e bibliotecas de
tags;
webapps diretrio padro para o de-
ployment de aplicaes web. Inclui uma s-
rie de aplicaes de exemplo, mas note que
algumas podem no funcionar de primeira,
pois dependem de configurao prvia de
fontes de dados JDBC ou de acesso a EJBs
em outros servidores, no fornecidos pelo
Tomcat. Tambm neste subdiretrio est a
documentao do Tomcat;
work diretrio utilizado pelo Tomcat
como rea de trabalho (por exemplo, para
armazenar servlets gerados pela compila-
o de uma pgina JSP);
temp diretrio temporrio para a JVM
(propriedade java.io.tmpdir).
3/4/2003, 17:50:22

Listagem 1. Arquivo conf/tomcat-users.xml para permitir o acesso a aplicaes de
administrao (modificaes em negrito)
<?xml version=1.0 encoding=utf-8?>
<tomcat-users>
<role rolename=tomcat/>
<role rolename=role1/>
<role rolename=manager/>
<user username=tomcat password=tomcat
roles=tomcat/>
<user username=role1 password=tomcat
roles=role1/>
<user username=both password=tomcat
roles=tomcat,role1/>
<user username=admin password=secreta
roles=manager,admin/>
</tomcat-users>
Operao bsica especificaes de servlets e JSP para sanar
Para iniciar o Tomcat, basta executar o eventuais dvidas.
script startup.sh (ou startup.bat) presente
no diretrio bin. Em ambiente Windows,
so abertas duas janelas de comandos, uma
para a execuo do script (batch) em si e ou-
tra para a execuo da JVM que hospeda o
Tomcat. A primeira janela pode ser fechada
imediatamente, mas a segunda janela no,
pois isto provocar o trmino imediato do
Tomcat e poder segurar conexes e locks
em servidores de banco de dados. A forma
recomendada de se encerrar uma instncia
do Tomcat rodar o script shutdown.sh (ou
shutdown.bat) tambm presente no diret-
rio bin.
A configurao padro do Tomcat inicia
dois conectores: o conector HTTP (Coyote)
na porta 8080 e o conector mod_jk na porta
8009, como podemos ver pelas mensagens
de inicializao do servidor (Figura 1).
Apenas o conector HTTP necessrio para
desenvolvimento; o conector mod_jk pode
ser desabilitando pela edio do arquivo
conf/server.xml como veremos adiante. Te-
nha certeza de que nenhum outro servio
esteja utilizando a porta 8080 (ou desabilite
o servio em conflito, se houver). Alm dis-
so, o Tomcat aceita na porta 8005 comandos
administrativos como shutdown, portanto
tenha certeza de que esta porta tambm
esteja livre e desbloqueada no firewall
interno do seu servidor.
Para testar o funcionamento do Tom-
cat basta abrir, em qualquer navegador,
a URL http://127.0.0.1:8080/ para ver a
pgina inicial padro do Tomcat (Figura
2). Observe no canto superior esquerdo os
links Tomcat Administration e Tomcat
Manager, seguidos pelo link Tomcat Do-
cumentation. A documentao em formato
HTML fornecida com o Tomcat bastante
jm6-book.indb 19
abrangente e completa
(Figura 3), com refe-
rncias e how-tos para
praticamente todos os
aspectos da adminis-
trao do servidor ou
do desenvolvimento
de aplicaes, incluin-
do javadocs para as
APIs de servlets e JSP.
Apesar da qualidade
da documentao for-
necida, recomendo que
voc tenha em mos as
Administrao remota
A configurao padro do Tomcat no
permite o acesso s aplicaes de adminis-
trao, como forma de prevenir eventuais
brechas de segurana em servidores aces-
sveis pela internet. Voc ter que editar o no capaz de instalar novas aplicaes.
arquivo conf/tomcat-users.xml, que fornece
o mapeamento padro de usurios e roles
(para mais detalhes sobre esse tema, veja o
artigo sobre segurana em aplicaes web
na Edio 4). Deve haver um usurio com
o role manager para a aplicao Manager
ou admin para a aplicao Admin. Por
exemplo, a Listagem 1 defi ne o usurio
admin com senha secreta.
Vamos iniciar pelo Tomcat Manager.
Podemos seguir o link na pgina inicial
ou ento utilizar a URL http://127.0.0.1:
8080/manager/html (veja a Figura 4). Esta
aplicao permite instalar, remover, pa-
rar, (re)iniciar ou recarregar aplicaes
web hospedadas pelo Tomcat. Fornece
uma API simples, baseada em requisies
HTTP, para que o administrador crie o
seu prprio front-end para a
administrao do servidor.
A mesma API disponibili-
zada tambm como tarefas
(tasks) do Ant, de modo que
um build file possa atualizar
aplicaes web no Tomcat
sem interveno manual.
O Tomcat no capaz de
recarregar aplicaes web a
partir de um pacote WAR. A
aplicao deve ser removida
e reinstalada. Entretanto, se a
aplicao for instalada como
um subdiretrio de webapps, Figura 4. Tomcat Manager
podemos recarreg-la a partir do Manager
e ento evitar a necessidade de reiniciar o
servidor.
J o Tomcat Admin (Figura 5) um front-
end para a edio dos arquivos de configu-
rao do Tomcat e mesmo dos descritores
de deployment das aplicaes web hospe-
dadas. Ele baseado no framework Struts
(veja artigo nesta edio) e permite modi-
ficar on-the-fly as configuraes do Tomcat,
por exemplo definindo novos usurios, sem
necessidade de reiniciar o Tomcat. Pode-
mos acessar a aplicao Admin pelo link
na pgina inicial do servidor ou pela URL
http://127.0.0.1:8080/admin.
As duas aplicaes, Admin e Manager,
apesar de bem diferentes na sua constru-
o, so complementares: o Manager per-
mite adicionar ou remover aplicaes web
do servidor, enquanto que o Admin mo-
difica parmetros de operao do prprio
servidor e das aplicaes hospedadas, mas
Configurao
O principal arquivo de configurao do
Tomcat conf/server.xml. Ele defi ne uma
hierarquia encabeada pelo elemento ser-
vidor (server), que representa a JVM onde
o Tomcat executado.
Cada servidor contm um ou mais servi-
os (service) que so conjuntos de conec-
tores (connector) associados ao mesmo
container web (engine). Cada container
pode por sua vez conter um ou mais hosts
(host, para suporte a domnios virtuais
web), que, por sua vez, hospedam um ou
mais contextos (context). Cada contexto
associa uma URL a uma aplicao web,
mas no necessrio definir contextos
para todas as aplicaes, pois o atributo
Edio 6 Java Magazine 19
3/4/2003, 17:50:24
Java Livre

arquivo conf/web.xml, que fornece valores

Listagem 2. Pgina JSP: index.jsp
padro para as entradas no especificadas
<%@ page import=java.util.Date,java.text.DateFormat %> no arquivo WEB-INF/web.xml das apli-
<html><body>
<h1>Aplicao Web mnima<hr></h1> caes hospedadas. A especificao de
<P>Hoje dia servlets determina que servlets annimos
<%= DateFormat.getDateInstance().format(new Date ()) %>
<P>Tambm temos uma verso (aqueles para os quais no foi definido um
<a href=servlet/Hello>Servelt</a> desta mesma pgina. mapeamento de URL) sejam acessveis pela
<hr><center>
Leia <a href=http://www.javamagazine.com.br>Java Magazine</a> URL /servlet/<nomeCompletoDaClasse>.
</center> O Tomcat fornece um servlet chamado
</body></html>
Invoker que implementa esse compor-
Listagem 3. Servlet: Hello.java tamento, mas ele est desabilitado na
configurao padro. Por isso modifico
import javax.servlet.*;
import javax.servlet.http.*; a configurao de modo a fornecer um
import java.io.*; mapeamento padro para o Invoker, des-
import java.util.Date; comentando a entrada abaixo no arquivo
import java.text.DateFormat; conf/web.xml:
public class Hello extends HttpServlet {
public void doGet (HttpServletRequest req, <!-- The mapping for the invoker servlet -->
HttpServletResponse res) <servlet-mapping>
throws IOException, ServletException { <servlet-name>invoker</servlet-name>
res.setContentType (text/html);
PrintWriter pw = new PrintWriter (res.getOutputStream());
<url-pattern>/servlet/*</url-pattern>
pw.println(<HTML>); </servlet-mapping>
pw.println(<BODY>);
pw.println(<H1>Servlet Mnimo<HR></H1>);
pw.println(<P>Hoje dia + Aplicaes web para o Tomcat
DateFormat.getDateInstance().format(new Date ()));
pw.println(<P>Tambm temos uma verso ); Como o Tomcat a implementao de
pw.println(<A href=\../index.jsp\>JSP</A> desta mesma pgina); referncia das especificaes de servlets
pw.println(</BODY>);
pw.println(</HTML>); e JSP, no h nada especfico para ele no
pw.flush(); desenvolvimento de aplicaes web em
pw.close();
} Java. Tambm no necessrio baixar
} nenhum pacote ou SDK externo (como o
Listagem 4. Descritor de deployment web.xml J2EE SDK), pois o Tomcat fornece todas as
APIs necessrias.
<?xml version=1.0 encoding=ISO-8859-1?> Em princpio, tudo o que devemos fa-
<!DOCTYPE web-app
PUBLIC -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN zer para compilar servlets adicionar o
http://java.sun.com/dtd/web-app_2_3.dtd> pacote common/lib/servlet.jar ao classpath.
<web-app>
<display-name>Hello</display-name> Caso sejam utilizados recursos adicio-
<description>Exemplo de aplicao web mnima</description> nais previstos no J2EE, deve-se adicionar
</web-app>
tambm os respectivos pacotes fornecidos
no mesmo diretrio, como mail.jar para o
appBase do element host determina um Pessoalmente, costumo fazer
diretrio no qual qualquer arquivo WAR ou duas modificaes na configura-
diretrio seguindo a mesma estrutura ser o padro do Tomcat para um
automaticamente ativado e associado a um ambiente de desenvolvimento. A
contexto criado dinamicamente. Este dire- primeira envolve o elemento host
trio webapps na configurao padro. no arquivo conf/server.xml, modifi-
Em cada nvel da hierarquia server/ cando o atributo unpackWARs de
service/engine/host/context podemos true para false. Se for mantido
definir recursos JNDI (resource e environ- o valor padro true, a atualizao
ment), configuraes de logging (logger), de pacotes WAR no surtir efeito,
restries de autenticao (realm) e filtros pois o Tomcat ir sempre utilizar a
de contedo baseados em IP ou em outros verso descompactada durante a
critrios (valve). primeira instalao.
Tendo em mente a hierarquia de elemen-
<Host name=localhost debug=0
tos configurados pelo Tomcat, torna-se
appBase=webapps unpackWARs=false
fcil especificar configuraes de rede ou autoDeploy=true>
de segurana do servidor, com auxlio da
documentao de referncia fornecida. A segunda modificao no Figura 5. Tomcat Admin, baseado no Struts

20 Java Magazine Edio 6

jm6-book.indb 20 3/4/2003, 17:50:25


Figura 6. Pgina JSP da aplicao mnima
Figura 7. Aplicao mnima reconhecida pelo Tomcat Admin
JavaMail e activation.jar para o Java Activa-
tion Framework (JAF). Alguns pacotes esto
presentes apenas para uso por IDEs, como
jasper-compiler.jar.
H trs formas de realizar o deployment
de uma aplicao web no Tomcat:
Copiar um pacote WAR para o diretrio
webapps;
Criar um subdiretrio em webapps se-
guindo a mesma estrutura de um pacote
WAR;
Utilizar o Tomcat Manager
Nas duas primeiras opes, o Tomcat
dever ser reiniciado (embora na segunda
possamos recarregar a aplicao pelo Ma-
nager). A aplicao ser associada ao con-
texto cujo nome o nome do pacote WAR
sem a extenso ou o nome do diretrio. As-
sim o diretrio webapps/examples est asso-
ciado URL http://127.0.0.1:8080/examples
e o pacote webapps/app.war ser associado
URL http://127.0.0.1:8080/app.
Exemplo de aplicao
Para encerrar o artigo, vamos criar uma
aplicao web mnima com o Tomcat,
exemplificando tanto servlets como p-
jm6-book.indb 21
ginas JSP. Crie em um diretrio
qualquer o subdiretrio hello, que
ser a raiz da aplicao web. Crie
tambm abaixo dele o subdiretrio
WEB-INF/classes para hospedar as
classes de servlets.
Crie os arquivos hello/index.jsp,
hello/WEB-INF/classes/Hello.java e
hello/WEB-INF/web.xml conforme
as Listagens 2, 3 e 4. Compile
a classe Hello.java (note que ela
est no pacote default, portanto
no h necessidade de ajustes no
classpath desde que este contenha
o ., que representa o diretrio
atual) e monte um pacote WAR
com o comando a seguir, execu-
tado de dentro do diretrio hello:
jar cvf ../hello.war *
(Lembre-se de trocar a barra de
diviso pela barra invertida em
sistemas Windows).
Copie o arquivo hello.war gerado
por esse comando para o subdi-
retrio webapps do Tomcat e rei-
nicie o servidor. Teste a aplicao
visitando a URL http://127.0.0.1:
8080/hello para obter uma pgina
semelhante exibida na Figura 6.
Se algo der errado, confirme que o Tom-
cat reconheceu a aplicao visitando as
aplicaes Manager ou Admin (Figura 7).
Verifique nos arquivos de log do Tomcat
no subdiretrio logs alguma indicao da
causa do problema e confira a estrutura
do seu pacote WAR com o comando jar
a estrutura deve estar de acordo com a
seguinte listagem:
$ jar tvf hello.war
0 Sun Mar 09 22:04:58 BRT 2003 META-INF/
71 Sun Mar 09 22:04:58 BRT 2003 META-INF/MANIFEST.MF
384 Sun Mar 09 21:47:44 BRT 2003 index.jsp
0 Sun Mar 09 17:51:46 BRT 2003 WEB-INF/
330 Sun Mar 09 17:53:30 BRT 2003 WEB-INF/web.xml
0 Sun Mar 09 17:51:46 BRT 2003 WEB-INF/classes/
1016 Sun Mar 09 17:54:50 BRT 2003 WEB-INF/classes/Hello.java
1371 Sun Mar 09 17:55:02 BRT 2003 WEB-INF/classes/Hello.class
Concluses
O Tomcat um container web poderoso
e capaz de atender s necessidades de uma
vasta gama de aplicaes, especialmente
quando no necessrio o suporte a EJBs
ou a separao fsica da camada web.
Vrios outros artigos da Java Magazine
apresentam os primeiros passos no desen-
volvimento de aplicaes web em Java, por
isso nosso objetivo neste artigo foi, prin-
cipalmente, orientar o leitor na instalao
e configurao do Tomcat e na deciso de
adot-lo ou no, sozinho ou em conjunto
com outros servidores, em ambientes de
desenvolvimento ou produo.
jakarta.apache.org
Site do projeto Jakarta, que inclui o Tomcat
java.sun.com/j2ee/tutorial
www.apl.jhu.edu/~hall/java/Servlet-
Tutorial
Tutoriais sobre servlets e JSP
www.onjava.com/pub/a/onjava/2002/07/31/
tomcat.html
Sobre o arquivo de configurao do Tomcat
www.theserverside.com/resources/articles/
Tomcat/article.html
www.ubeans.com/tomcat
Configurao e limitaes do Tomcat para
clustering
sources.redhat.com/rhug
Site do projeto RHUG, que fornece instrues e
binrios para compilao nativa do Tomcat
mingw.sourceforge.net
Site do projeto MingW, que fornece um porte para
Windows do GCJ, compilador Java nativo
blueskytime.sourceforge.net
Plugin para desenvolvimento de aplicaes web
no Eclipse. O Eclipse utiliza o Tomcat para fornecer
help on-line, mas no fornece uma maneira para
rodar suas prprias aplicaes no Tomcat incluso.
Este plugin resolve o problema.
www.javamagazine.com.br/downloads
/jm6/jm6-flozano-tomcat.zip
Fernando Lozano (fernando@lozano.eti.br)
consultor independente e detentor de vrias
certificaes Java, Linux e Microsoft. um ativista
antigo do software livre e autor do livro Java em
GNU/Linux pela Ed. Alta Books. Sua pgina pessoal em
www.lozano.eti.br contm os slides de vrias palestras
apresentadas pelo autor em congressos como a COM-
DEX-SUCESU e o One Day Java.
Edio 6 Java Magazine 21
3/4/2003, 17:50:27
 Java de Bolso

Conectivida d
Interoperabilidade com s

Uma grande largura de banda DatagramConnection , OutputConnection , Input-

necessria apenas quando so
transportados grandes volumes de
dados, o que no o caso para aplica-
es mveis, que devem poupar a bateria
do dispositivo e operar com restries de
memria e capacidade do processador. E
mesmo que haja uma boa largura de ban-
Connection , StreamConnectionNotifier e Stream-
Connection. Essas interfaces definem suporte
para conexes seriais, datagramas (UDP),
HTTP e TCP (cliente e servidor).
No MIDP 2 so adicionadas uma classe e
sete interfaces. As principais novidades em
conectividade no novo MIDP so:

U
m recurso crtico para aplicaes
MIDP a comunicao com
servios residentes em servi-
dores. Neste artigo, sero mostrados os
recursos de conectividade existentes no
CLDC/MIDP usando o Generic Connection
Framework (GCF) e as situaes em que
cada recurso se aplica, cobrindo protocolos
e formatos de dados, alm de boas prticas
e tcnicas de otimizao.
MIDP e a internet
Aplicaes para internet geralmente tm
funcionalidades de pesquisa e envio de
mensagens interagindo com servios lo-
calizados em outras mquinas. As mesmas
funcionalidades tambm so importantes
em aplicaes para telefones celulares e ou-
tros dispositivos com suporte a J2ME. No
meio wireless, isso envolve fatores como
a escolha de protocolos de comunicao,
formatos de dados, largura de banda e
latncia de rede.
A latncia de rede determinada pelo
tempo transcorrido desde o incio de uma
transmisso a partir da origem at o incio
do seu recebimento pelo destino. Em alguns
casos, como na comunicao via satlites,
a latncia pode ser maior do que o tempo
gasto na transmisso da mensagem. J a
largura de banda pode ser definida como
a quantidade de informao que pode ser
transmitida em uma nica conexo, j es-
tabelecida, por unidade de tempo.
Para aplicaes MIDP, a caracterstica da
rede mais importante a baixa latncia.
da, com uma alta latncia de rede o grande Implementao de HTTPS todo dis-
tempo de resposta pode tornar-se inaceit- positivo MIDP 2 deve ter suporte a HT-
vel para o usurio. TPS (no MIDP 1, isso era
importante destacar que opcional). O GCF no MIDP
Na rede celular, fatores
a rede de uma operadora de
telefonia celular bastante
como a cobertura de sinal, 2 tambm disponibiliza
suporte a conexes TLS,
diferente de uma rede grandes taxas de erro SSL e WAP/TLS (interfa-
TCP/IP convencional (a e alta latncia exigem ce SecureConnection), alm
que usamos normalmente tratamento diferenciado do suporte a certificados
para acessar a internet em pelos protocolos para a autenticao de
casa e no trabalho). Na rede conexes seguras (pacote
da operadora, os protocolos tm de ser im- javax.microedition.pki);
plementados usando tecnologias de trans- Suporte tecnologia push pode-se
misso wireless, passando por satlites e registrar aplicaes MIDP para responder
antenas. Fatores como a cobertura de sinal, a eventos de conectividade, mesmo que a
reas de sombra, grandes taxas de erro e mquina virtual Java no esteja ativa; por
alta latncia exigem tratamento diferencia- exemplo, um MIDlet pode ser invocado ao
do pelos protocolos de comunicao. Em receber uma notificao originada de uma
redes de telefonia celular, existem vrias URL registrada anteriormente;
maneiras de realizar o trfego de dados. As Suporte obrigatrio a OTA (Over The
principais so: CSD (Circuit-Switched Data), Air) pode-se realizar o download de apli-
GPRS (General Packet Radio Service), CDPD caes MIDP (usando WAP) para o telefone
(Cellular Digital Packet Data) e HSCSD (High- atravs da rede wireless.
Speed Circuit-Switched Data). Veja a seguir alguns exemplos de cone-
xes com o GCF.
O Generic Connection Framework HTTP:
O Generic Connection Framework (GCF) HttpConnection c1 = (HttpConnection) Connector.open(
a API J2ME padro para conectividade. http://www.jm.com.br?ed=5&imp=1);
Oferece suporte a vrios protocolos de co- TCP (Sockets):
municao, entre eles HTTP/HTTPS, TCP, StreamConnection c2 = (StreamConnection) Connector.open(
UDP, serial, e infravermelho, sem no entan- socket://192.168.7.3:7070);
to se ater a implementaes especficas.
Serial:
O GCF reside no pacote javax.microedition.io.
InputConnection c3 = (InputConnection) Connector.open(
No MIDP 1, o framework inclui a classe
comm:0;baudrate=9600, Connector.READ);
Connector e nove interfaces: Connection,
Con tentConnection, Datagram, HttpConnection , Como se pode deduzir a partir dos exem-

22 Java Magazine Edio 6

jm6-book.indb 22 3/4/2003, 17:50:30


a de com MIDP
m servios externos
plos, a URL passada como argumento obe-
dece ao seguinte esquema:
<protocolo>:<endereo>;<parmetros>
Essa URL utilizada pela classe Connector
para criar os objetos implementadores
da interface Connection especializados no
protocolo especificado. Os parmetros
especificados depois do ponto-e-vrgula
so consumidos pelo objeto xxxConnection
especfico.
As implementaes do Generic Connec-
tion Framework seguem uma nomencla-
tura de pacotes padro, para simplificar o
carregamento dinmico de classes. O nome
do protocolo includo no nome da classe,
que instanciada utilizando reflection. No
caso da implementao de referncia da
Sun (o J2ME Wireless Toolkit), o nome da
classe para o protocolo HTTP com.sun.cldc
.io.j2me.http.Protocol.class.
O mtodo open possui mais trs verses,
duas delas apresentadas nos exemplos
anteriores: open (String), open (String , int) e
open (String, int, boolean). O argumento in-
teiro determina o modo de acesso: leitura
(READ), escrita (WRITE) ou leitura/escrita
(READ_WRITE) este ltimo o padro. O
argumento booleano ativa um tempori-
zador (timer) interno da implementao
com isso uma exceo ser lanada caso
o tempo transcorrido no estabelecimento
da conexo seja excessivo.
Nos prximos exemplos enfatizamos os
conectores baseados em HTTP (HttpConnec-
tion e ContentConnection). A implementao de
HTTP pode ser diretamente sobre a rede
de telefonia celular ou atravs de gateways
(assim como em WAP). A implementao
dos demais protocolos previstos pela espe-
cificao opcional.
Protocolos e HttpConnection
O nico protocolo obrigatrio em qual-
jm6-book.indb 23
Integrao de aplicaes
J2ME/MIDP com servios
de rede atravs do Generic
Connection Framework
CLUDIO MIRANDA
quer implementao de CLDC/MIDP antes da conexo ao servidor.
o HTTP, mas alguns fornecedores (como Uma conexo HTTP (representada por
Nokia, Motorola, Siemens, IBM-J9, Jeode, um objeto do tipo HttpConnection) pode estar
Symbian, Sony-Ericsson e HP) implemen- em trs estados: setup (configurao), em
tam protocolos adicionais, por exemplo que a conexo ainda no est estabelecida
TCP, HTTPS, infravermelho e UDP. Apesar com o servidor e podem ser definidos os
de o MIDP 2 j definir interfaces para cone- parmetros da solicitao; connected, no
xes seriais (CommSerial), SSL/TLS (SecureCon- qual a conexo com o servidor est ativa,
nection) e sockets no lado do servidor (Ser- os parmetros da solicitao foram envia-
verSocketConnection), a implementao desses dos e uma resposta aguardada; e closed,
protocolos continua sendo opcional. onde o servidor j enviou mensagens para
O protocolo HTTP bastante fcil em o cliente e fechou a conexo. Observe que
comparao com os outros, pois trafegam depois de entrar no estado closed, qualquer
apenas mensagens textuais no h troca tentativa de reuso da conexo provocar
de dados em formato binrio. E as requi- uma IOException.
sies e respostas podem ser entendidas Os parmetros HTTP devem ser confi-
por pessoas, sem que antes precisem passar gurados no estado de configurao. So
por um parser. cabealhos HTTP como: User-Agent e
A interface HttpConnection do GCF trata Content-Type. Observe o exemplo na
da comunicao com um servidor HTTP Listagem 1.
e possui algumas peculiaridades, por se Vamos discutir alguns pontos do cdigo.
tratar de um protocolo de requisio/ Esteja atento para pequenos detalhes que
resposta (request/response) sem estado, em no mundo J2SE/J2EE no fazem muita dife-
que devem ser configurados parmetros rena, mas no J2ME importam muito.
Cabealhos HTTP
User-Agent Informa o tipo de cliente que est se conectando ao servidor HTTP
Indica o formato do contedo enviado alm da URL e deve ter a codificao
Content-type x-www-form-urlencoded para mtodo POST, a no ser que sejam enviados
arquivos anexados no padro MIME
Indica o tamanho dos dados enviados, especialmente no caso de dados
Content-length
binrios
Utilizado quando uma aplicao MIDP ser instalada por OTA. O servidor
usa esses cabealhos junto com User-agent para saber qual a verso do
Accept-Language
CLDC/MIDP e o idioma/pas suportados pelo dispositivo, fazendo que uma
aplicao customizada possa ser instalada automaticamente.
Indica se a conexo com o cliente deve ser reutilizada entre vrias requisies
(tambm conhecida como conexo persistente ou keep-alive). Caso contr-
rio, o servidor fecha a conexo ao fim de cada resposta enviada ao cliente.
Connection
Com conexes persistentes, se vrias conexes ao mesmo servidor forem
estabelecidas em um breve espao de tempo, haver ganhos de tempo e de
bateria caso a conexo seja reutilizada.
Edio 6 Java Magazine 23
3/4/2003, 17:50:34
Java de Bolso

GET, mas retorna apenas o cabealho da

Listagem 1. Conexo com HTTP
resposta, o que til para verificar a dispo-
01: HttpConnection http = null; nibilidade de determinada URL. Para mais
02: InputStream httpIn = null;
03: OutputStream httpOut = null; informaes sobre as outras propriedades
04: String url = http://site.com.br/pesq; estabelecidas para a conexo, veja o quadro
05: try {
06: String post = cod=34&pesq=JavaMagazine; Cabealhos HTTP.
07: // Conexo em estado de configurao Nota : os cabealhos Connection e
08: http = (HttpConnection) Connector.open(url);
09: http.setRequestMethod(HttpConnection.POST); Content-length esto presentes apenas
10: http.setRequestProperty(User-Agent, no HTTP 1.1. por isso que a especificao
Profile/MIDP-1.0, Configuration/CLDC-1.0);
11: http.setRequestProperty(Content-Type, MIDP requer a implementao do HTTP
application/x-www-form-urlencoded ); 1.1. Nas linhas 17 e 18, escrevemos no corpo
12: http.setRequestProperty(Connection, close);
13: http.setRequestProperty(Content-Length, da requisio os dados a serem enviados ao
Integer.toString(post.length()) ); servidor; mas at esse ponto a requisio
14: // Neste ponto todos os cabealhos necessrios foram configurados
15: no foi enviada. Somente na linha 21, ao
16: // Escreve os dados a serem enviados ao servidor capturarmos a resposta do servidor, os da-
17: httpOut = http.openOutputStream();
18: httpOut.write(post.getBytes()); dos so enviados. A resposta obedece ao
19: padro HTTP (cdigos 404, 500, 200 etc.).
20: // A conexo efetuada e os dados so enviados
21: int httpResponseCode = http.getResponseCode(); Na linha 31 verificamos se o servidor
22: // Verifica o cdigo da resposta HTTP retornou o tamanho da resposta, permi-
23: if (httpResponseCode!= HttpConnection.OK) {
24: System.out.println(Nao foi possivel efetuar conexao: + tindo a leitura em um nico bloco, ou se
httpResponseCode); teremos que ler a resposta byte a byte at
25: return;
26: } o seu trmino (final de arquivo).
27: // Efetua a leitura da resposta -
// o que seria exibido em um navegador
28: httpIn = http.getInputStream(); Formatos de dados
29: Agora vamos tratar do formato dos da-
30: // verifica o tamanho da resposta
31: int len = (int) http.getLength(); dos a serem transferidos. Podemos utilizar
32: // Veja o comentrio no texto sobre esta parte do cdigo formatos textuais (CSV, texto delimitado,
33: if (len > 0) {
34: // content-length foi fornecido pelo servidor - ler de uma s vez XML), formatos binrios personalizados
35: int actual = 0; ou serializao de objetos.
36: int totalLidos = 0 ;
37: byte[] data = new byte[len]; O desenvolvedor Java est habituado aos
38: while ((totalLidos!= len) && (actual!= -1)) { mecanismos de serializao e refl ection,
39: // Tenta ler todo o contedo de uma s vez
40: actual = httpIn.read(data, bytesread, len - totalLidos); entretanto estes no so suportados dire-
41: totalLidos += actual; tamente no CLDC/MIDP. A serializao,
42: }
43: // Efetua algum processamento com os dados no entanto, pode ser feita manualmente,
44: process(data); usando as classes java.io.DataInputStream e
45: } else {
46 // Ler byte a byte java.io.DataOutputStream da maneira mostra-
47: int ch; da na Listagem 2. Um exemplo de classe
48: while ((ch = httpIn.read())!= -1) {
49: // Efetua algum processamento com os dados serializvel mostrado na Listagem 3.
50: process((byte) ch); Como se pode ver nos exemplos, no
51: }
52: } difcil criar um mecanismo prprio de se-
53: } catch (ClassCastException e) { rializao. O desenvolvedor deve apenas
54: // Ocorre quando a url no corresponde
// interface de conexo especificada no cast observar a ordem de escrita e leitura, pois
55: throw new IllegalArgumentException( um erro pode ser difcil de detectar em
No uma url do tipo HTTP.);
56: } finally { classes com muitos atributos.
57: if (httpIn!= null) httpIn.close();
58: if (httpOut!= null) httpOut.close(); CSV
59: if (http!= null) http.close();
60: } O tipo de arquivo CSV (Comma-Separated
Values) existe desde a poca do MS-DOS.
Nele, como indica o nome, dados so sepa-
Nas linhas 9 a 13, definimos algumas pro- am=valor). Nesse caso, existe a limitao do
rados por vrgulas; a primeira linha deter-
priedades (cabealhos) para iniciar a con- tamanho da URL e os dados a serem envia-
mina os nomes dos campos. Por exemplo:
versa com o servidor HTTP e definimos dos somente podem ser textuais.
Nome,Idade,Origem
o mtodo de requisio ao servidor como Quando usado POST, no h limite Duke,8,java.sun.com
POST (outras opes so GET e HEAD). para o tamanho dos dados, que podem Tigre,50000,Asia
Internet,25,ArpaNET
Lembre-se que, usando GET, os dados so ainda ser binrios (figuras, mensagens
Humano,500000,Terra
enviados como parte da URL (por exemplo: criptografadas etc.). J o mtodo HEAD
http://site.com.br/processa?cod=1&tit=2&par tem funcionalidade semelhante de O formato CSV no difere muito de outros

24 Java Magazine Edio 6

jm6-book.indb 24 3/4/2003, 17:50:35

 formatos textuais delimitados, mas tem a
vantagem de ser simples e aceito por vrias
aplicaes, como planilhas eletrnicas.
A aplicao MIDP deve implementar a l-
gica de leitura/escrita especfica para cada
formato de dados utilizando mtodos como
substring e indexOf. Mas observe que esse pro-
cesso gera vrios objetos temporrios
aconselhvel apontar esses objetos para null
o mais cedo possvel, de modo a economi-
zar recursos do dispositivo consumidos no
processo de coleta de lixo.
XML
Um documento XML muito simples de
entender segue uma estrutura hierrqui-
ca evitando a repetio de dados e permite
armazenar contedo binrio. Documentos
XML podem ser validados usando um DTD
(Document Type Definition) ou um XML
Schema (documento XML que descreve
tags, atributos e tipos permitidos). Com
Java, existem basicamente duas maneiras
de acessar um documento XML: atravs de
SAX (Simple API for XML) ou DOM (Docu-
ment Object Model). Detalhes sobre a ma-
nipulao de documentos XML com Java
podem ser vistos no artigo Processando
XML em Java (Edio 2).
Em MIDP no h uma API padro para
tratar XML, mas existem bibliotecas que
podem ser usadas como a kXML e a Nano-
XML. Entretanto, ao usar XML em aplica-
es wireless Java, deve-se levar em conta
o espao ocupado, os custos de processa-
mento com a coleta de lixo e o consumo de
energia. No recomendo o uso intensivo de
XML com MIDP, salvo em situaes onde
no seja possvel realizar a troca de men-
sagens em formatos mais simples, como os
apresentados anteriormente.
Desempenho e tempo de resposta
Ao pensar em desempenho, devemos
estar atentos ao que queremos melhorar e
a qual o tempo de resposta aceitvel. co-
mum, ao buscar aumento de desempenho
em uma aplicao, no se determinar qual
o tempo considerado ideal, mas apenas
estabelecer como objetivo quanto mais
rpido melhor. No entanto, necessrio
estabelecer limites para sabermos at onde
vale a pena investir nessa rea.
A seguir, reno algumas dicas que re-
duzem os tempos resposta em aplicaes
MIDP, ou melhoram a experincia do
jm6-book.indb 25
usurio (concentrando-se em operaes (sincronizao de dados com a origem).
relacionadas conectividade) Normalmente, a verificao de cache efe-
tuada com base em timestamps de quando
Cache de dados
foi efetuada a leitura, e em um mecanismo
Para minimizar operaes de conexo de de notificao do servidor, ativado quando
rede, parsing, converso de tipos etc. im- os dados so modificados. No MIDP, im-
portante que seja definido um mecanismo portante que o cache tenha seu crescimento
de cache, para reduzir o nmero de leituras limitado para no comprometer o espao
do mesmo dado. Esse mecanismo capaz disponvel no dispositivo.
de saber quando um dado est sujo (de-
satualizado em relao ao mesmo dado na Thread para operaes assncronas
origem) e efetuar a sua leitura novamente Em MIDP, a conexo e a transferncia
Listagem 2. Serializao manual de objetos (mtodos get/set omitidos)
// Escrita
DataOutputStream dataOut = //... obter um DataOutputStream
dataOut.writeInt(5);
dataOut.writeBoolean(true);
dataOut.writeUTF(isto eh um teste);
// Leitura
DataInputStream dataIn = //... obter um DataOutputStream
int i = dataIn.readInt();
boolean b = dataIn.readBoolean();
String s = dataIn.readUTF();
Listagem 3. Exemplo de classe manualmente serializvel
01: public interface Serializer {
02:
03: public byte[] serialize() throws IOException;
04: public void deserialize(byte[] b) throws IOException;
05: }
06:
07: public class Pessoa implements Serializer {
08:
09: static final byte TOKEN_INICIO = 33;
10: static final byte TOKEN_FIM = 51;
11: public String nome;
12: public String endereco;
13: public boolean leJavamagazine;
14:
15: public byte[] serialize() throws IOException {
16: ByteArrayOutputStream byteOut = new
17: ByteArrayOutputStream(nome.length() + endereco.length() + 3);
18: DataOutputStream dataOut = new DataOutputStream(byteOut);
19: dataOut.writeByte(TOKEN_INICIO);
20: dataOut.writeUTF(nome);
21: dataOut.writeUTF(endereco);
22: dataOut.writeBoolean(leJavamagazine);
23: dataOut.writeByte(TOKEN_FIM);
24: dataOut.flush();
25: return byteOut.toByteArray();
26: }
27:
28: public void deserialize(byte[] data) throws IOException {
29: ByteArrayInputStream byteIn = new ByteArrayInputStream(data);
30: DataInputStream dataIn = new DataInputStream(byteIn);
31: byte b = dataIn.readByte();
32: if (b!= TOKEN_INICIO) {
33: throw new IOException(Inconsistncia na desserializao,
token inicial: + b);
34: }
35: nome = dataIn.readUTF();
36: endereco = dataIn.readUTF();
37: leJavamagazine = dataIn.readBoolen();
38: b = dataIn.readByte();
39: if (b!= TOKEN_FIM) {
40: nome = endereco = ;
41: leJavamagazine = false;
42: throw new IOException(Inconsistncia na desserializao,
token final: + b);
43: }
44: }
45: }
Edio 6 Java Magazine 25
3/4/2003, 17:50:36
Java de Bolso
de dados no so operaes rpidas, pois, possam ser executadas de uma s vez em
como visto anteriormente, a rede pode ter
baixa largura de banda ou alta latncia.
Com nossos equipamentos mveis e pes-
soais, no temos muita disposio para es-
perar por operaes demoradas. No mundo
wireless, no incomum situaes em que
o usurio desista de uma transao banc-
ria se houver uma demora maior que dez
segundos, por exemplo. J no desktop, es-
tamos acostumados a esperas mais longas
e quase nem percebemos as demoras.
No caso de operaes de longa durao
que usem conectividade, importante co-
locar a operao de conexo em uma thre-
ad separada e notificar o usurio (usando
uma barra de status ou caixa de dilogo,
por exemplo), de que a operao foi con-
cluda. Isso normalmente ocorre quando
uma conexo efetuada para buscar dados
em servidores e escrever registros usando
RMS Record Management System.
Alm disso, evite criar mais que duas
threads nos seus aplicativos para no exi-
gir muito do dispositivo, mesmo porque
algumas implementaes da JVM tm
restries quanto ao nmero de threads
ativas concorrentemente.
Minimizao de conexes de rede
No ciclo de vida de uma aplicao que
necessite se conectar com servidores em
uma operao do usurio (por exemplo,
uma consulta fatura de um carto de
crdito) quantas conexes so necessrias
para chegar ao resultado final? Podemos
minimizar as operaes de rede em proces-
sos batch, fazendo com que vrias tarefas
26 Java Magazine Edio 6
jm6-book.indb 26
cessrios esto disponveis se servidores
apenas uma conexo de rede. esto ativos e funcionando corretamente ou
se existe espao suficiente no dispositivo.
Uso de servio de proxy
Assim o usurio no perde tempo aguar-
Freqentemente necessrio extrair dando por uma operao que no poder
dados de documentos HTML/XML for- ser finalizada.
necidos por servios sobre os quais no
temos controle. Essas so operaes de Concluses
alto custo para o dispositivo, mas podemos A construo de aplicaes MIDP envolve
usar um servidor sob nosso controle para consideraes que no so necessrias em
efetuar previamente a extrao dos dados aplicaes desktop ou de servidor. Mas, to-
e deix-los em um formato mais leve para mando alguns cuidados, podemos garantir
a aplicao MIDP. ao usurio uma experincia agradvel.
Outra situao ocorre quando a aplica-
o MIDP consulta um servio que retorna
uma grande quantidade de dados. Pode-
mos delegar a consulta para um servio
de proxy do MIDP, localizado em outro java.sun.com/products/cldc
servidor sob nosso controle, que quebre Connected Limited Device Configuration (CLDC)
os dados em pedaos mais adequados aos
java.sun.com/products/midp
recursos limitados do dispositivo.
Mobile Information Device Profile (MIDP)
Indicador de operaes demoradas
www.ietf.org/rfc/rfc2616.txt
importante que, para tarefas que no
Hypertext Transfer Protocol (HTTP) 1.1
sejam instantneas (com durao de, diga-
mos, mais que 3 segundos), seja mostrado www.ietf.org/rfc/rfc768.txt
um indicador de que a operao esteja em User Datagram Protocol (UDP)
processamento e no travou ou foi cance- www.ietf.org/rfc/rfc2246.txt
lada. O indicador pode ser atualizado com Transport Layer Security (TLS) 1.0
base na porcentagem efetuada da tarefa, ou
em nmeros que indiquem a quantidade www.javamagazine.com.br/downloads
processada com relao ao total (por exem- /jm6/jm6-cmiranda-j2me.zip
plo, 20 de 135), ou ainda um aviso grfico
de progresso como o Gauge do MIDP.
Testes de disponibilidade Cludio Miranda (claudio.miranda@uol.com.br),
Antes da aplicao MIDP ser disponibi- consultor da Summa Technologies, certificado em
lizada para o usurio, conveniente que a Java, palestrante em vrios eventos sobre a tecnolo-
aplicao possa verificar se os recursos ne- gia e moderador da lista J2ME do SouJava.
3/4/2003, 17:50:37
 Edio 6 Java Magazine 27

jm6-book.indb 27 3/4/2003, 17:50:53


A
prxima verso do J2EE 1.4 com
lanamento previsto para o meio
desse ano inclui uma srie de no-
vidades, como o suporte a web services, o
EJB 2.1, JMX, Deployment API, Servlets 2.4
e JSP 2.0 (para uma viso geral das novida-
des do J2EE 1.4, veja o primeiro artigo desta
coluna, na Edio 1).
Nesta edio, vamos explorar com de-
talhes as novidades do JSP 2.0 e apontar
algumas boas prticas para o uso dos novos
recursos.
Facilidade de programao
O objetivo principal da nova especificao
JSP melhorar a legibilidade do cdigo e
Figura 1. Exemplo BookStore: livros disponveis (lista reduzida)
28 Java Magazine Edio 6
jm6-book.indb 28
Alm das Fronteiras
Novidades
Expressividade e abstra
facilitar a manuteno das pginas. Preo: <%= ((database.BookDetails)
Isso alcanado com uma melhora request.getAttribute(book)).getPrice() %>
significativa nos recursos para cria-
Com a introduo da EL, esse cdigo pode
o de bibliotecas de tags (tag libraries
ser reduzido para:
ou taglibs), e com a introduo de uma
linguagem de expresses. Preo: ${book.price}
Vamos explorar os novos recursos ana-
As expresses entre ${ e } so analisadas
lisando uma parte do exemplo BookStore,
em tempo de execuo pelo container web.
distribudo com o J2EE Tutorial Addendum.
No exemplo, o objeto representado pela cha-
O exemplo roda na verso beta da imple-
ve "book" procurado num dos possveis
mentao de referncia do J2EE 1.4 veja
contextos (page, request, session ou application).
no quadro Primeiros passos como fazer
O analisador de expresses ento traduz o
a instalao.
operador . (ponto) em mtodos getXXX
A aplicao consiste numa livraria on-line
onde XXX o nome da propriedade na
com as funcionalidades de exibir a lista de
expresso e navega na hierarquia de ob-
livros disponveis, detalhar um determina-
jetos usando introspeco.
do livro, adicionar livros cesta de compras
Para manipular objetos dessa forma
e finalizar um pedido. A Figura 1 mostra
preciso seguir o padro JavaBeans, ou seja,
a listagem dos livros disponveis, gerada
os objetos devem ser definidos em classes
pela pgina bookcatalog.jsp.
com um construtor vazio e mtodos get e set
para leitura e escrita dos atributos.
Linguagem de expresses
Para o acesso a atributos de objetos
A linguagem de expresses (Expression
e elementos de listas, a linguagem de
Language EL) melhora bastante a sintaxe
expresses defi ne dois operadores: . e
do JSP, aumentando o nvel de
[] (colchetes). Os dois tm aplicaes
abstrao dos comandos. Um
semelhantes, porm [] permite o uso de
container web do novo J2EE 1.4
variveis como argumentos. Usando esse
inclui um analisador de expres-
operador, o exemplo anterior poderia ser
ses. As expresses podem ser
escrito da seguinte maneira:
usadas em qualquer lugar da
pgina misturadas ao cdigo Preo: ${book[price]}
HTML ou em atributos de tags
Porm, o uso mais indicado para os col-
exceto em scriptlets (cdigo
chetes no acesso a listas indexadas. Por
Java dentro da pgina JSP).
exemplo, imagine que exista um atributo
Por exemplo, imagine que
chamado allBooks no request, contendo uma
precisamos exibir o preo de
coleo de BookDetails do tipo java.util.ArrayList.
um determinado livro. Va-
O preo do primeiro livro da lista poderia
mos supor que um objeto da
ser lido dessa forma:
classe database.BookDetails (que
representa a entidade Livro) Preo: ${allBooks[0].price}
passado para o JSP como um
atributo do request. At o JSP 1.2, J no caso dos livros estarem armazena-
o preo do livro poderia ser exi- dos num java.util.Map, o preo do livro com
bido da seguinte forma: chave 001 poderia ser lido assim:
3/4/2003, 17:51:05

s do JSP 2.0
a o no novo JSP
Preo: ${allBooks [001].price}
A leitura de atributos tambm permitida
para vrios nveis de hierarquia. Supondo
que a classe BookDetails tenha um atributo do
tipo Author, tendo por sua vez um atributo
firstName do tipo String. O primeiro nome
do autor seria exibido assim:
Nome: ${book.author.firstName}
Objetos implcitos
Alm de acesso aos JavaBeans, a lingua-
gem de expresses tambm facilita a leitura
de informaes tais como os parmetros
da requisio, o cabealho HTTP, cookies
e parmetros de inicializao. A leitura
feita atravs de objetos implcitos:
param usado para acessar parmetros
do request. Por exemplo, o campo ID de um
formulrio submetido poderia ser acessado
usando ${param.ID};
header para acessar informaes do
cabealho da requisio HTTP, como o
servidor (host) onde a aplicao executa, ou
o tipo de browser do cliente. Por exemplo:
${header.host};
cookie retorna um cookie a partir de seu
nome. Por exemplo, ${cookie.ultimoAcesso} aces-
sa o cookie criado com o nome ultimoA-
cesso.
initParam d acesso aos parmetros de
inicializao da aplicao, obtidos atravs
do seu nome. ${initParam.defaultLocale}, por
exemplo, obtm o valor do parmetro com
nome defaultLocale.
Existem ainda os objetos implcitos
paramValues e headerValues, usados para
obter arrays de Strings com mltiplos
valores para parmetros contidos no
request e no header, respectivamente.
Tambm possvel acessar JavaBeans
num contexto especfico, usando os
objetos pageScope, requestScope, sessionScope e
applicationScope.
jm6-book.indb 29
Nova linguagem de expresses,
padronizao da JSTL, fragmentos
JSP e tag files so algumas
Operadores
A linguagem de expresses tambm
suporta operadores aritmticos, lgicos e
relacionais. As seguintes so expresses
vlidas:
${100 == 100}
${5 < 10}
${10 % 3}
Alm disso, curiosamente, foram defi-
nidas novas palavras-chave equivalentes
aos operadores lgicos e relacionais. O
conjunto de expresses a seguir tem o
mesmo efeito do anterior:
${100 eq 100}
${5 lt 10}
${10 mod 3}
Primeiros passos
P ara instalar e executar o exemplo
apresentado nesse artigo, siga estes
passos:
1. Faa o download Java 2 Enterprise Edi-
tion SDK Beta 1.4 (J2EE 1.4) e do J2EE Tutorial
Addendum e instale-os (veja referncias).
2. Defina a varivel de ambiente J2EE_
HOME, apontando para o diretrio de
instalao do J2EE 1.4. Configure tambm
a varivel de ambiente PATH para incluir o
diretrio %J2EE_HOME%\bin.
3. Usando a linha de comando, inicie o
banco de dados Cloudscape, com o co-
mando cloudscape start. Inicie tambm o
servidor J2EE, usando o comando j2ee.
4. Para criar a base de dados do exemplo,
entre no diretrio %J2EE_HOME%\doc\
tutorial\examples\web\bookstore e digite
o comando ant -create-book-db.
Nota: o arquivo WAR do exemplo pode ser
baixado do site da Revista. Com ele possvel
pular os passos 5, 6 e 7.
5. O prximo passo compilar os arquivos
do exemplo BookStore. No diretrio indi-
extenses na verso 2.0
JLIO CSAR LINS
Apesar de essas novas palavras-chave
serem bastante intuitivas, uma boa
idia evit-las, optando pelos operadores
j usados na linguagem Java, para evitar
confuses.
Tag Files
Os Tag Files permitem a implementao
de bibliotecas de tags sem o uso de cdigo
Java. So arquivos XML contendo a defini-
o e o comportamento das tags. Permitem
o uso de outras tags dentro do corpo da tag
definida e no requerem conhecimento da
linguagem Java.
Um Tag File um arquivo com extenso
.tag, semelhante a um JSP convencional
cado anteriormente, digite o comando ant
package-bookstore.
6. A verso usada no exemplo foi a BookS-
tore3 (so quatro exemplos BookStore). Para
compilar essa verso, entre no diretrio
%J2EE_HOME%\doc\tutorial\examples\
web\bookstore3 e digite o comando ant
build.
7. Compacte o contedo do diretrio
%J2EE_HOME%\doc\tutorial\examples\
web\bookstore3\build e chame o arquivo
de bookstore3.war.
8. Inicie a ferramenta de deploy do J2SDKEE
1.4 atravs do comando deploytool e abra o
arquivo bookstore3.war. Clique o boto de
deploy e, quando solicitado, abra o arquivo
sun-j2ee-ri.xml que se encontra no diretrio:
%J2EE_HOME%\doc\tutorial\examples\
web\bookstore3\build\META-INF.
9. Pronto. A aplicao j pode ser acessada
pelo endereo:
http://localhost:8000/bookstore3/
bookstore.jsp
Edio 6 Java Magazine 29
3/4/2003, 17:51:14
Novidades do JSP 2.0

pode conter cdigo HTML, expresses conter chamadas a outras tags e expres- mento. Observe tambm na listagem o uso
(em EL) e chamadas a outras tags. A di- ses; a nica restrio no poder usar das aes <jsp:invoke> e <jsp:param>.
ferena est na declarao dos atributos scriptlets.
recebidos e nas variveis utilizadas, que No exemplo da Listagem 2, podemos ver Configuraes globais
devem ser especificados no cabealho do um trecho do JSP bookcatalog.jsp, que chama Com as configuraes globais (Global Con-
arquivo. Observe as declaraes sendo fei- a tag <sc:catalog> passando dois atributos figurations) possvel definir propriedades
tas com o uso das diretivas <%@ atributo %> que so trechos de cdigo JSP. Nesse caso, para um conjunto de JSPs. As opes de
e <%@ varivel %> na Listagem 1. a tag chamada decide qual trecho ser configurao so avaliao de expresses
executado dependendo do livro estar ou da EL, execuo de scriptlets, definio da
Fragmentos no em promoo. codificao da pgina (encoding) e incluso
Fragmentos (JSP fragments) so pores Os fragmentos passados como argu- de cabealho e rodap.
de cdigo JSP escritas para serem reusadas mentos tambm podem conter variveis As configuraes so descritas no
dentro de uma aplicao. Por conveno, a serem preenchidas pela tag chamada. descritor web (web.xml) dentro do
fragmentos devem ser salvos em arquivos As variveis so declaradas na forma elemento <jsp-config>, usando elemen-
com terminao .jspf. Esses arquivos devem ${varivel}, como ${origPrice} e ${salePrice} usa- tos <jsp-property-group>. O exemplo da
ser includos em outros JSPs usando o co- das no exemplo. Esse recurso acrescenta Listagem 3 faz a incluso de um cabe-
mando include do JSP. Fragmentos tambm s tags o poder de manipular o fragmento alho e um rodap em todas as JSPs da
podem ser passados como atributos de sem muito esforo de codificao, pois as aplicao.
tags, na forma de pores de cdigo JSP variveis podem receber valores atravs de
(usando a nova ao jsp:attribute) e podem parmetros passados na execuo do frag- JSTL
A JSP Standard Tag Library (JSTL) foi
lanada em julho de 2002 e compatvel
Listagem 1. Exemplo de Tag File com a verso 1.3 do J2EE; no J2EE 1.4 j
<!-- Declara a utilizao de outras bibliotecas --> includa como parte da plataforma. A
<%@ taglib uri=/jstl-c prefix=c %> JSTL contm uma srie de tags bastante
<%@ taglib uri=/jstl-fmt prefix=fmt %>
teis na programao JSP, divididas em
<!-- Declara os atributos recebidos --> quatro bibliotecas:
<%@ attribute name=bookDB required=true
rtexprvalue=true type=database.BookDB %> Ncleo (Core) contm tags usadas para
<%@ attribute name=color required=true %> controlar o fluxo da pgina e a sada de
<!-- Declara um atributo do tipo fragment (que pode ser executado) --> mensagens;
<%@ attribute name=normalPrice fragment=true %> Processamento XML (XML Processing)
<!-- Declara o uso de uma varivel -->
<%@ variable fragment=normalPrice name-given=price %> tags utilitrias para processamento de
<%@ attribute name=onSale fragment=true %> XML;
<%@ variable fragment=onSale name-given=origPrice %>
<%@ variable fragment=onSale name-given=salePrice %> Internacionalizao (I18N Capable
Formatting) tags usadas para formao
<center>
<table> de textos, valores monetrios e nmeros,
<!-- Percorre os livros lidos do banco de dados --> com base na localizao do usurio;
<c:forEach var=book begin=0 items=${bookDB.books}>
<tr> Acesso a dados (Database Access) tags
<!-- OMITIDO: montagem do ttulo do livro --> para acesso a bancos de dados relacionais
<c:set var=sale value=${book.price * .85} />
de maneira simplificada, sem a necessidade
<!-- Decide qual fragmento executar verificando de cdigo Java.
se o livro est em promoo -->
<c:choose> A explorao do JSTL daria um artigo
<c:when test=${book.onSale} > parte aqui vamos nos concentrar na
<!-- Executa o fragmento onSale (veja declarao dos atributos) -->
<jsp:invoke fragment=onSale> relao desta com a tecnologia JSP.
<!-- Define o valor das variveis passadas para o fragmento -->
<jsp:param name=origPrice value=${book.price}/>
<jsp:param name=salePrice value=${sale}/> Expresses com J2EE 1.3
</jsp:invoke> importante ressaltar que a JSTL j su-
</c:when>
<c:otherwise> porta a linguagem de expresses quando
<jsp:invoke fragment=normalPrice> usada em atributos de tags. Em outras pala-
<jsp:param name=price value=${book.price}/>
</jsp:invoke> vras, o valor de um atributo na chamada de
</c:otherwise> uma tag pode ser o resultado da avaliao
</c:choose>
&nbsp;</td> de uma expresso. Com isso, todos os re-
<!-- OMITIDO: montagem dos dados do autor --> cursos da linguagem de expresses podem
</tr>
</c:forEach> ser usados num container J2EE 1.3, desde
</table> que dentro de atributos de tags, e no como
</center>
parte do texto.

30 Java Magazine Edio 6

jm6-book.indb 30 3/4/2003, 17:51:15

 inteligncia do 2.0 simplificar a sintaxe, aumentando
Listagem 2. Passagem de fragmento como atributo de uma tag
componente reu- assim a produtividade e facilitando a ma-
<sc:catalog bookDB=${bookDB} color=#cccccc> svel. nuteno do cdigo. O JSP j est chegando
<!-- Exibe o preo do livro de maneira convencional -->
<jsp:attribute name=normalPrice> Com as bibliotecas a um estado maduro e o suporte de ferra-
<fmt:formatNumber value=${price} type=currency/> de tags, a criao mentas j bem rico. Segundo a equipe
</jsp:attribute>
de componentes na responsvel pela especificao, a idia
<!-- Exibe o preo normal do livro riscado camada web deu continuar avanando nas melhorias, bus-
e o preo promocional em vermelho -->
<jsp:attribute name=onSale> um grande salto e cando a sintaxe do XML.
<strike><fmt:formatNumber value=${origPrice} agora evolui ainda Com a incorporao de melhorias a cada
type=currency/></strike><br/>
<font color=red><fmt:formatNumber mais com os novos nova verso, o desenvolvimento web com
value=${salePrice} type=currency/></font> recursos do JSP 2.0 JSP est se tornando cada vez mais simples
</jsp:attribute>
</sc:catalog> o reuso passa a e ao mesmo tempo mais poderoso. Outro
ser possibilidade grande salto ser dado com o lanamento
Listagem 3. Exemplo de configurao global concreta no desen- da tecnologia JavaServer Faces - JSF (veja
<web-app> volvimento. Hoje mais nesta coluna, na Edio 3). Em breve
... j existem diversos a dificuldade para criar interfaces web
<jsp-config>
... componentes, no ricas e de fcil manuteno ser coisa do
<jsp-property-group> somente os mais passado.
<url-pattern>/*.jsp
</url-pattern> genricos como os
<include-prelude>/template/prelude.jspf da JSTL, mas tam-
</include-prelude> jcp.org/jsr/detail/151.jsp
<include-coda>/template/coda.jspf bm outros que se
JSR-151 (especificao do J2EE 1.4)
</include-coda> propem a resolver
</jsp-property-group>
</jsp-config> problemas mais jcp.org/jsr/detail/152.jsp
</web-app> especficos, como JSR-152 (especificao do JSP 2.0)
paginao de dados, java.sun.com/j2ee/download.html
Na verso 2.0 do JSP, a especificao leitura de arquivos e logging. Download do J2EE 1.4 beta e do Tutorial
melhorou a sintaxe do cdigo, delegando Por exemplo, o site jsptags.com, oferece Addendum
a avaliao da expresso para o container e uma biblioteca de tags para a paginao de
permitindo assim que qualquer biblioteca registros muito interessante, que permite java.sun.com/products/jsp/jstl
de tags possa tirar proveito da linguagem navegar para frente e para trs ou acessar JSP Standard Tag Library - JSTL
de expresses. uma pgina diretamente, alm de mudar jakarta.apache.org/taglibs
Usando a JSTL, tambm possvel usar o look-and-feel da paginao, com suporte Jakarta Taglibs
expresses para ler atributos de objetos, ao formato de sites de busca como o Google
mas necessrio usar a tag <c:out>. Com e o Altavista. jsptags.com
essa tag, a exibio do preo do livro mos- O projeto Apache Jakarta, responsvel Portal com referncias para vrias taglibs
trada anteriormente ficaria dessa forma: pela implementao de referncia da JSTL,
oferece vrias bibliotecas, como DateTime www.javamagazine.com.br/downloads
Preo: <c:out value=${book.price}/> /jm6/jm6-jlins-jsp.zip
para formatao de data/hora, Mailer para
Reuso na camada web envio de e-mails, alm das bibliotecas do
Antes das verses mais recentes do JSP, framework Struts, j muito usadas pela Jlio Cesar Lins (jcsl@cin.ufpe.br) consultor
produzir componentes reusveis na ca- comunidade de desenvolvimento web. independente de Java e J2EE, programador
mada web era uma tarefa complicada, j certificado pela Sun e certificado em anlise e
que era feita basicamente com comandos Concluses projeto pela IBM.
include em pginas JSP, o que limitava a O principal objetivo da nova verso JSP

Edio 6 Java Magazine 31

jm6-book.indb 31 3/4/2003, 17:51:16

 Dicas e Solues
Uso de final e desempenho

bem conhecido o que a palavra-chave

final capaz de fazer teoricamente
campos final s podem ser atribudos
uma nica vez, mtodos final no podem
ser redefinidos e classes final no podem
ser herdadas (veja detalhes no quadro
abaixo).
Mas muitos no conhecem alguns bene-
fcios prticos do uso desse modificador.
Alm de forar o uso correto das classes,
mtodos e variveis (veja quadro Usos
de final), usar final permite que compi-
ladores e mquinas virtuais faam otimi-
zaes como inlining (veja o quadro ao
lado), aumentando consideravelmente o
desempenho do cdigo.
Uma boa maneira de verificar as melho-
rias selecionar algumas classes de um
sistema ou subsistema pronto que j tenha
medidas de desempenho bem definidas e
recompil-las aps ter alterado o cdigo
para usar final em todos os lugares poss-
veis. Na maioria dos casos, o ganho ser
claramente perceptvel.

Usos de final

A pesar de fazer parte de Java desde sua primeira verso, a

palavra-chave final no to usada nem como poderia.
Conhea os principais usos de final na linguagem.
realizada, visto que o mtodo realizaOperacao() final.

Em variveis de instncia
Variveis de instncia final precisam ser inicializadas na decla-
rao, ou em todos os construtores da classe. Tomando como
Em classes
base a seguinte classe, por exemplo:
Quando uma classe declarada final, ela no pode ser herdada.
Conseqentemente, o seguinte trecho de cdigo no compila: public class Exemplo {
private final int inicializado = 50;
public final class ClasseNaoExtensivel { private final int posInicializado;
//...
} public Exemplo() {
class Filho extends ClasseNaoExtensivel { //No compila posInicializado = 0;
//... }
} public Exemplo(int valor) {
posInicializado = valor;
Em mtodos }
Mtodos declarados final, no podem ser redefinidos em sub- }
classes. Uma boa razo para fazer isto garantir a segurana do
Seriam invlidos os seguintes construtores:
cdigo, como no exemplo abaixo:
//No inicializa posInicializado
public abstract class OperacaoBanco { public Exemplo(String disp) {
//... System.out.println(disp);
private void enviaDados(DadosCliente dc) }
throws ValidacaoException {
//Aqui so realizadas operaes seguras e //Tenta atribuir novamente um valor a uma varivel final
//crticas, como autenticao, compactao etc. public Exemplo(String disp, int valor) {
} System.out.println(disp);
protected abstract DadosCliente coletaDados() { inicializado = valor;
// As subclasses coletam os dados de forma especfica }
}
public final void realizaOperacao()
throws ValidacaoException { Em variveis locais
// importante que estaa operao s seja realizada
//da forma definida nesta classe
Variveis locais final precisam ser inicializadas na declarao e
enviaDados(coletaDados()); no podem depois ter outro valor atribudo. Por exemplo, para
}
}
o seguinte mtodo a segunda linha no permitida:
Nesse exemplo, as subclasses de OperacaoBanco podem definir public void metodo() {
final int i = -1;
diversas maneiras de coletar os dados para operaes especficas, i++; // Erro!
mas no podem mudar a forma como a operao de envio }

32 Java Magazine Edio 6

jm6-book.indb 32 3/4/2003, 17:51:20

 Dicas e pequenas solues
para problemas comuns no
dia-a-dia do desenvolvedor

MICHAEL NASCIMENTO SANTOS

ser interpretadas como uma indicao de

rollback podem porque o container pode
Inlining de mtodos simplesmente descartar a instncia e ten-
Certos trechos podem ser modificados pelo compilador (ou em execuo, pelo JIT) tar utilizar outra no lugar, dependendo das
devido ao uso de final. Isso se aplica especialmente a mtodos. Veja um exemplo: circunstncias em que as excees forem
lanadas.
class Exemplo {
private int a;
Portanto, a nica forma de garantir
public final void setA(int a) { que uma transao seja cancelada,
this.a = a;
} chamar setRollbackOnly() na instncia de
} javax.ejb.EJBContext de seu EJB. Observe que
public class Teste { isso s se aplica a EJBs com transaes
private static void metodoTeste(Exemplo ex) { gerenciadas pelo container (CMT).
ex.setA(5);
}
java.sun.com/docs/books/jls
public static void main(String[] args) {
metodoTeste(new Exemplo()); Java Language Specification (para detalhes
} sobre o uso de final)
}
Visto que o mtodo setA no pode ser redefinido em subclasses, o compilador pode java.sun.com/j2se/1.4.1/docs/guide/
facilmente substituir a chamada ao mtodo em Teste.main pelo seu equivalente. Assim, serialization
o bytecode gerado para ex.setA(5) seria o mesmo que: Serializao
ex.a = 5;
java.sun.com/j2ee/sdk_1.3/techdocs/api/
(Esta uma instruo invlida se usada diretamente no cdigo fonte, mas possvel javax/ejb/EJBContext.html
nos arquivos .class). Descompilar as classes com e sem o uso de final revela o nmero Documentao do mtodo setRollbackOnly
de instrues economizadas.
Michael Nascimento Santos
(michael.nascimento@tesla.com.br) Sun Certified
Programmer for the Java 2 Platform 1.2 & 1.4 e Sun
Certified Web Component Developer for J2EE. H qua-
Recuperando sesses aps quedas Rollback em EJBs tro anos desenvolve com Java, trabalhando com diversas
A maioria dos containers web permite Os desenvolvedores que trabalham arquiteturas e moderador da java-list, lista de discus-
que sesses sejam persistidas e recupera- com Enterprise JavaBeans conhecem so do SouJava, alm de membro individual do JCP e
das mesmo aps uma queda do container. as interfaces javax.ejb.SessionContext e funcionrio da Tesla Tecnologia (www.tesla.com.br).
No entanto, para tirar proveito desse me- javax.ejb.EntityContext, disponveis desde a
canismo, necessrio que todos os objetos primeira verso da especificao de EJB.
armazenados nos objetos HttpSession sejam O mtodo setRollbackOnly() e st em ambas as
serializveis ou seja, suas classes devem interfaces, visto que elas so subinterfaces
implementar a interface java.io.Serializable di- de javax.ejb.EJBContext. Cham-lo indica para
reta ou indiretamente e que sejam tambm o container EJB que o nico final possvel
serializveis todas as suas variveis de para a transao atual um rollback.
instncia no-transientes. Se o seu cdigo A questo que muitos desenvolvedo-
seguir esse padro, provavelmente apenas res acreditam que lanar uma exceo
uma propriedade na configurao de seu qualquer a partir de um dos mtodos
servidor precisar ser alterada para que as de um EJB ir cancelar a transao. Mas
sesses dos usurios sobrevivam s para- no bem assim. Somente excees que
das programadas e s inesperadas. herdam de java.lang.RuntimeException podem

Edio 6 Java Magazine 33

jm6-book.indb 33 3/4/2003, 17:51:21

Ttulo

34 Java Magazine Edio 6

jm6-book.indb 34 3/4/2003, 17:51:23

 Edio 6 Java Magazine 35

jm6-book.indb 35 3/4/2003, 17:51:31

 Asseres no J2S
Garanta a qualidade do cdigo por ante c
A
verso 1.4 do J2SE realmente inovadora. Alm de mui-
tas mudanas e melhorias nas APIs (como a introduo
de logging, expresses regulares e um novo pacote de
I/O), foi introduzida uma mudana na linguagem em si: o uso
de asseres (assertions).
Asseres so usadas para facilitar a realizao de testes de
sanidade (sanity checks) em uma aplicao. Mais precisamente,
servem para testar condies que devem ser sempre verdadeiras
(caso a condio seja falsa, existe um bug no cdigo).
Sintaxe
A sintaxe de asseres em Java muito simples. Uma assero
pode ser feita de duas maneiras:
assert expresso;
ou
assert expresso1: expresso2;
A primeira maneira equivalente a:
if (!expresso)
throw new AssertionError();
Ou seja, caso expresso no seja verdadeira, gerada uma ex-
ceo (do tipo AssertionError).
Com a segunda maneira, necessrio passar, alm da expresso
a ser testada (expresso1), uma descrio (expresso2). O cdigo
equivalente :
if (!expresso1)
throw new AssertionError(expresso2);
Listagem 1. A.java
public class A {
public static void main( String args[] ) {
System.out.println( "A.main()" );
B.main(args);
assert false: "false em A: B deveria ter " +
"terminado a execuo do programa";
} comando :
} $ javac -source 1.4 A.java B.java
Listagem 2. B.java
public class B {
public static void main(String args[]) {
System.out.println("B.main()");
if (false) {
System.exit(0);
} assert false : false em A: B deveria ter terminado a
assert false : "false em B: deveria ter " +
"terminado a execuo do programa";
} [...]
} 4 errors
36 Java Magazine Edio 6
jm6-book.indb 36
A expresso2 pode ser qualquer expresso Java, exceto chamadas
a mtodos void. Como uma assero s til ao desenvolvedor
(ou equipe de suporte tcnico da aplicao em produo), no
necessrio que a descrio faa sentido para o usurio final.
Veja alguns exemplos de asseres:
assert conexao != null;
assert !lista.isEmpty(): lista vazia;
assert a > 0: a <= 0;
Por que a mudana na linguagem?
O leitor pode estar se perguntando por que a linguagem Java
foi modificada para realizar uma tarefa que poderia ser feita
com uma simples combinao if/throw? Veja alguns motivos
para a mudana:
Facilidade de uso muito mais fcil usar assert do que a
combinao if/throw. E quanto mais asseres existirem no c-
digo, maiores as chances de serem detectados erros em tempo
de desenvolvimento;
Flexibilidade o recurso de asseres pode ser habilitado ou
desabilitado em tempo de execuo, tanto globalmente quanto
para pacotes ou classes;
Desempenho caso as asseres estejam desabilitadas, o
custo em desempenho praticamente zero (ao contrrio da al-
ternativa do if/throw, onde a expresso de teste sempre avaliada,
causando impacto significativo).
Usando asseres
Para garantir a mxima compatibilidade com as verses an-
teriores do J2SE, onde assert no era uma palavra-chave, o uso
de asseres est desabilitado por padro, tanto no compilador
quanto na mquina virtual.
Para habilit-las, necessrio passar a opo -source 1.4 ao
javac (similarmente, existe a opo -source 1.3, que a default).
Para compilar o cdigo das Listagens 1 e 2, por exemplo, o
Nesse caso, se no for passada a opo -source 1.4, o compilador
exibir uma mensagem de erro:
$ javac A.java B.java
A.java:7: warning: as of release 1.4, assert is a
keyword, and may not be used as an identifier
execuo do programa;
^
2 warnings
3/4/2003, 17:51:40
S E 1.4 Como usar comandos assert
para detectar erros mais
cedo no desenvolvimento

e cipao
FELIPE LEME
J para a execuo, existem vrias opes disponveis. Veja um Para garantir pr-condies, ps-condies e invariantes
resumo das opes na Tabela 1. Portanto, para executar a classe Asseres facilitam a prtica do design-by-contract, ou seja, elas
A com as asseres habilitadas, usa-se: podem ser usadas para garantir pr-condies (condies que
$ java -ea A devem ser verdadeiras antes de uma operao), ps-condies
(condies que devem ser verdadeiras aps uma operao) e
Esta ser a sada:
invariantes (condies que devem permanecer invariveis).
Veja um exemplo:
A.main()
private double totalComJuros
B.main()Exception in thread main java.lang.Assertion
/* ... */
Error: false em B: deveria ter terminado a execuo do
public void calculeTotalComJuros() {
programa
// pr-condio
at B.main(B.java:9)
assert this.parcelas > 0;
at A.main(A.java:4)
// invariante
assert objetoValido();
Note que possvel combinar opes. Por exemplo, para exe-
cutar a classe A com as asseres habilitadas no pacote default, //Realizar clculos financeiros, alterando totalComJuros
mas desabilitadas na classe B (mostrada na Listagem 2), a // invariante
sintaxe : assert objetoValido();

$ java -ea:... -da:A B // ps-condio

assert this.totalComJuros > this.total;
E a sada: }

Aqui, o mtodo objetoValido checa se as estruturas internas do

A.main()
B.main() Exception in thread main java.lang.Assertion
Error: false em A: B deveria ter terminado a execuo do
programa
at A.main(A.java:5)
Boas prticas
Embora seja simples a sintaxe de assert, pode ser difcil saber
quando usar esse comando. Nesta seo, so listadas as princi-
pais situaes onde devem ser usadas asseres. Sero mostradas
tambm algumas situaes onde no se deve us-las.
objeto so vlidas e se os clculos esto corretos.
Para testar uma condio que voc supe ser verdadeira
Um caso tpico na chamada de um mtodo em um objeto
retornado por outro mtodo. Por exemplo:
Object objeto3 = objeto1.getObjeto2().getObjeto3();
Aqui estamos assumindo que objeto1.getObjeto2() sempre retorna
um objeto no-nulo. Se for retornado null, a aplicao levantar
uma NullPointerException, o que poderia ser evitado usando-se
uma assero.

Item Habilitar asseres Desabilitar asseres

todas as classes exceto as de sistema -ea (ou -enableassertions) -da (ou -disableassertions)

vrias classes -ea: classe... (ou -enableassertions: classe...), usando um -da: classe... (ou -disableassertions: classe), usando um parmetro
parmetro para cada classe para cada classe
pacote default -ea: ... (ou -enableassertions: ...) -da: ... (ou -disableassertions: ...)

pacotes especificados -ea: pacote... ou -enableassertions: pacote...), com um par- -da: pacote... (ou -disableassertions: pacote...), usando um parme-
metro para cada pacote tro para cada pacote
classes de sistema -esa (ou -enablesystemassertions) -dsa (ou -disablesystemassertions)

Tabela 1. Opes para asseres na JVM

Edio 6 Java Magazine 37

jm6-book.indb 37 3/4/2003, 17:51:42

Asseres no J2SE 1.4

assert objeto1.getObjeto2()!= null;

Object objeto3 = objeto1.getObjeto2().getObjeto3();
Para garantir que o valor de uma varivel est em seu domnio vlido
Por exemplo:
assert (tamanho < TAM_MAXIMO && tamanho > TAM_MINIMO):
"tamanho fora da faixa: " + tamanho;
Em declaraes condicionais, para garantir que a condio vlida
Por exemplo:
Idioms de asseres
E mbora as prticas de quando usar (ou no) asseres sejam
comuns em outras linguagens de programao, existem al-
guns casos particulares na linguagem Java. So os chamados
idioms (idiom, nesse caso, refere-se a um padro de codificao
especfico a uma linguagem de programao). Em particular,
destacamos dois idioms para asseres:

Forando a retirada de asserts do arquivo binrio

switch(naipe) {
case Naipe.PAUS: Caso seja necessrio retirar asserts do bytecode de uma classe
// ... no ambiente de produo o que s deve ser feito em casos
break;
case Naipe.COPAS: extremos, quando o tamanho da classe crtico , pode-se usar
// ... a seguinte estrutura:
break;
case Naipe.ESPADAS:
// ... static final boolean usarAssercoes = true;
break; //mude p/ false para retirar asserts do cd. compilado
case Naipe.OURO: if(usarAssercoes) assert expresso;
// ...
break;
default: Caso a varivel useAssercoes seja mudada para false, o compi-
assert false: naipe invlido: + naipe; lador no gerar a declarao de assert (j que a condio do
}
if ser sempre falsa).
ou:
Forando o uso de asseres em tempo de execuo
Em situaes onde necessrio forar o uso de asseres em
String status = comando.getStatus();
assert status!= null; tempo de execuo, use o seguinte idiom na inicializao do
sistema:
if (status.equals(status.OK)) {
// tratar status OK
} else if (status.equals(status.ERROR)) { static {
// tratar status de erro boolean usandoAssercoes = false;
} else { assert usandoAssercoes = true;
assert false: status invlido: + status; if (! usandoAssercoes )
} throw new RuntimeException(
Esta aplicao exige asseres habilitadas);
}

Para checar os parmetros de mtodos no-pblicos

Note que, nesse caso, a expresso do assert uma atribuio
Quando se tem controle sobre quem est acessando um m-
e no uma comparao, o que gera um efeito colateral: a atri-
todo (caso o mtodo seja private ou package, ou se for protected,
buio do valor true para a varivel usandoAssercoes. Caso as as-
sendo a classe com visibilidade package ou protected), possvel
seres estejam habilitadas (em tempo de execuo), a varivel
usar asseres para garantir que os parmetros sejam passados
no ser mudada e a aplicao lanar uma exceo.
corretamente. Veja um exemplo:

class FormValidator { Existe, porm, uma exceo para essa regra: os casos onde uma
// Note que o escopo da classe package e no public
/* ... */
assero esteja verificando algo referente ao sistema de asseres
protected void validate(HttpRequest request) em si (veja um exemplo no quadro Idioms de asseres).
throws ValidationError {
assert request != null; No use asseres para checar parmetros de mtodos pblicos
// validao do request aqui
} Quando no se tem controle sobre quem est acessando seus
/* ... */ mtodos (principalmente em mtodos public), no se deve usar
}
asseres para checar parmetros, por dois motivos:
No use, nas asseres, expresses que gerem efeitos colaterais As asseres servem para checar erros imprevistos, mas o
Asseres devem ser usadas para realizar testes, mas no aes, uso de parmetros invlidos (de um mtodo pblico) um erro
pois os efeitos colaterais no sero executados caso as asseres previsvel;
estiverem desabilitadas em tempo de execuo. Por exemplo: Caso as asseres estejam desabilitadas, a checagem do pa-
rmetro no ter nenhum efeito. Um exemplo:
// forma correta
assert pilha.pop()!= null; public void setParent(Object parent) {
assert parent != null // Incorreto
// forma incorreta this.parent = parent;
Object topo = pilha.pop(); }
assert topo!= null;

38 Java Magazine Edio 6

jm6-book.indb 38 3/4/2003, 17:51:44

 O correto:
java.sun.com/j2se/1.4/docs/guide/lang/assert.html
public void setParent(Object parent) { Guia oficial do J2SE 1.4 sobre asseres
if (parent = = null ) { //Correto
throw new NullPointerException(
objeto pai no pode ser null); www.javalobby.org/members/jdk14/index.jsp
} Download gratuito do livro JDK 1.4 Tutorial ( necessrio registrar-se no site;
this.parent = parent;
} o registro gratuito)
www.manning.com/travis
Concluses Site do livro JDK 1.4 Tutorial (editora Manning)
Embora seja novidade em Java, o uso de asseres j bastante
difundido em outras linguagens (as asseres estavam previstas
na especificao da linguagem Oak, precursora da linguagem
www.javamagazine.com.br/downloads/jm6/jm6-fleme-assercoes.zip
Java). Assim, j existem vrias convenes do que deve ou no
ser feito (as boas e ms prticas); esse artigo visa conscientizar
Felipe Leme (felipeal@iname.com) Engenheiro de Computao, atualmente
o leitor dessas prticas.
trabalhando como Consultor Snior para a Trust Consultores (www.trust.com.br) e
E, como diz Greg Travis (autor do livro JDK 1.4 Tutorial), qual- como instrutor Java para a SeedTS (www.seedts.com).
quer assero melhor que nenhuma!

Edio 6 Java Magazine 39

jm6-book.indb 39 3/4/2003, 17:51:46

 Struts: primeiros
Conceitos, arquitetura e exemplos
N
o desenvolvimento de aplicaes
web, a mistura de cdigo Java
com HTML e JavaScript pode
trazer muitos problemas no desenvolvi-
mento, questo que se agrava quando a
aplicao possui design grfico complexo
e funcionalidades avanadas. Torna-se
difcil a manuteno do cdigo e a inte- flexvel, extensvel e suportado pelas prin-
rao entre a equipe de desenvolvimento
e a de design grfico fica comprometida.
Como solucionar as divergncias, separar
melhor o trabalho das equipes e faz-las
trabalhar com produtividade em suas
especialidades?
Um passo importante padronizar a
arquitetura das aplicaes, usando as
melhores prticas do mercado e evitando
partir do zero. nesse ponto que entram os
frameworks web, entre os quais o Struts do
projeto Apache Jakarta o mais conhecido
e respeitado.
Figura 1. Arquiteturas Model 1 e Model 2
40 Java Magazine Edio 6
jm6-book.indb 40
O framework
Com o nome completo Apache Struts
Web Application Framework, o Struts
muito popular entre os desenvolvedores
de aplicaes web com Java. Alm de ser
software livre e bem documentado (tanto
na web como em diversos livros), o Struts
Viso-Controlador) divide uma aplicao
cipais ferramentas de desenvolvimento
(entre elas JBuilder, Eclipse, JDeveloper,
NetBeans e IDEA).
O Struts baseado em uma variao do
tradicional padro de arquitetura MVC
(Model-View-Controller) e se integra bem,
na camada de apresentao, com outras
tecnologias e frameworks web tais como
JSP, Jakarta Velocity e XSLT. Para a cama-
da de dados, as opes so igualmente
amplas: de JDBC a Enterprise JavaBeans,
passando por JDO.
a arquitetura do Struts que o torna to
extensvel e adaptvel. Antes de entrarmos
nos detalhes sobre o framework, vamos
conhecer um pouco sobre as origens e
caractersticas dos padres adotados.
Arquiteturas e variaes
O padro de arquitetura MVC (Modelo-
em trs partes ou papis: dados e classes
de negcio (modelo), apresentao (viso)
e controle.
Centralizando o controle, o padro MVC
reduz a duplicao de cdigo e simplifica a
manuteno e a evoluo de aplicaes web,
alm de fomentar o reuso dos componentes
da viso e do modelo.
O JSP j suportava parcialmente o padro
MVC, desde a verso 0.91, com a integrao
de JavaBeans com pginas JSP, em um pa-
dro que ficou conhecido como Model 1.
O Model 1, no entanto, no traz uma se-
parao clara entre os papis so apenas
dois componentes (JSPs e JavaBeans) para
desempenhar os trs papis do MVC. O
controle descentralizado e tanto os de-
senvolvedores como os designers precisam
editar pginas JSP, dificultando o trabalho
em equipe e a manuteno. Por apresentar
essas deficincias, a arquitetura Model 1
considerada adequada apenas para apli-
caes pequenas e praticamente estticas,
sem um fluxo complexo de navegao.
Para projetos de grande porte, manter
uma clara separao entre os papis torna-
se muito importante. Isso atingido com
a arquitetura Model 2, que adiciona um
elemento: o controlador. Implementado
geralmente por um servlet, o controlador
tem a responsabilidade de receber solici-
taes, acessar classes de negcio e coor-
denar a gerao do contedo da apresen-
tao (pginas HTML, WML etc.). O pouco
cdigo Java que resta na apresentao (nas
pginas JSP) pode ser substitudo por tags
3/4/2003, 17:52:15
passos Conhea o framework lder
no desenvolvimento web

MIGUEL NGELO GALLINDO, RICHARDSON OLIVEIRA E DANIEL FREITAS

personalizadas, que, para os designers, so

mais fceis de compreender e manter. Fluxo Bsico
Veja uma comparao dos dois padres
de arquitetura na Figura 1.

Em cena, o Struts
O Struts uma implementao completa
e madura do padro de arquitetura Model
2. As melhores prticas dos Blueprints da
Sun (veja links) recomendam que aplica-
es web, ou a camada web de aplicaes
J2EE, sejam implementadas usando um
framework web MVC. E o Struts citado
vrias vezes como uma alternativa robusta
para isso.
O framework fornece um controlador
constitudo por trs elementos princi-
pais: o ActionServlet (servlet controlador),
o RequestProcessor e as classes de ao, ou
Actions. O ActionServlet e o RequestProces-
sor so fornecidos prontos pelo framework;
as aes devem ser implementadas pelo de-
senvolvedor estendendo a classe abstrata 1. No navegador web, submetido um for- 4. A classe de ao escolhida instanciada
Action. So as aes as responsveis por mulrio (ou clicado um link), gerando uma e chamado seu mtodo execute;
acessar o modelo, fazendo a ligao entre requisio recebida pelo ActionServlet, que 5. So realizadas as chamadas ao modelo
a lgica de negcio e o servlet. determina se h necessidade de instanciar (JavaBeans ou EJBs, por exemplo);
um ActionForm para encapsular os dados 6. Ao final da execuo, a ao retorna
De modo similar, o Struts fornece os
contidos na requisio, e identifica a ao um objeto ActionForward, indicando para
ActionForms, JavaBeans criados pelo de-
responsvel pelo seu processamento. As o ActionServlet que outra ao deve ser
senvolvedor, que tm suas propriedades
duas tarefas so realizadas baseando-se executada (retornando ao passo 4), ou que
preenchidas automaticamente pelo Struts
nos mapeamentos definidos no arquivo uma pgina deve ser exibida (continuando
a partir de formulrios HTML. Os Action-
struts-config.xml; com o passo 7);
Forms fazem a ponte entre a viso (pginas
2. Caso seja necessrio popular um Ac- 7. Se tiver sido indicada uma pgina, ela
JSP) e o controlador (aes e servlet). tionForm, recuperada uma instncia pr- processada para gerar a resposta requisi-
Alm desses, o Struts inclui uma srie existente da sesso (criada numa invocao o original, ou exibida a pgina original
de elementos adicionais importantes, anterior da mesma URL, por exemplo) ou com erros de validao;
como um pool de conexes (configurado gerada uma nova instncia. O ActionForm 8. A pgina consulta os JavaBeans inseri-
no arquivo struts-config.xml), e uma vasta ento populado com os parmetros da dos pela ao na requisio ou na sesso
bibliotecas de tags, contemplando prati- requisio; (esses objetos so fornecidos como respos-
camente todas as tarefas necessrias no 3. O mtodo validate do ActionForm ta pelo modelo ou construdos pela ao);
desenvolvimento de pginas JSP. chamado e, caso retorne algum erro 9. O resultado final (geralmente cdigo
(encapsulado em objetos ActionError), a HTML) enviado para o navegador, e o
Fluxo de uma aplicao Struts pgina original reexibida (passo 7), caso usurio pode prosseguir interagindo com
O ActionServlet o nico servlet de uma contrrio o processamento continua; a aplicao.
aplicao construda com o Struts. O arqui-

Edio 6 Java Magazine 41

jm6-book.indb 41 3/4/2003, 17:52:24

Struts: Primeiros passos

da sesso HTTP, estando portanto dispo-

Listagem 1. index.jsp nveis tanto para as aes responsveis
<%@ page language=java %> por processar a requisio quanto para
<!-- tlds das tags do struts --> as pginas JSP responsveis por exibir o
<%@ taglib uri=/WEB-INF/struts-bean.tld prefix=bean %>
<%@ taglib uri=/WEB-INF/struts-html.tld prefix=html %> resultado.
<html:html locale=true>
O quadro Fluxo bsico apresenta o flu-
xo de controle de uma aplicao baseada no
<head>
<!- a tag bean:message retorna uma mensagem Struts (a figura se baseia na documentao
armazenada no arquivo application.properties--> do framework).
<title><bean:message key=index.title/></title>
<html:base/>
</head> Obteno e instalao
<body bgcolor=white> Usaremos a verso 1.1 do Struts, e o Tom-
<h3><bean:message key=application.name/></h3> cat 4.1 (veja a coluna Java Livre nesta
<hr>
<html:link page=/listar.do> edio para mais informaes sobre como
<bean:message key=link.list/></html:link><br>
<html:link page=/preencheform.do>
instalar e configurar o Tomcat). O Struts
<bean:message key=link.register/></html:link> pode ser baixado em jakarta.apache.org/site/
</body>
</html:html> binindex.cgi. Aps descompactar o pacote
zip, voc ter uma rvore de diretrios
Listagem 2. Mapeamento das aes no struts-config.xml
semelhante mostrada na Figura 2
<global-forwards> Observe na figura os arquivos subli-
<forward name=excecoes path=/jsp/error.jsp/>
. . . nhados em vermelho. No struts.jar ficam
</global-forwards> as classes do framework, arquivos *.tld
<action-mappings>
<action path=/listar (com as definies das bibliotecas de tags)
type=br.com.recjug.exemplostruts.actions.ListarAction> e arquivos de propriedades. Este jar ne-
<forward name=sucesso path=/jsp/lista.jsp/>
</action> cessrio para a distribuio de aplicaes
<action path=/preencheform baseadas no Struts.
type=br.com.recjug.exemplostruts.actions.PreencheFormAction>
<forward name=cadastro path=/jsp/cadastro.jsp/>
</action>
...
Aplicao inicial
</action-mappings> Um bom ponto de partida para criar uma
aplicao Struts o arquivo struts-blank.war,
Listagem 3. Ao responsvel por obter a listagem de funcionrios
uma aplicao web vazia com os princi-
public final class ListarAction extends Action { pais arquivos necessrios e configuraes
public ActionForward execute(ActionMapping mapping,
ActionForm form, padro. Faa uma cpia deste arquivo para
HttpServletRequest req,
HttpServletResponse res) throws Exception {
o diretrio webapps do Tomcat. Ao iniciar o
try { Tomcat o war ser descompactado (certifi-
FachadaModelo fachada = FachadaModelo.getInstance();
Collection funcs = fachada.getFuncionarios();
req.getSession(true).setAttribute(funcs, funcs);
return mapping.findForward(sucesso);
}
catch (SQLException e) {
ActionErrors erros = new ActionErrors();
erros.add(ActionErrors.GLOBAL_ERROR, new ActionError(errors.sqlerror));
saveErrors(req, erros);
return mapping.findForward(excecoes);
}
}
}

vo web.xml deve conter um mapeamento sveis pelo seu processamento. Escolhida

genrico, direcionando pginas diferentes
da aplicao para esse servlet. Em geral
utilizado o padro de URL (URL pattern)
*.do.
Quando o ActionServlet recebe uma re-
quisio, ela repassada para o Request-
Processor, que processa e valida os dados
recebidos. No arquivo struts-config.xml, so
mapeadas as URLs para as aes respon-
a ao, ela instanciada e em seguida
chamado seu mtodo execute, que realiza
chamadas ao modelo. Ao final da execuo,
a ao retorna uma indicao para o contro-
lador sobre qual viso deve ser exibida.
Tambm no struts-config.xml, so listados
os ActionForms que devem ser instancia-
dos e populados para cada URL. Estes so
inseridos como atributos da requisio ou Figura 2. A rvore de diretrios do Struts 1.1

42 Java Magazine Edio 6

jm6-book.indb 42 3/4/2003, 17:52:39

 que-se de que sua instalao do Tomcat URLs /preencheform.do e
est configurada para tal); teremos uma /listar.do para montar os Listagem 4. Acesso aos elementos de uma coleo
rvore de diretrios semelhante mos- links. <%@ page language=java %>
trada na Figura 3. As aes listadas na p- <%@ taglib uri=/WEB-INF/struts-logic.tld prefix=logic %>
...
importante destacar dois arquivos gina inicial no possuem <h2>Lista de funcionrios cadastrados</h2>
nessa estrutura: struts-config.xml (j apre- formulrio associado. A <table border=1>
<tr>
sentado) e application.properties. Este lti- primeira, /listar.do, faz a <th>Nome</th>
<th>Email</th>
mo o arquivo de propriedades utilizado consulta base e retorna os <th>Cargo</th>
pelo Struts para a definio de mensa- funcionrios cadastrados. <th>Sexo</th>
</tr>
gens personalizadas, que levam em con- A ao /preencheform.do re- <logic:iterate id=func name=funcs>
siderao o idioma e a regio geogrfica torna uma Collection conten- <tr>
<td><jsp:getProperty name=func property=nome/></td>
(Locale) do cliente que estiver acessando do os cargos disponveis <td><jsp:getProperty name=func property=email/></td>
a aplicao. As mensagens definidas nes- na empresa, que usada <td><jsp:getProperty name=func property=cargo/></td>
<td><jsp:getProperty name=func property=sexo/></td>
te arquivo so inclusas nas pginas JSP na pgina de formulrio </tr>
por meio dos tags da biblioteca <html:>. </logic:iterate>
para alimentar um <se- </table>
Podemos fornecer mensagens em outros lect> HTML. A Listagem ...
idiomas incluindo na aplicao arquivos 2 mostra como estas duas Listagem 5. Trecho do mtodo perform da ao que obtm a listagem de cargos
da forma application_xx.properties onde aes so configuradas no ...
xx o cdigo padro de localidades, por arquivo struts-config.xml. FachadaModelo fachada = FachadaModelo.getInstance();
Collection cargos = fachada.getCargos();
exemplo en_US ou pt_BR. A tag action possui seis req.getSession(true).setAttribute(cargos, cargos);
Nota: o arquivo web.xml da aplicao atributos, mas quando no return mapping.findForward(cadastro);
...
struts-blank j fornece o ActionServlet con- existe associao a formu-
figurado para o mapeamento padro lrios, apenas dois so usa- Listagem 6. Usando as tags <html:options> e <html:select>
*.do e normalmente no necessita ser dos: path e type. O atributo <html:form action=/cadastre>
alterado pelo desenvolvedor. path informa a URL a partir <table><tr>
<td>Nome:</td><td>
da qual a ao ser chama- <html:text property=nome/>
Ponto de entrada da. O parmetro type infor- <html:errors property=nome/> </td>
</tr>
Nossa aplicao de exemplo bastante ma ao servlet qual classe de ...
simples: consiste de um cadastro e uma <tr>
ao ser instanciada. Cada <td>Cargo:</td>
listagem de funcionrios. Veja a navega- tag action pode conter tags <td>
o bsica da aplicao na Figura 4. <html:select property=cargo>
forward indicando outras <html:options collection=cargos
Vamos comear com o ponto de en- aes ou vises que podem property=idCargo
labelProperty=nome/>
trada, a pgina index.jsp (mostrada na ser executadas aps a pr- </html:select>
Listagem 1). Observe que usamos as pria ao. No exemplo cada </td>
</tr><tr>
ao especifica uma pgi- <td><html:submit/></td>
<td><html:reset/></td>
na diferente para exibir o </tr>
resultado da requisio. </table>
</html:form>
Tambm possvel definir
forwards globais dentro do
Listagem 7. Associando os ActionForms s aes no struts-config.xml
tag global-forwards.
A Listagem 3 mostra o <form-beans>
<form-bean name=cadastreForm
cdigo da ao ListarAction, type=exemplostruts.struts.forms.CadastreForm/>
...
que est associada URL </form-beans>
/ listar.do. Seu mtodo <action-mappings>
...
execute pode realizar dois <action type=exemplostruts.struts.actions.CadastreAction
forwards: o forward local path=/cadastre name=cadastreForm
scope=request validate=true
sucesso para o caso de input=/jsp/cadastro.jsp>
tudo ocorrer conforme o <forward name=sucesso path=/listar.do/>
</action>
esperado, que, como defi- ...
nido no struts - config.xml, </action-mappings>
exibe a pgina /jsp/lista.jsp;
ou caso ocorram excees, o forward global modelo, uma listagem de funcionrios, que
excecoes. retornada em uma coleo e adicionada
Figura 3. Estrutura da aplicao struts-blank.war O propsito da ao ListarAction obter, do sesso HTTP do usurio com o nome

Edio 6 Java Magazine 43

jm6-book.indb 43 3/4/2003, 17:52:41

Struts: Primeiros passos

arquivo struts-config.xml, que a ao pos-

Listagem 8. Mtodos validate e reset sui um ActionForm associado (Listagem
public class CadastreForm extends ActionForm { 7). O mtodo validate deste ActionForm
private String cargo; invocado e, caso ocorram erros, retorna
private String email;
private String nome; um objeto do tipo ActionErrors (Listagem
private String sexo; 8) de modo similar ao realizado pela ao
// Mtodos get e set omitidos de listagem. Estes erros so exibidos pelas
public void reset(ActionMapping mapping, HttpServletRequest request) {
tags <html:errors> na pgina de cadastro.
String cargo = ; String email = ; Se os dados forem validados correta-
String nome = ; String sexo = ;
} mente, a ao CadastreAction (no exibida
public ActionErrors validate(ActionMapping mapping, nas listagens) inclui o novo funcionrio
HttpServletRequest request) {
ActionErrors erros = new ActionErrors(); e retorna para a pgina de listagem dos
if (email == null || email.trim().equals()) { funcionrios.
erros.add(email, new ActionError(errors.emptyemail));
} Chegamos ao fim de nosso pequeno
if (nome == null || nome.trim().equals()) { exemplo. O fonte completo, incluindo ins-
erros.add(nome, new ActionError(errors.emptynome));
} trues de instalao, pode ser baixado do
if (cargo == null || cargo.trim().equals()) {
erros.add(cargo, new ActionError(errors.emptycargo));
site da Java Magazine.
}
if (sexo == null || sexo.trim().equals()) {
erros.add(sexo, new ActionError(errors.emptysexo));
Concluses
} Existem muitos frameworks para desen-
return erros;
} volvimento web, como Turbine, Tapestry e
} Webmacro (com objetivos e especialidades
diferentes), mas o Struts vem se tornando
funcs. Em caso de erro, a ao instancia de scriptlets, usaremos um tag de iterao um padro mundial pelo poder de seus
um objeto da classe ActionErrors que in- para percorrer todos os elementos. Veja na recursos, facilidade de uso e pelos ganhos
serido na requisio. O mtodo add dessa Listagem 4 o trecho de cdigo que gera a de produtividade que traz.
classe recebe dois argumentos: o primeiro lista de funcionrios. Este parte da pgina Este artigo mostrou apenas conceitos
classifica o erro, que pode assim receber /jsp/lista.jsp executada em resposta ao bsicos do Struts. H muitas outras fun-
tratamento diferenciado pelas vises, e o /listar.do. cionalidades, como formulrios dinmicos,
segundo indica qual mensagem do arquivo O atributo name da tag <logic:iterate> subprojetos, templates e tiles, alm das mui-
application.properties ser exibida para o usu- especifica (como esperado) o nome sob tas novidades da verso 1.1. Certamente,
rio. A constante ActionErrors.GLOBAL_ERROR o qual a coleo foi inserida na sesso existe material suficiente para vrios novos
usada para informar a aplicao sobre erros (ou na requisio no objeto implcito artigos.
inesperados. request do JSP). A cada iterao, um Java-
Bean disponibilizado e o corpo da tag
Listagem de funcionrios processado. O nome do bean informado
Nesta parte do exemplo, vemos como as atravs da propriedade id e pode ser utili- jakarta.apache.org/struts
tags do Struts facilitam bastante o desen- zado em tags <jsp:getProperty>. Stuts: documentao, downloads e referncias
volvimento. Na sesso do usurio temos
nossa coleo contendo os dados dos fun- Cadastro de funcionrios java.sun.com/blueprints
cionrios da empresa e queremos exibir Na ao de cadastro, obtemos a cole- Java Blueprints: diretrizes, padres e exemplos
o cargos, que tambm colocada na seguindo as melhores prticas recomendadas
esses dados na pgina. Para isso, em vez
sesso do usurio (veja a Listagem 5).
pela Sun
Esta coleo utilizada pela pgina de
viso /jsp/cadastro.jsp (Listagem 6) para www.javamagazine.com.br/downloads
preencher um <select> que faz parte do /jm6/jm6-varios-struts
formulrio de cadastro de funcionrios. O
Struts fornece uma tag bastante til para
essa tarefa, <html:select> que, em conjunto
Daniel Freitas (freitas@facilit.com.br), Miguel ngelo
com a tag <html:options>, monta a lista de
Gallindo (miguel@facilit.com.br) e Richardson
acordo com as propriedades desejadas de Oliveira (richardson@facilit.com.br) so certificados
cada objeto na coleo. pela Sun (SJCP) e engenheiros de software da Facilit
Quando ocorre a submisso da pgina, Tecnologia (www.facilit.com.br).
Figura 4. Pginas JSP da aplicao de exemplo o controlador determina, pela leitura do

44 Java Magazine Edio 6

jm6-book.indb 44 3/4/2003, 17:52:44

 Edio 6 Java Magazine 45

jm6-book.indb 45 3/4/2003, 17:53:28

 Automao com X D
Livre-se da codificao repetitiva
D
iversas reas da programao em
Java tm uma caracterstica bem
distinta: o uso de cdigo baseado
em modelos ou templates aquelas classes
que voc sempre acaba copiando de um
exemplo, ou cria baseando-se em padres
de projeto bem conhecidos. medida que
um projeto cresce, a criao dessas classes
se torna apenas trabalho repetitivo. Esse
o cenrio ideal para a aplicao e uma
ferramenta de gerao de cdigo como o
XDoclet.
Origens
Visando livrar o programador do traba-
lho repetitivo no desenvolvimento de EJBs,
Rickard berg criou uma ferramenta cha-
mada ejbdoclet, que gerava interfaces de
componentes e seus deployment descriptors.
O ejbdoclet ganhou fora e, com a idia
de levar a gerao automtica de cdigo vedores na Alemanha, Frana, Noruega,
a outras reas da programao, nasceu o
XDoclet.
Figura 1. Arquitetura e fluxo do XDoclet
46 Java Magazine Edio 6
jm6-book.indb 46
Figura 2. JBossIDE mostrando as tags XDoclet disponveis para um EJB
Hoje, berg no participa mais do desen-
volvimento da ferramenta, mas o projeto
atraiu um grupo de programadores ao
redor do mundo, tornando a equipe do
projeto verdadeiramente internacional. O
XDoclet conta atualmente com desenvol-
de um Enterprise JavaBean: as interfaces, a
Rssia, Brasil e Estados Unidos, entre
vrios outros pases.
@tags: metadados saber sobre um componente fica em um
para o cdigo
Informaes
so fornecidas ao
XDoclet atravs
da marcao do
cdigo fonte com
tags semelhantes
s usadas para
gerar documen-
tao usando a
ferramenta javadoc.
As tags adicionam
metadados ao c-
digo existente so
esses metadados a
fonte de informa-
o para a gerao
de arquivos pelo
XDoclet.
Com o XDoclet, voc passa a ver os co-
mentrios de seu cdigo com outros olhos.
Eles passam a complementar o significado
dos programas, expressando coisas que a
linguagem Java no consegue expressar,
tais como as relaes entre as vrias partes
classe de implementao e os deployment
descriptors. A principal vantagem de
um modelo como esse a centralizao
da informao. Tudo o que voc precisa
nico local: a classe de implementao do
componente.
Algumas das principais tags do XDoclet
usadas na programao de EJBs so:
@ejb.bean fornece informaes gerais
sobre um componente EJB, como o tipo de
componente, seu nome, localizao no
JNDI, tipos de interface (local ou remota)
e chave primria;
@ejb.finder define mtodos de pesqui-
sa (finders) para um entity bean;
@ejb.persistence especifica parme-
tros de persistncia para um entity bean,
tais como o nome da tabela em que o bean
persistido, ou o nome da coluna em que
persistida cada propriedade.
Arquitetura
No corao do XDoclet, est o template
3/4/2003, 17:53:42
X Doclet Retirar do programador a tarefa de
criar cdigo repetitivo, adicionan-
do mais significado ao cdigo o
objetivo do XDoclet

MARCUS BRITO

Instalao e uso Voc precisar escrever um arquivo de

A URL para download do
XDoclet :
sourceforge.net/project/
s h o w f i l e s.p h p ?g ro up_
id=31602.
Baixe a verso mais recen-
te, com o nome xdoclet-bin-
<verso>.zip. O pacote con-
tm diversos arquivos .jar,
com as classes do XDoclet
e todos os seus mdulos.
Basta ento descompactar
o zip em um diretrio
sua escolha.
O XDoclet executado
Figura 3. Middlegen: gerao de cdigo integrada ao XDoclet como uma tarefa do Ant.
build (buildfile) do Ant que chama as fun-
cionalidades do XDoclet (conhea mais
sobre o Ant no artigo Builds com Ant,
na Edio 2).
O diretrio onde foi feita a descompac-
tao ser usado para construir o classpath
de execuo do XDoclet no buildfile. Para
o exemplo a seguir, vamos supor que
voc descompactou o zip no diretrio
c:\xdoclet.
EJB a partir de uma classe
Vamos montar um exemplo simples:
escrever a classe de um EJB incluindo as
tags do XDoclet, executar a ferramenta e
compilar o projeto. Note que importante

engine (mecanismo de templates), respon-

Listagem 1. ProdutoEJB.java: EJB com tags do XDoclet
svel pela interpretao dos modelos de
cdigo usados como base para a gerao. package jm;
Os templates so escritos numa sintaxe /**
particular ao XDoclet e fazem uso de tag * Um EJB representando um produto num sistema comercial (PDV)
*
handlers (manipuladores de tags), classes * @ejb.bean
que fornecem os dados necessrios para * type=CMP
* name=Produto
os templates. Ligado aos tag handlers est * primkey-field=produtoId
o xjavadoc, um analisador de cdigo Java * @ejb.persistence
* table-name=produto
responsvel por fornecer aos handlers */
public abstract class ProdutoEJB implements javax.ejb.EntityBean {
informaes sobre as tags utilizadas na /**
marcao do cdigo fonte. * O cdigo do produto.
*
A execuo de um template do XDoclet * @ejb.interface-method view-type=local
segue este fluxo: o engine carrega um * @ejb.persistence column-name=prod_id
*/
template, identifica os tag handlers utiliza- public abstract Integer getProdutoId();
dos nele e executa os tag handlers medida
public abstract void setProdutoId(Integer id);
que prossegue analisando o template. Os
handlers fazem uso do xjavadoc para obter /**
* A descrio do produto.
as informaes necessrias (as @tags) e ge- *
ram o resultado final. Veja a Figura 1. * @ejb.interface-method view-type=local
* @ejb.persistence column-name=prod_descricao
A arquitetura do XDoclet torna-o bastan- */
public abstract String getDescricao();
te flexvel. Se for necessrio modificar a for-
ma como gerado algum elemento, basta /**
* @ejb.interface-method view-type=local
modificar o template usado para ger-lo; se */
voc quiser que o XDoclet gere novos ele- public abstract void setDescricao(String descricao);
}
mentos, basta escrever mais um template e
opcionalmente alguns tag handlers.

Edio 6 Java Magazine 47

jm6-book.indb 47 3/4/2003, 17:53:45

Automao com XDoclet

entender um pouco sobre EJB para acom-

Listagem 2. build.xml: exemplo de buildfile para execuo do XDoclet para um EJB
panhar esse exemplo. Um exemplo mais
<project name=javamagazine basedir=. default=jar> extenso, demonstrando recursos adicio-
<!-- Diretrio onde esto guardados os .java -->
<property name=fontes.dir value=src/> nais, est disponvel para download no
site da Revista.
<!-- Onde o xdoclet vai gerar .java -->
<property name=srcgen.dir value=target/src-gen/> A Listagem 1 mostra o cdigo fonte de
um EJB marcado com @tags. um entity
<!-- Onde as classes sero compiladas -->
<property name=classes.dir value=target/classes/> bean CMP chamado Produto, com ape-
<!-- Onde o xdoclet vai gerar .xml -->
nas duas propriedades. Crie um diretrio
<property name=metainf.dir value=target/meta-inf/> para o exemplo usaremos xd e den-
<!-- Diretrio de instalao do xdoclet --> tro dele um diretrio com nome src. Para
<property name=xdoclet.dir value=c:\xdoclet/> manter a estrutura de pacotes, crie tambm
<property name=xdoclet.lib.dir value=${xdoclet.dir}/lib/> um diretrio src/jm. Neste ltimo, salve
<property name=xdoclet.samples.lib.dir value=${xdoclet.dir}/samples/lib/> o arquivo ProdutoEJB.java, mostrado na
<path id=xdoclet.path> listagem.
<fileset dir=${xdoclet.lib.dir} includes=**/*.jar/>
<fileset dir=${xdoclet.samples.lib.dir} includes=**/*.jar/>
A Listagem 2 mostra o buildfile (build.xml)
</path> que cria os diretrios necessrios, executa
<target name=init> o XDoclet e compila todo o cdigo fonte
<mkdir dir=${classes.dir}/> resultante. Salve esse arquivo no diretrio
<mkdir dir=${metainf.dir}/>
<mkdir dir=${srcgen.dir}/> "xd. Voc j pode executar o XDoclet,
usando o comando ant (o processo fica
<taskdef
name=ejbdoclet mais simples se voc colocar o diretrio
classname=xdoclet.modules.ejb.EjbDocletTask
classpathref=xdoclet.path/>
bin do Ant no path do sistema).
</target> So gerados dois arquivos, um no
<target name=xdoclet depends=init> diretrio target/src-gen e outro no diretrio
<ejbdoclet destdir=${srcgen.dir} ejbspec=2.0> target/meta-inf (esses diretrios foram espe-
<fileset dir=${fontes.dir} includes=**/*.java/>
<localinterface/> cificados no buildfile). Dentro de src-gen,
<localhomeinterface/> so criadas as interfaces local e local home
<deploymentdescriptor destdir=${metainf.dir} xmlencoding=ISO-8859-1>
<configParam name=Description value=Exemplo para Java Magazine/> do EJB; em meta-inf criado o arquivo
</deploymentdescriptor>
</ejbdoclet> ejb-jar.xml. As Listagens 3 e 4 mostram o
</target> contedo das interfaces geradas (o arqui-
<target name=compile depends=xdoclet> vo XML foi omitido e est disponvel para
<javac download).
destdir=${classes.dir}
classpathref=xdoclet.path
srcdir=${fontes.dir}:${srcgen.dir}/>
</target> Integrao com ferramentas
difcil memorizar todas as tags que
</project>
podem ser usadas com o XDoclet. Para
auxiliar o programador, alguns projetos
Listagem 3. ProdutoLocalHome.java
esto surgindo para integrar o XDoclet
/*
* Generated by XDoclet - Do not edit!
com outras ferramentas e facilitar a inclu-
*/ so das tags. Atualmente o mais completo
package jm;
o JBossIDE (Figura 2), um plugin para
/** o IDE Eclipse que facilita o deployment
* Local home interface for Produto.
*/ de aplicaes no JBoss e auxilia o progra-
mador, mostrando as tags disponveis e
public interface ProdutoLocalHome
extends javax.ejb.EJBLocalHome completando-as automaticamente. Mais
{
plugins esto sendo desenvolvidos para
outras ferramentas de desenvolvimento,
public static final String COMP_NAME=java:comp/env/ejb/ProdutoLocal;
public static final String JNDI_NAME=ProdutoLocal; como o IntelliJ IDEA e o Borland JBuilder.
O XDoclet tambm excelente para a au-
public jm.ProdutoLocal findByPrimaryKey(java.lang.Integer pk)
throws javax.ejb.FinderException; tomao de projetos que seguem a idia de
integrao contnua veja o quadro ciclo
}
de desenvolvimento com XDoclet.

48 Java Magazine Edio 6

jm6-book.indb 48 3/4/2003, 17:53:47


Listagem 4. ProdutoLocal.java
/*
* Generated by XDoclet - Do not edit!
*/
package jm;
/**
* Local interface for Produto.
*/
public interface ProdutoLocal
extends javax.ejb.EJBLocalObject
{ cdigo, mas tambm na padronizao e na
/**
* A descrio do produto.
*/
public java.lang.String getDescricao( ) ;
/**
* O cdigo do produto.
*/
public java.lang.Integer getProdutoId( ) ;
public void setDescricao(java.lang.String descricao) ;
} Editora Campus, 2002
Abrangncia
Um dos projetos mais interessantes para
aqueles que esto explorando o XDoclet
o xPetstore, uma verso do famoso ex-
emplo Java Petstore da Sun, mas usando
uma arquitetura diferente. um projeto
J2EE completo, criado usando projetos de
software livre, como o Struts e o Sitemesh
(veja links).
Outro projeto importante em que o XDo-
clet vem ganhando terreno no servidor
de aplicaes JBoss. Ele desempenha um
papel importante no desenvolvimento do
Ciclo de desenvolvimento com XDoclet
N o desenvolvimento de um grande
projeto, importante no quebrar o
que j est funcionando, ou seja, preciso
testar continuamente o sistema, garantin-
do que modificaes no afetem partes em
funcionamento.
A integrao contnua, defendida pelo
guru de orientao a objetos Martin Fow-
ler, leva essa idia ao mximo, rezando que
deve ser possvel, a qualquer momento, re-
alizar todas as etapas do ciclo de implemen-
tao de um projeto (compilao, execuo,
testes etc.), de forma automatizada.
O Ant uma excelente ferramenta para a
prtica da integrao contnua. E o XDoclet
se encaixa bem neste cenrio, pois, como
mostrado neste artigo, a sua execuo
jm6-book.indb 49
JBoss e boa parte do cdigo do servidor
hoje gerado com auxlio do XDoclet.
Existem tambm ferramentas comple-
mentares, como o Middlegen (veja a Figura
3), uma ferramenta de gerao de cdigo
a partir de bancos de dados. O cdigo ge-
rado pelo Middlegen marcado com tags
XDoclet para processamento posterior.
Por exemplo, voc pode usar o Middlegen
para gerar entity beans a partir do banco
de dados e usar o XDoclet para gerar ou-
tros arquivos. Vale lembrar que o criador
do Middlegen (Aslak Hellesy) tambm
sempre orientada por uma tarefa do Ant.
Assim, um buildfile do Ant bem construdo
torna a gerao de cdigo com o XDoclet
em apenas mais uma etapa automatizada
no processo de integrao contnua do
projeto.
A gerao de cdigo traz mais um benef-
cio importante alm de poupar o tempo
dos programadores, fica mais fcil reforar
o uso de padres de projeto se o cdigo
gerado j utilizar esses padres.
O XDoclet utiliza alguns padres e Marcus Brito (pazu@animegaiden.com.br) mem-
boas prticas nas suas tarefas. As tarefas
<utilobject> e <valueobject>, por exemplo,
so implementaes dos padres Service Unitech (www.unitech.com.br), onde presta servios
Locator e Value Object, como apresentados
no livro Core J2EE Patterns (veja livros).
um dos desenvolvedores do XDoclet, o
que explica a integrao prxima entre as
ferramentas.
Concluses
O uso do XDoclet pode trazer um grande
ganho de produtividade, especialmente
se j for utilizado o Ant em seus projetos.
A ferramenta ajuda no s na gerao de
documentao, auxiliando na implemen-
tao de padres de projeto estabelecidos
e concentrando, num s lugar, todas as
informaes a respeito de um componente
do sistema.
Core J2EE Patterns, Deepak Alur et al,
www.xdoclet.org
Pagina principal do XDoclet.
www.martinfowler.com/articles/
continuousIntegration.html
Integrao contnua
ant.apache.org
Apache Ant
www.jboss.org
JBoss, servidor J2EE livre e integrado com o
XDoclet
sourceforge.net/projects/jboss
Downloads do JBoss, incluindo o plugin JBossIDE
xpetstore.sourceforge.net
Exemplo de uso do XDoclet em um projeto J2EE
jakarta.apache.org/struts
Struts, framework para aplicaes web
www.opensymphony.com/sitemesh
Sistema de layout para web
boss.bekk.no/boss/middlegen
Middlegen: gerao de cdigo a partir de um
banco de dados
www.javamagazine.com.br/downloads
/jm6/jm6-mbrito-xdoclet.zip
bro ativo da equipe de desenvolvedores do XDoclet
e programador Java, atualmente trabalhando na
Telebahia Celular em anlise e desenvolvimento de
projetos J2EE.
Edio 6 Java Magazine 49
3/4/2003, 17:53:48
 Jakarta Velocity
Acabe com a briga com os designers

U
ma das reas em que o desenvol-
vimento de aplicaes web com
Java mais encontra problemas
na separao entre a camada de controle,
que faz as chamadas lgica de negcio, e
a camada de apresentao, onde realizada
a montagem da interface web.
Uma forma eficaz de fazer essa separao
usando sistemas de templates (template
engines). O framework Jakarta Velocity do
Grupo Apache um dos mais populares
desses sistemas, e pode ser usado tanto em
aplicaes web quanto locais.

Sistemas de templates
Pode-se fazer muito com um sistema de
templates desde a gerao de simples ar-
quivos-texto criao de arquivos binrios,
tudo o que siga um determinado padro
de formatao. Pode-se gerar cdigo-fonte
de alguma linguagem, XML, HTML, docu-
mentos RTF e muitos outros. Por exemplo,
o Poseidon for UML, ferramenta CASE
desenvolvida em Java, usa o Velocity para
a gerao de cdigo a partir de diagramas
UML.
Usar templates tem uma srie de van-
tagens: existe uma melhor designao
de tarefas, pois os programadores ficam
Diretivas da VTL
#set($varivel = valor)
Atribui um valor a uma varivel.
#foreach ($varivel in $ itens) ... #end
Percorre uma coleo, iterator ou array,
atribuindo o elemento atual a $varivel.
#if(condio) ... #else ... #end
Condicional padro da VTL. Diferente-
mente de Java, a condio no precisa
retornar um valor booleano (para objetos,
null considerado como false). O uso do
#else opcional.
#include(arquivo)
Inclui o contedo de um arquivo no corpo
Figura 1. O processo de merge
concentrados na lgica do sistema e os
designers se preocupam apenas com o
layout, o que reduz o risco de alterarem
indevidamente o cdigo da aplicao. Alm
disso, os templates ficam em arquivos se-
parados, possibilitando mudar o visual da
aplicao sem a necessidade de recompilar
do template, sem fazer o parse. Usada
para incluir cdigo esttico.
#parse(arquivo)
Inclui o contedo de um arquivo no corpo
do template e faz o parse do cdigo VTL
existente no arquivo.
Nota: existe ainda a diretiva #stop, mas seu
uso no mais recomendado.
Voc pode ver mais detalhes sobre todas
as diretivas da VTL no VTL Reference
Guide em jakarta.apache.org/velocity/vtl-
reference-guide.html.
ou reiniciar o sistema.
Mas o que exatamente so templates? So
arquivos com grande parte de sua estru-
tura e formatao pronta, contendo dire-
tivas indicando valores a serem inseridos
e aes a serem realizadas pelo sistema
de templates. Com diretivas, possvel,
por exemplo, mostrar o contedo de uma
varivel, navegar em listas e arrays, ou at
mesmo invocar mtodos de objetos.
Diretivas so a parte principal da Velocity
Template Language (VTL) veja mais so-
bre essa linguagem no quadro Diretivas
da VTL.
Funcionamento bsico
Uma aplicao que usa o Velocity executa,
basicamente, os seguintes passos: inicializa
o sistema de templates, cria um contexto,
adiciona a ele objetos, carrega um template
e realiza o merge (veja a Figura 1).
Os contextos so a forma usada no
Velocity para fornecer dados para o
mecanismo de templates. Um contexto

50 Java Magazine Edio 6

jm6-book.indb 50 3/4/2003, 17:53:50

 O uso de templates na camada de
apresentao de aplicaes web
simplifica a manuteno e a sepa-
rao de responsabilidades

PAULO SILVEIRA E RAFAEL STEIL

merge (mistura ou intercalao), o

Listagem 1. ProcesaEmpregados.java Velocity interpreta as diretivas e extrai os
import org.apache.velocity.app.VelocityEngine; dados necessrios do contexto, gerando a
import org.apache.velocity.VelocityContext; sada desejada.
import org.apache.velocity.Template;

import java.io.*;
import java.util.ArrayList;;
Obteno e instalao
O download da ltima verso estvel do
public class ProcessaEmpregados { Velocity pode ser feito em jakarta.apache.org/
public static void main(String args[]) {
BufferedReader reader = null; builds/jakarta-velocity/release. Para us-lo em
suas aplicaes, voc deve incluir a biblio-
try {
// Inicia o Velocity teca velocity-dep-<versao>.jar (que vem no
VelocityEngine ve = new VelocityEngine(); pacote) no classpath do sistema operacional
ve.init();
ou de seu container web.
// Abre o template
Template tmplt = ve.getTemplate(relacao_empregados.vm);
Al Velocity
// Cria um contexto para colocar os dados Nosso primeiro exemplo gera um do-
VelocityContext context = new VelocityContext();
cumento XML a partir de dados contidos
reader = new BufferedReader(new FileReader(empregados.txt)); em um arquivo-texto, e apresenta alguns
ArrayList empregados = new ArrayList();
String campos[] = new String[3]; elementos importantes do Velocity.
String linha; O arquivo-texto utilizado (empregados.txt)
// L arquivo separando as informaes e montando uma coleo bastante simples, contendo nomes, e-
while ((linha = reader.readLine())!= null) { mails e salrios:
campos = linha.split(,, 3);
empregados.add(new Empregado(campos[0], campos[1],
Double.parseDouble(campos[2]))); George Harrison,george@beatles.com,80000.00
}
Ringo Starr,ringo@beatles.com,40000.00
// Adiciona a coleo montada ao contexto Jim Morrison,jimmy@doors.com,100000.00
context.put(empregados, empregados); Manoel da Silva,mano@provedor.com.br,220.00
BufferedWriter writer = new BufferedWriter(
new FileWriter(new File(empregados.xml))); O template (RelacaoEmpregados.vm)
// Faz o merge mostrado a seguir (com o cdigo da VTL
tmplt.merge(context, writer); destacado):
writer.flush();
writer.close(); ## Macro para gerar uma entrada XML
} #macro(adicionaEmpregado
catch (Exception e) { $nome $email $salario)
e.printStackTrace(); <empregado>
} <nome>$nome</nome>
finally { <email>$email</email>
if (reader!= null) { <salario>$salario</salario>
try { </empregado>
reader.close(); #end
}
catch (Exception e) {} <?xml version =1.0 encoding=ISO-8859-
} 1?>
} <relacao-empregados>
}
} ## Cria uma entrada para
## cada item da coleo
#foreach ($e in $empregados)
uma instncia da classe org.apache.velocit importantes: put(String chave, Object valor) e #adicionaEmpregado(
y.VelocityContext, que utiliza internamente get(String chave). $e.Nome $e.Email $e.Salario)
#end
um HashMap para manter um conjunto de Uma vez criado e preenchido o contexto,
pares String-objeto. Possui dois mtodos prossegue-se para o merge. Durante o </relacao-empregados>

Edio 6 Java Magazine 51

jm6-book.indb 51 3/4/2003, 17:53:55

Jakarta Velocity

A classe ProcessaEmpregados, mostrada na

Listagem 2. Empregado.java Listagem 1, faz a gerao do XML base-
public class Empregado { ando-se no template e nos dados lidos do
private String email; arquivo. A classe Empregado, utilizada na
private String nome;
double salario; gerao, apresentada na Listagem 2.
Para testar o exemplo, crie os quatro ar-
public Empregado(String nome, String email, double salario) {
this.nome = nome; this.email = email; this.salario = salario; quivos apresentados anteriormente em um
} novo diretrio, compile os .java e execute
public String getNome() {
return nome; } a classe ProcessaEmpregados. Ser criado um
public String getEmail(){ arquivo chamado empregados.xml contendo
return email;
} os dados estruturados em XML.
public double getSalario() { O que acontece no exemplo? De forma
return salario;
} simples, a aplicao inicializa o Velocity,
} l o arquivo-texto, monta uma coleo con-
Listagem 3. CadastroVelocityServlet.java tendo os dados dos empregados, adiciona a
coleo ao contexto e inicia o merge. Duran-
import org.apache.velocity.servlet.VelocityServlet;
import org.apache.velocity.context.Context;
te o merge, o Velocity processa o template e,
import org.apache.velocity.Template; ao encontrar uma diretiva, l do contexto
import javax.servlet.http.*;
os objetos necessrios.
import java.io.IOException; No template, a diretiva foreach usada
public class CadastroVelocityServlet extends VelocityServlet {
para percorrer a coleo $empregados:
public Template handleRequest(HttpServletRequest request,
HttpServletResponse response, Context context) throws IOException { #foreach ($e in $empregados)
Template tmplt = null; #adicionaEmpregado(
$e.Nome $e.Email $e.Salario)
// Verifica se o usurio enviou o formulrio #end
if (request.getParameter(acao)!= null) {
String nome = request.getParameter(nome); Dentro do foreach, chamada a macro
String email = request.getParameter(email);
adicionaEmpregado (defi nida no incio do
// Adiciona os dados em um contexto visvel ao Velocity template), que gera um pequeno trecho
if (!nome.equals()) context.put(nome, nome);
if (!email.equals()) context.put(email, email); de XML. Note como as variveis so pas-
} sadas para a macro voc no precisa usar
// Carrega e faz um parsing inicial do template $e.getNome(), por exemplo, pois o Velocity
// usando mtodo herdado de VelocityServlet realiza uma introspeco nos objetos e
try {
tmplt = this.getTemplate(FormCadastro.vm); identifica (e chama) seus mtodos get.
}
catch (Exception e) {
// template nao existe ou houve erros durante a sua validao Velocity na web
e.printStackTrace(); Para facilitar o uso em aplicaes web,
}
return tmplt; a distribuio do Velocity inclui o servlet
} org.apache.velocity.servlet.VelocityServlet, que
}
realiza a maior parte da configurao do
Listagem 4. FormCadastro.vm ambiente automaticamente.
<html><body>
Como exemplo, vamos criar um servlet
<center> simples (Listagem 3) que usa o Velocity
<h3>Ol <b>
#if ($nome!= ) $nome
para gerar uma pgina com dados obtidos
#else Visitante de um formulrio HTML. O template usa-
#end</b>, seja bem-vindo(a)</h3>
</center>
do mostrado na Listagem 4.
<br> O ponto de entrada de um VelocityServlet
#if ($nome!= )
o mtodo handleRequest, que deve ser
0 E-mail informado foi: <b>$email</b><br> redefi nido no seu servlet. Analisando o
#end
cdigo, voc notar que no houve neces-
<br><br> sidade de criar um contexto o servlet j
<h3> Cadastro: </h3>
<form action=/ExemploVelocity method=post>
cria um contexto, passando-o para o m-
Nome: <input type=text name=nome value=$!nome><br> todo handleRequest. Tambm no existe a
E-mail: <input type=text name=email value=$!email><br>
<input type=submit name=acao value=Enviar>
necessidade de chamar o mtodo merge ou
</form> abrir a sada do HttpServletResponse, pois o
</body></html>
VelocityServlet realiza essas duas operaes
quando handleRequest retorna.

52 Java Magazine Edio 6

jm6-book.indb 52 3/4/2003, 17:53:56


Listagem 5. Configurao do servlet no web.xml
...
<web-app>
...
<servlet>
<servlet-name>ExemploVelocity</servlet-name>
<servlet-class>CadastroVelocityServlet</servlet-class>
<init-param>
<param-name>properties</param-name>
<param-value>/WEB-INF/velocity.properties</param-value>
</init-param>
</servlet>
</web-app>
Para testar o segundo exemplo rapi-
damente, crie uma nova aplicao web
incluindo o servlet compilado, copie a
biblioteca velocity-dep-<versao>.jar para
WEB-INF/lib e configure o servlet no
web.xml como mostrado na Listagem 5
(isso garante que o arquivo de proprieda-
des do Velocity seja utilizado pelo servlet).
Copie, tambm, o template e o arquivo
velocity.properties (veja adiante) para o
diretrio raiz da aplicao web.
Configurao
O Velocity configurado atravs do ar-
Velocity e Struts
Q uando o framework Struts foi conce-
bido, a idia era trabalhar com JSP na
camada de apresentao. Com a populari-
zao do Velocity, sentiu-se a necessidade
de criar ferramentas que facilitassem a
integrao entre os dois. O subprojeto
jm6-book.indb 53
quivo velocity.properties. As configuraes
disponveis vo de opes de logging at
a configurao de cache, macros e ajustes
finos para as diretivas de templates. Veja
algumas das opes mais importantes:
file.resource.loader.path define o
diretrio para os templates; por padro,
utilizado o da aplicao mas comum, em
aplicaes web, alterar esse diretrio para
WEB-INF/templates;
runtime.log determina onde so gra-
vados erros e outras mensagens geradas
(o padro o arquivo velocity.log);
file.resource.loader.cache ativa o cache
velocity-struts (ainda em pr-release e
acessvel apenas pelo CVS) inclui classes adi-
cionais e tarefas do Ant que automatizam
parte da integrao. Mais informaes em
www.teamup.com/jakarta-velocity-tools/
struts/docs.
dos templates que j foram parsed; o valor
padro false.
Concluses
Sistemas de templates so uma alternati-
va eficaz ao JSP e podem simplificar muito a
manuteno de aplicaes web. O Velocity
vem sendo cada vez mais usado, especial-
mente de forma integrada a frameworks
web MVC como o Struts (veja o quadro
Velocity e Struts). Vale a pena conferir
a documentao bastante completa e h
vrios exemplos prontos.
jakarta.apache.org/velocity
Downloads, documentao e subprojetos
do Velocity
www.teamup.com/jakarta-velocity-tools/
struts/docs
Ferramentas para integrar o Velocity ao Struts
veloedit.sourceforge.net
Plugin para o Eclipse que simplifica a edio de
arquivos do Velocity
www.javamagazine.com.br/downloads
/jm6/jm6-silveira-steil-velocity.zip
Paulo Eduardo Azevedo Silveira
(paulo@paulo.com.br) Bacharel em Cincia da
Computao pela USP e programador certificado
Java. um dos fundadores do GUJ (www.guj.com.br),
instrutor da Sun Education e desenvolvedor autnomo.
Rafael Steil (rafael@insanecorp.com) co-fundador
do GUJ e desenvolvedor web com experincia de vrios
anos em PHP e Java.
Edio 6 Java Magazine 53
3/4/2003, 17:53:57
 Livros
Um autor tupiniquim?
Existem bons escritores brasileiros sobre Java
I
maginem a cena: noite quente de
domingo em Braslia, debaixo de um
coqueiro, ao lado de uma piscina...
enquanto nossas famlias se divertiam, eu
estava jogando conversa fora com o meu
amigo Fernando Anselmo. Estvamos
buscando inspirao para os prximos
textos que amos escrever aqui para a
Java Magazine, quando observei que nos
ltimos meses, nesta coluna, tenho sem-
pre discutido livros de autores gringos,
mas nunca os de escritores brasileiros. E
um dos maiores estava sentado ao meu
lado, e eu ouvindo as bobagens que dizia
(e olha que ele s tomou refrigerante!).
Fernando Anselmo autor de sete livros
tcnicos, incluindo dois sobre Java: Tudo
o que voc queria saber sobre a JDBC e
Tudo o que voc queria saber sobre o JSP,
quando utiliza o servidor Tomcat com o
banco MySQL, ambos da Editora Visual
Books, de Florianpolis. um cmico
nato ningum consegue ficar srio ao
lado dele, pois transforma at anlise
Ficha tcnica
Tudo o que voc
queria saber sobre
a JDBC...
Fernando Anselmo
Editora Visual Books
200 pginas
R$ 37,00
ISBN 8575020560
Tudo que Voc Queria
Saber Sobre o JSP...
Fernando Anselmo
Editora Visual Books
192 pginas
R$ 39,00
ISBN 8575020943
54 Java Magazine Edio 6
jm6-book.indb 54
DANIEL DEOLIVEIRA
de cdigo Java em pura gozao, que o mado no livro sobre JSP (com 190 pginas,
digam seus alunos do curso corujo tambm com CD-ROM). Inicialmente
(que acontece durante a madrugada) e os ele ensina como baixar e instalar cada
que o assistem s suas muitas palestras. uma das ferramentas necessrias ao
Sobre seu principal fator de motivao projeto: o MySQL, o Forte e o Tomcat.
para escrever, me disse Um aspecto interessante
que era por no encontrar que esse livro no ensina
respostas objetivas para as servlets, pois como afirma
dificuldades que teve ao o autor, isso s serve para
estudar as tecnologias. Sua complicar a cabea dos no-
crtica que a maioria dos vatos em JSP. Em seguida,
livros que consultou apre- o livro apresenta o desen-
senta apenas trechos de volvimento de um sistema
cdigos, mas nunca uma para intranet com dois
soluo completa, ou seja, subsistemas distintos: um
um projeto com principio, destinado ao pblico geral,
meio e fim. Por isso, nos dois onde os clientes podem se
livros, voc encontrar um cadastrar, consultar os
Os dois livros incluem
projeto completo incluin- filmes disponveis e fazer
do o cdigo fonte, pois o
o cdigo de um projeto reservas; o outro destinado
autor no acredita que se completo: o autor acredita aos administradores do sis-
deva comear a codificar que o programador deve tema, que podem realizar
partindo de uma tela vazia, comear modificando algo operaes como registrar
mas sim modificando algo j em funcionamento devolues e cadastrar fil-
que j esteja funcionando. mes. Um ponto alto deste li-
O livro sobre JDBC tem 200 pginas e vem vro a parte relativa aos relatrios, assunto
com um CD-ROM com aquelas quinqui- quase nunca abordado em livros de Java.
lharias que todo desenvolvedor Java Para concluir, o autor afirma que no tem
adora. Comeou a ser escrito a partir das a menor pretenso de substituir os gran-
notas dos cursos ministrados pelo autor e des livros de treinamento Java no mercado,
das perguntas que os alunos lhe faziam. como por exemplo, o seu fervorosamente
Ao procurar respostas, Fernando cons- amado formiguinhas, dos irmos Deitel
tatou a brutal falta de documentao em (Java Como Programar, Editora Bookman).
portugus sobre JDBC. Foi esse o ponto Seu objetivo facilitar a vida do desenvolve-
de partida: responder cada uma das dor quem quer dar os primeiros passos em
perguntas; e ao melhor detalh-las, cada uma dessas tecnologias, sem traumas. Com
resposta foi se transformando em um ca- uma vantagem para ns: por ser um escri-
ptulo completo. Em seguida, foi criado um tor brasileiro, a editora no precisa pagar
projeto completo de locadora de DVDs, ini- royalties ao exterior. Portanto, prestigiem
cialmente conectando com o Access (como os autores tupiniquins e bons cdigos!
de costume em livros semelhantes) e pos-
teriormente com o banco de dados MySQL.
Daniel deOliveira (daniel@dfjug.org) o
Em resposta aos leitores do primeiro
coordenador do DFJUG (Braslia Java Users Group),
livro, que solicitaram o desdobramento
www.dfjug.org.
do projeto, o sistema de locadora reto-
3/4/2003, 17:54:02
 Edio 5 Java Magazine 55

jm6-book.indb 55 3/4/2003, 17:54:28

jm6-book.indb 56 3/4/2003, 17:54:40