Caelum Java Web Vraptor Hibernate Ajax Fj28

FJ-28
Desenvolvimento gil para a

Web 2.0 com VRaptor, Hibernate
e AJAX
A Caelum atua no mercado com consultoria, desenvolvimento e ensino em computao. Sua equipe
participou do desenvolvimento de projetos em vrios clientes e, aps apresentar os cursos de vero de Java
na Universidade de So Paulo, passou a oferecer treinamentos para o mercado. Toda a equipe tem uma
forte presena na comunidade atravs de eventos, artigos em diversas revistas, participao em muitos
projetos open source como o VRaptor e o Stella e atuao nos fruns e listas de discusso como o GUJ.
Com uma equipe de mais de 80 prossionais altamente qualicados e de destaque do mercado, oferece
treinamentos em Java, Ruby on Rails e Scrum em suas trs unidades - So Paulo, Rio de Janeiro e
Braslia. Mais de 8 mil alunos j buscaram qualicao nos treinamentos da Caelum tanto em nas unidades
como nas prprias empresas com os cursos incompany.
O compromisso da Caelum oferecer um treinamento de qualidade, com material constantemente
atualizado, uma metodologia de ensino cuidadosamente desenvolvida e instrutores capacitados
tecnicamente e didaticamente. E oferecer ainda servios de consultoria gil, mentoring e desenvolvimento
de projetos sob medida para empresas.
Comunidade
Nossa equipe escreve constantemente artigos no Blog da Caelum que j conta
com 150 artigos sobre vrios assuntos de Java, Rails e computao em geral.
Visite-nos e assine nosso RSS:
blog.caelum.com.br
Acompanhe a Caelum no Twitter:
twitter.com/caelum
O GUJ maior frum de Java em lngua portuguesa, com 700 mil posts e 70 mil
usurios. As pessoas da Caelum participam ativamente, participe tambm:
www.guj.com.br
Assine nossa Newsletter para receber notcias tcnicas de Java, Rails, Agile e
Web, alm de novidades, eventos e artigos:
www.caelum.com.br/newsletter
No site da Caelum h algumas de nossas Apostilas disponveis gratuitamente
para download e alguns dos artigos de destaque que escrevemos:
www.caelum.com.br/apostilas
www.caelum.com.br/artigos
Conhea alguns de nossos cursos
FJ-11:
Java e Orientao a
objetos
FJ-26:
Laboratrio Web com JSF2 e
CDI
FJ-16:
Laboratrio Java com Testes,
XML e Design Patterns
FJ-19:
Preparatrio para Certificao
de Programador Java
FJ-21:
Java para Desenvolvimento
Web
FJ-31:
Java EE avanado e
Web Services
FJ-91:
Arquitetura e Design de
Projetos Java
RR-71:
Desenvolvimento gil para Web
2.0 com Ruby on Rails
RR-75:
Ruby e Rails avanados: lidando
com problemas do dia a dia
Mais de 8000 alunos treinados;
Reconhecida nacionalmente;
Contedos atualizados para o mercado e para sua carreira;
Aulas com metodologia e didtica cuidadosamente preparadas;
Ativa participao nas comunidades Java, Rails e Scrum;
Salas de aula bem equipadas;
Instrutores qualicados e experientes;
Apostilas disponveis no site.
Para mais informaes e outros cursos, visite: caelum.com.br/cursos
FJ-25:
Persistncia com JPA2 e
Hibernate
Sobre esta apostila
Esta apostila da Caelumvisa ensinar de uma maneira elegante, mostrando apenas o que necessrio e quando
necessrio, no momento certo, poupando o leitor de assuntos que no costumam ser de seu interesse em
determinadas fases do aprendizado.
A Caelum espera que voc aproveite esse material. Todos os comentrios, crticas e sugestes sero muito
bem-vindos.
Essa apostila constantemente atualizada e disponibilizada no site da Caelum. Sempre consulte o site para
novas verses e, ao invs de anexar o PDF para enviar a um amigo, indique o site para que ele possa sempre
baixar as ltimas verses. Voc pode conferir o cdigo de verso da apostila logo no nal do ndice.
Baixe sempre a verso mais nova em: www.caelum.com.br/apostilas
Esse material parte integrante do treinamento Desenv. gil para Web . com VRaptor, Hibernate e AJAX
e distribudo gratuitamente exclusivamente pelo site da Caelum. Todos os direitos so reservados Caelum.
A distribuio, cpia, revenda e utilizao para ministrar treinamentos so absolutamente vedadas. Para uso
comercial deste material, por favor, consulte a Caelum previamente.
www.caelum.com.br
Sumrio
: O curso :
. Objetivo do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Sobre o curso: Hibernate, VRaptor, JSP e AJAX . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Onde posso aprender mais do VRaptor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
i O sistema
. A necessidade do cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Partes do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Novo projeto
. Denindo as tecnologias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Montando o ambiente de desenvolvimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios: montando o ambiente de desenvolvimento . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios: congurando o deploy da aplicao . . . . . . . . . . . . . . . . . . . . . . . . . . . .
{ Persistindo os dados com o Hibernate :
. A camada de persistncia do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Preparando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Congurando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios: Congurando o banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cadastrando Produtos io
. Modelando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Anotando a classe Produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios - Modelando o produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Adicionando um produto no banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exercicios - outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Discusso em sala - mais sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
o Refatorando :
. Analisando o cdigo atual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Refactoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Aprendendo a refatorar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Comentrios so sempre necessrios? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Refatorando para criar os DAOs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
i
. Discusso em sala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
, VRaptor {,
. Sobre o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Como instalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Como congurar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Primeiro exemplo com o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Redirecionando para uma view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Disponibilizando informaes para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Disponibilizando colees para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8 Criando o Controlador de Produtos ,
. Listando produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Quais so minhas dependncias? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Injeo de Dependncias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Cadastrando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Criando o formulrio HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Redirecionar para listagem depois de adicionar . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Atualizando e removendo produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Discusso em sala - VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Refatorando os DAOs 8:
. Injeo de dependncias no DAO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Analisando o cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Escopos denidos pelo VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Fechando a sesso do Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:o Validando formulrios
. Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Para saber mais: Hibernate Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios Opcionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:: REST :oi
ii
. O que REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Caractersticas e vantagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. O tringulo do REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Mudando a URI da sua lgica: @Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Mudando o verbo HTTP dos seus mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Refatorando o ProdutosController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:i AJAX e efeitos visuais ::i
. O que AJAX? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Um pouco de JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Validando formulrios com o JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Criando a busca de produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Melhorando a busca: Autocomplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Para saber mais: Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
: Criando o Carrinho de Compras :i,
. O modelo do Carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Controlando o carrinho de compras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Visualizando os itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Removendo itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:{ Autenticao :{i
. Criando Usurios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Efetuando o login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Restringindo funcionalidades para usurios logados . . . . . . . . . . . . . . . . . . . . . . . . .
. Interceptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
: Apndice - Download e Upload :{
. Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:o Apndice - Integrando VRaptor e Spring :8
. Como fazer a integrao? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Integrando o Transaction Manager do Spring . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios: Transaction Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
:, Apndice: Mudando a View Padro: Velocity :o{
. Exerccios: Congurando o Velocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. Exerccios: Mudando o Template Engine de uma nica lgica . . . . . . . . . . . . . . . . . . .
. Exerccios: Mudando o resultado de todas as lgicas para Velocity . . . . . . . . . . . . . . . .
ndice Remissivo :o,
iii
Verso: :{..i
iv
C
O curso
Dizem que os homens nunca se contentam e, quando se lhes d alguma coisa, pedem sempre um pouco mais.
Dizem ainda que essa uma das melhores qualidades da espcie e que foi ela que tornou o homem superior
aos animais, que se contentam com o que tm.
A prola, John Steibeck.
:.: On)v1:vo oo ccnso
Uma das grandes vantagens de utilizar a plataforma Java a quantidade de opes: so centenas de fra-
meworks opensource de qualidade que podemos escolher para desenvolver um projeto. Mas qual deles es-
colher?
Depois da escolha dos frameworks ainda temos um outro problema: fazer com que eles trabalhem juntos
de maneira coesa. Para isso necessrio conhecer as boas prticas e tratar muito bem do ciclo de vida dos
objetos caros, como threads, conexes, sees e arquivos. Um erro no gerenciamento desses objetos pode
ser fatal para a performance e escalabilidade do seu sistema.
Nesse curso, alm de estudarmos frameworks para o desenvolvimento web, necessrio car atento para
a importncia de como vamos faz-los trabalhar junto. Essa costura pode ser aplicada em diversos outros
casos, mesmo com outros frameworks, e baseada essencialmente no bom isolamento de classes, usando
inverso de controle e injeo de dependncias, assunto que ser tratado recorrentemente durante o curso.
Material do Treinamento Desenv. gil para Web . com VRaptor, Hibernate e AJAX
:.i Sonnv o ccnso: H:nvnNn1v, VRnv1on, JSP v AJAX
Um dos frameworks que encontrado na grande maioria dos projetos atualmente o Hibernate, que ser
utilizado nesse curso para persistncia. Veremos mais do que o simples gerenciamento de estado e de queries,
pois ser praticado como tratar de maneira correta a Session e a Transaction envolvida.
O VRaptor, iniciativa brasileira para Controller MVC, utilizado para facilitar o desenvolvimento web, evi-
tando o contato comas classes pouco amigveis do javax.servlet, deixando o cdigo legvel e desacoplado,
ideal para testes.
Java Server Pages utilizado como camada View, mostrando as principais tags e problemas enfrentados.
Juntamente com o VRaptor, o framework javascript JQuery ser utilizado para nossas requisies AJAX
consumindo dados no formato JSON.
:. ONov vosso nvnvNovn mn:s oo VRnv1on:
Voc pode encontrar uma vasta documentao em portugus no site do VRaptor: http://www.vraptor.com.
br/
O frum do GUJ tambm uma excelente fonte de informao, e abriga o frum ocial do VRaptor: http:
//www.guj.com.br/
Captulo - O curso - Sobre o curso: Hibernate, VRaptor, JSP e AJAX - Pgina
C
O sistema
Veremos como ser o sistema que vamos desenvolver e as tecnologias que utilizaremos.
i.: A Nvcvss:onov oo ct:vN1v
Nossa empresa foi contratada para desenvolver um sistema de compras online. O cliente quer que o sistema
seja acessado atravs da web, e deixou claro que devemos nos preocupar muito coma facilidade de navegao
e a interao dos usurios com o sistema.
As seguintes funcionalidades foram solicitadas pelo cliente:
Cadastrar, atualizar, listar e remover produtos
Buscar produtos
Adicionar, remover e listar produtos do carrinho de compras
Cadastrar, atualizar, listar e remover usurios
Sistema de login
Efetuar a compra, devendo solicitar do cliente a forma de pagamento
Em um projeto real, esses requisitos seriam garimpados com o passar do tempo junto ao cliente, para de-
senvolver o sistema de forma incremental e iterativa, utilizando mtodos geis como Scrum (curso PM-)
e prticas XP (curso PM-).
i.i Pnn1vs oo vno)v1o
Para facilitar o desenvolvimento, vamos separar em tarefas o que devemos fazer, que sero vistas a partir do
prximo captulo.
) Deciso de tecnologias
) Montagem do ambiente de desenvolvimento
) CRUD produto
) Carrinho de compras
) CRUD usurio
) login
) Compra de produto
Captulo - O sistema - Partes do projeto - Pgina
C
Novo projeto
No h uma verdade fundamental, apenas h erros fundamentais
Bachelard , Gaston
Neste captulo, vamos denir as tecnologias do projeto e vamos criar e congurar nosso projeto inicial.
.: Dvv:N:Noo ns 1vcNotoc:ns
Nosso projeto ser todo em Java e utilizar o VRaptor .x como framework Web. Para a persistncia, usare-
mos o Hibernate com anotaes rodando sobre o MySQL, que pode ser mudado caso desejado.
Na parte de interao com os usurios, teremos bastante Ajax. Para facilitar o uso do Ajax, vamos utilizar
uma biblioteca chamada JQuery, junto com alguns de seus plugins.
Como servidor, vamos usar o Apache Tomcat pela sua popularidade, mas podemos facilmente rodar a apli-
cao no Jetty ou Glasssh.
Svnv:oonvs v Jnvn EE
Para uma discusso mais detalhada sobre servidores de aplicao Java
EE e servlet containers, consulte os captulos iniciais da apostila do
curso FJ-i:.
IN1vnNv1 Exvtonvn o
Os CSSs, Javascripts e HTMLs usados no curso foram desenvolvidos
para oFirefox .+semse preocupar comcompatibilidade comoutros
browsers, ento algumas funcionalidades podem no funcionar em
outros browsers, principalmente no Internet Explorer .
Ao desenvolver umsistema voc deveria se preocupar coma compati-
bilidade entre os browsers, e voc pode saber mais sobre isso no curso
WD-{ | Desenvolvimento Web com HTML, CSS e JavaScript.
Resumindo as tecnologias:
Java
Hibernate Core - JBoss
Hibernate Annotations - JBoss
VRaptor - Caelum
JSTL - Sun
Tomcat - Apache
MySQL - Sun
Ajax
JQuery - JQuery
.i MoN1nNoo o nmn:vN1v ov ovsvNvotv:mvN1o
Para o ambiente de desenvolvimento, vamos utilizar o Eclipse com o plugin WTP. A verso que utilizaremos
no curso ser a mais nova, a ., que possui o codinome Helios.
Para utilizar o Eclipse, basta fazer o download, descompactar o zip baixado e depois execut-lo. Isso uma
grande vantagem em relao a programas que exigem a instalao. O Eclipse a IDE lder de mercado.
Formada por um consrcio liderado pela IBM, possui seu cdigo livre. Para fazer o download, acesse o site
do Eclipse e baixe a distribuio "Eclipse IDE for Java EE Developers.
http://www.eclipse.org/downloads
Vamos tambm congurar o Tomcat para rodar nossa aplicao.
Captulo - Novo projeto - Montando o ambiente de desenvolvimento - Pgina
. Exvncc:os: moN1nNoo o nmn:vN1v ov ovsvNvotv:mvN1o
) Na Caelum, execute o Eclipse pelo cone que est emseu Desktop. Emcasa, faa a instalao como citado
anteriormente.
) Descompacte o arquivo apache-tomcat-X.X.X.zip em seu Desktop. O arquivo est na pasta Caelum/i8
em seu Desktop.
Em casa, voc pode fazer o download do Tomcat .x em: http://tomcat.apache.org/
) No Eclipse, abra a view Servers. Para tal, voc pode ir em Window e depois Show View e escolher a opo
Servers.
Uma outra maneira de fazer isso, e acessar qualquer tela ou menu, atravs da pragmtica tecla de atalho
Ctrl+. Depois digite servers.
) Congure o Tomcat seguindo os passos abaixo:
Boto direito na view Servers
Escolha a opo New
Escolha a opo Server
) Escolha Tomcat v. Server, dentro da pasta Apache
Captulo - Novo projeto - Exerccios: montando o ambiente de desenvolvimento - Pgina
) Clique no boto Browse, e indique o local onde foi feito o unzip do Tomcat (a pasta do Tomcat no seu
Desktop):
Clique em Finish.
) Teste o servidor que acabamos de congurar. Na view Servers, selecione o Tomcat e clique no boto de
iniciar:
) Verique se o log est limpo e se nenhuma mensagem de erro foi impressa. muito importante, du-
rante todo o curso, observar esse log para vericar se o servidor subiu sem erros e se tudo est rodando
normalmente.
) Agora que o Tomcat est congurado, vamos par-lo umpouco para criar nosso projeto. Na viewServers,
selecione o Tomcat e clique no boto de parar.
) Caso voc esteja na Caelumsiga essas instrues: V na pasta Caelum/ e abra o arquivo goodbuy.zip.
Extraia o contedo desse arquivo para o Desktop.
) Importe o projeto no eclipse seguindo os passos:
) V em File
) Escolha a opo Import
) Escolha a opo General >> Import existing projects into workspace
) Clique em Next
) No Select root directory, selecione o Desktop e clique em Finish:
Este projeto j possui as conguraes bsicas do VRaptor e do Hibernate, para que no percamos muito
tempo congurando. Mas essas conguraes usadas sero explicadas commais detalhe durante o curso.
) O Eclipse perguntar se voc quer trocar de perspectiva. No ser necessrio, ento vamos escolher a
opo No.
) Caso voc no esteja na Caelume precise criar o projeto de casa. Basta voc baixar do site do VRaptor o
vraptor-blank-project, descompacta-lo e importa-lo. Depois disso, adicione, dentro da pasta WebContent
o contedo do zip goodbuy-auxiliares.zip, que contm cabealho, rodap, css e javascript bsicos que
usaremos durante o projeto.
Vc tambm precisar dos JARs do Hibernate e driver MySQL, que ser explicado como baixa-los no
prximo captulo.
Es1nc1cnn ov vns1ns ov cmvno)v1o Wvn
Para entender a estrutura de pastas dos projetos Web em Java, con-
sulte o captulo de servlets da apostila do curso FJ-.
.{ Exvncc:os: coNv:ccnnNoo o ovvtov on nvt:cnXo
) Na aba de Servers, selecione o Tomcat que conguramos no exerccio anterior e siga os passos abaixo:
Clique com o boto direito
Selecione Add and Remove...
) Passe o nosso projeto goodbuy para a direita, usando o boto Add All, e depois clique em Finish.
Captulo - Novo projeto - Exerccios: congurando o deploy da aplicao - Pgina
) O projeto car associado ao Tomcat, conforme a gura abaixo.
Pronto! Nosso projeto est preparado para ser executado no servidor.
) Inicie o servidor clicando com o boto direito e selecionando Start. Abra o refox e digite na barra de
endereos: http://localhost:/goodbuy.
C
Persistindo os dados com o Hibernate
{.: A cnmnon ov vvns:s1INc:n oo vno)v1o
Nossa primeira tarefa ser cadastrar, atualizar, listar e remover produtos do sistema. Para realiz-la, precisa-
mos gravar as informaes dos produtos no banco de dados. Para esse curso, utilizaremos o banco de dados
MySQL, um banco de dados gratuito, de cdigo aberto, simples e muito utilizado por diversas empresas.
Para maiores informaes e para fazer o download, acesse a URL:
http://www.mysql.com/
Depois de instalado e congurado, o MySQL pode ser acessado com o usurio chamado root e a senha vazia
(sem senha). Para testar, basta abrir o terminal e digitar o comando:
mysql -u root
Esse comando tenta fazer o login no mysql, informando o usurio root (-u root) e omitindo a senha, j que
esse usurio no tem senha.
Para nos comunicarmos com o banco de dados, seja para uma consulta ou para algum tipo de alterao de
dado, podemos usar a API que o Java SE disponibiliza, o JDBC. Um dos problemas do JDBC, quando usado
diretamente, conforme mostramos no curso FJ-, que ele muito trabalhoso alm de que precisamos
gerenciar muitos recursos importantes. Todas as informaes tm de ser passadas uma a uma.
Para evitar ter que car fazendo todas as chamadas ao JDBC e ganharmos tempo e produtividade, vamos
utilizar umframework para a persistncia que j traz muitas funcionalidades j implementadas. Oframework
que utilizaremos ser o Hibernate e ele ser o responsvel por fazer as chamadas API do JDBC.
Vale lembrar que, tudo que visto aqui no curso, aplicvel a outros frameworks de persistncia, como seria
o caso de usar o iBatis ou ento o EclipseLink atravs de JPA. muito importante perceber como vamos
integrar todas as nossas ferramentas de maneira coesa e desacoplada.
{.i Sonnv o H:nvnNn1v
O Hibernate um framework ORM - Object Relational Mapping. uma ferramenta que nos ajuda a per-
sistir objetos Java em um banco de dados relacional. O trabalho do desenvolvedor denir como os objetos
so mapeados nas tabelas do banco e o Hibernate faz todo o acesso ao banco, gerando inclusive os comandos
SQL necessrios.
O Hibernate um projeto opensource do grupo JBoss com muitos anos de histria e liderana no mercado
Java. Recentemente, boa parte das idias do Hibernate e outros frameworks ORM foram padronizadas em
uma especio ocial do Java, a JPA - Java Persistence API. A JPA uma especicao do JCP e possui
vrias implementaes (o Hibernate, o Oracle Toplink, EclipseLink, OpenJPA etc).
Mn:s sonnv H:nvnNn1v
Neste curso, veremos muitos tpicos sobre Hibernate e como integr-
lo em nosso projeto com VRaptor. Para tpicos avanados e mais
detalhes, consulte o treinamento FJ-:
http://www.caelum.com.br/curso/
{. PnvvnnnNoo o H:nvnNn1v
Para preparar o Hibernate, ser necessrio baixar dois ZIPs do site do Hibernate. Cada ZIP representa um
projeto diferente.
O primeiro ser o Hibernate Core, que se chama hibernate-distribution-XXX.zip. O segundo ZIP ser
do projeto Hibernate Annotations, j que queremos congurar nosso projeto comas anotaes da JPA. Esse
ZIP chama-se hibernate-annotations-XXX.zip. Faa os downloads diretamente em:
http://www.hibernate.org
Depois de fazer o download desses dois zips, basta descompact-los e utilizar os JARs que esto dentro de
cada projeto. No exerccio abaixo veremos quais JARs vamos precisar. A partir do Hibernate ., esses jars
todos vem numa nica distribuio, a core.
Captulo - Persistindo os dados com o Hibernate - Sobre o Hibernate - Pgina
Conhgurando o mecanismo de logging
OHibernate utiliza o SL4J - Simple Logging Facade for Java - para o mecanismo de logging. Ele serve apenas
como uma fachada para vrios frameworks de logging, por exemplo o Log4J e o java.util.logging.
No nosso projeto utilizaremos o Log4J, ento precisamos baixar mais dois zips. O primeiro o Log4J, do
grupo Apache. O segundo o prprio SL4J, que contm o jar que faz o binding do SL4J com o Log4J.
Conhgurando o driver do MySQL
Apesar de toda facilidade que o Hibernate nos trar, por baixo dos panos ele faz chamadas ao JDBC. Portanto,
para que nossa aplicao se conecte no banco de dados, precisamos do driver do MySQL no classpath. O
driver a implementao JDBC que ser utilizada. Cada banco de dados possui a sua implementao, e ela
deve ser baixada do site do prprio banco de dados. Faa o download do mysql jdbc driver.
Mn:s sonnv JDBC v Dn:vvns
Para mais informaes sobre o JDBC e como funcionam os Drivers,
consulte o captulo inicial da apostila do curso FJ-.
{.{ CoNv:ccnnNoo o H:nvnNn1v
Para congurar o Hibernate, podemos utilizar ou um arquivo .properties ou um arquivo XML.
O arquivo de properties mais simples, mais fcil de se criar, mas uma das desvantagens que ele no
consegue congurar tudo que queremos, por exemplo as entidades. As entidades tm que ser conguradas
no cdigo, e as outras informaes no arquivo de properties.
J o XML, por mais que seja umpouco mais difcil emrelao ao properties, permite que toda a congurao
seja feita nele. Por isso faremos nossa congurao no XML. Oarquivo XML que o Hibernate procurar ser
o hibernate.cfg.xml e ele deve estar no classpath.
Para nosso caso, vamos seguir a conveno e criar o arquivo hibernate.cfg.xml na pasta src, dentro do
nosso projeto. O contedo do arquivo ser esse:
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<property name="hibernate.connection.username">
root
Captulo - Persistindo os dados com o Hibernate - Congurando o Hibernate - Pgina
</property>
<property name="hibernate.connection.password">
</property>
<property name="hibernate.connection.url">
jdbc:mysql://localhost/fj28
</property>
<property name="hibernate.connection.driver_class">
com.mysql.jdbc.Driver
</property>
<property name="hibernate.dialect">
org.hibernate.dialect.MySQL5InnoDBDialect
</property>
<property name="hibernate.hbm2ddl.auto">update</property>
<property name="show_sql">true</property>
<property name="format_sql">true</property>
</session-factory>
</hibernate-configuration>
As conguraes que passamos nesse arquivo so parecidas quando queremos nos conectar a um banco
de dados. Para conectar em um banco de dados, precisamos informar qual o usurio, a senha, algumas
informaes do banco, como host, porta, etc.
Um detalhe importante da nossa congurao o banco de dados que foi passado. Na congurao
hibernate.connection.url foi passado o nome do database que utilizaremos. Para esse caso escolhemos o
database fj28.
Abaixo segue a descrio de todas as conguraes que usamos.
hibernate.connection.username - usurio do banco de dados
hibernate.connection.password - senha do usurio
hibernate.connection.url - chamada de URL ou string de conexo, deve ser congurada de acordo
com documentao do banco de dados
hibernate.connection.driver_class - driver que deve ser utilizado
hibernate.hbmiddl.auto - como o hibernate vai se comportar em relao s tabelas do banco. Com o
valor update ele vai criar ou modicar tabelas sempre que necessrio.
hibernate.dialect - dialeto a ser utilizado para a comunicao com o banco de dados
show_sql - ag que indica se os SQLs gerados devem ser impressos
format_sql - ag que indica se os SQLs devem ser formatados
Existem muitas outras conguraes possveis. Para maiores detalhes, acesse a documentao do Hibernate.
Captulo - Persistindo os dados com o Hibernate - Congurando o Hibernate - Pgina
{. Exvncc:os: CoNv:ccnnNoo o nnNco
) Todos os jars necessrios para usar o hibernate j esto no projeto base que usamos. O
hibernate.cfg.xml tambm j existe na pasta src. Caso voc esteja fazendo essa apostila em casa, baixe
os JARs de acordo com as orientaes desse captulo e crie o hibernate.cfg.xml similarmente.
) Conecte-se no banco de dados para vericar se o database fj28 existe. Se ele no existir, teremos que
cri-lo. Primeiro, abra um terminal pelo cone no Desktop. Depois digite:
mysql -u root
Depois de conectado, vamos vericar os bancos de dados disponveis:
mysql> show databases;
Se o database fj28 aparecer, digite:
mysql> drop database fj28;
mysql> create database fj28;
Captulo - Persistindo os dados com o Hibernate - Exerccios: Congurando o banco - Pgina
C
Cadastrando Produtos
No captulo anterior, conguramos o Hibernate para acessar o banco de dados. Neste captulo, nosso objetivo
cadastrar produtos.
.: MoovtnNoo cmvnooc1o
Agora que estamos com o ambiente congurado e com o banco de dados pronto, podemos partir para a
codicao.
A primeira classe que faremos ser a classe Produto. Ela representar os produtos que sero cadastrados no
sistema, ou seja, quando algum produto for colocado no sistema, ns criaremos uma instncia dessa classe.
Nossa classe Produto car assim:
public class Produto {
private String nome;
private String descricao;
private Double preco;
// getter e setters
}
B:cDvc:mnt
Em aplicaes normais, no se deve usar doubles para representar
nmeros reais (ex. dinheiro, porcentagem) por causa de problemas
de arredondamento. Podemos usar o BigDecimal que tem uma pre-
ciso xa, portanto os problemas de arredondamento so facilmente
contornveis. No usaremos BigDecimal pois ele um pouco mais
complicado de usar:
double a, b, c, d;
d = a+b/c;
com BigDecimal:
BigDecimal a, b, c, d;
d = a.add(b.divide(c));
.i ANo1nNoo n ctnssv Produto
A classe Produto , por enquanto, uma classe Java normal. Mas precisamos que instncias dessa classe sejam
persistidas ou recuperadas do banco de dados.
Uma das maneiras de transformar essa classe Java normal em uma classe que pode ser persistida atravs de
XML. O problema dessa abordagem a diculdade e o trabalho de se fazer isso com XML.
Outra maneira, que est sendo bem aceita pela comunidade o uso de anotaes para a congurao. Ao
invs de usar um arquivo XML para congurar, basta ir na prpria classe e anot-la. Uma das grandes van-
tagens, alm da simplicidade, que as anotaes passam pelo processo de compilao normal, assim como
qualquer outro cdigo java. Ou seja, a classe com as anotaes deve compilar.
Para anotar a classe Produto, basta colocar na declarao da classe a anotao @Entity, do pacote
javax.persistence. Essa anotao pertence a especicao da Java Persistence API.
@Entity
Captulo - Cadastrando Produtos - Anotando a classe Produto - Pgina
// getter e setters
}
Quando anotamos uma classe com @Entity, devemos indicar qual ser o campo de chave primria. Para o
nosso caso, vamos criar um campo id para ser a chave primria da tabela.
Para indicar que o campo id ser a chave primria, utilizaremos a anotao @Id. Um detalhe importante
que o nome da anotao no devido ao nome do atributo, ou seja, o atributo e a anotao tem o nome id,
mas a anotao sempre ser @Id, j o atributo de chave primria pode ser qualquer nome.
Vrias vezes no queremos passar o valor do id porque o valor desse campo ser gerado no banco de dados.
Podemos informar isso pro Hibernate atravs da anotao @GeneratedValue. Para o nosso caso, esse campo
ser do tipo auto_increment no banco de dados.
@Entity
@Id @GeneratedValue
private Long id;
// getter e setters
}
Pronto, agora nossa entidade est devidamente anotada. S temos que fazer mais uma coisa: avisar o Hi-
bernate dessa entidade, isso porque ele no encontra a entidade automaticamente. Para informar isso ao
Hibernate, utilizaremos o arquivo de congurao dele, o hibernate.cfg.xml.
O contedo do arquivo car assim:
<session-factory>


<mapping class="br.com.caelum.goodbuy.modelo.Produto" />
</session-factory>
Repare que temos que utilizar o nome completo da classe, ou seja, o nome da classe mais o pacote.
Captulo - Cadastrando Produtos - Anotando a classe Produto - Pgina
. Exvncc:os - MoovtnNoo o vnooc1o
) Crie a classe Produto dentro do pacote br.com.caelum.goodbuy.modelo.
private Long id;
// getter e setters
}
) Anote a classe com as anotaes da JPA.
@Entity
@Id @GeneratedValue
private Long id;
// getter e setters
}
) Congure essa entidade no Hibernate, alterando o arquivo hibernate.cfg.xml.
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<session-factory>



Captulo - Cadastrando Produtos - Exerccios - Modelando o produto - Pgina
</session-factory>
.{ Ao:c:oNnNoo cmvnooc1o No nnNco
Para adicionar um produto no banco de dados, precisamos primeiro nos conectar no banco de dados.
Quando usamos o JDBC, utilizamos a interface java.sql.Connection, que representa uma conexo com
o banco de dados.
Mas no nosso caso, que estamos usando o Hibernate, precisamos usar diretamente essa conexo do JDBC?
No, deixaremos isso para o Hibernate. Temos que lembrar que sempre que quisermos fazer algo no banco
de dados, utilizaremos o Hibernate.
Para nos comunicarmos com o banco de dados utilizando o Hibernate, precisamos pedir para o Hibernate
um objeto que encapsule uma conexo, e com essa conexo, ele faa o que queremos. Esse objeto que preci-
samos a Session, do pacote org.hibernate.
Esse objeto muito importante para ns porque ele quem vai encapsular todas as chamadas JDBC, facili-
tando muito o mecanismo de acesso ao banco de dados.
Nosso primeiro passo para conseguir uma Session instanciar uma classe que representa a
congurao do Hibernate, portanto iniciamos instanciando a classe do Hibernate cujo nome
org.hibernate.cfg.AnnotationConfiguration.
// Cria uma configurao
AnnotationConfiguration configuration = new AnnotationConfiguration();
Depois de criar esse objeto, vamos chamar o mtodo responsvel por ler o arquivo hibernate.cfg.xml, o
configure().
// L o hibernate.cfg.xml
configuration.configure();
Aps congurar, precisamos criar um objeto que cria as sesses, uma fbrica. Esse objeto uma
SessionFactory, que pode ser obtida com:
SessionFactory factory = configuration.buildSessionFactory();
Com a SessionFactory em mos conseguimos criar uma uma Session. O cdigo completo ca:
public class TesteDeSessao {
public static void main(String[] args) {
Captulo - Cadastrando Produtos - Adicionando um produto no banco - Pgina

Session session = factory.openSession();
}
}
Apartir desse objeto session, basta passarmos uma entidade que ele se encarregar de transformar do modelo
orientado a objetos para o modelo relacional.
Produto produto = new Produto();
produto.setNome("Prateleira");
produto.setDescricao("Uma prateleira para colocar livros");
produto.setPreco(35.90);
Transaction tx = session.beginTransaction();
session.save(produto);
tx.commit();
Note que utilizamos uma transao para salvar o produto. Essa transao do pacote org.hibernate, e ela
necessria para que o insert seja efetivado.
. Exvncc:os
) Crie a seguinte classe, que adiciona produtos no banco.
package br.com.caelum.goodbuy.testes;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.AnnotationConfiguration;
public class AdicaoDeProduto {



Captulo - Cadastrando Produtos - Exerccios - Pgina
tx.commit();
}
}
) Execute a classe que adiciona o produto. Repare no console o sql que foi gerado.
) Acesse o banco de dados e verique se o produto foi inserido com sucesso.
) (Opcional) Crie outros produtos no sistema.
.o Oc1nns ovvnnovs comvnooc1o
Para adicionarmos um produto no banco de dados, utilizamos o mtodo save() da sesso. A sesso do
Hibernate possui tambm mtodos de atualizao, remoo e busca, e a utilizao desses mtodos bem
parecida com o que zemos. Para alterar um produto, basta carregarmos esse produto, alterarmos e depois
atualizarmos.
public class AlteracaoDeProduto {
Captulo - Cadastrando Produtos - Outras operaes com produto - Pgina

// carrega o produto do banco de dados

Produto produto = (Produto) session.load(Produto.class, 1L);
session.update(produto);
tx.commit();
}
}
E para remover um produto:
public class RemocaoDeProduto {


session.delete(produto);
tx.commit();
}
}
., Exvnc:c:os - oc1nns ovvnnovs comvnooc1o
) Crie a classe de alterao do produto.
public class AlteracaoDeProduto {

Captulo - Cadastrando Produtos - Exercicios - outras operaes com produto - Pgina


tx.commit();
}
}
) Execute a classe que altera o produto. Repare no console o sql que foi gerado.
) Acesse o banco de dados e verique se o produto foi alterado com sucesso.
) Crie a classe de remoo do produto.
public class RemocaoDeProduto {



tx.commit();
}
}
) Execute a classe que remove o produto. Repare no console o sql que foi gerado.
) Acesse o banco de dados e verique se o produto foi alterado com sucesso.
.8 D:sccssXo vmsntn - mn:s sonnv o H:nvnNn1v
Por que utilizamos o Long e no o long para o campo id
Eu sempre z com que minhas entidades implementassem Serializable. mesmo necessrio?
Vale mesmo a pena utilizar o Hibernate? No vou perder performance?
Captulo - Cadastrando Produtos - Discusso em sala - mais sobre o Hibernate - Pgina
C
Refatorando
o.: ANnt:snNoo o coo:co n1cnt
Se olharmos para o nosso projeto agora, temos a seguinte situao:
Tabela de produtos est no banco de dados
Hibernate congurado
Classes de testes para lidar com produtos
Mas ser que com o que temos agora podemos cadastrar produtos, conforme o cliente pediu?
Repare na ltima parte da pergunta, que muito importante. Se entregarmos o que temos agora para o
cliente, ele dir que isso intil e nosso sistema no tem nada ainda.
O que faltou, que muito importante, integrar a parte visual (web) com as regras de negcios.
Mas repare que o jeito que esto nossas classes que lidam com um produto no banco de dados. Todo nosso
cdigo est em classes de testes, dentro do mtodo main(). Se deixarmos dessa maneira caria muito difcil
de utilizar esse cdigo.
Ento o que precisamos fazer melhorar nosso cdigo, para que possamos utilizar o que foi escrito dentro
do main(), e tambm para melhorar a manuteno e a legibilidade.
o.i Rvvnc1on:Nc
Uma prtica bastante comume difundida no meio da Orientao a Objetos a chamada Refatorao (Refac-
toring). Refatorar umprograma melhorar seu cdigo semalterar sua funcionalidade. Aideia da refatorao
no corrigir bugs, por exemplo, mas melhorar a estrutura de seu cdigo, deix-lo mais OO, mais legvel.
H diversos tipos de refatoraes. Renomear uma varivel para um nome mais claro um exemplo simples.
Quebrar um mtodo grande em vrios mtodos menores um outro exemplo um pouco mais complicado.
Vrias IDEs de Java possuem suporte refatoraes comuns. O Eclipse possui timas opes automticas
que utilizaremos nesse curso.
O livro mais famoso sobre refatoraes foi escrito por Martin Fowler e chama-se Refactoring - Improving the
Design of existing code. umcatlogo comdezenas de tcnicas de refatorao e instrues de como e quando
execut-las.
o. AvnvNovNoo n nvvn1onnn
Vamos abrir novamente a classe de insero de produtos.
// import's
tx.commit();
}
}
Captulo - Refatorando - Refactoring - Pgina
Olhando para o mtodo main, podemos divid-lo em trs partes. Uma parte a aquisio de uma Session,
outra a criao do produto, e a outra adio do produto no banco de dados. Combase nessa diviso, vamos
pedir para o Eclipse nos ajudar a refatorar, para fazer essa diviso de uma maneira segura e automtica.
Apenas para car claro essa diviso, veja o cdigo novamente, agora com os comentrios mostrando onde
comea cada parte.
// import's

// Aquisio da sesso

// Criao do produto
// Adio do produto no banco de dados

tx.commit();
}
}
Selecionando apenas a parte da aquisio da sesso, vamos utilizar as teclas de atalho do Eclipse para criar
um mtodo com essas instrues. As teclas de atalho so Alt + Shift + M, que representa a opo Extract
Method.
Apertando essas teclas, o Eclipse mostrar uma tela perguntado o nome do mtodo que ser criado. O nome
desse mtodo ser getSession().
Colocando o nome do mtodo e apertando OK, o mtodo ser criado e a parte do cdigo que usa essas
instrues j muda automaticamente, fazendo a chamada ao mtodo recm-criado.
Captulo - Refatorando - Aprendendo a refatorar - Pgina
o.{ Exvncc:os
) Altere a classe AdicaoDeProduto, que est no pacote br.com.caelum.goodbuy.testes, colocando os co-
mentrios para deixar claro a diviso das partes.
// import's

// Aquisio da sesso

// Criao do produto

tx.commit();
}
}
) Selecione as linhas que fazem a aquisio da sesso, conforme a gura abaixo:
Captulo - Refatorando - Exerccios - Pgina
) Comas linhas selecionadas, pressione as teclas Alt + Shift + M (Extract Method), para criar ummtodo
com essas linhas. Aps pressionar essas teclas, aparecer a seguinte tela:
) A tela que est sendo mostrada est esperando por um nome de mtodo. Digite getSession como nome
do mtodo e pressione OK.
) Note como o Eclipse mudou seu cdigo, criando o mtodo getSession e fazendo a chamada a este m-
todo. A classe deve estar assim:
// Aquisio da sesso
Session session = getSession();
// Criao do produto
tx.commit();
}
private static Session getSession() {
return session;
}
}
) Faa o mesmo para as linhas de criao de produto e adio de produto no banco de dados. No nal,
caremos com mtodos, umchamado getSession, que j foi feito, outro chamado criaProduto e outro
chamado gravaProduto. Lembre-se de utilizar as teclas de atalho que vimos nesse exerccio.
) Para conferncia, caremos com a classe da seguinte forma:
// import's

// Aquisio da sesso
// Criao do produto
Produto produto = criaProduto();

gravaProduto(session, produto);
}
private static void gravaProduto(Session session, Produto produto) {

tx.commit();
}
private static Produto criaProduto() {

return produto;
}
private static Session getSession() {


return session;
}
}
o. ComvN1Kn:os sXo svmvnv NvcvssKn:os:
Note que o que zmos foi quebrar ummtodo grande emvrios mtodo pequenos. Pode parecer intil esse
tipo de alterao, j que no mudamos nada no cdigo, s a forma como est organizado.
Mas repare que o mtodo main cou muito mais legvel, intuitivo. Basta dar uma olhada rpida que podemos
entender o que ele faz.
Mas agora que o mtodo main foi quebrado em mtodos menores, ser que precisamos mesmo de co-
mentrios? Olhe novamente para o cdigo, e veja que os nomes dos nossos mtodos j dizem muito o que
queremos, ento nem precisamos mais de comentrios.
J que no precisamos mais dos comentrios, vamos retir-los do nosso cdigo:
}
// outros mtodos
}
o.o Rvvn1onnNoo vnnn cn:nn os DAOs
Olhando novamente para a classe de adio de produtos, podemos notar que ainda no podemos reaproveitar
o cdigo de criao de sesso do Hibernate em outras classes. O mesmo acontece com a classe de remoo
de usurios.
Podemos ento criar uma classe que vai ser responsvel pela obteno de Sessions, para que possamos us-la
sempre que precisarmos de uma. Vamos dar a essa classe o nome de CriadorDeSession, e mover o mtodo
getSession() para ela.
Da mesma forma, podemos juntar as operaes de adicionar, remover, atualizar produtos emuma classe, que
ser responsvel por acessar os produtos no banco de dados. Ea essa classe vamos dar o nome de ProdutoDao.
Captulo - Refatorando - Comentrios so sempre necessrios? - Pgina
o., Exvncc:os
) Crie uma classe chamada CriadorDeSession no pacote br.com.caelum.goodbuy.infra. Essa classe ser
a responsvel por criar uma Session.
) Selecione o mtodo getSession da classe AdicaoDeProduto.
) Com as linhas selecionadas, pressione as teclas Alt + Shift + V (Move Method), para criar um mtodo
com essas linhas. Aps pressionar essas teclas, aparecer a seguinte tela:
) A tela que est sendo mostrada est esperando pela classe que car com esse mtodo. Pressione o boto
Browse..., e busque pela classe CriadorDeSession, conforme a imagem abaixo:
) Aps encontrar a classe CriadorDeSession, pressione o boto OK para escolher essa classe, depois OK
novamente para conrmar a mudana do mtodo para essa classe.
) Aparecer uma tela avisando que a visibilidade do mtodo getSession ser alterada public. Conrme
essa alterao pressionando o boto Continue.
) Repare como cou a classe aps essa alterao:
Session session = CriadorDeSession.getSession();
}
private static void gravaProduto(Session session, Produto produto) {
tx.commit();
}
return produto;
}
}
) Crie uma classe chamada ProdutoDao no pacote br.com.caelum.goodbuy.dao. Essa classe ser a respon-
svel por encapsular as chamadas ao Hibernate.
) Mova o mtodo gravaProduto para a classe ProdutoDao. Utilize as teclas de atalho que vimos nesse
exerccio.
) Repare como cou a classe aps essa alterao:
ProdutoDao.gravaProduto(session, produto);
}
return produto;
}
}
) Vamos refatorar agora a classe ProdutoDao, que est no momento assim:
public class ProdutoDao {
public static void gravaProduto(Session session, Produto produto) {
tx.commit();
}
}
Primeiro vamos tirar o static do mtodo gravaProduto.
public void gravaProduto(Session session, Produto produto) {
tx.commit();
}
}
) A classe AdicaoDeProduto agora no compila. Vamos trocar o acesso esttico por acesso a uma instncia
do dao:
new ProdutoDao().gravaProduto(session, produto);
}
//...
}
) O mtodo gravaProduto recebe uma Session. Mas o ProdutoDao deveria ser responsvel pelo acesso a
dados, ento ela mesma deve ser responsvel por criar a session. Mude isso no ProdutoDao:
public void gravaProduto(Produto produto) {
tx.commit();
}
}
Mude tambm a classe AdicaoDeProduto:
new ProdutoDao().gravaProduto(produto);
}
//...
}
) Por ltimo, no precisamos criar uma Session dentro do mtodo gravaProduto, vamos fazer isso dentro
do construtor da classe, e colocar a Session como atributo:
private final Session session;
public ProdutoDao() {
this.session = CriadorDeSession.getSession();
}
public void gravaProduto(Produto produto) {
tx.commit();
}
}
) Agora a chamada do mtodo gravaProduto est correta, porm repare como est um pouco redun-
dante:
new ProdutoDao().gravaProduto(produto);
Seria melhor se fosse assim:
new ProdutoDao().salva(produto);
Vamos fazer essa mudana de nome de mtodo utilizando o Eclipse. Pressione as teclas Alt + Shift +
R (rename) mtodo da classe ProdutoDao, e o Eclipse pedir o novo nome para o mtodo.
Digite salva como novo nome do mtodo.
) (Opcional) Refatore as outras classes de teste, AlteracaoDeProduto e RemocaoDeProduto, para utilizar o
ProdutoDao.
o.8 D:sccssXo vmsntn
Ouvi falar do padro Repository. Ainda preciso dos daos?
O eclipse ajuda no refactoring?
Captulo - Refatorando - Discusso em sala - Pgina
C
VRaptor
,.: Sonnv o VRnv1on
VRaptor um framework MVC para web focado no desenvolvimento gil.
Atravs da inverso de controle e injeo de depndencias, ele diminui drasticamente o tempo de trabalho
que seria perdido com o cdigo repetitivo: validaes, converses, direcionamentos, ajax e lookups.
,.i Como :Ns1ntnn
Para utilizar o VRaptor, basta fazer o download da ltima verso do VRaptor, e depois fazer o unzip.
Aps fazer o unzip, abra a pasta que foi criada e copie os jars que esto em lib/mandatory para a pasta
WEB-INF/lib do seu projeto, alm do vraptor-.X.X.jar. Tambm necessrio escolher um container de
injeo de dependncias (falaremos sobre eles mais pra frente no curso), entre o Spring, Google Guice ou
Pico container, adicionando todos os jars da pasta lib/containers/<container>.
,. Como coNv:ccnnn
Uma das grandes vantagens do VRaptor que ele usa muitas convenes, ou seja, ao invs de termos que
congurar tudo, como por exemplo no Struts, no precisamos congurar quase nada.
Seguindo as convenes que o VRaptor usa, podemos criar apenas nossas lgicas (cdigo java) sem precisar
escrever xmls ou properties.
A nica congurao que precisamos fazer congurar o controlador do VRaptor. Essa congurao feita
dentro do arquivo web.xml, o arquivo de congurao da aplicao.
<web-app ...>

<filter>
<filter-name>vraptor</filter-name>
<filter-class>br.com.caelum.vraptor.VRaptor</filter-class>
</filter>
<filter-mapping>
<filter-name>vraptor</filter-name>
<url-pattern>/*</url-pattern>
<dispatcher>FORWARD</dispatcher>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
</web-app>
Essas conguraes j foram feitas no projeto base.
Svnvtv1 .o
Se voc estiver usando um Servlet Container que implementa a Ser-
vlet . voc nem precisa da congurao do ltro no web.xml. Basta
colocar o jar do VRaptor na pasta WEB-INF/lib e ele ser congurado
automaticamente.
,.{ Pn:mv:no vxvmvto como VRnv1on
Vamos criar nosso primeiro exemplo utilizando o VRaptor. Esse primeiro exemplo ser bem simples, para
entendermos o funcionamento do VRaptor. Veremos mais adiante exemplos mais complexos e mais elabo-
rados.
Nosso primeiro exemplo ser composto de uma classe, que representar as regras de negcio, e uma pgina
de resultado.
Vamos comear pela regra de negcio, um mtodo dentro de uma classe java simples.
package br.com.caelum.goodbuy;
Captulo - VRaptor - Primeiro exemplo com o VRaptor - Pgina

public class Mundo {
public void boasVindas() {

System.out.println("ol mundo!");
}
}
Repare que essa classe no herda nem implementa nenhuma interface. Essa classe um exemplo de um
POJO. Isso muito importante porque a classe est bem simples, bem legvel.
Agora como fazer para chamar essa lgica? Queremos cham-la assim pelo browser:
http://localhost:8080/goodbuy/mundo/boasVindas
Para chamar essa lgica, temos que anotar nossa classe que contm a regra de negcio, para indicar para o
controlador do VRaptor que essa classe deve ser controlada por ele.
A anotao que utilizaremos para indicar isso a @Resource.
Nossa classe car assim:
import br.com.caelum.vraptor.Resource;
@Resource

}
}
O VRaptor vai usar uma conveno para chamar o nosso mtodo: para executar o mtodo boasVindas() da
classe Mundo, posso chamar no browser a URI /mundo/boasVindas a partir da nossa aplicao, ou seja, a URI
http://localhost:/goodbuy/mundo/boasVindas.
@Resource
Captulo - VRaptor - Primeiro exemplo com o VRaptor - Pgina

}
}
,. Exvncc:os
) Crie a classe Mundo no pacote br.com.caelum.goodbuy.

}
}
) Anote a classe Mundo com @Resource.
) Abra um browser, por exemplo o Firefox, e digite a seguinte url: http://localhost:/goodbuy/mundo/
boasVindas
) Ao acessar essa url, mostrada uma pgina com erro (pgina no encontrada). Isso ocorreu porque
ainda no criamos a pgina de resultado. Ela ser criada na prxima seo. O importante vericar o log
da aplicao, na view Console do Eclipse, e ver que a mensagem apareceu.
) (Opcional) Crie outro mtodo, parecido como que zemos, e acesse pelo browser. Se quiser, esse mtodo
pode ser em outra classe.
Captulo - VRaptor - Exerccios - Pgina
,.o Rvo:nvc:oNnNoo vnnn cmn v:vw
Nosso ltimo exemplo executava a lgica que tnhamos criado, mas a pgina de resultado no tinha sido
feita, e recebamos o erro .
Vamos fazer a pgina de resultado, para que depois de executada a lgica, essa pgina seja chamada. Esse
o contedo da pgina:
Ol Mundo!
Conforme foi dito anteriormente, o VRaptor prefere convenes do que conguraes. A conveno de
redirecionamento de pginas aps a lgica a seguinte:
/WEB-INF/jsp/{nomeDoResource}/{lgica}.jsp
Para nosso caso, temos a seguinte situao:
{nomeDoResource} = Mundo
{lgica} = boasVindas()
O VRaptor vai fazer algumas modicaes nesses valores. A primeira letra do nome do resource, que para
ns o nome da classe, ser passado para minsculo. O resto do nome continuar igual. J o nome da lgica
continuar igual, mas sem os parnteses. Ento o VRaptor vai considerar os seguintes valores:
{nomeDoResource} = mundo
{lgica} = boasVindas
E a pgina que ele buscar ser a seguinte:
/WEB-INF/jsp/mundo/boasVindas.jsp
,., Exvncc:os
) Crie uma pasta chamada jsp dentro da pasta WEB-INF. Cuidado, o nome da pasta deve ser com letras
minsculas.
) Crie uma pasta chamada mundo dentro da pasta WEB-INF/jsp. Cuidado, o nome da pasta deve ser com
letras minsculas.
) Crie umjsp chamado boasVindas.jsp dentro da pasta WEB-INF/jsp/mundo. Seu projeto deve car assim:
Captulo - VRaptor - Redirecionando para uma view - Pgina
) Abra o arquivo boasVindas.jsp que acabamos de criar e digite o seguinte contedo:
Ol Mundo!
) Vamos testar nossas alteraes. Inicie o Tomcat na view Servers, depois abra um browser e digite a se-
guinte url: http://localhost:/goodbuy/mundo/boasVindas
) Verique se o console mostra a mensagem ol mundo!, e verique se o browser exibe a mensagem Ol
Mundo.
,.8 D:svoN:n:t:znNoo :Nvonmnovs vnnn n v:vw
Nosso exemplo at agora s executa algo no servidor e depois a view chamada.
Captulo - VRaptor - Disponibilizando informaes para a view - Pgina
Mas para muitos casos precisamos que a lgica carregue informaes do banco de dados e depois a view
exiba essas informaes.
No VRaptor foi criada uma caracterstica muito intuitiva de se mandar informaes para a view. Quando
um mtodo invocado, por exemplo nosso mtodo boasVindas(), podemos fazer com que ele retorne algo,
e esse retorno ser enviado para a view automaticamente.
As verses anteriores usavam atributos junto com anotaes ou getters. O problema dessa abordagem que
a classe cava muito poluda com atributos, getters ou anotaes.
Vamos alterar nosso mtodo para enviar informaes para a view:
@Resource
public String boasVindas() {

return "ol mundo!";
}
}
Agora o mtodo boasVindas() no imprime nada, apenas retorna uma string. Aps a execuo desse m-
todo, essa string j estar disponvel na view.
muito importante perceber a legibilidade desse mtodo. uma classe java normal, e um mtodo que
retorna uma string.
Para que a view possa imprimir esse valor, vamos utilizar Expression Language no nosso jsp. Nosso jsp car
assim:
Mensagem vinda da lgica:
${string}
Como utilizamos o retorno do mtodo para disponibilizar informaes para a view, no temos como dar um
nome signicativo para utilizar depois.
O VRaptor usa a conveno de buscar o tipo do retorno, nesse nosso caso uma String, e disponibilizar para a
viewcomo mesmo nome, apenas passando a primeira letra para minsculo. Por esse motivo que foi utilizado
a expression language ${string}.
,. D:svoN:n:t:znNoo cotvovs vnnn n v:vw
Podemos utilizar a mesma maneira que zemos comStrings para disponibilizar colees para a view. Utiliza-
mos muito as colees do pacote java.util, seja pela facilidade no uso ou pela integrao com frameworks
Captulo - VRaptor - Disponibilizando colees para a view - Pgina
como o Hibernate.
Se nossa lgica criasse uma coleo com informaes que vieram do banco de dados, poderamos retornar
essa coleo, assim como zemos anteriormente. O cdigo caria assim:
@Resource

return "ol mundo!";
}
public List<String> paises() {

List<String> result = new ArrayList<String>();
result.add("Brasil");
result.add("Portugal");
result.add("Japo");
result.add("Canad");
result.add("Paraguai");
return result;
}
}
Na nossa view, podemos imprimir os valores dessa coleo da seguinte forma:
Pases vindos da lgica:
${stringList}
Note que agora o valor passado na expression language foi ${stringList}. O VRaptor identica que devol-
vemos uma lista, e essa lista genrica, informando que o tipo de informao dentro da lista ser String.
Para listas, o VRaptor vai adotar a seguinte conveno:
{tipoDaLista}List
Nosso exemplo era de uma lista de String, ou seja, List<String>, que virou ${stringList}.
,.:o Exvncc:os
) Altere o mtodo boasVindas() da classe Mundo para retornar uma String.
@Resource

return "ol mundo!";
}
}
) Altere o jsp boasVindas.jsp, que est dentro da pasta WEB-INF/jsp/mundo.
Mensagem vinda da lgica:
${string}
) Teste a lgica que acabamos de criar, acessando a seguinte url: http://localhost:/goodbuy/mundo/
boasVindas Sua pgina deve exibir o seguinte resultado:
) Crie ummtodo chamado paises() na classe Mundo. Esse mtodo deve retornar uma lista de Strings. Seu
cdigo car assim:
public List<String> paises() {
List<String> result = new ArrayList<String>();
result.add("Brasil");
result.add("Portugal");
result.add("Japo");
result.add("Canad");
result.add("Paraguai");
return result;
}
) Crie um jsp em WEB-INF/jsp/mundo chamado paises.jsp. O contedo deve ser esse:
Pases vindos da lgica:
${stringList}
) Teste a lgica que acabamos de criar, acessando a seguinte url:
http://localhost:/goodbuy/mundo/paises
Sua pgina deve exibir o seguinte resultado:
) (Opcional) Crie outro mtodo que mande alguma informao para a view. Dessa vez, tente retornar um
valor inteiro ou um valor decimal.
) (Opcional) Crie outro mtodo que retorne um Produto, com algumas informaes preenchidas. Tente
imprimir essas informaes no jsp.
) (Opcional) Na view que exibe os pases, itere sobre a coleo e mostre cada pas em uma linha. Dica: use
o JSTL, tag c:forEach.
) (Opcional) Um mtodo s pode retornar uma informao. Mas como faramos para disponibilizar para
a view mais de uma informao?
C
Criando o Controlador de Produtos
8.: L:s1nNoo vnooc1os
Relembrando o que temos no nosso projeto, criamos o dao de produto para encapsular as chamadas ao
Hibernate, e vimos como se usa o VRaptor , recebendo e disponibilizando valores da view. Precisamos
agora integrar essas duas partes, para que possamos fazer o cadastro do produto pelo browser.
Vamos comear criando nossa classe que far a lgica de negcios. O nome da classe poderia ser qualquer
nome vlido, mas usaremos uma conveno do VRaptor: utilizar o suxo Controller.
Vimos que o nome da classe utilizado pelo VRaptor para registrar esse componente, para que quando
zermos uma chamada do browser, essa classe seja encontrada e algummtodo seja invocado. Mas utilizando
o nome ProdutosController, o VRaptor vai mapear essa classe para apenas /produtos, removendo o suxo
Controller que faz parte da conveno.
Dentro dessa classe, teremos ummtodo para listar todos os produto. Esse mtodo ser invocado pelo VRap-
tor e o produto em questo ser passado com os dados j populados atravs dos dados do formulrio.
Primeiro, vamos listar todos os produtos existentes no banco de dados. Para isso, vamos usar o mtodo
createCriteria de Session que cria uma Criteria. Atravs de um Criteria, temos acesso a diversas ope-
raes no banco de dados; uma delas listar tudo com o mtodo list().
Nosso mtodo listaTudo() no ProdutoDao ca assim:
//...
public List<Produto> listaTudo() {
return this.session.createCriteria(Produto.class).list();
}
}
Com essa listagem pronta, podemos us-la no ProdutosController, e criar uma lgica que lista produtos.
Coloque a classe no pacote br.com.caelum.goodbuy.controller:
package br.com.caelum.goodbuy.controller;
public class ProdutosController {
public List<Produto> lista() {
ProdutoDao dao = new ProdutoDao();
return dao.listaTudo();
}
}
Olhando para esse mtodo, que no incio tnhamos denido para ser nossa regra de negcio, ser que temos
apenas isso? Ser que apenas listamos os produtos?
Na verdade esse mtodo est fazendo mais tarefas do que deveria. Ele possui algumas responsabilidades
extras, por exemplo criar o ProdutoDao. A nica parte que a regra de negcio para esse caso a chamada
ao dao.listaTudo(). O resto apenas infraestrutura para permitir executar essa tarefa.
Avaliando esse problema, podemos perceber que estamos buscando recursos, nesse caso um dao, e portanto
nos preocupando demasiadamente com os mesmos. Se buscar um recurso ruim, seja pela complexidade
ou diculdade no acesso, e tambm por no fazer parte da regra de negcio, que tal se ao invs de cri-lo,
recebssemos o mesmo?
// import's
@Resource
private ProdutoDao dao;
public ProdutosController(ProdutoDao dao) {

this.dao = dao;
}
Captulo - Criando o Controlador de Produtos - Listando produtos - Pgina

}
}
Repare como seria mais simples nosso mtodo que executa a regra de negcio, e tambm como o mtodo
s executa a parte que realmente lhe interessa. A busca dos recursos necessrios para a execuo de nessa
lgica de negcios - nesse caso a criao do dao - no interessa pra essa classe.
Um ponto muito importante que temos que notar que para que essa classe funcione corretamente, preci-
samos de uma instncia de ProdutoDao. Se no tivermos essa instncia, impossvel executar nossa regra de
negcios, pois no existe construtor que no receba um ProdutoDao.
Como vimos antes, essa lgica redireciona para a jsp /WEB-INF/jsp/produtos/lista.jsp, e como retorna-
mos uma lista de produtos, existe uma varivel chamada ${produtoList} disponvel no jsp.
Para podermos mostrar a listagemde umjeito mais fcil, vamos usar uma taglib da JSTLchamada c:forEach,
que capaz de iterar sobre uma lista passada.
<c:forEach items="${produtoList}" var="produto">
</c:forEach>
Usando essa taglib, vamos criar uma tabela com todos os produtos do sistema:
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
</tr>
</thead>
<tbody>
<tr>
<td>${produto.nome }</td>
<td>${produto.descricao }</td>
<td>${produto.preco }</td>
</tr>
</c:forEach>
</tbody>
</table>
Captulo - Criando o Controlador de Produtos - Listando produtos - Pgina
8.i Qcn:s sXo m:Nnns ovvvNoINc:ns:
Tudo que umobjeto necessita para permitir a execuo de seus mtodos, isto , tudo o que ele depende, pode
ser passado para o mesmo atravs de mtodos (como os setters, por exemplo), ou do construtor.
Na nossa abordagem, utilizamos o construtor da classe ProdutosController para receber nossas dependn-
cias e, com isso, ganhamos a garantia de que, se tenho um objeto do tipo ProdutosController na minha
mo, posso invocar o mtodo adiciona pois o atributo dao teve seu valor atribudo durante a construo do
objeto.
Ao adicionar o construtor customizado, perdemos o construtor padro, e no podemos mais instanciar essa
classe assim:
ProdutosController controller = new ProdutosController();
Essa caracterstica de, com um objeto em mos, saber que seus mtodos podem ser invocados sem ne-
cessidade de nenhuma dependncia externa extra, parte do que foi chamado de Good Citizen: http:
//docs.codehaus.org/display/PICO/Good+Citizen
Em um objeto todas as dependncias devem ser passadas durante o processo de construo evitando assim
um possvel estado incosistente.
Como poderia ento criar o meu ProdutosController?
ProdutosController controller = new ProdutosController(dao);
Repare que logo aps a segunda linha ser executada, tenho a conana de que o objeto referenciado pela
varivel controller est preparado para ter seus mtodos invocados.
Dessa maneira injetamos todas as nossas dependncias durante a instanciao do controlador, um trabalho
manual que car extremamente repetitivo e propcio a erro a medida que aumenta o nmero de dependn-
cias de nossa classe.
8. IN)vXo ov DvvvNoINc:ns
Sendo assim, ca muito mais fcil se zermos uso de uma API que execute todo o processo de injeo auto-
maticamente.
No nosso caso, quemvai instanciar essa classe? Ns ou o VRaptor? Essa classe ser instanciada pelo VRap-
tor. Mas se o VRaptor zer isso, como ele descobrir sobre interligaes entre as dependncias?
Uma vez que precisamos da classe ProdutoDao como dependncia nossa, precisamos noticar o framework
que o mesmo se encarregar de gerenciar as instncias de ProdutoDao, isto , nesse caso especco, ele criar
uma instncia e utilizar como argumento para o construtor. Para fazer isso, basta anotarmos essa classe com
@Component.
Captulo - Criando o Controlador de Produtos - Quais so minhas dependncias? - Pgina
package br.com.caelum.goodbuy.dao;
// import's
import br.com.caelum.vraptor.ioc.Component;
@Component
//...
}
Agora a classe ProdutoDao tambm ser controlada pelo VRaptor. Dessa forma, quando o VRaptor for ins-
tanciar a classe ProdutosController, ele vericar que ela depende de umProdutoDao, e criar uma instncia
da mesma.
O que acabamos de fazer foi criar uma maneira de passar as dependncias para onde for necessrio, ou
seja, um mecanismo de injetar as dependncias. Por esse motivo, esse conceito chamado de Injeo de
Dependncias.
OVRaptor est fortemente baseado nesse conceito, uma vez que at ele mesmo utiliza o mesmo para conectar
seus componentes internos. O conceito bsico por trs de Dependency Injection (DI) que voc no deve
buscar aquilo que deseja acessar, mas tais necessidades devem ser fornecidas para voc.
Isso se traduz, por exemplo, na passagem de componentes atravs do construtor de seus controladores. Ima-
gine que seu controlador de clientes necessita acessar um dao. Sendo assim, especique claramente essa
necessidade.
Tvs1nNoo scn nvt:cnXo
Ao usarmos injeo de dependncias, ganhamos uma caracterstica
muito boa na nossa aplicao: a testabilidade. Se recebemos nos-
sas dependncias no construtor, conseguimos passar implementaes
falsas ou controladas e, assim, testar unitariamente nossas classes.
Voc pode encontrar umcontedo mais aprofundado sobre testes nos
cursos FJ-:o - Laboratrio Java comTestes, XML e Design Patterns
e PM-8, - Prticas geis de desenvolvimento de soware.
8.{ Exvncc:os
) Abra a classe ProdutoDao e adicione o mtodo para listar todos os produtos:
//...
Captulo - Criando o Controlador de Produtos - Exerccios - Pgina
}
}
) Crie a classe ProdutosController no pacote br.com.caelum.goodbuy.controller. Crie tambm o m-
todo lista, que retorna uma List<Produto>.
) Anote a classe com a anotao @Resource.
// import's
@Resource

}
}
) Crie o construtor que recebe uma instncia de ProdutoDao, e guarde essa instncia em um atributo.
// import's
@Resource
private final ProdutoDao dao;

this.dao = dao;
}

}
}
) No mtodo lista, faa a chamada ao mtodo listaTudo do dao.
// import's
@Resource

this.dao = dao;
}

}
}
) Na pasta WEB-INF/jsp, crie a pasta produtos.
) Crie o arquivo lista.jsp na pasta /WEB-INF/jsp/produtos.
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
</tr>
</thead>
<tbody>
<tr>
</tr>
</c:forEach>
</tbody>
</table>
) Acesse a URI que executa o mtodo lista: http://localhost:/goodbuy/produtos/lista.
) Deu uma exception! A informao mais importante dela est no nal da Stacktrace:
...
Caused by: org.springframework.beans.factory
.NoSuchBeanDefinitionException:
No unique bean of type
[br.com.caelum.goodbuy.dao.ProdutoDao] is defined:
Unsatisfied dependency of type
[class br.com.caelum.goodbuy.dao.ProdutoDao]:
expected at least 1 matching bean
at org.springframework.beans.factory.support....
Ouseja, o Spring -- que usado pelo VRaptor para gerenciar dependncias -- no conhece o ProdutoDao.
Precisamos indicar para o VRaptor que ele tem que registrar o ProdutoDao no Spring, com a anotao
@Component.
) Anote a classe ProdutoDao com @Component, para indicar que essa classe uma dependncia e pode ser
instanciada pelo VRaptor sempre que necessrio.
package br.com.caelum.goodbuy.dao;
// import's
@Component
//...
}
) Se acessarmos de novo a URI que executa o mtodo lista: http://localhost:/goodbuy/produtos/lista ve-
remos a listagem de produtos:
) Abra o arquivo header.jspf e procure a div com id="menu". Adicione um link ao menu, para acessar a
listagem de produtos:
<div id="menu">
<ul>
<li><a href="<c:url value="/produtos/lista"/>">Lista Produtos</a></li>
</ul>
</div>
8. Cnons1nnNoo cmvnooc1o
Para cadastrar um produto, bastar passarmos esse produto para o mtodo salva da classe ProdutoDao. Va-
mos criar ento um mtodo no ProdutoController para adicionar produtos:
// import's
@Resource
public void adiciona(Produto produto) {

dao.salva(produto);
}
}
Captulo - Criando o Controlador de Produtos - Cadastrando um produto - Pgina
8.o Cn:nNoo o vonmctKn:o HTML
Nossa lgica para criar (salvar) produtos j est pronta. Mas como passar um produto populado para o m-
todo adiciona do ProdutosController? Uma sada seria aproveitar a injeo de dependncias do VRaptor,
receber um HttpServletRequest no construtor, e pegar os parmetros que vieram do formulrio, e usar os
getters e setters do Produto para popul-lo. Mas isso bem chato e repetitivo: imagine se o Produto tivesse
campos!
Para evitar isso, o VRaptor possui uma conveno para popular os parmetros da sua lgica. O mtodo
adiciona recebe como parmetro um Produto chamado produto, ento para popular o campo nome desse
produto, o VRaptor vai usar um parmetro da requisio chamado produto.nome. Para o campo descricao
o parmetro vai ser produto.descricao. Ou seja, a partir do nome do parmetro do mtodo, podemos usar
pontos para setar os campos do parmetro, desde que voc tenha getters e setters para eles.
O que vale o nome do parmetro: se o mtodo adiciona fosse
public void adiciona(Produto novoProduto) {...}
o VRaptor iria usar os parmetros novoProduto.nome, novoProduto.descricao, etc para popular os campos
do produto.
Rvvtvc1:oN No Nomv oos vnnXmv1nos
Infelizmente, o Java no realiza reection em cima de parmetros,
esses dados no cam disponveis em bytecode (a no ser se com-
pilado em debug mode, porm algo opcional). Isso faz com que a
maioria dos frameworks que precisam desse tipo de informo criem
uma anotao prpria para isso, o que polui muito o cdigo (exem-
plo no JAX-WS, onde comum encontrar um mtodo como o acima
com a assinatura void add(@WebParam(name="cliente") Cliente
cliente).
OVRaptor tira proveito do framework Paranamer (http://paranamer.
codehaus.org), que consegue tirar essa informao atravs de pr
compilao ou dos dados de debug, evitando criar mais uma ano-
tao. Alguns dos desenvolvedores do VRaptor tambm participam
no desenvolvimento do Paranamer.
Agora que sabemos como o VRaptor popula os parmetros do mtodo, vamos criar um formulrio para
poder cadastrar produtos. Esse formulrio dever car na pasta WEB-INF/jsp/produtos, com o nome de
formulario.jsp.
<form action="adiciona">
<fieldset>
Captulo - Criando o Controlador de Produtos - Criando o formulrio HTML - Pgina
<legend>Adicionar Produto</legend>
<label for="nome">Nome:</label>
<input id="nome" type="text" name="produto.nome"/>
<label for="descricao">Descrio:</label>
<textarea id="descricao" name="produto.descricao"></textarea>
<label for="preco">Preo:</label>
<input id="preco" type="text" name="produto.preco"/>
<button type="submit">Enviar</button>
</fieldset>
</form>
Como nossas pginas cam sempre na pasta WEB-INF, no temos como acessar diretamente pelo browser
um jsp. Para acessar a pgina que acabamos de criar, vamos criar um mtodo na classe ProdutosController
para chamar nossa pgina, usando a conveno do VRaptor.
@Resource
// atributo, construtor e mtodos
public void formulario() {
}
}
Pelo browser, chamaremos a seguinte URL:
http://localhost:/goodbuy/produtos/formulario
Aps preencher as informaes do formulrio e enviar, o VRaptor vai invocar o mtodo adiciona, passando
o Produto populado com os campos que digitamos. E como diz a conveno do VRaptor, precisamos criar o
arquivo adiciona.jsp, na pasta WEB-INF/jsp/produtos. Por enquanto vamos colocar o seguinte contedo:
Produto adicionado com sucesso!
8., Exvncc:os
) Crie o mtodo adiciona que recebe um Produto como parmetro e faa a chamada ao mtodo salva do
dao passando esse produto.
//...

dao.salva(produto);
}
}
) Na pasta WEB-INF/jsp/produtos, crie o arquivo formulario.jsp.
) Abra o arquivo que acabamos de criar e coloque os campos para de digitao, assim como o boto e o
formulrio.
<fieldset>
<input id="nome" type="text" name="produto.nome"/>
<textarea id="descricao" name="produto.descricao"></textarea>
<input id="preco" type="text" name="produto.preco"/>
</fieldset>
</form>
) Na pasta WEB-INF/jsp/produtos, crie o arquivo adiciona.jsp com o contedo.
<h3>Produto adicionado com sucesso!</h3>
) Acesse a listagem de produtos e veja os produtos que existem.
) Acesse a URI do formulrio e adicione um produto. http://localhost:/goodbuy/produtos/formulario
) Volte listagem, e veja se um usurio foi cadastrado com sucesso.
) Abra o arquivo header.jspf e procure a div com id="menu". Adicione um link dentro do menu para
acessar o formulrio:
<div id="menu">
<ul>
<li><a href="<c:url value="/produtos/formulario"/>">
Novo Produto
</a></li>
<li><a href="<c:url value="/produtos/lista"/>">
Lista Produtos
</a></li>
</ul>
</div>
8.8 Rvo:nvc:oNnn vnnn t:s1ncvmovvo:s ov no:c:oNnn
Uma coisa no aparenta estar muito certa no nosso sistema: Quando adicionamos um produto, redireciona-
mos para uma pgina coma mensagemProduto adicionado comsucesso. Ser que essa pgina suciente?
Ser que no melhor mostrar informaes mais relevantes?
Aps adicionar produtos podemos, por exemplo, mostrar uma lista comos produtos j adicionados. Usando
a conveno do VRaptor, poderamos colocar a lista de produtos no arquivo adiciona.jsp. Mas j temos uma
lgica que lista produtos, por que no us-la? Para isso precisamos falar para o VRaptor que no queremos
usar a conveno, queremos ao invs de ir para a pgina adiciona.jsp, redirecionar para a lgica de listagem.
Para sobrescrever a conveno da view padro, existe um componente do VRaptor chamado Result. Com
ele possvel redirecionar para pginas ou para lgicas, ao nal do seu mtodo.
Primeiro precisamos de uma instncia de Result. Vamos dar umnewnele? No, e isso nem possvel porque
Result uma interface. Como fazer ento? Como visto antes, o VRaptor usa injeo de dependncias, e
como o Result um componente conhecido pelo VRaptor, basta receb-lo no construtor da classe.
import br.com.caelum.vraptor.Result;
@Resource
private final Result result;
public ProdutosController(ProdutoDao dao, Result result) {
this.dao = dao;
Captulo - Criando o Controlador de Produtos - Redirecionar para listagem depois de adicionar - Pgina
this.result = result;
}
//...
}
Agora que temos essa instncia de Result podemos us-la para mudar o resultado da lgica adiciona do
ProdutosController. O jeito de fazer isso dizer: Como resultado, quero redirecionar para a lgica Pro-
dutosController.lista(). Ou em java:
result.redirectTo(ProdutosController.class).lista();
Dentro do mtodo adiciona isso caria:
@Resource
this.dao = dao;
}
dao.salva(produto);
}
}
}
}
Repare que no foi necessrio criar arquivos de congurao para fazer essa mudana de conveno, tudo
feito no prprio mtodo. Ao olhar para o mtodo adiciona ca claro que o resultado dele no vai ser o
adiciona.jsp, vai ser a lgica lista do ProdutosController.
Como o redirecionamento para uma lgica do mesmo controller voc pode ainda usar um comando mais
enxuto:
Captulo - Criando o Controlador de Produtos - Redirecionar para listagem depois de adicionar - Pgina
result.redirectTo(this).lista();
Existem duas maneiras de redirecionar para uma lgica:
redirecionamento do lado do cliente, usando o mtodo redirectTo: o resultado da requisio ser
um cdigo para o browser fazer outra requisio, para a URL indicada. uma boa prtica usar o
redirecionamento do lado do cliente sempre aps requisies POST, ou seja, sempre que submetemos
formulrios prevenindo, assim, que o usurio recarregue a pgina e resubmeta o formulrio.
redirecionamento do lado do servidor, usando o mtodo forwardTo: o servidor vai redirecionar in-
ternamente para a lgica especicada, desse modo possvel mudar o resultado de uma lgica sem
mudanas do lado do cliente. No use esse redirecionamento em requisies POST.
Alm disso, podemos redirecionar nossa requisio para pginas usando outros mtodos:
result.forwardTo(/uma/outra/pagina.jsp): redirecionamento do lado do servidor para a pgina es-
pecicada.
result.redirectTo(/uma/outra/pagina.jsp): redirecionamento do lado do cliente para a pgina espe-
cicada.
result.of(ProdutosController.class).lista(): redireciona para a pgina da lgica especicada, sem exe-
cutar a lgica. Nesse caso redirecionaria para /WEB-INF/jsp/produtos/lista.jsp.
Existem mais redirecionamentos possveis implementados no VRaptor. Todos eles esto disponveis como
mtodos estticos da classe Results, que voc pode chamar dentro do mtodo use do Result, por exemplo:
result.use(Results.logic()). Redireciona usando uma lgica. A chamada que zemos anteri-
ormente result.redirectTo(ProdutosController.class).lista() na verdade um atalho para
result.use(Results.logic()).redirectTo(ProdutosController.class).lista().
result.use(Results.page()). Redireciona usando uma pgina. A chamada que vimos an-
teriormente result.forwardTo("/uma/outra/pagina.jsp") na verdade um atalho para
result.use(Results.page()).forwardTo("/uma/outra/pagina.jsp").
result.use(Results.nothing()): No usa nenhuma pgina como resultado.
result.use(Results.http()): Usa como resultado status codes e Headers HTTP. Ex:
result.use(Results.http()).setStatusCode(404)
result.use(Results.referer()): Usa como resultado a pgina que originou a requisio. Usa um
Header HTTPchamado Referer que no obrigatrio, e que removido por alguns Proxies e Firewalls,
ento cuidado ao usar esse resultado.
8. Exvncc:os
) Receba um Result no construtor do ProdutosController e guarde-o em um atributo.
import br.com.caelum.vraptor.Result;
@Resource
this.dao = dao;
}
//...
}
) Mude o resultado da lgica adiciona para redirecionar para a lgica lista.
@Resource
this.dao = dao;
}
dao.salva(produto);
}
}
}
}
) Reinicie o tomcat para que ele carregue as suas mudanas, abra o formulrio e adicione mais umproduto.
Repita essa operao e adicione mais produtos.
8.:o A1cnt:znNoo v nvmovvNoo vnooc1os
Para melhorarmos um pouco mais o nosso sistema, vamos incluir as operaes de atualizao e remoo de
produtos.
Comeando pela atualizao, primeiro precisamos de uma lgica que mostre um formulrio com os dados
do produto preenchidos. Vamos dar a essa lgica o nome de edita.
Captulo - Criando o Controlador de Produtos - Atualizando e removendo produtos - Pgina
public void edita() {...}
}
Precisamos passar para essa lgica o id do produto que queremos editar, para que possamos carregar suas
informaes do banco de dados. E para passar o Produto carregado para a jsp, basta retorn-lo:
public Produto edita(Long id) {
return dao.carrega(id);
}
}
Agora podemos criar o formulrio de edio, passando os valores do produto carregado para os inputs:
<form action="altera">
<fieldset>
<legend>Editar Produto</legend>
<input type="hidden" name="produto.id"
value="${produto.id }" />
<input id="nome" type="text"
name="produto.nome" value="${produto.nome }"/>
<textarea id="descricao" name="produto.descricao">
${produto.descricao }
</textarea>
<input id="preco" type="text"
name="produto.preco" value="${produto.preco }"/>
</fieldset>
</form>
Repare que precisamos tambm colocar um input hidden com o valor do produto.id para que saibamos
qual produto ser alterado. A action do form para a lgica altera, ento precisamos cri-la no nosso con-
troller. Como usamos os nomes dos campos do formulrio do jeito certo, podemos simplesmente receber
um Produto como argumento na lgica altera.
//...
public void altera(Produto produto) {
dao.atualiza(produto);
}
}
Assim como na lgica adiciona, zemos um POST num formulrio, ento ao invs de colocar uma jsp com
uma mensagem de Produto alterado com sucesso, vamos redirecionar para a listagem de produtos.
//...
}
Agora precisamos de um jeito fcil de editar um produto. Vamos ento adicionar um link para editar o
produto, na listagem:
<tr>
<td><a href="edita?id=${produto.id }">Editar</a></td>
</tr>
</c:forEach>
Vamos tambm remover produtos no nosso controller. Para remover um produto precisamos apenas do seu
id, ento basta criar a lgica:
public void remove(Long id) {
Produto produto = dao.carrega(id);
dao.remove(produto);
}
Tambm no faz muito sentido criar uma pgina de resultado para a remoo, ento vamos redirecionar
para a listagem.
}
Assim como criamos o link para a edio, vamos criar um link para a remoo:
<tr>
<td><a href="remove?id=${produto.id }">Remover</a></td>
</tr>
</c:forEach>
8.:: Exvncc:os
) Crie as lgicas para edio de produtos no ProdutosController:
}
}
) Implemente os mtodos no ProdutoDao. Lembre-se de usar o Ctrl+1.
public Produto carrega(Long id) {
return (Produto) this.session.load(Produto.class, id);
}
public void atualiza(Produto produto) {
this.session.update(produto);
tx.commit();
}
) Crie o formulrio de edio no arquivo /WEB-INF/jsp/produtos/edita.jsp.
<form action="altera">
<fieldset>
<input type="hidden" name="produto.id"
value="${produto.id }" />
<input id="nome" type="text" name="produto.nome"
value="${produto.nome }"/>
</textarea>
<input id="preco" type="text" name="produto.preco"
value="${produto.preco }"/>
</fieldset>
</form>
) Modique a listagem de produtos para incluir um link para a edio, no arquivo
/WEB-INF/jsp/produtos/lista.jsp:
<tr>
</tr>
</c:forEach>
) Reinicie o tomcat e acesse a listagem http://localhost:/goodbuy/produtos/lista. Escolha um dos pro-
dutos e clique em Editar.
Edite o produto e clique em Enviar.
) Crie agora a lgica de remoo na classe ProdutosController:
}
) Implemente o mtodo remove no ProdutoDao.
public void remove(Produto produto) {
this.session.delete(produto);
tx.commit();
}
) Modique a listagem de produtos, adicionando o link para remoo
<tr>
<td><a href="edita?id=${produto.id}">Editar</a></td>
<td><a href="remove?id=${produto.id}">Remover</a></td>
</tr>
</c:forEach>
) Reinicie o tomcat, acesse a listagem e remova algum produto.
8.:i D:sccssXo vmsntn - VRnv1on
Mas o mercado usa mais o Struts. Vale a pena troc-lo?
Por que tantas convenes?
Captulo - Criando o Controlador de Produtos - Discusso em sala - VRaptor - Pgina
C
Refatorando os DAOs
.: IN)vXo ov ovvvNoINc:ns No DAO
Existe algo errado com o ProdutoDao: ele est criando uma Session, que uma dependncia dele. Usando
injeo de dependncias, podemos receber a Session no construtor, e o VRaptor vai se encarregar de criar
essa Session e passar pro construtor do dao.
@Component
public ProdutoDao(Session session) {
this.session = session;
}
//...
}
Mas como falar que a Session pode ser usada como dependncia?
Poderamos fazer a mesma alterao que zemos no ProdutoDao, anotando a classe Session do pacote
org.hibernate com@Component. Assim, a sesso do Hibernate tambmseria gerenciada pelo VRaptor. Mas
ser que podemos anotar uma classe do Hibernate? S se baixssemos o cdigo fonte e compilssemos na
mo, junto com nosso projeto. Daria muito trabalho e seria muito estranho, nosso projeto alterando outro
projeto.
Para resolver isso, o VRaptor possui ummecanismo que nos auxilia a passar dependncias de outros projetos
para nossas classes. Basta criarmos uma classe que implementa a interface ComponentFactory. Essa interface
dene um nico mtodo, o getInstance.
Criando essa classe, podemos denir a lgica de criao de um determinado objetos, e o VRaptor usar a
instncia retornada para passar como dependncia para outras classes. No nosso caso, podemos criar uma
classe que cria sesses do Hibernate.
J temos uma classe que cria uma classe que nos d uma instncia de Session: a CriadorDeSession, ento
para transform-la em um ComponentFactory basta implementar a interface. Mas o mtodo que nos d a
Session se chama getSession, e a interface espera que o mtodo se chame getInstance. E, por ltimo,
anotamos a classe com @Component para que o VRaptor saiba como cri-la. A classe car assim:
import br.com.caelum.vraptor.ioc.ComponentFactory;
@Component
public class CriadorDeSession implements ComponentFactory<Session> {
public Session getInstance() {
AnnotationConfiguration configuration =
new AnnotationConfiguration();
SessionFactory factory = configuration
.buildSessionFactory();
return session;
}
}
Note que utilizamos Generics para informar qual ser o tipo de objeto criado por essa classe.
O mtodo getInstance ainda est fazendo coisas demais: ele cria uma AnnotationConfiguration, con-
gura, constri uma SessionFactory, e s ento abre uma sesso. No seria suciente s abrir uma sesso
a partir da SessionFactory? A SessionFactory uma dependncia para criar uma Session. Ento vamos
receb-la no construtor da classe.
@Component
private final SessionFactory factory;
Captulo - Refatorando os DAOs - Injeo de dependncias no DAO - Pgina
public CriadorDeSession(SessionFactory factory) {
this.factory = factory;
}
return factory.openSession();
}
}
Podemos usar a mesma idia e criar um ComponentFactory para SessionFactory, com o cdigo que remo-
vemos da CriadorDeSession. No podemos nos esquecer da anotao @Component:
@Component
public class CriadorDeSessionFactory implements
ComponentFactory<SessionFactory> {
public SessionFactory getInstance() {
SessionFactory factory = configuration
.buildSessionFactory();
return factory;
}
}
Poderamos continuar esse processo, e criar uma ComponentFactory para AnnotationConfiguration tam-
bm, mas vamos parar por aqui. Resumindo o que acabamos de fazer, chegamos a seguinte situao:
ProdutosController depende de ProdutoDao que depende de Session que depende de SessionFactory.
primeira vista pode parecer que zemos muita coisa s pra resolver o problema da Session. Mas a van-
tagem de utilizarmos essa abordagem que para as nossas prximas lgicas, no precisaremos fazer nada.
Se tivermos que criar DAOs no nosso sistema, no precisamos mais se preocupar com Sessions, basta
receber uma no construtor.
.i Exvncc:os
) Faa a classe ProdutoDao receber uma Session no construtor. Remova o mtodo getSession:
@Component
Captulo - Refatorando os DAOs - Exerccios - Pgina
public ProdutoDao(Session session) {
}
//...
}
) Modique a classe CriadorDeSession. Faa com que essa classe implemente a interface
ComponentFactory, passando a Session como tipo genrico. Renomeie o mtodo getSession
para getInstance, e remova o static.
import br.com.caelum.vraptor.ioc.ComponentFactory;
@Component
return session;
}
}
) A classe CriadorDeSession est fazendo coisas demais. Recorte a parte que cria uma SessionFactory e
receba uma SessionFactory no construtor. A classe deve car assim:
package br.com.caelum.goodbuy.infra;
// import's

}

return session;
}
}
) Aps ter criado o construtor, guarde o parmetro factory em um atributo. Utilize as teclas de atalho do
Eclipse. Pressione as teclas Ctrl + 1 (quick x) no parmetro factory, e o Eclipse nos mostrar algumas
sugestes. Selecione a primeira opo, Assign parameter to new field.
) Anote a classe com @Component, para indicar que essa classe uma dependncia e pode ser instanciada
pelo VRaptor sempre que necessrio.
) Crie a classe CriadorDeSessionFactory no pacote br.com.caelum.goodbuy.infra que implementa a
interface ComponentFactory<SessionFactory>.
// import's

}
) A classe no compila, pois falta implementar o mtodo que foi denido na interface. Para isso utilize as
teclas de atalho do Eclipse: coloque o cursor no nome da classe e digite Ctrl+1. Selecione a opo Add
unimplemented methods.
Coloque a criao da fbrica de sesses que voc tinha recortado da outra classe nesse mtodo.
// import's
public class CriadorDeSessionFactory

implements ComponentFactory<SessionFactory> {

SessionFactory factory =
configuration.buildSessionFactory();
return factory;
}
}
) Anote a classe com @Component, para indicar que essa classe uma dependncia e pode ser instanciada
pelo VRaptor sempre que necessrio.
) As classes de teste que tnhamos criado no esto compilando mais, pois mudamos o construtor do
ProdutoDao. Mude as chamadas, usando as ComponentFactories para criar as dependncias. Note que
na aplicao web, o VRaptor que vai se encarregar executar esse cdigo.
SessionFactory factory = new CriadorDeSessionFactory().getInstance();
Session session = new CriadorDeSession(factory).getInstance();
ProdutoDao dao = new ProdutoDao(session);
) Acesse o sistema e veja que ele continua funcionando como antes.
. ANnt:snNoo o coo:co
J conseguimos cadastrar um produto pelo browser e j criamos algumas classes para injeo de dependn-
cias para nossas prximas lgicas, mas ser que nosso cdigo atual est certo?
Toda vez que precisamos de uma sesso do Hibernate, o VRaptor injeta no dao uma sesso nova. Essa sesso
criada de uma fbrica de sesses, e essa fbrica tambm criada. Ou seja, para cada requisio, estamos
criando uma fbrica nova. Mas temos que nos lembrar que isso no deveria ser feito. custoso ter que criar
uma fbrica de sesses para cada requisio.
Uma alternativa para resolver esse problema utilizar um bloco esttico dentro do CriadorDeSessionFac-
tory. Outra alternativa seria utilizar o Design Pattern Singleton, fazendo com que apenas uma instncia de
determinada classe seja criada.
Mas como estamos utilizando o VRaptor, vamos utilizar um recurso dele para esse controle.
.{ Escovos ovv:N:oos vvto VRnv1on
O VRaptor nos permite denir o tempo de vida de instncias de determinada classe. Esse tempo de vida
importante porque cada componente tem uma responsabilidade, e alguns devem sobreviver por mais tempo
que outros.
Captulo - Refatorando os DAOs - Analisando o cdigo - Pgina
Alguns componentes devemter o tempo de vida de uma requisio, ou seja, enquanto estamos atendendendo
uma solicitao do cliente. Esse caso seria aplicado sesso do Hibernate, por exemplo.
Mas alguns componentes devem durar mais que uma requisio, devem durar enquanto um cliente estiver
logado por exemplo. Esse seria o caso de um carrinho de compras. Para cada produto que um cliente quiser
comprar, esse produto deve ser adicionado no mesmo carrinho, e enquanto o cliente estiver usando o sistema
o carrinho deve continuar guardando os produtos.
Para alguns casos, umcomponente deve durar para todas as requisies, e esse componente pode ser utilizado
por todos os clientes. Esse caso poderia ser a fbrica de sesses do Hibernate. Essa fbrica caria nica para
toda a aplicao, e qualquer cliente que precisar de uma sesso, usaramos essa fbrica.
Para cada cenrio acima, o VRaptor deniu um tempo de vida. Esse tempo de vida no VRaptor chamado
de escopo. O VRaptor dene quatro escopos, e para utiliz-los, basta anotarmos nossos componentes com
uma das seguintes anotaes:
@RequestScoped - o componente ser criado a cada requisio. o escopo padro dos componentes.
@SessionScoped - o componente ser criado uma vez por sesso (HttpSession) de usurio
@ApplicationScoped - o componente ser criado uma nica vez na aplicao.
@PrototypeScoped - o componente ser criado toda vez que for solicitado.
Para nossa classe CriadorDeSessionFactory, queremos ter apenas uma instncia dessa classe para toda nossa
aplicao, ento vamos anot-la com @ApplicationScoped.
// import's
@Component
@ApplicationScoped

return configuration.buildSessionFactory();
}
}
Agora o VRaptor vai criar apenas uma instncia dessa classe. Mas repare que o mtodo getInstance cria
toda vez uma fbrica nova. Precisamos refatorar para que seja criada apenas uma fbrica.
Captulo - Refatorando os DAOs - Escopos denidos pelo VRaptor - Pgina
Para resolver esse problema, poderamos criar um atributo do tipo SessionFactory e colocar no construtor
da classe a criao da fbrica.
@Component
@ApplicationScoped
ComponentFactory<SessionFactory>{
public CriadorDeSessionFactory() {
factory = configuration.buildSessionFactory();
}
return factory;
}
}
Mas o VRaptor permite a utilizao de anotaes bemteis do Java EE : o @PostConstruct e o @PreDestroy.
Essas anotaes devem ser anotadas em mtodos e tm a seguinte semntica:
os mtodos anotados com @PostConstruct sero executados assim que o escopo for iniciado, ou seja,
no comeo da requisio, sesso de usurio ou da aplicao.
os mtodos anotados com @PreDestroy sero executados assim que o escopo for nalizado, ou seja,
no nal da requisio, sesso de usurio ou da aplicao.
Desse modo, podemos usar um mtodo anotado com @PostConstruct para criar a fbrica de sesses, e
como uma boa prtica fechar todos os recursos que abrimos, devemos criar um mtodo anotado com
@PreDestroy que vai fechar a fbrica.
Fazendo essas modicaes, nossa classe caria assim:
@Component
@ApplicationScoped
private SessionFactory factory;
Captulo - Refatorando os DAOs - Escopos denidos pelo VRaptor - Pgina
@PostConstruct
public void abre() {
this.factory = configuration.buildSessionFactory();;
}
return this.factory;
}
@PreDestroy
public void fecha() {
this.factory.close();
}
}
Note que no precisamos de um bloco esttico ou um singleton, pois o VRaptor que vai se encarregar de
criar apenas uma instncia da fbrica, e quando o recurso no for mais necessrio, o VRaptor vai fechar a
fbrica.
. FvcnnNoo n svssXo oo H:nvnNn1v
Outro problema que temos no nosso cdigo so as sesses do Hibernate. Para cada requisio, abrimos uma
sesso e utilizamos sempre que for necessrio durante toda a requisio. Mas quando fechamos essa sesso?
No nosso caso, ns no estamos fechando.
Mas onde colocaramos o fechamento da sesso? No dao? Na lgica? Mas ser que nossa lgica que deveria
fechar? No seria bom que o VRaptor fechasse para ns a sesso no nal da requisio?
Utilizando as anotaes que vimos na sesso anterior, @PostConstruct e @PreDestroy, conseguimos fazer
um cdigo muito elegante e de fcil entendimento.
Na classe CriadorDeSession, podemos criar dois mtodos, umpara abrir e outro para fechar a sesso. Dessa
forma, no precisaremos nos preocupar com esse tipo de tarefa, que no faz parte da regra de negcio.
A classe caria assim:
// import's
Captulo - Refatorando os DAOs - Fechando a sesso do Hibernate - Pgina

@Component

private Session session;

}
@PostConstruct
this.session = factory.openSession();
}
return this.session;
}
@PreDestroy
this.session.close();
}
}
Note que criamos um atributo chamado session, que guardar uma sesso do Hibernate. Temos que lem-
brar que componentes que controlados pelo VRaptor sempre tm um escopo, mesmo no estando ano-
tado. O escopo padro para componentes o de requisio, ou seja, daria na mesma anotar essa classe com
@RequestScoped. Desse modo, uma sesso vai ser aberta no comeo da requisio, e ser fechada assim que
acabar a requisio
.o Exvncc:os
) Anote a classe CriadorDeSessionFactory com @ApplicationScoped.
// import's
@Component
@ApplicationScoped
//...
}
) Refatore essa classe para que seja criado apenas uma instncia da fbrica.
// import's
@Component
@ApplicationScoped
ComponentFactory<SessionFactory>{
private SessionFactory factory;
@PostConstruct
this.factory = configuration.buildSessionFactory();
}

return this.factory;
}
@PreDestroy
this.factory.close();
}
}
) Refatore a classe CriadorDeSession, colocando os mtodos de callback e colocando a sesso do Hibernate
em um atributo.
@Component
}
@PostConstruct
this.session = factory.openSession();
}
}
@PreDestroy
}
}
) Reinicie o tomcat, acesse o sistema e veja que tudo continua funcionando
) (Opcional) Coloque System.out.println nos mtodos dos ComponentFactories, para ver a ordem que
os mtodos so chamados
) (Opcional) Faa em uma folha de papel todo o uxo de cadastro de um usurio. Esse uxo pode ser feito
de qualquer forma, com echas e caixas de texto por exemplo. O ponto importante desse exerccio car
claro como est a arquitetura do seu projeto.
C
Validando formulrios
Quando temos um formulrio para adicionar dados no nosso sistema, geralmente precisamos vericar se os
dados esto corretos e consistentes. Por exemplo no gostaramos que o usurio digitasse vinte e trs reais
no campo preo, ou que o campo nome fosse vazio.
Ento, antes de salvar esses dados no banco precisamos vericar se tudo est como esperamos. Chamamos
isso de validao. Existem duas maneiras de fazer validao:
Validao do lado do cliente: vericamos os dados antes de mandar os dados para o servidor, assim o
feedback da validao instantneo.
Validao do lado do servidor: os dados so enviados para o servidor, e se houver erros, o servidor
devolve esses erros para o cliente.
A validao do lado do cliente geralmente feita usando javascript, impedindo que o formulrio seja sub-
metido caso acontea algum erro. A do lado do servidor feita em Java, e o VRaptor pode te ajudar a faz-la.
:o.: Vnt:on1on
O VRaptor possui um componente, chamado Validator, para ajudar a fazer validaes do lado do servidor.
Com ele, voc pode executar a lgica de validao, e caso haja algum erro, especicar para onde deve ser
redirecionada a requisio. Para obter um Validator basta receb-lo no construtor do seu Controller:
import br.com.caelum.vraptor.Validator;
@Resource
private final Validator validator;
public ProdutosController(ProdutoDao dao, Result result,
Validator validator) {
this.dao = dao;
this.validator = validator;
}
//...
}
Com essa instncia do Validator podemos adicionar erros de validao para o caso em que os dados da
requisio no vieram corretos. Geralmente validamos quando estamos adicionando ou atualizando algo no
banco, ento vamos executar a validao no mtodo adiciona.
Para isso vamos denir primeiro as regras de validao para um produto:
nome: deve ser obrigatrio, e ter pelo menos letras.
descrio: deve ser obrigatrio, e ter menos de letras.
preo: no pode ser negativo, nem ser de graa.
Para executar essa lgica com o Validator, temos duas maneiras:
maneira classica: voc faz os if s e adiciona as mensagens manualmente:
if (produto.getNome() == null ||
produto.getNome().length() < 3) {
validator.add(new ValidationMessage(
"Nome obrigatrio e precisa ter mais de 3 letras",
"produto.nome"));
}
if (produto.getDescricao() == null ||
produto.getDescricao().length() > 40) {
"Descrio obrigatria e no pode ter " +
"mais que 40 letras", "produto.descricao"));
}
Captulo - Validando formulrios - Validator - Pgina
if (produto.getPreco() <= 0.0) {
"Preo precisa ser positivo", "produto.preco"));
}
dao.salva(produto);
}
maneira uente: voc diz o que quer que seja verdade, e caso no seja adiciona uma mensagem inter-
nacionalizada:
public void adiciona(final Produto produto) {
validator.checking(new Validations() {{
that(produto.getNome() != null &&
produto.getNome().length() >= 3,
"produto.nome","nome.obrigatorio");
that(produto.getDescricao() != null &&
produto.getDescricao().length() <= 40,
"produto.descricao", "descricao.obrigatoria");
that(produto.getPreco() != null && produto.getPreco() > 0.0,
"produto.preco", "preco.positivo");
}});
dao.salva(produto);
}
Como a mensagem internacionalizada, voc precisa colocar essas chaves no seu arquivo messa-
ges.properties:
nome.obrigatorio = Nome obrigatrio e precisa ter mais
de 3 letras
descricao.obrigatoria = Descrio obrigatria e no pode ter
mais que 40 letras
preco.positivo = Preo precisa ser positivo
Emambas as maneiras voc precisa especicar pra qual lgica voltar quando der erro de validao. No nosso
caso, ao dar erro queremos voltar pro formulrio, ento fazemos:
validator.onErrorUsePageOf(ProdutosController.class).formulario();
A lgica de redirecionamento a mesma que se voc estivesse usando o result.of(). Voc deve colocar essa
chamada logo no nal da sua lgica de validao, no momento em que, se houver algum erro, a execuo
deve parar e voltar para o formulrio, mostrando os erros.
Captulo - Validando formulrios - Validator - Pgina
Quando existemerros de validao, o VRaptor disponibiliza para a jsp umatributo chamado ${errors}, que
contm a lista dos erros que aconteceram. Ento voc usar o seguinte cdigo para mostrar as mensagens no
seu jsp:
<ul>
<c:forEach items=${errors} var="error">
<li>${error.category} - ${error.message}</li>
</c:forEach>
</ul>
Alm disso, se quisermos que o formulrio volte preenchido quando houver algum erro de validao, preci-
samos passar como valor dos inputs, o que foi mandado para a requisio:
<fieldset>
</textarea>
</fieldset>
</form>
:o.i Exvncc:os
) Receba um Validator no construtor do ProdutosController e guarde-o num atributo:
import br.com.caelum.vraptor.Validator;
@Resource
Captulo - Validando formulrios - Exerccios - Pgina
public ProdutosController(ProdutoDao dao, Result result,
this.dao = dao;
}
//...
}
) Modique o mtodo adiciona para que inclua a validao dos campos do produto. Se preferir, faa a
validao na forma uente.
if (produto.getNome() == null ||
produto.getNome().length() < 3) {
"Nome obrigatrio e precisa ter mais" +
" de 3 letras", "produto.nome"));
}
if (produto.getDescricao() == null ||
produto.getDescricao().length() > 40) {
"Descrio obrigatria no pode ter mais" +
" que 40 letras", "produto.descricao"));
}
if (produto.getPreco() <= 0) {
"Preo precisa ser positivo", "produto.preco"));
}
validator.onErrorUsePageOf(ProdutosController.class)
.formulario();
dao.salva(produto);
}
) Abra o arquivo header.jspf, e adicione o cdigo para mostrar os erros de validao, dentro da div com
id="erros".
<div id="erros">
<ul>
<c:forEach items="${errors}" var="error">
<li>${error.category } - ${error.message }</li>
</c:forEach>
</ul>
</div>
) Adicione o cdigo para que o formulrio continue preenchido quando der erro de validao:
<fieldset>
</textarea>
</fieldset>
</form>
) Abra o browser e tente adicionar um produto invlido.
) (Opcional) O mtodo atualiza tambm precisa de validao. Voc consegue aproveitar o cdigo do
adiciona para fazer isso? Ele deve redirecionar para o mesmo lugar em caso de erro?
:o. Pnnn snnvn mn:s: H:nvnNn1v Vnt:on1on
Hibernate Validator um poderoso framework para validao de objetos. Ele j vem com validadores que
vericam as regras mais comuns, como campos obrigatrios, tamanhos mnimos e cartes de crdito.
Alm disso, o framework tambm bastante exvel, j que permite a criao dos seus prprios validadores.
Para denir as regras de validao, basta anotar os campos do nosso modelo que precisam ser validados.
Para tal, usaremos as anotaes prontas no Hibernate Validator. Alguns exemplos:
@NotNull, para campos obrigatrios
@NotEmpty, idem, mas tambm no aceita String vazia
@Length, para impor restries sobre o tamanho (min e max)
@Min e @Max, para restringir o valor de nmeros
@Past e @Future, para impor restries temporais
@Pattern, para restringir valores usando uma expresso regular
@Email, conferir validade de e-mail
Munidos dessas anotaes, vamos aplicar nossas regras de validao no Produto:
import org.hibernate.validator.Length;
import org.hibernate.validator.Min;
import org.hibernate.validator.NotNull;
@Entity
@Id @GeneratedValue
private Long id;
@NotNull
@Length(min=3)
@NotNull
@Length(max=40)
@Min(0)
}
Captulo - Validando formulrios - Para saber mais: Hibernate Validator - Pgina
Com nosso modelo anotado, podemos substituir as validaes que zemos pelo Hibernate Validator. O
interface Validator do VRaptor possui um mtodo chamado validate que valida qualquer objeto usando o
Hibernate Validator. Assim, se voc chamar:
validator.validate(produto)
todos os erros de validao que ocorreremsero adicionados ao validator automaticamente. Assimpodemos
substituir as validaes que tnhamos feito antes, pelas equivalentes do Hibernate Validator.
:o.{ Exvncc:os Ovc:oNn:s
) Se as anotaes no aparecerem, v para a pasta que voc tinha extrado o zip do VRaptor e copie o jar
hibernate-validator-X.X.X.jar que est na pasta lib/optional/hibernate para a pasta WEB-INF/lib da
aplicao.
) Anote os campos do produto para adicionar nossas regras de validao.
import org.hibernate.validator.Length;
import org.hibernate.validator.Min;
import org.hibernate.validator.NotNull;
@Entity
@Id @GeneratedValue
private Long id;
@NotNull
@Length(min=3)
@NotNull
@Length(max=40)
@Min(0)
}
) Mude a lgica de validao do mtodo adiciona do ProdutosController para usar o Hibernate Valida-
tor:
@Resource
//...
Captulo - Validando formulrios - Exerccios Opcionais - Pgina
validator.validate(produto);
validator.onErrorUsePageOf(ProdutosController.class).formulario();
dao.salva(produto);
}
}
) Acesse o browser e adicione algum produto invlido, para ver as mensagens de validao.
) (Opcional) Repare que as mensagens so as mensagens padro e esto em ingls. Para usar uma mensa-
gem em portugus, precisamos pass-la para as anotaes do Hibernate Validator.
@NotNull(message="Nome precisa ser preenchido")
@Length(min=3, message="Nome precisa ter mais de 3 letras")
Se quisermos usar internacionalizao nessas mensagens, basta colocar a chave de internacionalizao
entre {}:
@NotNull(message="{nome.precisa.ser.preenchido}")
@Length(min=3, message="{nome.curto}")
e colocar as respectivas mensagens no arquivo messages.properties:
nome.precisa.ser.preenchido = Nome precisa ser preenchido
nome.curto = Nome muito curto. Deve ter mais de 3 letras
Mude as mensagens
Captulo - Validando formulrios - Exerccios Opcionais - Pgina
C
REST
::.: Oqcv v REST
REST um conjunto de restries que dene um padro arquitetural com caractersticas especcas: bene-
fcios e diculdades determinadas aparecero ao implementar um sistema seguindo o padro REST.
::.i Cnnnc1vns1:cns v vnN1ncvNs
Permitir o endereamento dos recursos do seu sistema de uma forma padronizada implica em algumas van-
tagens do REST: as URIs so bookmarkable, o contedo mais suscetvel a cache e os componentes agindo
entre o cliente e o servidor possuem uma viso melhor do que est sendo enviado de um lado para o outro
permitindo que os mesmos tomem decises especcas para aumentar a escalabilidade ou a segurana do
seu sistema.
Utilizar o protocolo HTTP no somente como uma maneira de transmitir dados mas tambm como um
protocolo de aplicao permite maior visibilidade para os componentes intermedirios.
Contedo hipermdia permite a navegabilidade de um cliente atravs do seu sistema, alm de diminuir o
acoplamento entre o cliente e o servidor, que costuma ser muito alto em aplicaes orientadas a servio.
O tpico de hipermdia bem amplo e no ser abordado no curso, sugerimos a visita ao site do restfulie-
java para entender mais como ele funciona e suas vantagens em um sistema: http://github.com/caelum/
restfulie-java
::. O1n:XNccto oo REST
Uma requisio web tem trs tipos de componentes importantes: substantivos, verbos e tipos de contedo
(Content Types). Uma aplicao RESTful costuma reforar mais os substantivos do que os verbos, alm
de conter uma gama de tipos de contedo determinados. A vantagem de seguir isso que conseguimos
aproveitar toda a estrutura que o protocolo HTTP proporciona.
Substantivos: Recursos
Substantivos so os nomes dos recursos do seu sistema. Quando fazemos requisies Web, precisamos falar
o caminho da mesma, a URI (Unied Resource Identier), ou seja, o identicador nico de um recurso.
Ento ao criar as URIs do nosso sistema devemos levar em conta que elas representam recursos, no
aes. Em sistemas REST, nossas URIs devem conter apenas substantivos, que so nossos recursos:
/produtos/adiciona no boa, pois contm um verbo e no est identicando um recurso, mas sim uma
operao. Para representar a adio de um produtos podemos usar a URI /produtos com o mtodo HTTP
POST, que representa que estamos adicionando alguma informao no sistema.
Verbos: Operaes
Uma das caracterstas mais importantes de REST que voc tenha umconjunto pequeno e xo de operaes
bem denidas, gerando uma interface uniforme. Desse modo, para duas aplicaes conversarem elas no
precisam implementar diversas operaes: basta usar as operaes denidas. Perceba que adicionar um
produto e adicionar um usurio no sistema so operaes equivalentes.
O protocolo HTTP possui sete operaes -- os mtodos GET, POST, PUT, DELETE, HEAD, OPTIONS e
TRACE. Duas delas (GET e POST) j so bem conhecidas e utilizadas: GET quando clicamos em links ou
digitamos o endereo no navegador, e POST quando preenchemos formulrios de cadastro. Cada mtodo
tem uma semntica diferente e juntando o mtodo URI deveramos conseguir representar todas as aes
do nosso sistema. As semnticas principais so:
GET - recupera informaes sobre o recurso identicado pela URI. Ex: listar produtos, visualizar o
produto . Uma requisio GET no deve modicar nenhum recurso do seu sistema, ou seja, no
deve ter nenhum efeito colateral, voc apenas recupera informaes do sistema.
POST - adiciona informaes usando o recurso da URI passada. Ex: adicionar um produto. Pode
adicionar informaes a um recurso ou criar um novo recurso.
PUT- adiciona (ou modica) umrecurso na URI passada. Ex: atualizar umproduto. Adiferena fun-
damental entre umPUTe umPOST que no POSTa URI signica o lugar que vai tratar a informao,
e no PUT signica o lugar em que a informao ser armazenada.
Captulo - REST - O tringulo do REST - Pgina
DELETE - remove o recurso representado pela URI passada. Ex: remover um produto.
HEAD, OPTIONS e TRACE - recuperam metadados da URI passada. Respectivamente o Header,
quais mtodos so possveis e informaes de debug.
Content Type: Representao
Quando fazemos uma aplicao no trafegamos um recurso pela rede, apenas uma representao dele. Por
exemplo, quando queremos adicionar um produto ao sistema, passamos para o servidor uma representao
do produto: dados do formulrio. E quando pedimos uma lista de produtos para o servidor ele responde com
uma representao HTML desses produtos. Mas no precisa ser restrito a isso: poderamos adicionar um
produto ao sistema via uma representao em XML, e o servidor poderia nos devolver uma lista de produtos
em formato JSON.
Resumindo: nossas URIs devem representar recursos, as operaes no recurso devem ser indicadas pelos
mtodos HTTP e podemos falar qual o formato em que conversamos com o servidor com o Content Type.
Nas prximas sees vamos ver como aplicar essas idias usando o VRaptor.
::.{ MconNoo n URI on scn toc:cn: qPn1n
Como vimos anteriormente, o VRaptor possui uma conveno para gerar as URIs das suas lgicas. Mas, se
voc est fazendo seu sistema seguindo REST, essa conveno no muito boa: mtodos geralmente contm
verbos, e no bom colocar verbos nas URIs. Ento precisamos sobrescrever essa conveno do VRaptor, e
podemos fazer isso facilmente usando a anotao @Path. Por exemplo, se quisermos que o mtodo lista do
ProdutosController responda URI /produtos, basta anot-lo:
import br.com.caelum.vraptor.Path;
@Resource
@Path("/produtos")
}
}
Dessa forma, o mtodo lista no vai mais estar acessvel pela URI /produto/lista, ele apenas poder ser
acessado pela URI /produtos.
Com a anotao @Path ainda possvel usar templates para extrair parmetros a partir da URI. Por exemplo,
no nosso mtodo edita, precisamos passar um query parameter para falar qual o produto que queremos
editar:
Captulo - REST - Mudando a URI da sua lgica: @Path - Pgina
/produto/edita?id=10
As URIs devem identicar recursos (alm de no conter verbos, mas vamos tir-los em breve), e o id algo
que identihca o recurso que queremos acessar, ento caria melhor se passssemos esse id dentro da URI,
como por exemplo:
/produto/10/edita
ou seja, uma URI que representa a edio do produto de id . Para extrair esse da URI, podemos colocar
um template no nosso @Path. Para isso basta colocar o nome do parmetro que queremos extrair entre
chaves, dentro da URI do @Path, e ento receber o parmetro como argumento do mtodo:
@Path("/produto/{id}/edita")
}
Assim possvel criar URIs mais representativas, que identicam verdadeiramente recursos especcos.
::. MconNoo o vvnno HTTP oos svcs mv1ooos
Podemos tambmmudar o(s) verbo(s) HTTPque os mtodos dos nossos controllers respondem. Por padro,
voc pode acessar seus mtodos usando qualquer umdos verbos HTTP. Mas, como vimos, cada verbo HTTP
tem uma semntica diferente, e devemos levar em conta essas semnticas quando acessamos nossas lgicas.
Se uma operao no segue a semntica de algum dos verbos, no deve aceitar o mesmo.
Por exemplo, nosso mtodo lista uma operao idempotente: no tem nenhum efeito colateral, posso
cham-lo vrias vezes e, se o banco de dados no mudou, o resultado vai ser o mesmo. Logo faz sentido que
o verbo HTTP para acessar esse mtodo seja o GET. Para fazer essa restrio, basta anotar o mtodo com
@Get:
import br.com.caelum.vraptor.Get;
@Resource
@Path("/produtos")
@Get
}
}
Captulo - REST - Mudando o verbo HTTP dos seus mtodos - Pgina
ou ainda o atalho:
@Resource
@Get("/produtos")
}
}
Se quisermos permitir outros verbos HTTP, podemos usar as anotaes @Post, @Put, @Delete, @Trace e
@Head. Apartir do momento que colocamos uma anotao de verbo HTTP no nosso mtodo, ele no poder
ser acessado pelos outros verbos. Ento se tentarmos fazer uma requisio POST /produtos, ela no vai cair
no mtodo lista, a requisio vai retornar umstatus {o (Mtodo no suportado), que quer dizer que existe
um recurso nessa URI, mas ele no suporta o verbo HTTP da requisio.
Assim, podemos colocar mais de um mtodo que responda mesma URI, desde que os verbos HTTP sejam
diferentes. Por exemplo, podemos fazer com que o mtodo adiciona tambm responda URI /produtos.
Mas o mtodo adiciona no idempotente: se eu repetir duas vezes uma requisio a esse mtodo, vou
adicionar dois produtos ao sistema. Estamos adicionando produtos, mas no sabemos qual vai ser a URI
dele, ento podemos colocar o verbo POST.
import br.com.caelum.vraptor.Post;
@Resource
@Post("/produtos")
//...
}
@Get("/produtos")
}
}
Captulo - REST - Mudando o verbo HTTP dos seus mtodos - Pgina
::.o Rvvn1onnNoo o Pnooc1osCoN1nottvn
O nosso ProdutosController a classe responsvel por controlar um recurso do sistema: o Produto. Nele
podemos realizar vrias operaes em cima dos Produtos, ento podemos padronizar as URIs que vo exe-
cutar tais operaes. Vamos remover todos os verbos das URIs, e usar o verbo HTTP para determinar qual
ser a operao, assim podemos criar URIs que representam recursos.
A URI /produtos representa a lista de todos os produtos do sistema. E as operaes possveis so:
GET /produtos => recupera a lista de todos os
produtos. Mtodo lista.
POST /produtos => adiciona um produto na lista de todos os
produtos. Mtodo adiciona.
As URIs do tipo /produtos/42 representam um produto especco, no caso de id . As operaes possveis
so:
GET /produtos/4 => mostra o produto de id 4. Mtodo edita.
PUT /produtos/10 => atualiza o produto de id 10. Mtodo atualiza.
DELETE /produtos/3 => remove o produto de id 3. Mtodo remove.
Nem todas as URIs precisam representar recursos xos, mas elas precisam semanticamente representar o
mesmo tipo de recurso. Por exemplo a URI /produtos/ultimo pode representar o ltimo produto adici-
onado e a URI /produtos/maisVendidos pode representar uma lista dos produtos mais vendidos, que so
recursos bem denidos. No nosso caso precisamos de uma URI para identicar o formulrio de adio de
um produto. Vamos ento usar a seguinte:
GET /produtos/novo => mostra o formulrio para adicionar um novo
produto. Mtodo formulario.
Com essa especicao de operaes no recurso Produto, podemos usar as anotaes vistas anteriormente
para deixar o ProdutosController de acordo com ela:
@Resource
@Get("/produtos/novo")
public void formulario() {...}
@Get("/produtos/{id}")
public Produto edita(Long id) {...}
@Put("/produtos/{produto.id}")
Captulo - REST - Refatorando o ProdutosController - Pgina
public void altera(Produto produto) {...}
@Post("/produtos")
public void adiciona(final Produto produto) {...}
@Delete("/produtos/{id}")
public void remove(Long id) {...}
@Get("/produtos")
public List<Produto> lista() {...}
}
Note no mtodo altera que o parmetro extrado o produto.id. O VRaptor vai se comportar da mesma
forma que se esse produto.id tivesse vindo da requisio: vai popular o campo id do produto com o valor
extrado.
Agora que mudamos as URIs dos mtodos, precisamos atualizar as nossas jsps para usar as URIs novas.
Podemos usar a tag c:url para poder usar as URIs absolutas, a partir do nosso nome de contexto.
Primeiro na jsp do formulrio, precisamos mudar a action do form para /produtos, e o method para POST.
<form action="<c:url value="/produtos"/>" method="POST">
Na listagem de produtos, temos um link para a edio, vamos mud-lo:
<a href="<c:url value="/produtos/${produto.id}"/>">Editar</a>
Ainda existe o link de Remoo, mas o mtodo remove do nosso controller s aceita o verbo DELETE! Como
fazer uma requisio com o verbo DELETE de dentro da sua pgina? Infelizmente os browsers atuais s con-
seguem fazer requisies GET (atrves de links e formulrios) e POST(atravs de formulrios). Para conseguir
usar os outros verbos, podemos fazer duas coisas:
mudar o verbo HTTP da requisio via javascript
passar um parmetro adicional, especicando qual deveria ser o mtodo da requisio. No VRaptor,
esse parmetro deve se chamar _method.
Ento, para criar o link de remoo, precisamos criar um formulrio (no podemos usar um <a href> pois
isso geraria uma requisio GETque no pode ter efeitos colaterais), que passa o parmetro _method=DELETE.
Podemos ainda fazer com que o boto do formulrio parea um link, para que a pgina de listagem parea a
mesma de antes:

<style type="text/css">
.link {
text-decoration: underline;
border: none;
background: none;
color: blue;
cursor: pointer;
}
</style>

<td>
<form action="<c:url value="/produtos/${produto.id}"/>" method="POST">
<button class="link" name="_method" value="DELETE">Remover</button>
</form>
</td>
Por ltimo precisamos mudar o formulrio de edio, colocando a action correta, e mudando o mtodo para
PUT. Mas como colocar method="PUT" no nosso formulrio no funciona, precisamos passar o parmetro
_method:
<form action="<c:url value="/produtos/${produto.id }"/>" method="POST">
<fieldset>
</textarea>

<button type="submit" name="_method" value="PUT">
Enviar
</button>
</fieldset>
</form>
No precisamos mais passar o input hidden com produto.id, porque essa informao j est na URI!
nc11oN v o IN1vnNv1 Exvtonvn
Em algumas verses do Internet Explorer, no possvel usar o name
e value do button para mandar parmetros na requisio. Nesse caso
voc precisa trocar o button por:
<input type="hidden" name="_method" value="PUT"/>
<input type="submit" value="Enviar"/>
::., Exvncc:os
) Anote os mtodos do ProdutosController para seguirmos a nossa especicao de Produto:
Recurso Produto:
GET /produtos => recupera a lista de todos os produtos.
Mtodo lista.
POST /produtos => adiciona um novo produto.
Mtodo adiciona.
GET /produtos/4 => mostra o produto de id 4.
Mtodo edita.
PUT /produtos/10 => atualiza o produto de id 10.
Mtodo atualiza.
DELETE /produtos/3 => remove o produto de id 3.
Mtodo remove.
GET /produtos/novo => mostra o formulrio para adicionar um
novo produto. Mtodo formulario.
) Abra o formulario.jsp e mude a action do form:
) Abra o edita.jsp e mude a action e o mtodo do form. Lembre-se que voc no precisa mais do input
hidden do produto.id.
<form action="<c:url value="/produtos/${produto.id }"/>"
method="POST">

<button type="submit" name="_method" value="PUT">
Enviar
</button>
</form>
) Modique o lista.jsp, colocando o link para Edio e o link para Remoo:
Captulo - REST - Exerccios - Pgina
<td><a href="<c:url value="/produtos/${produto.id}"/>">
Editar
</a></td>
<td>
<form action="<c:url value="/produtos/${produto.id}"/>"
method="POST">
<button class="link" name="_method" value="DELETE">
Remover
</button>
</form>
</td>
) Abra o header.jspf e modique os links do menu:
<div id="menu">
<ul>
<li><a href="<c:url value="/produtos/novo"/>">
Novo Produto
</a></li>
<li><a href="<c:url value="/produtos"/>">
Lista Produtos
</a></li>
</ul>
</div>
Captulo - REST - Exerccios - Pgina
C
AJAX e efeitos visuais
:i.: Oqcv v AJAX:
AJAX(Asynchronous Javascript and XML) umconjunto de tcnicas de desenvolvimento Web para executar
tarefas do lado do cliente, por exemplo modicar pedaos de uma pgina semter que carregar ela inteira. Na
verdade o mecanismo muito simples. De acordo com alguma ao um javascript envia uma requisio ao
servidor como se fosse embackground. Na resposta dessa requisio vemumXML que o javascript processa
e modica a pgina segundo essa resposta.
o efeito que tanto ocorre no gmail e google maps.
H vrias ferramentas para se trabalhar comAjax emJava. DWRe Google Web Toolkit so exemplos famosos
de ferramentas que te auxiliam na criao de sistemas que usam AJAX.
Ns utilizaremos o VRaptor no servidor para nos ajudar com as requisies Ajax. No cliente, usaremos a
biblioteca JQuery que totalmente escrita em JavaScript, portanto independente de linguagem do servidor.
H vrios frameworks javascript disponveis no mercado alm do JQuery. Apenas para citar os mais famo-
sos: Prototype/Script.aculo.us, Yahoo User Interface (YUI), Dojo. Usaremos o JQuery devido a sua extrema
simplicidade de uso, muito boa para quem no domina javascript mas quer usar recursos de Ajax.
:i.i Umvocco ov JQcvnv
A biblioteca JQuery baseada em um conceito de encadeamento (chaining). As chamadas de seus mtodos
so encadeadas uma aps a outra, o que cria cdigo muito simples de ser lido.
O ponto de partida do JQuery a funco $ que seleciona elementos DOM a partir de seletores CSS. Para
selecionar um n com id teste por exemplo, fazemos:
$('#teste')
ou para selecionar os elementos que possuem a classe produto:
$('.produto')
Svtv1onvs
OJQuery suporta XPath e CSS , comseletores avanadssimos (alm
dos clssicos id e class). Veja mais aqui: http://docs.jquery.com/
Selectors
Depois de selecionar o(s) elemento(s) desejado(s), podemos chamar mtodos para as mais variadas coisas.
O Hello World do JQuery mostra como exibir e esconder um div especico:
$('#meuDiv').show()
$('#meuDiv').hide()
Umoutro ponto forte do JQuery que ele possui diversos plugins que fazemvrias coisas interessantes como
validao de formulrios, autocomplete, efeitos visuais, drag n drop, etc. Uma lista de plugins disponveis
pode ser encontrada em http://plugins.jquery.com/. Uma documentao mais completa sobre o JQuery se
encontra em http://docs.jquery.com/ e uma documentao visual em http://www.visualjquery.com/.
Mn:s sonnv )nvnscn:v1
Nesse curso no daremos foco no desenvolvimento de cdigo javas-
cript, boas prticas e caractersticas dessa linguagem, apenas usare-
mos plugins do JQuery. Mas o cdigo javascript uma parte bas-
tante importante do desenvolvimento Web, e precisamos ter com ele
os mesmos cuidados que temos com o cdigo java.
Um contedo aprofundado sobre javascript, alm de CSS e HTML,
pode ser encontrado no curso WD-{ | Desenvolvimento Web com
HTML, CSS e JavaScript.
Captulo - AJAX e efeitos visuais - Um pouco de JQuery - Pgina
:i. Vnt:onNoo vonmctKn:os como JQcvnv
Quando zemos a validao do formulrio de adio de produtos, precisvamos enviar uma requisio para
o servidor, executando algumas lgicas para decidir se os dados estavamcorretos, para ento responder para
o usurio que os seus dados no esto vlidos. Isso pode ser evitado se zermos a validao do lado do
cliente.
Alm de ser bem mais rpido, evita que seja feita uma requisio desnecessria para o servidor.
Existe um plugin do JQuery chamado Validation (http://bassistance.de/jquery-plugins/
jquery-plugin-validation/) que torna a validao do lado do cliente bem simples. Para us-lo voc
precisa importar os javascripts no seu jsp:
<script type="text/javascript" src=".../jquery-1.3.2.min.js"></script>
<script type="text/javascript" src=".../jquery.validate.min.js"></script>
Voc tambm precisa falar qual vai ser o form que vai ser validado. Para isso voc pode adicionar um id ao
seu formulrio, e usar um seletor do JQuery para torn-lo validvel":
<form id="produtosForm" action="<c:url value="/produtos"/>"
method="POST">
...
<script type="text/javascript">
$('#produtosForm').validate();
</script>
Assim voc pode adicionar as restries aos seus campos, lembrando que o nome do produto obrigatrio
e tem que ter o tamanho maior que , a descrio tambm obrigatria e o tamanho tem que ser menor que
, e o preo maior que zero:
<fieldset>
<legend>Adicionar produtos</legend>
<input id="nome" class="required" minlength="3"
type="text" name="produto.nome" value="${produto.nome }"/>
<textarea id="descricao" class="required" maxlength="40"
name="produto.descricao">${produto.descricao }</textarea>
Captulo - AJAX e efeitos visuais - Validando formulrios com o JQuery - Pgina
<input id="preco" min="0"
type="text" name="produto.preco" value="${produto.preco }"/>
</fieldset>
</form>
Se voc no gosta de colocar mais atributos nos seus campos de formulrio, voc ainda pode denir todas as
regras de validao de uma vez s, usando os names dos inputs, dentro da parte rules:
$('#produtosForm').validate({
rules: {
"produto.nome": {
required: true,
minlength: 3
},
"produto.descricao": {
required: true,
maxlength: 40
},
"produto.preco": {
min: 0.0
}
}
});
</script>
:i.{ Cn:nNoo n ncscn ov vnooc1os
Como todo loja virtual que se preze, precisamos criar uma funcionalidade de busca de produtos. Para isso
vamos criar uma lgica que efetua a busca no banco, dentro do ProdutosController:
@Resource
//...
public List<Produto> busca(String nome) {
return dao.busca(nome);
}
}
Captulo - AJAX e efeitos visuais - Criando a busca de produtos - Pgina
Repare que o nosso dao ainda no possui o mtodo busca, mas podemos usar o eclipse para criar esse mtodo
pra ns. Para isso, coloque o cursor em cima do erro de compilao e aperte Ctrl+1. No menu que apareceu
selecione Create method busca(String) in type ProdutoDao.
Agora podemos modicar o mtodo criado no ProdutoDao para realmente buscar os produtos que contm
a string passada no nome. Para isso usaremos a API de Criteria do Hibernate:
@Component
//...
return session.createCriteria(Produto.class)
.add(Restrictions.ilike("nome", nome, MatchMode.ANYWHERE))
.list();
}
}
Traduzindo essa chamada: crie uma Criteria de produtos, com a restrio de que o nome contenha a string
passada em qualquer lugar, ignorando maisculas e minsculas.
Agora precisamos criar o jsp que mostra os resultados da busca, em /WEB-INF/jsp/produto/busca.jsp.
Podemos aproveitar o jsp de listagem para mostrar a tabela:
<h3>Resultados da busca pelo nome <b>"${nome }"</b></h3>
<%@ include file="lista.jsp" %>
Precisamos tambm passar o nome que foi buscado, ento podemos mudar o mtodo busca do
ProdutosController:
result.include("nome", nome);
}
Por ltimo, vamos criar um formulrio para poder acessar essa busca. Abra o arquivo header.jspf e modi-
que o div menu:
<div id="menu">
<ul>
<li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li>
<li><a href="<c:url value="/produtos"/>">Lista Produtos</a></li>
<li><form action="<c:url value="/produto/busca"/>">
<input name="nome"/>
</form>
</li>
</ul>
</div>
Para que no que um input perdido no menu, sem que as pessoas saibam o que ele faz, podemos usar
um plugin do JQuery bem simples chamado Puts (http://github.com/cairesvs/Puts). Esse plugin coloca um
texto em cima do input, e quando a pessoa clica nele, o texto some. Assim podemos colocar o texto Busca
de produtos por nome no nosso input. Para usar esse plugin, precisamos baixar o javascript e import-lo na
nossa pgina, e ento usar o mtodo puts() para colocar nosso texto.
<script type="text/javascript"
src="<c:url value="/javascripts/jquery.puts.js"/>"></script>
...
<input id="busca" name="nome"/>
</form>
$("#busca").puts("Busca produtos por nome");
</script>
</li>
Assim temos o seguinte resultado:
:i. MvtnonnNoo n ncscn: Ac1ocomvtv1v
Podemos ainda melhorar nossa busca, mostrando dicas de produtos j existentes enquanto o usurio est
digitando. Queremos um resultado parecido com este:
Para isso vamos usar um plugin do JQuery chamado AutoComplete (http://bassistance.de/jquery-plugins/
jquery-plugin-autocomplete/) que faz autocomplete de campos de texto. Esse plugin faz uma requisio ajax
para uma URL que retorna um JSON com os dados que vo aparecer no autocomplete.
Por causa desse plugin, precisamos criar uma lgica que gere um JSON para ns. No VRaptor, gerar JSON
bem simples:
import static br.com.caelum.vraptor.view.Results.*;
//...
@Get("/produtos/busca.json")
public void buscaJson(String nome) {
result.use(json()).from(dao.busca(nome)).serialize();
}
Ou seja, voc passa para o mtodo from() o que voc quer serializar em JSON. Pode ser um objeto qual-
quer, mas no nosso caso vai ser uma lista. Ao chamarmos a URI desse mtodo no browser, passando um
nome qualquer, por exemplo http://localhost:/goodbuy/produtos/busca.json?nome=a retornado um JSON
parecido com:
Captulo - AJAX e efeitos visuais - Melhorando a busca: Autocomplete - Pgina
{"list": [
{
"id": 1,
"nome": "Sabonete",
"descricao": "Um sabonete com perfume de lavanda",
"preco": "3.53"
},
{
"id": 3,
"nome": "Sapato",
"descricao": "um sapato de couro",
"preco": "132.00"
}
]}
Mas como vamos buscar os produtos apenas por nome, no precisamos de todas essas informaes, s pre-
cisamos de uma lista de nomes, talvez com o preo. Para isso podemos excluir as outras propriedades:
import static br.com.caelum.vraptor.view.Results.*;
//...
@Get @Path("/produtos/busca.json")
public void buscaJson(String nome) {
result.use(json()).from(dao.busca(nome))
.exclude("id", "descricao")
.serialize();
}
Gerando o seguinte json:
{"list": [
{
"nome": "Sabonete",
"preco": "3.53"
},
{
"nome": "Sapato",
"preco": "132.00"
}
]}
Podemos tambm remover o {list": } usando o mtodo .withoutRoot():
result.use(json()).withoutRoot()
.from(dao.busca(nome))
.serialize();
que gera o json:
[
{
"nome": "Sabonete",
"preco": "3.53"
},
{
"nome": "Sapato",
"preco": "132.00"
}
]
Agora estamos prontos para usar o plugin de autocomplete. Para isso, abra o arquivo header.jspf , e adicione
o javascript e o css do plugin. Use o mesmo lugar do plugin Puts:
<link
href="<c:url value="/javascripts/jquery.autocomplete.css"/>"
rel="stylesheet" type="text/css" media="screen" />
<script type="text/javascript"
src="<c:url value="/javascripts/jquery.autocomplete.min.js"/>"></script>
...
$("#busca").autocomplete('/goodbuy/produtos/busca.json');
</script>
Isso deveria ser o suciente, mas o plugin AutoComplete espera que voc mande os dados separados por
pipe(|) ou um dado por linha. Como queremos usar JSON, precisamos congurar isso no plugin:
$("#busca").autocomplete('/goodbuy/produtos/busca.json', {
dataType: "json", // pra falar que vamos tratar um json
parse: function(produtos) { // para tratar o json
// a funo map vai iterar por toda a lista,
// e transformar os dados usando a funo passada
return $.map(produtos, function(produto) {
return {
// todos os dados do produto
data: produto,
// o valor lgico do produto
value: produto.nome,
// o que vai aparecer ao selecionar
result: produto.nome
};
});
},
// o que vai aparecer na lista de autocomplete
formatItem: function(produto) {
return produto.nome + "(" + produto.preco + ")";
}
});
Alm disso, o plugin passa como parmetro da requisio o que voc digitou no input, numa varivel cha-
mada q ento voc precisa modicar a lgica de busca para o parmetro se chamar q:
public void buscaJson(String q) {
.from(dao.busca(q))
.serialize();
}
Pnnn snnvn mn:s: c:cnt ovN1no ov )nvnscn:v1
Repare que estamos passando o nome de contexto (goodbuy) nas
URLs do javascript acima. Isso uma pssima prtica, pois o nome
de contexto depende de como voc fez o deploy de sua aplicao. Do
jeito que zemos, somos obrigados a sempre fazer o deploy da apli-
cao com o nome goodbuy.
Para corrigir isso, podemos usar a tag c:url dentro do javascript:
$("#busca").autocomplete('<c:url value="/produtos/busca.json"/>');
possvel usar qualquer tag JSTL ou Expression Language dentro dos
javascripts das suas jsps. Mas cuidado, pois seus javascripts podem
car mais difceis de entender.
:i.o Exvncc:os
) Modique os formulrios de adio e edio de produtos para incluir a validao do lado do cliente. Os
javascripts do plugin j esto importados no projeto base. Se preferir use a outra forma de validao,
passando as opes para o mtodo validate().
Captulo - AJAX e efeitos visuais - Exerccios - Pgina
<form id="produtosForm" action="<c:url value="/produtos"/>"
method="POST">
<fieldset>
<legend>Adicionar produtos</legend>
<input id="nome" class="required" minlength="3"
type="text" name="produto.nome"
<textarea id="descricao" class="required"
maxlength="40" name="produto.descricao">
</textarea>
<input id="preco" min="0" type="text"
name="produto.preco" value="${produto.preco }"/>
</fieldset>
</form>
$('#produtosForm').validate();
</script>
) Tente adicionar um produto invlido.
) (Opcional) As mensagens de erro esto emingls. Tente procurar na documentao do plugin como fazer
para que as mensagens quem em portugus.
) Crie um mtodo em ProdutosController para a listagem de produtos.
@Resource
//...
}
}
) Use o atalho Ctrl+1 para criar o mtodo busca no ProdutoDao.
) Implemente o mtodo busca no ProdutoDao.
@Component
//...
.list();
}
}
) Crie o JSP de resultado da busca, em /WEB-INF/jsp/produto/busca.jsp
<h3>Resultados da busca pelo nome <b>"${nome }"</b></h3>
<%@ include file="lista.jsp" %>
) Abra o arquivo header.jspf e modique o menu para incluir um formulrio de busca:
<div id="menu">
<ul>
<input name="nome"/>
</form>
</li>
</ul>
</div>
) Faa buscas usando esse formulrio.
) Modique o formulrio de busca para usar o plugin Puts e deixar uma mensagem dentro do input.
<div id="menu">
<ul>
<input id="busca" name="nome"/>
</form>
</script>
</li>
</ul>
</div>
) Recarregue a pgina atual e veja que a mensagem apareceu no input.
) Crie o mtodo de busca que retorna JSON no ProdutosController.
public void buscaJson(String q) {
.from(dao.busca(q))
.serialize();
}
) Adicione o cdigo javascript para que o autocomplete funcione.
$("#busca").autocomplete('/goodbuy/produtos/busca.json', {
dataType: "json",
parse: function(produtos) {
return $.map(produtos, function(produto) {
return {
data: produto,
value: produto.nome,
result: produto.nome
};
});
},
formatItem: function(produto) {
return produto.nome + "(" + produto.preco + ")";
}
});
) Recarregue a pgina e teste o autocomplete digitando algo no campo de busca.
:i., Pnnn snnvn mn:s: RvvnvsvN1n1:oN
possvel usar a mesma lgica para a busca normal e a busca por json, usando a view representation() do
VRaptor.
Captulo - AJAX e efeitos visuais - Para saber mais: Representation - Pgina
public void busca(String nome) {
result.use(representation())
.from(dao.busca(q), "produtos")
.serialize();
}
Assim, se a requisio for feita passando o content-type application/json, ser a lista serializada em json, se
for passado o content type application/xml, ser serializada em xml, seno o VRaptor redireciona para a
jsp respectiva, com a varivel {produtos} disponvel.
Captulo - AJAX e efeitos visuais - Para saber mais: Representation - Pgina
C
Criando o Carrinho de Compras
:.: Omoovto oo Cnnn:Nno
Ainda no possvel comprar os produtos na nossa loja virtual. Precisamos de algum jeito fazer com que o
usurio selecione os produtos que deseja comprar. O jeito mais comum de fazer isso criar um carrinho de
compras, guardando os produtos que foram selecionados.
Vamos criar uma classe que representa o carrinho de compras. Essa classe vai conter uma lista dos produtos
escolhidos e o valor total:
public class Carrinho {
private List<Item> itens = new ArrayList<Item>();
private Double total = 0.0;
// getters e setters
}
Alm disso precisamos criar uma classe que representa um item do carrinho: um produto com a quantidade
selecionada.
public class Item {
private Produto produto;
private Integer quantidade;
// getters e setters
}
Pergunta importante: precisamos guardar esse carrinho no banco? O usurio no comprou ainda os produ-
tos, ento no faz muito sentido guardar no banco de dados. Esse carrinho precisa car disponvel enquanto
o usurio estiver navegando no sistema, ento podemos apenas colocar o carrinho na sesso. Como vimos
antes, para que um componente seja nico durante a sesso do usurio basta anot-lo com @SessionScoped,
ento basta modicar a classe do carrinho para incluir as anotaes:
@Component
@SessionScoped
//getters e setters
}
Agora podemos receber esse carrinho no construtor de algum controller, com a certeza de que ele ser nico
durante a sesso do usurio.
:.i CoN1notnNoo o cnnn:Nno ov comvnns
Agora que temos o modelo do Carrinho, vamos criar uma maneira de adicionar produtos. O jeito mais
simples modicar a listagem de produtos adicionando um boto para comprar:
<table>
<thead>
<tr>
...
<th>Comprar</th>
...
</tr>
</thead>
<tbody>
Captulo - Criando o Carrinho de Compras - Controlando o carrinho de compras - Pgina
<tr>
...
<td>

<form action="<c:url value="/carrinho"/>" method="POST">
<input type="hidden" name="item.produto.id"
value="${produto.id }"/>
<input class="qtde" name="item.quantidade" value="1"/>
<button type="submit">Comprar</button>
</form>
</td>
...
</tr>
</c:forEach>
</tbody>
</table>
O novo formulrio vai adicionar um item ao carrinho, passando a quantidade e o id do produto. Precisamos
agora criar um controlador que trate das operaes no carrinho de compras, que seja capaz de adicionar um
item ao carrinho. Esse controlador vai se chamar CarrinhoController:
@Resource
public class CarrinhoController {
}
Vamos criar o mtodo que responde URI colocada no formulrio de compra:
@Resource
@Post("/carrinho")
public void adiciona(Item item) {
}
}
Para adicionar o itemao carrinho, temos que receber umCarrinho no construtor, assimo VRaptor vai passar
para o CarrinhoController o carrinho da sesso do usurio:
@Resource
private final Carrinho carrinho;
public CarrinhoController(Carrinho carrinho) {
this.carrinho = carrinho;
}
@Post("/carrinho")
carrinho.adiciona(item);
}
}
No existe ainda o mtodo adiciona no Carrinho, ento use o Ctrl+1 para criar o mtodo. Ao adicionar um
item no carrinho precisamos atualizar o total:
itens.add(item);
total += item.getProduto().getPreco() * item.getQuantidade();
}
//...
}
Repare que estamos usando o preo do produto para atualizar o total do carrinho, mas no formulrio s
estamos passando o id do produto. Precisamos carregar as outras informaes do Produto no banco de
dados, usando o ProdutoDao:
@Resource
public CarrinhoController(Carrinho carrinho, ProdutoDao dao) {
this.dao = dao;
}
@Post @Path("/carrinho")
dao.recarrega(item.getProduto());
}
}
Para implementar o mtodo recarrega no ProdutoDao, vamos usar um mtodo da Session que busca as
informaes no banco e coloca no prprio objeto passado. Esse mtodo se chama refresh.
@Component
//...
public void recarrega(Produto produto) {
session.refresh(produto);
}
}
Por ltimo, precisamos ir para alguma pgina aps adicionar algum item no carrinho. Por ora, vamos vol-
tar pra pgina de listagem de produtos. Repare que como o redirecionamento para uma lgica de outro
controller, precisamos usar a classe deste controller:
@Resource
public CarrinhoController(Carrinho carrinho,
ProdutoDao dao, Result result) {
this.dao = dao;
}
@Post("/carrinho")
}
}
:. V:scnt:znNoo os :1vNs oo cnnn:Nno
J conseguimos adicionar itens no carrinho, mas no possvel ainda visualizar o que tem dentro dele. Pri-
meiro, vamos adicionar uma lugar em todas as pginas que mostra o estado atual do carrinho: quantos itens
ele teme qual o valor total. Mas como vamos acessar o carrinho da sesso emtodas as nossas pginas? Ser
que precisamos incluir o carrinho no Result em todas as lgicas? No, isso no necessrio.
Quando criamos um componente SessionScoped, o VRaptor coloca a instncia desse componente como
um atributo da sesso, usando a conveno de nomes padro. Ou seja, para o Carrinho, existir um atri-
buto da sesso chamado carrinho, ento voc consegue acessar o carrinho nas suas jsps usando a varivel
${carrinho}.
Vamos, ento, abrir o arquivo header.jspf e adicionar dentro da div header uma div do carrinho:
<div id="header">
<div id="carrinho">
<h3>Meu carrinho:</h3>
<c:if test="${empty carrinho or carrinho.totalDeItens eq 0 }">
<span>Voc no possui itens no seu carrinho</span>
</c:if>
<c:if test="${carrinho.totalDeItens > 0 }">
<ul>
<li>
<strong>Itens:</strong> ${carrinho.totalDeItens }
</li>
<li>
<strong>Total:</strong>
<fmt:formatNumber type="currency"
value="${carrinho.total }"/>
</li>
</ul>
</c:if>
Captulo - Criando o Carrinho de Compras - Visualizando os itens do carrinho - Pgina
</div>
</div>
Estamos usando a expresso ${carrinho.totalDeItens} mas classe Carrinho no possui um getter para
esse total de itens. Ento vamos adicionar:
//...
public Integer getTotalDeItens() {
return itens.size();
}
}
Agora ao adicionar produtos ao carrinho, conseguimos ver a quantidade de produtos adicionados e o valor
total do carrinho nessa div que acabamos de criar:
Ainda no conseguimos visualizar os itens do carrinho, ento vamos criar uma lgica que liste os itens, no
CarrinhoController.
@Get @Path("/carrinho")
public void visualiza() {
}
Esse mtodo vai atender mesma URI que o mtodo adiciona, mas com outro verbo HTTP: o GET. Agora
podemos criar a pgina que lista os itens. Crie essa pgina em /WEB-INF/jsp/carrinho/visualiza.jsp.
<h3>Itens do seu carrinho de compras</h3>
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
<th>Qtde</th>
<th>Total</th>
</tr>
</thead>
<tbody>
<c:forEach items="${carrinho.itens}" var="item">
<tr>
<td>${item.produto.nome }</td>
<td>${item.produto.descricao }</td>
<td>
value="${item.produto.preco }"/>
</td>
<td>${item.quantidade }</td>
<td>
value="${item.quantidade * item.produto.preco }"/>
</td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
<td colspan="2"></td>
<th colspan="2">Total:</th>
<th>
</th>
</tr>
</tfoot>
</table>
Para acessar essa visualizao, vamos criar um link na div do carrinho:
<div id="header">
<div id="carrinho">
<h3><a href="<c:url value="/carrinho"/>">Meu carrinho:</a></h3>
Agora que temos uma pgina de visualizao, podemos redirecionar para ela quando adicionamos algum
produto ao carrinho.
@Resource
//...
@Post("/carrinho")
result.redirectTo(this).visualiza();
}
}
:.{ RvmovvNoo :1vNs oo cnnn:Nno
Para completar as funcionalidades do carrinho de compras, vamos modicar a visualizao do carrrinho
para ser possvel remover itens:
<table>
...
<tbody>
<c:forEach items="${carrinho.itens}" var="item" varStatus="s">
<tr>
...
<td>
<form action="<c:url value="/carrinho/${s.index }"/>" method="POST">
</form>
</td>
</tr>
</c:forEach>
</tbody>
...
</table>
Vamos criar, tambm, o mtodo que remove itens do carrinho no controller:
//...
@Delete("/carrinho/{indiceItem}")
public void remove(int indiceItem) {
Captulo - Criando o Carrinho de Compras - Removendo itens do carrinho - Pgina
carrinho.remove(indiceItem);
}
}
E implementar o mtodo que remove o item do carrinho, atualizando o total:
//...
Item removido = itens.remove(indiceItem);
total -= removido.getProduto().getPreco() * removido.getQuantidade();
}
}
:. Exvncc:os
) Crie os modelos Carrinho e Item:
package br.com.caelum.goodbuy.modelo;
@Component
@SessionScoped
//getters e setters
}
public class Item {
private Produto produto;
private Integer quantidade;
//getters e setters
}
) Modique a listagem de produtos para incluir um boto para comprar o produto:
<table>
<thead>
Captulo - Criando o Carrinho de Compras - Exerccios - Pgina
<tr>
...
<th>Comprar</th>
...
</tr>
</thead>
<tbody>
<tr>
...
<td>

<form action="<c:url value="/carrinho"/>" method="POST">
<input type="hidden" name="item.produto.id"
value="${produto.id }"/>
<input class="qtde" name="item.quantidade" value="1"/>
<button type="submit">Comprar</button>
</form>
</td>
...
</tr>
</c:forEach>
</tbody>
</table>
) Adicione o div do carrinho no cabealho da pgina (arquivo header.jspf)
<div id="header">
<div id="carrinho">
<h3><a href="<c:url value="/carrinho"/>">Meu carrinho:</a></h3>
<c:if test="${empty carrinho or carrinho.totalDeItens eq 0 }">
<span>Voc no possui itens no seu carrinho</span>
</c:if>
<c:if test="${carrinho.totalDeItens > 0 }">
<ul>
<li><strong>Itens:</strong> ${carrinho.totalDeItens }</li>
<li><strong>Total:</strong>
<fmt:formatNumber type="currency" value="${carrinho.total }"/></li>
</ul>
</c:if>
</div>
</div>
) Crie o CarrinhoController, com um mtodo para adicionar itens no carrinho.
@Resource
public CarrinhoController(Carrinho carrinho,
ProdutoDao dao, Result result) {
this.dao = dao;
}
@Post("/carrinho")
}
}
//...
itens.add(item);
total += item.getProduto().getPreco() *
item.getQuantidade();
}
public Integer getTotalDeItens() {
return itens.size();
}
}
//...
}
}
) Compre alguns produtos e veja o carrinho sendo atualizado no header.
) Crie a lgica e o jsp que visualiza os itens do carrinho. Mude tambm o redirecionamento do mtodo
adiciona para a nova lgica.
@Resource
//...
@Get("/carrinho")
public void visualiza() {
}
@Post("/carrinho")
}
}
/WEB-INF/jsp/carrinho/visualiza.jsp
<h3>Itens do seu carrinho de compras</h3>
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
<th>Qtde</th>
<th>Total</th>
</tr>
</thead>
<tbody>
<c:forEach items="${carrinho.itens}" var="item"
varStatus="s">
<tr>
<td>${item.produto.nome }</td>
<td>${item.produto.descricao }</td>
<td>
value="${item.produto.preco }"/>
</td>
<td>${item.quantidade }</td>
<td>
value="${item.quantidade * item.produto.preco }"/>
</td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
<td colspan="2"></td>
<th colspan="2">Total:</th>
<th>
</th>
</tr>
</tfoot>
</table>
) Adicione mais produtos ao carrinho.
) Crie a lgica de remover produtos do carrinho e adicione o boto de remoo na visualizao do carri-
nho.
//...
@Delete("/carrinho/{indiceItem}")
carrinho.remove(indiceItem);
}
}
Item removido = itens.remove(indiceItem);
total -= removido.getProduto().getPreco() * removido.getQuantidade();
}
}
/WEB-INF/jsp/carrinho/visualiza.jsp
<table>
...
<tbody>
<c:forEach items="${carrinho.itens}" var="item" varStatus="s">
<tr>
...
<td>
<form action="<c:url value="/carrinho/${s.index }"/>" method="POST">
</form>
</td>
</tr>
</c:forEach>
</tbody>
...
</table>
) Adicione e remova itens do carrinho.
C
Autenticao
:{.: Cn:nNoo UscKn:os
No nosso sistema, atualmente, qualquer um pode adicionar, editar ou remover produtos. Ser que isso o
desejvel? No seria melhor apenas habilitar essas funcionalidades para os administradores do sistema?
Ento vamos criar um sistema de login para a nossa aplicao, comeando pelo modelo de usurios:
public class Usuario {
private String login;
private String senha;
//getters e setters
}
uma boa idia guardar os usurios no banco de dados, ento vamos adicionar as anotaes do hibernate.
No h a necessidade de criar um campo id para usurios, pois o login j ser um identicador nico.
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
public class Usuario {
@Id
private String login;
private String senha;
//getters e setters
}
Como estamos adicionando uma entidade nova, precisamos coloc-la no hibernate.cfg.xml. Ainda vamos
adicionar a propriedade hibernate.hbm2ddl.auto com o valor update, assim o hibernate far as mudanas
nas tabelas do banco quando necessrio.
<session-factory>

<property name="hibernate.hbm2ddl.auto">update</property>
<mapping class="br.com.caelum.goodbuy.modelo.Usuario" />
</session-factory>
Com o modelo pronto j possvel criar as lgicas de cadastro e de login de usurios. Vamos comear pelo
cadastro, criando o controlador de usurios com uma lgica para mostrar o formulrio:
@Resource
public class UsuariosController {
public void novo() {
Captulo - Autenticao - Criando Usurios - Pgina
}
}
E ento o jsp com o formulrio, em /WEB-INF/jsp/usuarios/novo.jsp, com todos os campos obrigatrios:
<form id="usuariosForm" action="<c:url value="/usuarios"/>"
method="POST">
<fieldset>
<legend>Criar novo usurio</legend>
<input id="nome" class="required"
type="text" name="usuario.nome" value="${usuario.nome }"/>
<label for="login">Login:</label>
<input id="login" class="required"
type="text" name="usuario.login" value="${usuario.login }"/>
<label for="senha">Senha:</label>
<input id="senha" class="required" type="password"
name="usuario.senha"/>
<label for="confirmacao">Confirme a senha:</label>
<input id="confirmacao" equalTo="#senha" type="password"/>
</fieldset>
</form>
$('#usuariosForm').validate();
</script>
Precisamos tambmcriar umlink para esse cadastro. Para isso criaremos uma div no cabealho que mostrar
as informaes do usurio. Abra o arquivo header.jspf e modique a div header:
<div id="header">
<div id="usuario">
Voc no est logado.
<a href="<c:url value="/usuarios/novo"/>">
Cadastre-se
</a>
</div>
...
</div>
Para completar o cadastro, vamos criar a lgica que adiciona o usurio de fato, validando se o login escolhido
ainda no existe no sistema:
@Resource
private final UsuarioDao dao;
public UsuariosController(UsuarioDao dao, Result result,
this.dao = dao;
}
@Post("/usuarios")
public void adiciona(Usuario usuario) {
if (dao.existeUsuario(usuario)) {
validator.add(new ValidationMessage("Login j existe",
"usuario.login"));
}
validator.onErrorUsePageOf(UsuariosController.class).novo();
dao.adiciona(usuario);
}
//...
}
O UsuarioDao ainda no existe. Use o Ctrl+1 para criar o dao e os seus mtodos:
@Component
public class UsuarioDao {
public UsuarioDao(Session session) {
}
public boolean existeUsuario(Usuario usuario) {
Usuario encontrado = (Usuario) session.createCriteria(Usuario.class)
.add(Restrictions.eq("login", usuario.getLogin()))
.uniqueResult();
return encontrado != null;
}
public void adiciona(Usuario usuario) {
Transaction tx = this.session.beginTransaction();
this.session.save(usuario);
tx.commit();
}
}
:{.i Evv1cnNoo o toc:N
Criamos o cadastro, mas o usurio ainda no consegue fazer o login. Primeiro vamos criar um link para
acessar o formulrio de login, no cabealho:
<div id="header">
<div id="usuario">
Voc no est logado. <a href="<c:url value="/login"/>">Login</a>
<a href="<c:url value="/usuarios/novo"/>">Cadastre-se</a>
</div>
e a respectiva lgica e formulrio:
@Resource
//...
@Get("/login")
public void loginForm() {
}
}
<form action="<c:url value="/login"/>" method="POST">
<fieldset>
<legend>Efetue o login</legend>
<label for="login">Login:</label>
<input id="login" type="text" name="usuario.login"/>
Captulo - Autenticao - Efetuando o login - Pgina
<label for="senha">Senha:</label>
<input id="senha" type="password" name="usuario.senha"/>
<button type="submit">Login</button>
</fieldset>
</form>
Quando o usurio faz o login, precisamos guardar a informao de que ele j est logado. A melhor forma
guardar a informao de login na sesso, que mantm os dados enquanto o usurio estiver navegando
pela aplicao. Para isso, vamos criar uma classe que guarda o usurio logado. Essa classe ser acessada nos
jsps para acessar as informaes do usurio, ento adicionamos alguns getters para expor as informaes
relevantes.
@Component
@SessionScoped
public class UsuarioWeb {
private Usuario logado;
public void login(Usuario usuario) {
this.logado = usuario;
}
public String getNome() {
return logado.getNome();
}
public boolean isLogado() {
return logado != null;
}
}
Ento na nossa lgica de login, podemos colocar o usurio logado dentro da classe acima, depois de vericar
que o usurio digitou o login e senha certos.
@Resource
private final UsuarioWeb usuarioWeb;
//...
public UsuariosController(UsuarioDao dao, Result result,
Validator validator, UsuarioWeb usuarioWeb) {
//...
this.usuarioWeb = usuarioWeb;
}
@Post("/login")
public void login(Usuario usuario) {
Usuario carregado = dao.carrega(usuario);
if (carregado == null) {
validator.add(
new ValidationMessage("Login e/ou senha invlidos",
"usuario.login"));
}
validator.onErrorUsePageOf(UsuariosController.class)
.loginForm();
usuarioWeb.login(carregado);
}
}
Para carregar o usurio, crie o mtodo no UsuarioDao que busca um usurio por login e senha:
@Component
public class UsuarioDao {
//...
public Usuario carrega(Usuario usuario) {
return (Usuario) session.createCriteria(Usuario.class)
.add(Restrictions.eq("login", usuario.getLogin()))
.add(Restrictions.eq("senha", usuario.getSenha()))
.uniqueResult();
}
}
E para mostrar que o usurio est logado mesmo, vamos modicar o cabealho:
<div id="header">
<div id="usuario">
<c:if test="${usuarioWeb.logado}">
Ol, ${usuarioWeb.nome }!
<a href="<c:url value="/logout"/>">Logout</a>
</c:if>
<c:if test="${empty usuarioWeb or not usuarioWeb.logado}">
Voc no est logado.
<a href="<c:url value="/login"/>">Login</a>
<a href="<c:url value="/usuarios/novo"/>">Cadastre-se</a>
</c:if>
</div>
...
</div>
Por ltimo vamos adicionar a lgica de logout:
//...
@Path("/logout")
public void logout() {
usuarioWeb.logout();
}
}
public class UsuarioWeb {
//...
public void logout() {
this.logado = null;
}
}
:{. Rvs1n:Nc:Noo vcNc:oNnt:onovs vnnn cscKn:os tocnoos
Como falamos no comeo do captulo, no legal que todo mundo consiga adicionar, remover e editar
produtos. Vamos, ento, fazer com que s usurios logados consigam acessar essas funcionalidades. Um
primeiro passo retirar os links para elas quando o usurio no est logado:
/header.jspf:
<div id="menu">
<ul>
<c:if test="${usuarioWeb.logado }">
<li><a href="<c:url value="/produtos/novo"/>">
Novo Produto
</a></li>
</c:if>
...
/WEB-INF/jsp/produto/lista.jsp
Captulo - Autenticao - Restringindo funcionalidades para usurios logados - Pgina
<table>
...
<tbody>
<tr>
...
<c:if test="${usuarioWeb.logado }">
<td>
<a href=
"<c:url value="/produtos/${produto.id}"/>">
Editar
</a>
</td>
<td>
<form action=
"<c:url value="/produtos/${produto.id}"/>"
method="POST">
<button class="link" name="_method"
value="DELETE">
Remover
</button>
</form>
</td>
</c:if>
</tr>
</c:forEach>
</tbody>
</table>
Agora os usurios que no esto logados no conseguem mais ver os links das aes que ele no pode exe-
cutar. Mas ser que isso o suciente? O que impede o usurio de digitar na barra de endereos do browser:
http://localhost:/goodbuy/produtos/novo? Nada! Ele s precisa conhecer qual a URI. Precisamos, de al-
gum jeito, impedir que os usurios acessem certas URIs se eles no estiverem logados, monitorar todas as
aes do usurio para que quando ele acessar uma URI proibida, redirecionar para uma pgina de erro, ou
melhor, para o login.
:{.{ IN1vncvv1on
UmInterceptor no VRaptor como se fosse umServlet Filter: ele pode interceptar requisies, executando
algo antes e/ou depois da sua lgica. Mais ainda, ele pode impedir que sua lgica seja executada, redirecio-
nando a requisio para outro lugar. Isso exatamente o que a gente queria: vericar se o usurio est logado
antes de ir pro controller, e se ele no estiver, redirecionar para o login.
Para implementar um Interceptor do VRaptor precisamos de duas coisas: anotar a classe com @Intercepts
Captulo - Autenticao - Interceptor - Pgina
e implementar a interface Interceptor:
@Intercepts
public class AutenticacaoInterceptor implements Interceptor {
...
}
Essa interface tem dois mtodos:
public boolean accepts(ResourceMethod method) - decide se vai ou no interceptar a requisio
atual. o parmetro method representa qual o mtodo java que ser executado na requisio, o m-
todo do seu controller. Com esse objeto voc tem acesso classe do controller e ao mtodo java dele
(java.reect.Method) para poder, por exemplo, ver qual o nome do mtodo, ou se ele tem alguma
anotao
public void intercept(InterceptorStack stack, ResourceMethod method, Object
resourceInstance) throws InterceptionException { - intercepta a requisio. O parmetro
stack possibilita continuar a execuo normal da requisio e, portanto, executar de fato a lgica de
negcios. O parmetro method o mesmo do mtodo accepts, e o resourceInstance o controller
instanciado.
Como qualquer classe registrada no VRaptor, voc pode receber qualquer componente da sua aplicao (e
do VRaptor) pelo construtor do seu interceptor. No nosso caso precisamos vericar se o usurio est logado,
e essa informao est no UsuarioWeb.
@Intercepts
public class AutorizacaoInterceptor implements Interceptor {
private final UsuarioWeb usuario;
public AutorizacaoInterceptor(UsuarioWeb usuario) {
this.usuario = usuario;
}
}
Mas s precisamos executar a lgica de autenticao caso o usurio no esteja logado, ento vamos imple-
mentar o mtodo accepts:
public boolean accepts(ResourceMethod method) {
return !this.usuario.isLogado();
}
Para o mtodo intercepts, sabemos j que o usurio no est logado, ento vamos redirecionar para a lgica
de login. Para isso precisamos do Result.
@Intercepts
public class AutorizacaoInterceptor implements Interceptor {
private final UsuarioWeb usuario;
public AutorizacaoInterceptor(UsuarioWeb usuario, Result result) {
this.usuario = usuario;
}
return false;
}
public void intercept(InterceptorStack stack, ResourceMethod method,
Object resourceInstance) throws InterceptionException {
result.redirectTo(UsuariosController.class).loginForm();
}
}
No o caso, mas se quisssemos continuar a requisio normalmente, poderamos fazer:
stack.next(method, resourceInstance);
Mas temos um pequeno problema: se o usurio no estiver logado ele no vai conseguir acessar nada no
sistema, nem o login! Na verdade, s queremos proibir que o usurio adicione e modique produtos, ento
nosso interceptor s pode executar para essas operaes.
Poderamos at colocar no Interceptor uma lista dos mtodos que sero interceptados, mas assim toda vez
que adicionarmos uma operao nova que precise de autenticao precisaramos mudar o interceptor.
Um jeito mais legal de fazer isso marcar os mtodos que precisam de autenticao. Para isso podemos criar
uma anotao para ser colocada nos mtodos:
//a anotao vai ficar disponvel em tempo de execucao
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD) // anotao para mtodos
public @interface Restrito {
}
Assim, podemos anotar os mtodos restritos (adiciona, atualiza, remove, formulario e edita do Produtos-
Controller):
@Resource
@Restrito
public void formulario() {}
@Restrito
public Produto edita(Long id) {...}
@Restrito
public void altera(Produto produto) {...}
@Restrito
public void adiciona(final Produto produto) {...}
@Restrito
public void remove(Long id) {...}
...
}
E do lado do Interceptor, apenas fazemos:
return !usuario.isLogado() && method.containsAnnotation(Restrito.class);
}
Pronto. Nosso sistema de autenticao est pronto. Poderamos trocar a anotao @Restrito por uma, por
exemplo, @Liberado caso tenha bem mais operaes liberadas do que restritas, depende do seu sistema.
C
Apndice - Download e Upload
Nesse captulo, vamos adicionar imagens aos produtos, para uma melhor visualizao na listagem. Para isso,
precisamos fazer o upload dessas imagens para o servidor, e depois fazer o download para mostr-las na
listagem.
:.: Exvncc:os
) Modique a pgina de edio de Produtos (/WEB-INF/jsp/produtos/edita.jsp), para incluir um for-
mulrio de Upload de imagem. Esse formulrio vai submeter para uma lgica nova que vamos criar a
seguir.

<form action=
"<c:url value="/produtos/${produto.id }/imagem"/>"
method="POST" enctype="multipart/form-data">
<fieldset>
<legend>Upload de Imagem</legend>
<input type="file" name="imagem" />
</fieldset>
</form>
) Crie o Controller abaixo, que vai tratar dos uploads e downloads de imagens.
import br.com.caelum.vraptor.interceptor.multipart.UploadedFile;
@Resource
public class ImagensController {
@Post("/produtos/{produto.id}/imagem")
public void upload(Produto produto, UploadedFile imagem) {
}
}
) S estamos interessados em fazer uploads de imagens. Ento vamos validar se o upload foi uma imagem
mesmo. O ContentType de imagens comea com image:
public void upload(Produto produto,
final UploadedFile imagem) {
if (that(imagem, is(notNullValue()), "imagem",
"imagem.nula")) {
that(imagem.getContentType(),
startsWith("image"), "imagem", "nao.eh.imagem");
}
}});
validator.onErrorRedirectTo(ProdutosController.class)
.edita(produto.getId());
}
) Coloque as mensagens internacionalizadas no messages.properties:
imagem.nula = Digite uma imagem
nao.eh.imagem = Selecione uma imagem
) Crie o componente do VRaptor que ser responsvel por guardar as imagens no servidor. Esse com-
ponente vai criar uma pasta xa onde todas as imagens sero guardadas. Para isso, precisamos con-
seguir o caminho de uma pasta do servidor, e a classe que consegue nos dar essa informao o
ServletContext.
package br.com.caelum.goodbuy.imagens;
import java.io.File;
import javax.servlet.ServletContext;
Captulo - Apndice - Download e Upload - Exerccios - Pgina
@Component
public class Imagens {
private File pastaImagens;
public Imagens(ServletContext context) {
String caminhoImagens = context.getRealPath("/WEB-INF/imagens");
pastaImagens = new File(caminhoImagens);
pastaImagens.mkdir();
}
}
) Crie um mtodo que salve a imagem do upload na pasta padro. Colocaremos uma extenso xa para
facilitar. O IOUtils vem do projeto commons-io e copia um InputStream para algum OutputStream
package br.com.caelum.goodbuy.imagens;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.commons.io.IOUtils;
@Component
public class Imagens {
//...
public void salva(UploadedFile imagem, Produto produto) {
File destino = new File(pastaImagens, produto.getId() + ".imagem");
try {
IOUtils.copy(imagem.getFile(), new FileOutputStream(destino));
} catch (IOException e) {
throw new RuntimeException("Erro ao copiar imagem", e);
}
}
}
) Use a classe Imagens para salvar a imagem que veio no upload. E a classe Result para voltar para o for-
mulario de edio.
@Resource
public class ImagensController {
private final Imagens imagens;
public ImagensController(Validator validator,
Imagens imagens, Result result) {
this.imagens = imagens;
}
public void upload(Produto produto,
final UploadedFile imagem) {
if (that(imagem, is(notNullValue()), "imagem",
"imagem.nula")) {
that(imagem.getContentType(),
startsWith("image"), "imagem", "nao.eh.imagem");
}
}});
validator
.onErrorRedirectTo(ProdutosController.class)
imagens.salva(imagem, produto);
result.redirectTo(ProdutosController.class)
}
}
) Crie a lgica para fazer o download da imagem no ImagensController:
@Get("/produtos/{produto.id}/imagem")
public File download(Produto produto) {
return imagens.mostra(produto);
}
) Crie o mtodo mostra na classe Imagens:
public File mostra(Produto produto) {
return new File(pastaImagens, produto.getId() + ".imagem");
}
) Mude o formulrio de edio para incluir a imagem do produto. Repare que estamos usando nosso con-
troller para mostrar a imagem. Coloque essa imagem na listagem de produtos tambm.
<img src="<c:url value="/produtos/${produto.id}/imagem"/>"
width="100" height="100"/>
C
Apndice - Integrando VRaptor e Spring
:o.: Como vnzvn n :N1vcnnXo:
Para usar os componentes do Spring no VRaptor basta congur-los no applicationContext.xml da ma-
neira que voc j est acostumado a fazer quando trabalha com o Spring. Todos os componentes declarados
no applicationContext.xml estaro disponveis para os componentes do VRaptor, e vice-versa.
Umdetalhe da integrao que se voc usar algumlistener do spring para carregar o applicationContext.xml
(como o ContextLoaderListener), o VRaptor s consegue incluir os seus componentes aps um reload do
contexto, ento se voc precisar de um componente do VRaptor dentro de um do Spring, o do VRaptor
precisa ser marcado como opcional:
@Autowired(optional=true)
public void setComponenteDoVRaptor(ComponenteDoVRaptor c) {...}
Se no houver o listener do Spring, e o applicationContext.xml estiver no classpath, o optional no neces-
srio.
:o.i IN1vcnnNoo o TnnNsnc1:oN MnNncvn oo Svn:Nc
Na nossa aplicao estamos controlando as transaes manualmente, abrindo e fechando-as dentro de alguns
mtodos do DAO. Mas isso no bom, principalmente se voc precisar fazer mais de uma operao dentro
da mesma transao.
OSpring possui umcomponente que controla transaes, e podemos us-lo para transferir esse controle para
o Spring. Esse componente depende indiretamente de uma SessionFactory, que no momento gerenciada
pelo VRaptor.
Para passar a SessionFactory como dependncia para o componente de transaes do Spring, no podemos
mais usar o CriadorDeSessionFactory, precisamos criar a SessionFactory do jeito do Spring, por exemplo
com o componente AnnotationSessionFactoryBean.
Ao usar o SessionFactory do Spring, no podemos mais criar Sessions do jeito que fazamos antes, apenas
chamando o openSession, pois o Spring gerencia as Sessions de uma maneira que est acoplada a todos os
componentes que precisam us-la. Por causa disso precisaremos adaptar o nosso CriadorDeSession.
Nos exerccios abaixo mostraremos como integrar esse componente de transaes como a nossa aplicao.
:o. Exvncc:os: TnnNsnc1:oN MnNncvn
) Crie o arquivo applicationContext.xml dentro da pasta src:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
</beans>
) Inclua o componente que gerencia as transaes, baseado em anotaes do Spring.
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-2.0.xsd">
<tx:annotation-driven />
</beans>
) Esse componente de transaes genrico: funciona tanto com a JTA direto, com Hibernate/JPA, com
Captulo - Apndice - Integrando VRaptor e Spring - Exerccios: Transaction Manager - Pgina
JDBC, etc. Ento para especicar qual dos gerenciadores de transao vai ser utilizado, voc precisa
adicionar um bean na congurao. No nosso caso, vamos usar transaes do Hibernate:
<beans xmlns...>
<tx:annotation-driven />
<bean id="transactionManager"
class="org.springframework.orm.hibernate3.HibernateTransactionManager">
<property name="sessionFactory" ref="sessionFactory" />
</bean>
</beans>
) O transactionManager precisa de uma SessionFactory congurada. J temos uma no VRaptor, mas ela
no poder ser usada. Remova a anotao @Component do CriadorDeSessionFactory, e adicione o bean
que cria uma SessionFactory no Spring:
<beans xmlns....>

<bean id="sessionFactory"
class="org.springframework.orm.hibernate3.
annotation.AnnotationSessionFactoryBean">
<property name="configLocation">
<value>classpath:/hibernate.cfg.xml</value>
</property>
</bean>
</beans>
) Ao usar a SessionFactory do Spring estamos presos ao seu controle de Sessions. Isso signica que no
podemos fazer o sessionFactory.openSession para obter Sessions. O Spring controla isso para voc,
ento voc obrigado a usar componentes do Spring para conseguir uma Session, para poder usar a
mesma que est participando da transao. Mas ao invs de mudar todo o nosso sistema para usar as
sessions do Spring, vamos modicar o nosso CriadorDeSession para usar-las.
Por causa do jeito que o Spring trabalha, temos que pedir uma Session para ele no momento que vamos
us-la, e no na criao do DAO, por exemplo. Ento vamos usar um Proxy Dinmico para poder passar
uma Session no construtor do DAO, mas mesmo assim s pedir a Session pro Spring na hora de chamar
algum mtodo.
Modique o CriadorDeSession.
import net.vidageek.mirror.dsl.Mirror;
import org.springframework.orm.hibernate3.SessionFactoryUtils;
import br.com.caelum.vraptor.proxy.MethodInvocation;
import br.com.caelum.vraptor.proxy.Proxifier;
import br.com.caelum.vraptor.proxy.SuperMethod;
@Component
private final Proxifier proxifier;
public CriadorDeSession(SessionFactory factory, Proxifier proxifier) {
this.proxifier = proxifier;
}
@PostConstruct
this.session = proxifier.proxify(Session.class,
new MethodInvocation<Session>() {
public Object intercept(Session proxy,
Method method, Object[] args,
SuperMethod superMethod) {
Session sessionDoSpring =
SessionFactoryUtils
.doGetSession(factory, true);
return new Mirror().on(sessionDoSpring)
.invoke().method(method).withArgs(args);
}
});
}
}
@PreDestroy
}
}
) Para usar o controle de transaes do Spring, remova a abertura e o fechamento de transaes dos m-
todos do DAO, e anote o mtodo com @Transactional. Repare que nem todos os mtodos precisam de
transaes, s os que modicam o banco.
import org.springframework.transaction.annotation.Transactional;
@Component
@Transactional
public void salva(Produto produto) {
//Transaction tx = session.beginTransaction();
//tx.commit();
}
public Produto carrega(Long id) {
return (Produto) session.load(Produto.class, id);
}
@Transactional
public void atualiza(Produto produto) {
}
}
@Transactional
public void remove(Produto produto) {
}
.list();
}
}
}
) O Spring transactional usa o Spring AOP para gerenciar as transaes. O Spring AOP tem uma restrio
forte: para poder decorar suas classes ele usa proxies da Cglib. Esses proxies precisamque sua classe tenha
um construtor sem argumentos, ou que as dependncias da sua classe sejam sempre interfaces. E como
programar voltado a interfaces uma boa prtica, pois diminui o acoplamento de uma classe com as suas
dependncias, vamos optar pela segunda soluo.
Renomeie a classe ProdutoDao para HibernateProdutoDao. Use o Ctrl+Shi+R no nome da classe.
Extraia uma interface chamada ProdutoDao, selecionando todos os mtodos. Com o cursor no nome da
classe digite Ctrl+ e ento Extract Interface. Ou Alt+Shi+T e selecione Extract Interface. Marque o
checkbox: Use supertype where possible
C
Apndice: Mudando a View Padro: Velocity
No VRaptor, a view padro de uma lgica uma JSP. Mas nem sempre queremos usar JSP para gerar nossas
pginas. Veremos ento como usar uma outra Template Engine para gerar nossos HTMLs: o Velocity.
:,.: Exvncc:os: CoNv:ccnnNoo o Vvtoc:1v
) Entre no site de downloads do velocity (http://velocity.apache.org/download.cgi) e baixe os zips velocity-
x.x.x.zip e velocity-tools-x.x.zip. Copie os seguintes jars para o seu WEB-INF/lib:
no velocity-x.x.x.zip copie os jars velocity-x.x.x.jar e velocity-x.x.x-dep.jar
no velocity-tools-x.x.zip copie todos os jars da pasta lib
) Abra o web.xml e adicione a servlet do Velocity.
<servlet>
<servlet-name>velocity</servlet-name>
<servlet-class>
org.apache.velocity.tools.view.servlet
.VelocityViewServlet
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>velocity</servlet-name>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
:,.i Exvncc:os: MconNoo o Tvmvtn1v ENc:Nv ov cmn N:cn to-
c:cn
) Se voc quiser usar o Velocity em uma nica ou poucas lgicas, voc no precisa de muita coisa. Com
a Servlet do Velocity congurada, para criar uma pgina com o velocity basta criar um arquivo com a
extenso .vm. Por exemplo, crie o arquivo olamundo.vm na pasta WebContent.
<html>
<body>
Ol mundo.
</body>
</html>
) Acesse a pgina do Velocity diretamente: http://localhost:/goodbuy/olamundo.vm
) Crie um controller simples para redirecionar pra esse arquivo. Note que os objetos includos no Result
cam acessveis no template do Velocity.
public class TesteController {
private Result result;
public TesteController(Result result) {
}
@Path("/teste")
public void teste() {
result.include("mensagem", "Estou usando o Velocity");
result.forwardTo("/olamundo.vm");
}
}
e modique o olamundo.vm para mostrar a mensagem includa:
<html>
<body>
Ol mundo. $mensagem.
</body>
</html>
) Acesse a URL que cai nesse mtodo: http://localhost:/goodbuy/teste
Captulo - Apndice: Mudando a View Padro: Velocity - Exerccios: Mudando o Template Engine de uma nica lgica -
Pgina
:,. Exvncc:os: MconNoo o nvsct1noo ov 1oons ns toc:cns
vnnn Vvtoc:1v
) O VRaptor tem uma conveno para chamar a pgina de resultado de uma lgica: a pgina em
/WEB-INF/jsp/<nomeDoController>/<nomeDoMetodo>.jsp. Mas e se quisermos mudar a conveno para
outra coisa? Por exemplo no usar jsp, e sim velocity?
Para isso precisamos sobrescrever um comportamento do VRaptor. Quase todos os componentes do
VRaptor podem ser sobrescritos por componentes da sua aplicao, pois ele utiliza Injeo de Depen-
dncia para ligar seus componentes internos. Se voc criar uma implementao de uma interface interna
do VRaptor, e anot-la com @Component, o VRaptor vai usar a sua implementao, e no mais a padro.
Queremos mudar o padro da pgina para usar Velocity, ento podemos mudar o padro para algo do
tipo: /WEB-INF/velocity/<nomeDoController>/<nomeDoMetodo>.vm.
O componente responsvel por essa conveno o PathResolver, que tem uma implementao padro
chamada DefaultPathResolver. Essa implementao padro contm mtodos protected que podem ser
sobrescritos, tornando fcil a mudana da conveno. Ento para usar a conveno nova basta criar a
classe abaixo, que estende de DefaultPathResolver.
package br.com.caelum.goodbuy.vraptor;
import javax.servlet.http.HttpServletRequest;
import br.com.caelum.vraptor.view.AcceptHeaderToFormat;
import br.com.caelum.vraptor.view.DefaultPathResolver;
@Component
public class VelocityPathResolver extends DefaultPathResolver {
public VelocityPathResolver(HttpServletRequest request,
AcceptHeaderToFormat acceptHeaderToFormat) {
super(request, acceptHeaderToFormat);
}
@Override
protected String getPrefix() {
// o retorno padro desse mtodo /wEB-INF/jsp/, que a pgina
// onde suas views sero procuradas
return "/WEB-INF/velocity/";
}
@Override
protected String getExtension() {
// o retorno padro jsp, que a extenso da pgina da sua view
return "vm";
Captulo - Apndice: Mudando a View Padro: Velocity - Exerccios: Mudando o resultado de todas as lgicas para Velocity -
Pgina
}
}
) Crie a pasta /WEB-INF/velocity, e dentro dela a pasta teste. Mova o arquivo olamundo.vm para a pasta
teste e o renomeie para teste.vm.
) Remova o redirecionamento para a pgina olamundo.vm de dentro do TesteController:
public class TesteController {
private Result result;
public TesteController(Result result) {
}
@Path("/teste")
public void teste() {
result.include("mensagem", "Estou usando o Velocity");
}
}
) Acesse a url do mtodo teste (http://localhost:/goodbuy/teste), e veja que continua funcionando: ele
vai redirecionar automaticamente para a pgina /WEB-INF/velocity/teste/teste.vm.
) Veja que agora nenhuma das outras pginas do sistema esto acessveis. Agora qualquer chamada vai dar
, pois ele estar usando a nova conveno. O comportamento do VRaptor agora o da sua classe, e
no mais a padro dele!
Captulo - Apndice: Mudando a View Padro: Velocity - Exerccios: Mudando o resultado de todas as lgicas para Velocity -
Pgina
ndice Remissivo
AnnotationConguration,
Criteria,
Driver,
Escopo,
Hibernate,
Hibernate Annotations,
Hibernate Core,
Injeo de Dependncias,
JPA,
LogJ,
Logging,
MySQL,
ORM,
POJO,
Result,
SLJ,
Validao,

Caelum Java Web Vraptor Hibernate Ajax Fj28

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Caelum Java Web Vraptor Hibernate Ajax Fj28

Încărcat de

Drepturi de autor:

Formate disponibile

FJ-28

Desenvolvimento gil para a

SessionFactory factory = configuration.buildSessionFactory();

public class AdicaoDeProduto {

SessionFactory factory = configuration.buildSessionFactory();

Produto produto = new Produto();

SessionFactory factory = configuration.buildSessionFactory();

// carrega o produto do banco de dados

SessionFactory factory = configuration.buildSessionFactory();

// carrega o produto do banco de dados

public class AlteracaoDeProduto {

Captulo - Cadastrando Produtos - Exercicios - outras operaes com produto - Pgina

// carrega o produto do banco de dados

public class RemocaoDeProduto {

SessionFactory factory = configuration.buildSessionFactory();

// carrega o produto do banco de dados

public class AdicaoDeProduto {

public static void main(String[] args) {

SessionFactory factory = configuration.buildSessionFactory();

// Adio do produto no banco de dados

public class AdicaoDeProduto {

public static void main(String[] args) {

SessionFactory factory = configuration.buildSessionFactory();

// Adio do produto no banco de dados

public class AdicaoDeProduto {

public static void main(String[] args) {

// Adio do produto no banco de dados

private static void gravaProduto(Session session, Produto produto) {

private static Produto criaProduto() {

private static Session getSession() {

SessionFactory factory = configuration.buildSessionFactory();

Captulo - VRaptor - Primeiro exemplo com o VRaptor - Pgina

public void boasVindas() {

public void boasVindas() {

public void boasVindas() {

public class Mundo {

public void boasVindas() {

public String boasVindas() {

public String boasVindas() {

public List<String> paises() {

public String boasVindas() {

private ProdutoDao dao;

public ProdutosController(ProdutoDao dao) {

public List<Produto> lista() {

public List<Produto> lista() {

private final ProdutoDao dao;

public ProdutosController(ProdutoDao dao) {

public List<Produto> lista() {

private final ProdutoDao dao;

public ProdutosController(ProdutoDao dao) {

public List<Produto> lista() {

public void adiciona(Produto produto) {

public void adiciona(Produto produto) {

public class CriadorDeSession implements ComponentFactory<Session> {

public CriadorDeSession(SessionFactory factory) {

public Session getInstance() {

public class CriadorDeSessionFactory implements

public class CriadorDeSessionFactory

public SessionFactory getInstance() {

public SessionFactory getInstance() {

Captulo - Refatorando os DAOs - Fechando a sesso do Hibernate - Pgina

private final SessionFactory factory;

public CriadorDeSession(SessionFactory factory) {

private SessionFactory factory;