Java Com Vraptor e Ajax

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 60 profissionais altamente qualificados 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 qualificao 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 tambm a equipe Caelum no Twitter:

twitter.com/caelumdev/equipe
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 tambm nossa Newsletter para receber as novidades e destaques dos

eventos, artigos e promoes da Caelum:
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:
FJ-25:
Java e Orientao a
objetos
Persistncia com JPA2 e

Hibernate
FJ-16:
FJ-26:
Laboratrio Java com Testes,

XML e Design Patterns
Laboratrio Web com JSF2 e

CDI
FJ-19:
FJ-31:
Preparatrio para Certificao

de Programador Java
Java EE avanado e
Web Services
FJ-21:
FJ-91:
Java para Desenvolvimento

Web
Arquitetura e Design de
Projetos Java
RR-71:
RR-75:
Desenvolvimento gil para Web

2.0 com Ruby on Rails
Ruby e Rails avanados: lidando

com problemas do dia a dia
Para mais informaes e outros cursos, visite: caelum.com.br/cursos
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 qualificados e experientes;
Apostilas disponveis no site.
Sobre esta apostila

Esta apostila da Caelum visa 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 final do ndice.
Baixe sempre a verso mais nova em: www.caelum.com.br/apostilas
Esse material parte integrante do treinamento Desenv. gil para Web 2.0 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
ndice
1 O curso
1.1 Objetivo do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Sobre o curso: Hibernate, VRaptor, JSP e AJAX . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3 Onde posso aprender mais do VRaptor?
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 O sistema
2.1 A necessidade do cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Partes do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Persistindo os dados com o Hibernate
3.1 A camada de persistncia do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 Preparando o Hibernate
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.4 Configurando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5 Exerccios: Configurando o banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 Cadastrando Produtos
4.1 Modelando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Anotando a classe Produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 Exerccios - Modelando o produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.4 Adicionando um produto no banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.6 Outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.7 Exercicios - outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
i
4.8 Discusso em sala - mais sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

5 Refatorando
17
5.1 Analisando o cdigo atual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.2 Refactoring
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5.3 Aprendendo a refatorar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

5.4 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.5 Comentrios so sempre necessrios? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.6 Refatorando para criar os DAOs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.8 Discusso em sala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6 VRaptor
31
6.1 Sobre o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

6.2 Como instalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.3 Como configurar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.4 Primeiro exemplo com o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.6 Redirecionando para uma view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
6.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
6.8 Disponibilizando informaes para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
6.9 Disponibilizando colees para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.10 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7 Criando o Controlador de Produtos
40
7.1 Listando produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

7.2 Quais so minhas dependncias? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.3 Injeo de Dependncias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.4 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.5 Cadastrando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.6 Criando o formulrio HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.8 Redirecionar para listagem depois de adicionar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
ii
7.9 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
7.10 Atualizando e removendo produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.11 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.12 Discusso em sala - VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
8 Refatorando os DAOs
62
8.1 Injeo de dependncias no DAO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

8.2 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
8.3 Analisando o cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.4 Escopos definidos pelo VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.5 Fechando a sesso do Hibernate
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
8.6 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
9 Validando formulrios
72
9.1 Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
9.2 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9.3 Para saber mais: Hibernate Validator
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
9.4 Exerccios Opcionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

10 REST
79
10.1 O que REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

10.2 Caractersticas e vantagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
10.3 O tringulo do REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
10.4 Mudando a URI da sua lgica: @Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
10.5 Mudando o verbo HTTP dos seus mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
10.6 Refatorando o ProdutosController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
10.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
11 AJAX e efeitos visuais
87
11.1 O que AJAX? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

11.2 Um pouco de JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
11.3 Validando formulrios com o JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
11.4 Criando a busca de produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
11.5 Melhorando a busca: Autocomplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
11.6 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
iii
12 Criando o Carrinho de Compras
99
12.1 O modelo do Carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

12.2 Controlando o carrinho de compras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
12.3 Visualizando os itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.4 Removendo itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
12.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
13 Autenticao
112
13.1 Criando Usurios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

13.2 Efetuando o login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
13.3 Restringindo funcionalidades para usurios logados . . . . . . . . . . . . . . . . . . . . . . . . . 117
13.4 Interceptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
14 Apndice - Download e Upload
122
14.1 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

15 Apndice - Integrando VRaptor e Spring
126
15.1 Como fazer a integrao? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

15.2 Integrando o Transaction Manager do Spring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
15.3 Exerccios: Transaction Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
16 Apndice: Mudando a View Padro: Velocity
130
16.1 Exerccios: Configurando o Velocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

16.2 Exerccios: Mudando o Template Engine de uma nica lgica . . . . . . . . . . . . . . . . . . . . 130
16.3 Exerccios: Mudando o resultado de todas as lgicas para Velocity . . . . . . . . . . . . . . . . . 131
Verso: 12.9.20
iv
C APTULO
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.
1.1 - Objetivo do curso

Uma das grandes vantagens de utilizar a plataforma Java a quantidade de opes: so centenas de
frameworks opensource de qualidade que podemos escolher para desenvolver um projeto. Mas qual deles
escolher?
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 ficar 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.
1.2 - Sobre o curso: Hibernate, VRaptor, JSP e 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 desenolvimento web, evitando
o contato com as classes pouco amigveis do javax.servlet, deixando o cdigo legvel e desacoplado, ideal
para testes.
JavaServer 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.
1.3 - Onde posso aprender mais do VRaptor?

Voc pode encontrar uma vasta documentao em portugus no site do VRaptor: http://www.vraptor.
com.br/
Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX
O frum do GUJ tambm uma excelente fonte de informao, e abriga o frum oficial do VRaptor: http:
//www.guj.com.br/
Captulo 1 - O curso - Onde posso aprender mais do VRaptor? - Pgina 2
C APTULO
O sistema
Veremos como ser o sistema que iremos desenvolver e as tecnologias que utilizaremos.
2.1 - A necessidade do cliente

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 com a 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
desenvolver o sistema de forma incremental e iterativa, utilizando mtodos geis como Scrum (curso PM-83) e
prticas XP (curso FJ-16).
2.2 - Partes do projeto

Para facilitar o desenvolvimento, vamos separar em tarefas o que devemos fazer, que sero vistas a partir
do prximo captulo.
1) Deciso de tecnologias
2) Montagem do ambiente de desenvolvimento
3) CRUD produto
4) Carrinho de compras
5) CRUD usurio
6) login
7) Compra de produto
C APTULO
Persistindo os dados com o Hibernate

3.1 - A camada de persistncia do projeto
Nossa primeira tarefa ser cadastrar, atualizar, listar e remover produtos do sistema. Para realiz-la, precisamos 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 configurado, 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-21, 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 ficar fazendo todas as chamadas ao JDBC e ganharmos tempo e produtividade, vamos
utilizar um framework para a persistncia que j traz muitas funcionalidades j implementadas. O framework
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.
3.2 - Sobre o Hibernate

O Hibernate um framework ORM - Object Relational Mapping. uma ferramenta que nos ajuda a
persistir objetos Java em um banco de dados relacional. O trabalho do desenvolvedor definir 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
especifio oficial do Java, a JPA - Java Persistence API. A JPA uma especificao do JCP e possui vrias
implementaes (o Hibernate, o Oracle Toplink, EclipseLink, OpenJPA etc).
4
Mais sobre Hibernate

Neste curso, veremos muitos tpicos sobre Hibernate e como integr-lo em nosso projeto com
VRaptor3. Para tpicos avanados e mais detalhes, consulte o treinamento FJ-25:
http://www.caelum.com.br/curso/fj25
3.3 - Preparando o Hibernate

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 configurar nosso projeto com as 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 iremos precisar. A partir do Hibernate 3.5, esses jars
todos vem numa nica distribuio, a core.
Configurando o mecanismo de logging

O Hibernate 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.
Configurando 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.
Mais sobre JDBC e Drivers
Para mais informaes sobre o JDBC e como funcionam os Drivers, consulte o captulo inicial da
apostila do curso FJ-21.
3.4 - Configurando o Hibernate

Para configurar 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 configurar tudo que queremos, por exemplo as entidades. As entidades tm que ser configuradas no
cdigo, e as outras informaes no arquivo de properties.
Captulo 3 - Persistindo os dados com o Hibernate - Preparando o Hibernate - Pgina 5
J o XML, por mais que seja um pouco mais difcil em relao ao properties, permite que toda a configurao
seja feita nele. Por isso faremos nossa configurao no XML. O arquivo 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</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 configuraes 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 configurao o banco de dados que foi passado. Na configurao
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 configuraes 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 configurada de acordo com
documentao do banco de dados
hibernate.connection.driver_class - driver que deve ser utilizado

hibernate.hbm2ddl.auto - como o hibernate vai se comportar em relao s tabelas do banco. Com o
valor update ele vai criar ou modificar tabelas sempre que necessrio.
hibernate.dialect - dialeto a ser utilizado para a comunicao com o banco de dados

show_sql - flag que indica se os SQLs gerados devem ser impressos
format_sql - flag que indica se os SQLs devem ser formatados
Captulo 3 - Persistindo os dados com o Hibernate - Configurando o Hibernate - Pgina 6
Existem muitas outras configuraes possveis. Para maiores detalhes, acesse a documentao do Hibernate.
3.5 - Exerccios: Configurando o banco

1) 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.
2) Conecte-se no banco de dados para verificar 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 verificar os bancos de dados disponveis:

mysql> show databases;
Se o database fj28 aparecer, digite:

mysql> drop database fj28;
mysql> create database fj28;
Captulo 3 - Persistindo os dados com o Hibernate - Exerccios: Configurando o banco - Pgina 7
C APTULO
Cadastrando Produtos
No captulo anterior, configuramos o Hibernate para acessar o banco de dados. Neste captulo, nosso
objetivo cadastrar produtos.
4.1 - Modelando um produto

Agora que estamos com o ambiente configurado e com o banco de dados pronto, podemos partir para a
codificao.
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 ficar assim:
public class Produto {
private String nome;
private String descricao;
private Double preco;
// getter e setters
}
BigDecimal
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 preciso fixa, 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));
4.2 - Anotando a classe 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 dificuldade e o trabalho de se fazer isso com XML.
Outra maneira, que est sendo bem aceita pela comunidade o uso de anotaes para a configurao.
Ao invs de usar um arquivo XML para configurar, basta ir na prpria classe e anot-la. Uma das grandes
vantagens, 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 especificao da Java Persistence API.
@Entity
// 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
}
Captulo 4 - Cadastrando Produtos - Anotando a classe Produto - Pgina 9
Pronto, agora nossa entidade est devidamente anotada. S temos que fazer mais uma coisa: avisar o
Hibernate dessa entidade, isso porque ele no encontra a entidade automaticamente. Para informar isso ao
Hibernate, utilizaremos o arquivo de configurao dele, o hibernate.cfg.xml.
O contedo do arquivo ficar 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.
4.3 - Exerccios - Modelando o produto

1) Crie a classe Produto dentro do pacote br.com.caelum.goodbuy.modelo.
private Long id;

// getter e setters
}
2) Anote a classe com as anotaes da JPA.

@Entity
@Id @GeneratedValue
private Long id;
// getter e setters
}
Captulo 4 - Cadastrando Produtos - Exerccios - Modelando o produto - Pgina 10
3) Configure essa entidade no Hibernate, alterando o arquivo hibernate.cfg.xml.

<session-factory>


</session-factory>
4.4 - Adicionando um produto no banco

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
precisamos a Session, do pacote org.hibernate.
Esse objeto muito importante para ns porque ele quem vai encapsular todas as chamadas JDBC,
facilitando muito o mecanismo de acesso ao banco de dados.
Nosso primeiro passo para conseguir uma Session instanciar uma classe que representa a
configurao 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 configurar, precisamos criar um objeto que cria as sesses, uma fbrica.
SessionFactory, que pode ser obtida com:
Esse objeto uma
Captulo 4 - Cadastrando Produtos - Adicionando um produto no banco - Pgina 11
SessionFactory factory = configuration.buildSessionFactory();
Com a SessionFactory em mos conseguimos criar uma uma Session. O cdigo completo fica:
1 public class TesteDeSessao {
2
public static void main(String[] args) {
3
4
5
6
7
Session session = factory.openSession();
8
}
9 }
A partir 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.
4.5 - Exerccios
1) Crie a seguinte classe, que adiciona produtos no banco.
1 package br.com.caelum.goodbuy.testes;
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import
import
import
import
org.hibernate.Session;
org.hibernate.SessionFactory;
org.hibernate.Transaction;
org.hibernate.cfg.AnnotationConfiguration;
public class AdicaoDeProduto {

Captulo 4 - Cadastrando Produtos - Exerccios - Pgina 12
18
19
20
21
22
23
24
25 }

tx.commit();
}
2) Execute a classe que adiciona o produto. Repare no console o sql que foi gerado.
3) Acesse o banco de dados e verifique se o produto foi inserido com sucesso.
4) (Opcional) Crie outros produtos no sistema.
4.6 - Outras operaes com produto

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 fizemos. Para alterar um produto, basta carregarmos esse produto, alterarmos e depois
atualizarmos.
1 public class AlteracaoDeProduto {
2
3
4
5
6
7
8
Captulo 4 - Cadastrando Produtos - Outras operaes com produto - Pgina 13
9
10
11
12
13
14
15
16
17 }
// 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:

1 public class RemocaoDeProduto {
2
3
4
5
6
7
8
9
10
11
12
13
session.delete(produto);
14
tx.commit();
15
}
16 }
4.7 - Exercicios - outras operaes com produto

1) Crie a classe de alterao do produto.
2
4
5
6
7
8
9
10
11
12
13
14
15
16
17
tx.commit();
18
}
Captulo 4 - Cadastrando Produtos - Exercicios - outras operaes com produto - Pgina 14
19 }
2) Execute a classe que altera o produto. Repare no console o sql que foi gerado.
3) Acesse o banco de dados e verifique se o produto foi alterado com sucesso.
4) Crie a classe de remoo do produto.

2
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18 }
tx.commit();
}
5) Execute a classe que remove o produto. Repare no console o sql que foi gerado.
4.8 - Discusso em sala - mais sobre o Hibernate

Por que utilizamos o Long e no o long para o campo id
Eu sempre fiz com que minhas entidades implementassem Serializable. mesmo necessrio?
Vale mesmo a pena utilizar o Hibernate? No vou perder performance?
Captulo 4 - Cadastrando Produtos - Discusso em sala - mais sobre o Hibernate - Pgina 16
C APTULO
Refatorando
5.1 - Analisando o cdigo atual
Se olharmos para o nosso projeto agora, temos a seguinte situao:
Tabela de produtos est no banco de dados

Hibernate configurado
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 ficaria 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.
5.2 - Refactoring
Uma prtica bastante comum e difundida no meio da Orientao a Objetos a chamada Refatorao (Refactoring). Refatorar um programa melhorar seu cdigo sem alterar sua funcionalidade. A ideia 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. um catlogo com dezenas de tcnicas de refatorao e instrues de como e quando
execut-las.
17
5.3 - Aprendendo a refatorar

Vamos abrir novamente a classe de insero de produtos.
package br.com.caelum.goodbuy.testes;
// imports
tx.commit();
}
}
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. Com base nessa diviso, vamos
pedir para o Eclipse nos ajudar a refatorar, para fazer essa diviso de uma maneira segura e automtica.
Apenas para ficar claro essa diviso, veja o cdigo novamente, agora com os comentrios mostrando onde
comea cada parte.
2
3 // imports
4
5 public class AdicaoDeProduto {
6
7
8
// Aquisio da sesso
9
10
11
12
13
14
15
// Criao do produto
16
17
18
19
Captulo 5 - Refatorando - Aprendendo a refatorar - Pgina 18
20
21
22
23
24
25
26 }
// 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.
5.4 - Exerccios
1) Altere a classe AdicaoDeProduto, que est no pacote br.com.caelum.goodbuy.testes, colocando os
comentrios para deixar claro a diviso das partes.
2
3 // imports
4
6
7
8
// Aquisio da sesso
9
10
11
12
13
14
15
// Criao do produto
16
17
18
19
20
21
22
23
24
tx.commit();
25
}
26 }
2) Selecione as linhas que fazem a aquisio da sesso, conforme a figura abaixo:
Captulo 5 - Refatorando - Exerccios - Pgina 19
3) Com as linhas selecionadas, pressione as teclas Alt + Shift + M (Extract Method), para criar um mtodo
com essas linhas. Aps pressionar essas teclas, aparecer a seguinte tela:
4) A tela que est sendo mostrada est esperando por um nome de mtodo. Digite getSession como nome do
mtodo e pressione OK.
5) Note como o Eclipse mudou seu cdigo, criando o mtodo getSession e fazendo a chamada a este mtodo.
A classe deve estar assim:

// Aquisio da sesso
Session session = getSession();
// Criao do produto
tx.commit();
}
private static Session getSession() {
return session;
}
}
6) Faa o mesmo para as linhas de criao de produto e adio de produto no banco de dados. No final,
ficaremos com 3 mtodos, um chamado getSession, que j foi feito, outro chamado criaProduto e outro
chamado gravaProduto. Lembre-se de utilizar as teclas de atalho que vimos nesse exerccio.
7) Para conferncia, ficaremos com a classe da seguinte forma:
2
3 // imports
4
6
7
8
// Aquisio da sesso
9
10
11
// Criao do produto
12
Produto produto = criaProduto();
13
14
15
gravaProduto(session, produto);
16
}
17
18
private static void gravaProduto(Session session, Produto produto) {
19
20
21
tx.commit();
22
}
23
24
private static Produto criaProduto() {
25
26
27
28
29
return produto;
30
}
31
32
33
34
35
36
37
38
return session;
39
}
40 }
5.5 - Comentrios so sempre necessrios?

Note que o que fizmos foi quebrar um mtodo grande em vrios 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 ficou muito mais legvel, intuitivo. Basta dar uma olhada rpida que podemos
entender o que ele faz.
Captulo 5 - Refatorando - Comentrios so sempre necessrios? - Pgina 22
Mas agora que o mtodo main foi quebrado em mtodos menores, ser que precisamos mesmo de comentrios? 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
}
5.6 - Refatorando para criar 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 em uma classe,
que ser responsvel por acessar os produtos no banco de dados. E a essa classe vamos dar o nome de
ProdutoDao.
5.7 - Exerccios
1) Crie uma classe chamada CriadorDeSession no pacote br.com.caelum.goodbuy.infra. Essa classe ser a
responsvel por criar uma Session.
2) Selecione o mtodo getSession da classe AdicaoDeProduto.
Captulo 5 - Refatorando - Refatorando para criar os DAOs - Pgina 23
3) Com as linhas selecionadas, pressione as teclas Alt + Shift + V (Move Method), para criar um mtodo
4) A tela que est sendo mostrada est esperando pela classe que ficar com esse mtodo. Pressione o boto
Browse..., e busque pela classe CriadorDeSession, conforme a imagem abaixo:
5) Aps encontrar a classe CriadorDeSession, pressione o boto OK para escolher essa classe, depois OK
novamente para confirmar a mudana do mtodo para essa classe.
6) Aparecer uma tela avisando que a visibilidade do mtodo getSession ser alterada public. Confirme essa
alterao pressionando o boto Continue.
7) Repare como ficou a classe aps essa alterao:


Session session = CriadorDeSession.getSession();
}
tx.commit();
}
return produto;
}
}
8) Crie uma classe chamada ProdutoDao no pacote br.com.caelum.goodbuy.dao. Essa classe ser a responsvel por encapsular as chamadas ao Hibernate.
9) Mova o mtodo gravaProduto para a classe ProdutoDao. Utilize as teclas de atalho que vimos nesse exerccio.

ProdutoDao.gravaProduto(session, produto);
}
return produto;
}
}
11) 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();
}
}
12) A classe AdicaoDeProduto agora no compila. Vamos trocar o acesso esttico por acesso a uma instncia
do dao:

new ProdutoDao().gravaProduto(session, produto);
}
//...
}
13) 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);
}
//...
}
14) 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();
}

tx.commit();
}
}
15) Agora a chamada do mtodo gravaProduto est correta, porm repare como est um pouco redundante:
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.
16) (Opcional) Refatore as outras classes de teste, AlteracaoDeProduto e RemocaoDeProduto, para utilizar o
ProdutoDao.
5.8 - Discusso em sala

Ouvi falar do padro Repository. Ainda preciso dos daos?
O eclipse ajuda no refactoring?
Captulo 5 - Refatorando - Discusso em sala - Pgina 30
C APTULO
VRaptor
6.1 - Sobre o VRaptor
VRaptor 3 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.
6.2 - Como instalar

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-3.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>.
6.3 - Como configurar

Uma das grandes vantagens do VRaptor que ele usa muitas convenes, ou seja, ao invs de termos que
configurar tudo, como por exemplo no Struts, no precisamos configurar quase nada.
Seguindo as convenes que o VRaptor usa, podemos criar apenas nossas lgicas (cdigo java) sem precisar escrever xmls ou properties.
A nica configurao que precisamos fazer configurar o controlador do VRaptor. Essa configurao feita
dentro do arquivo web.xml, o arquivo de configurao da aplicao.
<web-app ...>

<filter>
<filter-name>vraptor</filter-name>
<filter-class>br.com.caelum.vraptor.VRaptor</filter-class>
</filter>
<filter-mapping>
<url-pattern>/*</url-pattern>
<dispatcher>FORWARD</dispatcher>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
</web-app>
31
Essas configuraes j foram feitas no projeto base.

Servlet 3.0
Se voc estiver usando um Servlet Container que implementa a Servlet 3.0 voc nem precisa da
configurao do filtro no web.xml. Basta colocar o jar do VRaptor na pasta WEB-INF/lib e ele ser
configurado automaticamente.
6.4 - Primeiro exemplo com o VRaptor

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 elaborados.
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.
1 package br.com.caelum.goodbuy;
2
3 public class Mundo {
4
5
public void boasVindas() {
6
System.out.println("ol mundo!");
7
}
8
9 }
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 ficar assim:
1
2
3
4
5
6
7
8
9
package br.com.caelum.goodbuy;
import br.com.caelum.vraptor.Resource;
@Resource
public class Mundo {
Captulo 6 - VRaptor - Primeiro exemplo com o VRaptor - Pgina 32
10
11
12 }
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:8080/goodbuy/mundo/boasVindas.
1
2
3
4
5
6
7
8
9
10
11
12
@Resource
}
}
6.5 - Exerccios
1) Crie a classe Mundo no pacote br.com.caelum.goodbuy.
2
4
5
6
7
}
8
9 }
2) Anote a classe Mundo com @Resource.

3) Abra um browser, por exemplo o Firefox, e digite a seguinte url: http://localhost:8080/goodbuy/mundo/
boasVindas
4) Ao acessar essa url, mostrada uma pgina com erro 404 (pgina no encontrada). Isso ocorreu porque
ainda no criamos a pgina de resultado. Ela ser criada na prxima seo. O importante verificar o log
da aplicao, na view Console do Eclipse, e ver que a mensagem apareceu.
Captulo 6 - VRaptor - Exerccios - Pgina 33
5) (Opcional) Crie outro mtodo, parecido com o que fizemos, e acesse pelo browser. Se quiser, esse mtodo
pode ser em outra classe.
6.6 - Redirecionando para uma view

Nosso ltimo exemplo executava a lgica que tnhamos criado, mas a pgina de resultado no tinha sido
feita, e recebamos o erro 404.
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 configuraes. 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 ir fazer algumas modificaes 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 ir considerar os seguintes valores:
{nomeDoResource} = mundo
{lgica} = boasVindas
E a pgina que ele buscar ser a seguinte:
/WEB-INF/jsp/mundo/boasVindas.jsp
Captulo 6 - VRaptor - Redirecionando para uma view - Pgina 34
6.7 - Exerccios
1) Crie uma pasta chamada jsp dentro da pasta WEB-INF. Cuidado, o nome da pasta deve ser com letras
minsculas.
2) Crie uma pasta chamada mundo dentro da pasta WEB-INF/jsp. Cuidado, o nome da pasta deve ser com letras
minsculas.
3) Crie um jsp chamado boasVindas.jsp dentro da pasta WEB-INF/jsp/mundo. Seu projeto deve ficar assim:
4) Abra o arquivo boasVindas.jsp que acabamos de criar e digite o seguinte contedo:

Ol Mundo!
5) Vamos testar nossas alteraes. Inicie o Tomcat na view Servers, depois abra um browser e digite a seguinte
url: http://localhost:8080/goodbuy/mundo/boasVindas
6) Verifique se o console mostra a mensagem ol mundo!, e verifique se o browser exibe a mensagem Ol
Mundo.
6.8 - Disponibilizando informaes para a view

Nosso exemplo at agora s executa algo no servidor e depois a view chamada.
Mas para muitos casos precisamos que a lgica carregue informaes do banco de dados e depois a view
exiba essas informaes.
No VRaptor 3 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 ficava muito poluda com atributos, getters ou anotaes.
Vamos alterar nosso mtodo para enviar informaes para a view:
1
2
3
4
5
6
7
8
9
10
@Resource
public String boasVindas() {
return "ol mundo!";
}
}
Agora o mtodo boasVindas() no imprime nada, apenas retorna uma string. Aps a execuo desse
mtodo, 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
ficar assim:
Mensagem vinda da lgica:
${string}
Captulo 6 - VRaptor - Disponibilizando informaes para a view - Pgina 36
Como utilizamos o retorno do mtodo para disponibilizar informaes para a view, no temos como dar um
nome significativo para utilizar depois.
O VRaptor usa a conveno de buscar o tipo do retorno, nesse nosso caso uma String, e disponibilizar para
a view com o mesmo nome, apenas passando a primeira letra para minsculo. Por esse motivo que foi utilizado
a expression language ${string}.
6.9 - Disponibilizando colees para a view

Podemos utilizar a mesma maneira que fizemos com Strings para disponibilizar colees para a view. Utilizamos muito as colees do pacote java.util, seja pela facilidade no uso ou pela integrao com frameworks
como o Hibernate.
Se nossa lgica criasse uma coleo com informaes que vieram do banco de dados, poderamos retornar
essa coleo, assim como fizemos anteriormente. O cdigo ficaria assim:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@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 identifica que devolvemos uma lista, e essa lista genrica, informando que o tipo de informao dentro da lista ser String.
Para listas, o VRaptor ir adotar a seguinte conveno:
{tipoDaLista}List
Nosso exemplo era de uma lista de String, ou seja, List<String>, que virou ${stringList}.
Captulo 6 - VRaptor - Disponibilizando colees para a view - Pgina 37
6.10 - Exerccios
1) Altere o mtodo boasVindas() da classe Mundo para retornar uma String.
2
3 @Resource
5
6
7
return "ol mundo!";
8
}
9
10 }
2) Altere o jsp boasVindas.jsp, que est dentro da pasta WEB-INF/jsp/mundo.

${string}
3) Teste a lgica que acabamos de criar, acessando a seguinte url: http://localhost:8080/goodbuy/mundo/

boasVindas Sua pgina deve exibir o seguinte resultado:
4) Crie um mtodo chamado paises() na classe Mundo. Esse mtodo deve retornar uma lista de Strings. Seu
cdigo ficar assim:
result.add("Japo");
return result;
}
5) Crie um jsp em WEB-INF/jsp/mundo chamado paises.jsp. O contedo deve ser esse:

${stringList}
6) Teste a lgica que acabamos de criar, acessando a seguinte url:
http://localhost:8080/goodbuy/mundo/paises
Sua pgina deve exibir o seguinte resultado:
7) (Opcional) Crie outro mtodo que mande alguma informao para a view. Dessa vez, tente retornar um valor
inteiro ou um valor decimal.
8) (Opcional) Crie outro mtodo que retorne um Produto, com algumas informaes preenchidas. Tente imprimir essas informaes no jsp.
9) (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.
10) (Opcional) Um mtodo s pode retornar uma informao. Mas como faramos para disponibilizar para a view
mais de uma informao?
C APTULO
Criando o Controlador de Produtos

7.1 - Listando produtos
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 3, 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 sufixo Controller.
Vimos que o nome da classe utilizado pelo VRaptor para registrar esse componente, para que quando
fizermos uma chamada do browser, essa classe seja encontrada e algum mtodo seja invocado. Mas utilizando
o nome ProdutosController, o VRaptor ir mapear essa classe para apenas /produtos, removendo o sufixo
Controller que faz parte da conveno.
Dentro dessa classe, teremos um mtodo para listar todos os produto. Esse mtodo ser invocado pelo
VRaptor 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 operaes no banco de dados; uma delas listar tudo com o mtodo list().
Nosso mtodo listaTudo() no ProdutoDao fica 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();
}
}
40
Olhando para esse mtodo, que no incio tnhamos definido 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 dificuldade no acesso, e tambm por no fazer parte da regra de negcio, que tal se ao invs de cri-lo,
recebssemos o mesmo?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// imports
@Resource
private ProdutoDao dao;
public ProdutosController(ProdutoDao dao) {
this.dao = dao;
}
}
}
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, precisamos 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 retornamos uma lista de produtos, existe uma varivel chamada ${produtoList} disponvel no jsp.
Para podermos mostrar a listagem de um jeito mais fcil, vamos usar uma taglib da JSTL chamada
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>
Captulo 7 - Criando o Controlador de Produtos - Listando produtos - Pgina 41
<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>
7.2 - Quais so minhas dependncias?

Tudo que um objeto 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 dependncias 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
necessidade 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?
1 ProdutoDao dao = new ProdutoDao();
2 ProdutosController controller = new ProdutosController(dao);
Repare que logo aps a segunda linha ser executada, tenho a confiana 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 ficar extremamente repetitivo e propcio a erro a medida que aumenta o nmero de dependncias
de nossa classe.
Captulo 7 - Criando o Controlador de Produtos - Quais so minhas dependncias? - Pgina 42
7.3 - Injeo de Dependncias

Sendo assim, fica muito mais fcil se fizermos uso de uma API que execute todo o processo de injeo
automaticamente.
No nosso caso, quem vai instanciar essa classe? Ns ou o VRaptor? Essa classe ser instanciada pelo
VRaptor. Mas se o VRaptor fizer isso, como ele descobrir sobre interligaes entre as dependncias?
Uma vez que precisamos da classe ProdutoDao como dependncia nossa, precisamos notificar o framework
que o mesmo se encarregar de gerenciar as instncias de ProdutoDao, isto , nesse caso especfico, ele criar
uma instncia e utilizar como argumento para o construtor. Para fazer isso, basta anotarmos essa classe com
@Component.
package br.com.caelum.goodbuy.dao;
// imports
import br.com.caelum.vraptor.ioc.Component;
@Component
//...
}
Agora a classe ProdutoDao tambm ser controlada pelo VRaptor. Dessa forma, quando o VRaptor for instanciar a classe ProdutosController, ele verificar que ela depende de um ProdutoDao, 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.
O VRaptor 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.
Imagine que seu controlador de clientes necessita acessar um dao. Sendo assim, especifique claramente essa
necessidade.
Testando sua aplicao
Ao usarmos injeo de dependncias, ganhamos uma caracterstica muito boa na nossa aplicao:
a testabilidade. Se recebemos nossas dependncias no construtor, conseguimos passar implementaes falsas ou controladas e, assim, testar unitariamente nossas classes.
Voc pode encontrar um contedo mais aprofundado sobre testes no curso FJ-16 - Laboratrio
Java com Testes, XML e Design Patterns.
7.4 - Exerccios
1) Abra a classe ProdutoDao e adicione o mtodo para listar todos os produtos:
Captulo 7 - Criando o Controlador de Produtos - Injeo de Dependncias - Pgina 43

//...
}
}
2) Crie a classe ProdutosController no pacote br.com.caelum.goodbuy.controller. Crie tambm o mtodo

lista, que retorna uma List<Produto>.
3) Anote a classe com a anotao @Resource.
1 package br.com.caelum.goodbuy.controller;
2
3
4
5
6
7
8
9
10
11
12
13
// imports
@Resource
}
}
4) Crie o construtor que recebe uma instncia de ProdutoDao, e guarde essa instncia em um atributo.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// imports
@Resource
private final ProdutoDao dao;
this.dao = dao;
}
}
}
5) No mtodo lista, faa a chamada ao mtodo listaTudo do dao.

2
Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 44
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// imports
@Resource
this.dao = dao;
}
}
6) Na pasta WEB-INF/jsp, crie a pasta produtos.

7) 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>
8) Acesse a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista.
9) Deu uma exception! A informao mais importante dela est no final 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....
Ou seja, 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.
10) Anote a classe ProdutoDao com @Component, para indicar que essa classe uma dependncia e pode ser
instanciada pelo VRaptor sempre que necessrio.
// imports
@Component
//...
}
11) Se acessarmos de novo a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista veremos a listagem de produtos:
12) 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>
7.5 - Cadastrando um produto

Para cadastrar um produto, bastar passarmos esse produto para o mtodo salva da classe ProdutoDao.
Vamos criar ento um mtodo no ProdutoController para adicionar produtos:
1
2
3
4
5
6
7
8
9
10
11
12
13
// imports
@Resource
public void adiciona(Produto produto) {
dao.salva(produto);
}
}
7.6 - Criando o formulrio HTML

Nossa lgica para criar (salvar) produtos j est pronta. Mas como passar um produto populado para o
mtodo 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 20 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
Captulo 7 - Criando o Controlador de Produtos - Cadastrando um produto - Pgina 47
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.
Reflection no nome dos parmetros
Infelizmente, o Java no realiza reflection em cima de parmetros, esses dados no ficam disponveis em bytecode (a no ser se compilado 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 (exemplo no JAX-WS, onde comum encontrar um mtodo
como o acima com a assinatura void add(@WebParam(name="cliente) Cliente cliente).
O VRaptor 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
anotao. 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 ficar na pasta WEB-INF/jsp/produtos, com o nome de
formulario.jsp.
<form action="adiciona">
<fieldset>
<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 ficam 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
Captulo 7 - Criando o Controlador de Produtos - Criando o formulrio HTML - Pgina 48
// atributo, construtor e mtodos

public void formulario() {
}
}
Pelo browser, chamaremos a seguinte URL:
http://localhost:8080/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!
7.7 - Exerccios
1) Crie o mtodo adiciona que recebe um Produto como parmetro e faa a chamada ao mtodo salva do dao
passando esse produto.
2 public class ProdutosController {
3
4
//...
5
6
7
dao.salva(produto);
8
}
9
10 }
2) Na pasta WEB-INF/jsp/produtos, crie o arquivo formulario.jsp.
3) Abra o arquivo que acabamos de criar e coloque os campos para de digitao, assim como o boto e o
formulrio.
<fieldset>
</fieldset>
</form>
4) Na pasta WEB-INF/jsp/produtos, crie o arquivo adiciona.jsp com o contedo.

<h3>Produto adicionado com sucesso!</h3>
5) Acesse a listagem de produtos e veja os produtos que existem.

6) Acesse a URI do formulrio e adicione um produto. http://localhost:8080/goodbuy/produtos/formulario
7) Volte listagem, e veja se um usurio foi cadastrado com sucesso.
. 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>
</ul>
</div>
7.8 - Redirecionar para listagem depois de adicionar

Uma coisa no aparenta estar muito certa no nosso sistema: Quando adicionamos um produto, redirecionamos para uma pgina com a mensagem Produto adicionado com sucesso. Ser que essa pgina suficiente?
Ser que no melhor mostrar informaes mais relevantes?
Aps adicionar produtos podemos, por exemplo, mostrar uma lista com os 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 final do seu mtodo.
Primeiro precisamos de uma instncia de Result. Vamos dar um new nele? 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;
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 ProdutosController.lista(). Ou em java:
result.redirectTo(ProdutosController.class).lista();
Dentro do mtodo adiciona isso ficaria:

@Resource
this.dao = dao;
}
Captulo 7 - Criando o Controlador de Produtos - Redirecionar para listagem depois de adicionar - Pgina 52

dao.salva(produto);
}
}
}
}
Repare que no foi necessrio criar arquivos de configurao para fazer essa mudana de conveno,
tudo feito no prprio mtodo. Ao olhar para o mtodo adiciona fica 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:
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 ir redirecionar internamente para a lgica especificada, 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 especificada.
result.redirectTo(/uma/outra/pagina.jsp): redirecionamento do lado do cliente para a pgina especificada.

result.of(ProdutosController.class).lista(): redireciona para a pgina da lgica especificada, sem executar
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 fizemos anteriormente 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
anteriormente 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

result.use(Results.http()).setStatusCode(404)
status
codes
Headers
HTTP.
Ex:
result.use(Results.referer()): Usa como resultado a pgina que originou a requisio. Usa um Header
HTTP chamado Referer que no obrigatrio, e que removido por alguns Proxies e Firewalls, ento
cuidado ao usar esse resultado.
7.9 - Exerccios
1) Receba um Result no construtor do ProdutosController e guarde-o em um atributo.
@Resource
this.dao = dao;
}
//...
}
2) Mude o resultado da lgica adiciona para redirecionar para a lgica lista.

@Resource
this.dao = dao;
}
dao.salva(produto);
}
}

}
}
3) Reinicie o tomcat para que ele carregue as suas mudanas, abra o formulrio e adicione mais um produto.
Repita essa operao e adicione mais produtos.
7.10 - Atualizando e removendo produtos

Para melhorarmos um pouco mais o nosso sistema, vamos incluir as operaes de atualizao e remoo
de produtos.
Captulo 7 - Criando o Controlador de Produtos - Atualizando e removendo produtos - Pgina 55
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.
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 controller.
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, fizemos 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>
7.11 - Exerccios
1) Crie as lgicas para edio de produtos no ProdutosController:
}
}
2) 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();
}
3) Crie o formulrio de edio no arquivo /WEB-INF/jsp/produtos/edita.jsp.

<fieldset>
</fieldset>
</form>
4) Modifique a listagem de produtos

/WEB-INF/jsp/produtos/lista.jsp:
para
incluir
um
link
para
edio,
no
arquivo

<tr>
</tr>
</c:forEach>
5) Reinicie o tomcat e acesse a listagem http://localhost:8080/goodbuy/produtos/lista. Escolha um dos produtos e clique em Editar.
Edite o produto e clique em Enviar.
6) Crie agora a lgica de remoo na classe ProdutosController:

}
7) Implemente o mtodo remove no ProdutoDao.

public void remove(Produto produto) {
this.session.delete(produto);
tx.commit();
}
8) Modifique 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>
9) Reinicie o tomcat, acesse a listagem e remova algum produto.
7.12 - Discusso em sala - VRaptor

Mas o mercado usa mais o Struts. Vale a pena troc-lo?
Por que tantas convenes?
Captulo 7 - Criando o Controlador de Produtos - Discusso em sala - VRaptor - Pgina 61
C APTULO
Refatorando os DAOs
8.1 - Injeo de dependncias 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 fizemos no ProdutoDao, anotando a classe Session do pacote
org.hibernate com @Component. Assim, a sesso do Hibernate tambm seria 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 um mecanismo que nos auxilia a passar dependncias de outros
projetos para nossas classes. Basta criarmos uma classe que implementa a interface ComponentFactory. Essa
interface define um nico mtodo, o getInstance.
Criando essa classe, podemos definir 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 ficar assim:
import br.com.caelum.vraptor.ioc.ComponentFactory;
@Component
public class CriadorDeSession implements ComponentFactory<Session> {
public Session getInstance() {
62

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, configura, constri uma SessionFactory, e s ento abre uma sesso. No seria suficiente 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;
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 removemos da CriadorDeSession. No podemos nos esquecer da anotao @Component:
@Component
public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory> {
public SessionFactory getInstance() {
return factory;
}
}
Poderamos continuar esse processo, e criar uma ComponentFactory para AnnotationConfiguration tambm, 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 fizemos muita coisa s pra resolver o problema da Session. Mas a
vantagem de utilizarmos essa abordagem que para as nossas prximas lgicas, no precisaremos fazer
Captulo 8 - Refatorando os DAOs - Injeo de dependncias no DAO - Pgina 63
nada. Se tivermos que criar 50 DAOs no nosso sistema, no precisamos mais se preocupar com Sessions,
basta receber uma no construtor.
8.2 - Exerccios
1) Faa a classe ProdutoDao receber uma Session no construtor. Remova o mtodo getSession:
@Component
}
//...
}
2) Modifique 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.
@Component
return session;
}
}
3) A classe CriadorDeSession est fazendo coisas demais. Recorte a parte que cria uma SessionFactory e
receba uma SessionFactory no construtor. A classe deve ficar assim:
1 package br.com.caelum.goodbuy.infra;
2
3 // imports
4
5 public class CriadorDeSession implements ComponentFactory<Session> {
6
7
8
}
9
10
11
12
return session;
Captulo 8 - Refatorando os DAOs - Exerccios - Pgina 64
13
14
15 }
4) 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 fix) no parmetro factory, e o Eclipse nos mostrar algumas
sugestes. Selecione a primeira opo, Assign parameter to new field.
5) Anote a classe com @Component, para indicar que essa classe uma dependncia e pode ser instanciada
pelo VRaptor sempre que necessrio.
6) Crie a classe CriadorDeSessionFactory no pacote br.com.caelum.goodbuy.infra que implementa a
interface ComponentFactory<SessionFactory>.
2
3 // imports
4
5 public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory> {
6
7 }
7) A classe no compila, pois falta implementar o mtodo que foi definido 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.
2
3 // imports
4
6
7
8
9
10
11
12
13
14
15 }
return factory;
}
9) 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);
10) Acesse o sistema e veja que ele continua funcionando como antes.
8.3 - Analisando o cdigo

J conseguimos cadastrar um produto pelo browser e j criamos algumas classes para injeo de dependncias 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 CriadorDeSessionFactory. 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.
8.4 - Escopos definidos pelo VRaptor

O VRaptor nos permite definir 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.
Alguns componentes devem ter 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.
Captulo 8 - Refatorando os DAOs - Analisando o cdigo - Pgina 66
Para alguns casos, um componente 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 ficaria
nica para toda a aplicao, e qualquer cliente que precisar de uma sesso, usaramos essa fbrica.
Para cada cenrio acima, o VRaptor definiu um tempo de vida. Esse tempo de vida no VRaptor chamado
de escopo. O VRaptor define 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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
package br.com.caelum.goodbuy.infra;
// imports
@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.
Para resolver esse problema, poderamos criar um atributo do tipo SessionFactory e colocar no construtor
da classe a criao da fbrica.
@Component
@ApplicationScoped
public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory>{
public CriadorDeSessionFactory() {
factory = configuration.buildSessionFactory();
}
Captulo 8 - Refatorando os DAOs - Escopos definidos pelo VRaptor - Pgina 67

return factory;
}
}
Mas o VRaptor permite a utilizao de anotaes bem teis do Java EE 5: 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 finalizado, ou seja, no
final 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 modificaes, nossa classe ficaria assim:
@Component
@ApplicationScoped
private SessionFactory factory;
@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.
8.5 - Fechando a sesso do Hibernate

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 final 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, um para 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 ficaria assim:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// imports
@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
lembrar que componentes que controlados pelo VRaptor sempre tm um escopo, mesmo no estando anotado.
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
8.6 - Exerccios
Captulo 8 - Refatorando os DAOs - Fechando a sesso do Hibernate - Pgina 69
1) Anote a classe CriadorDeSessionFactory com @ApplicationScoped.

2
3
4
5
6
7
8
9
// imports
@Component
@ApplicationScoped
//...
}
2) Refatore essa classe para que seja criado apenas uma instncia da fbrica.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// imports
@Component
@ApplicationScoped
@PostConstruct
}
}
@PreDestroy
}
}
3) Refatore a classe CriadorDeSession, colocando os mtodos de callback e colocando a sesso do Hibernate

em um atributo.
@Component
}
@PostConstruct
}
}
@PreDestroy
}
}
4) Reinicie o tomcat, acesse o sistema e veja que tudo continua funcionando

5) (Opcional) Coloque System.out.println nos mtodos dos ComponentFactories, para ver a ordem que os
mtodos so chamados
6) (Opcional) Faa em uma folha de papel todo o fluxo de cadastro de um usurio. Esse fluxo pode ser feito de
qualquer forma, com flechas e caixas de texto por exemplo. O ponto importante desse exerccio ficar claro
como est a arquitetura do seu projeto.
C APTULO
Validando formulrios
Quando temos um formulrio para adicionar dados no nosso sistema, geralmente precisamos verificar 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 verificar se tudo est como esperamos. Chamamos isso de validao. Existem duas maneiras de fazer validao:
Validao do lado do cliente: verificamos 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 submetido caso acontea algum erro. A do lado do servidor feita em Java, e o VRaptor pode te ajudar a faz-la.
9.1 - Validator
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, especificar 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.
72
Para isso vamos definir primeiro as regras de validao para um produto:
nome: deve ser obrigatrio, e ter pelo menos 3 letras.

descrio: deve ser obrigatrio, e ter menos de 40 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 ifs 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"));
}
if (produto.getPreco() <= 0.0) {
"Preo precisa ser positivo", "produto.preco"));
}
dao.salva(produto);
}
maneira fluente: voc diz o que quer que seja verdade, e caso no seja adiciona uma mensagem
internacionalizada:
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 messages.properties:
nome.obrigatorio = Nome obrigatrio e precisa ter mais de 3 letras
Captulo 9 - Validando formulrios - Validator - Pgina 73
descricao.obrigatoria = Descrio obrigatria e no pode ter mais que 40 letras

preco.positivo = Preo precisa ser positivo
Em ambas as maneiras voc precisa especificar 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 final 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.
Quando existem erros de validao, o VRaptor disponibiliza para a jsp um atributo 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, precisamos passar como valor dos inputs, o que foi mandado para a requisio:
<fieldset>
</fieldset>
</form>
9.2 - Exerccios
1) Receba um Validator no construtor do ProdutosController e guarde-o num atributo:
Captulo 9 - Validando formulrios - Exerccios - Pgina 74
@Resource
this.dao = dao;
}
//...
}
2) Modifique o mtodo adiciona para que inclua a validao dos campos do produto. Se preferir, faa a
validao na forma fluente.
}
"Descrio obrigatria no pode ter mais que 40 letras",
}
if (produto.getPreco() <= 0) {
}
dao.salva(produto);
}
3) 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>
4) Adicione o cdigo para que o formulrio continue preenchido quando der erro de validao:
<fieldset>
</fieldset>
</form>
5) Abra o browser e tente adicionar um produto invlido.
6) (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?
9.3 - Para saber mais: Hibernate Validator

Hibernate Validator um poderoso framework para validao de objetos. Ele j vem com validadores que
verificam as regras mais comuns, como campos obrigatrios, tamanhos mnimos e cartes de crdito.
Alm disso, o framework tambm bastante flexvel, j que permite a criao dos seus prprios validadores.
Para definir 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
Captulo 9 - Validando formulrios - Para saber mais: Hibernate Validator - Pgina 76
@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)
private Double
preco;
Com nosso modelo anotado, podemos substituir as validaes que fizemos 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 ocorrerem sero adicionados ao validator automaticamente. Assim podemos substituir as validaes que tnhamos feito antes, pelas equivalentes do Hibernate Validator.
9.4 - Exerccios Opcionais

1) 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.
2) Anote os campos do produto para adicionar nossas regras de validao.
Captulo 9 - Validando formulrios - Exerccios Opcionais - Pgina 77
@Entity
@Id @GeneratedValue
private Long id;
@NotNull
@Length(min=3)
@NotNull
@Length(max=40)
@Min(0)
private Double
preco;
3) Mude a lgica de validao do mtodo adiciona do ProdutosController para usar o Hibernate Validator:
@Resource
//...
validator.validate(produto);
dao.salva(produto);
}
}
4) Acesse o browser e adicione algum produto invlido, para ver as mensagens de validao.
As mensagens esto em ingls e por enquanto no possvel internacionaliz-las, mas isso ser implementado em prximas verses do VRaptor.
C APTULO
10
REST
10.1 - O que REST
REST um conjunto de restries que define um padro arquitetural com caractersticas especficas: benefcios e dificuldades determinadas aparecero ao implementar um sistema seguindo o padro REST.
10.2 - Caractersticas e vantagens

Permitir o endereamento dos recursos do seu sistema de uma forma padronizada implica em algumas
vantagens 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 especficas 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 restfuliejava para entender mais como ele funciona e suas vantagens em um sistema: http://github.com/caelum/
restfulie-java
10.3 - O tringulo do 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 (Unified Resource Identifier ), ou seja, o identificador 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 identificando 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.
79
Verbos: Operaes
Uma das caracterstas mais importantes de REST que voc tenha um conjunto pequeno e fixo de operaes bem definidas, gerando uma interface uniforme. Desse modo, para duas aplicaes conversarem elas
no precisam implementar diversas operaes: basta usar as operaes definidas. 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 identificado pela URI. Ex: listar produtos, visualizar o produto
45. Uma requisio GET no deve modificar 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 modifica) um recurso na URI passada. Ex: atualizar um produto. A diferena fundamental entre um PUT e um POST que no POST a URI significa o lugar que vai tratar a informao, e no
PUT significa o lugar em que a informao ser armazenada.
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.
10.4 - Mudando a URI da sua lgica: @Path

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:
Captulo 10 - REST - Mudando a URI da sua lgica: @Path - Pgina 80
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:
/produto/edita?id=10
As URIs devem identificar recursos (alm de no conter verbos, mas vamos tir-los em breve), e o id algo
que identifica o recurso que queremos acessar, ento ficaria 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 10. Para extrair esse 10 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 identificam verdadeiramente recursos especficos.
10.5 - Mudando o verbo HTTP dos seus mtodos

Podemos tambm mudar o(s) verbo(s) HTTP que os mtodos dos nossos controllers respondem. Por padro, voc pode acessar seus mtodos usando qualquer um dos 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:
Captulo 10 - REST - Mudando o verbo HTTP dos seus mtodos - Pgina 81
import br.com.caelum.vraptor.Get;
@Resource
@Path("/produtos")
@Get
}
}
Se quisermos permitir outros verbos HTTP, podemos usar as anotaes @Post, @Put, @Delete, @Trace e
@Head. A partir 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 um status 405 (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
@Path("/produtos")
@Post
//...
}
@Path("/produtos")
@Get
}
}
10.6 - Refatorando o ProdutosController

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 executar
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.
Captulo 10 - REST - Refatorando o ProdutosController - Pgina 82
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 especfico, no caso de id 42. 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 fixos, mas elas precisam semanticamente representar o
mesmo tipo de recurso. Por exemplo a URI /produtos/ultimo pode representar o ltimo produto adicionado e
a URI /produtos/maisVendidos pode representar uma lista dos produtos mais vendidos, que so recursos bem
definidos. No nosso caso precisamos de uma URI para identificar 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 especificao de operaes no recurso Produto, podemos usar as anotaes vistas anteriormente
para deixar o ProdutosController de acordo com ela:
@Resource
@Get @Path("/produtos/novo")
public void formulario() {...}
@Get @Path("/produtos/{id}")
public Produto edita(Long id) {...}
@Put @Path("/produtos/{produto.id}")
public void altera(Produto produto) {...}
@Post @Path("/produtos")
public void adiciona(final Produto produto) {...}
@Delete @Path("/produtos/{id}")
public void remove(Long id) {...}
@Get @Path("/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 conseguem 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, especificando 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 GET que 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>
<!-vvvvvvv
vvv -->
<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!
button e o Internet Explorer
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"/>
10.7 - Exerccios
1) Anote os mtodos do ProdutosController para seguirmos a nossa especificao de Produto:
Recurso Produto:
POST /produtos => adiciona um novo produto. Mtodo adiciona.
2) Abra o formulario.jsp e mude a action do form:

3) 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>
4) Modifique o lista.jsp, colocando o link para Edio e o link para Remoo:

<td><a href="<c:url value="/produtos/${produto.id}"/>">Editar</a></td>
Captulo 10 - REST - Exerccios - Pgina 85
<td>
</form>
</td>
5) Abra o header.jspf e modifique 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>
C APTULO
11
AJAX e efeitos visuais

11.1 - O que AJAX?
AJAX (Asynchronous Javascript and XML) um conjunto de tcnicas de desenvolvimento Web para executar
tarefas do lado do cliente, por exemplo modificar pedaos de uma pgina sem ter 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 em background. Na resposta dessa requisio vem um XML que o javascript processa
e modifica a pgina segundo essa resposta.
o efeito que tanto ocorre no gmail e google maps.
H vrias ferramentas para se trabalhar com Ajax em Java. DWR e 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 famosos: 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.
11.2 - Um pouco de JQuery

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)
Seletores
O JQuery suporta XPath e CSS 3, com seletores 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 especifico:
87
$(#meuDiv).show()
$(#meuDiv).hide()
Um outro ponto forte do JQuery que ele possui diversos plugins que fazem vrias 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/.
Mais sobre javascript
Nesse curso no daremos foco no desenvolvimento de cdigo javascript, boas prticas e caractersticas dessa linguagem, apenas usaremos plugins do JQuery. Mas o cdigo javascript uma parte
bastante 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-43 | Desenvolvimento Web com HTML, CSS e JavaScript.
11.3 - Validando formulrios com o JQuery

Quando fizemos a validao do formulrio de adio de produtos, precisvamos enviar uma requisio para
o servidor, executando algumas lgicas para decidir se os dados estavam corretos, para ento responder para o
usurio que os seus dados no esto vlidos. Isso pode ser evitado se fizermos a validao do lado do cliente.
Alm de ser bem mais rpido, evita que seja feita uma requisio desnecessria para o servidor.
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:
Existe
um
plugin
<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 3, a descrio tambm obrigatria e o tamanho tem que ser menor que
40, e o preo maior que zero:
<fieldset>
<legend>Adicionar produtos</legend>
<input id="nome" class="required" minlength="3"
Captulo 11 - AJAX e efeitos visuais - Validando formulrios com o JQuery - Pgina 88
type="text" name="produto.nome" value="${produto.nome }"/>

<textarea id="descricao" class="required" maxlength="40"
name="produto.descricao">${produto.descricao }</textarea>
<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 definir 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>
11.4 - Criando a busca de produtos

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 11 - AJAX e efeitos visuais - Criando a busca de produtos - Pgina 89
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 modificar 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 modifique o div menu:
<div id="menu">
<ul>
<li><form action="<c:url value="/produto/busca"/>">
<input name="nome"/>
</form>
</li>
</ul>
</div>
Para que no fique 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:
11.5 - Melhorando a busca: Autocomplete

Captulo 11 - AJAX e efeitos visuais - Melhorando a busca: Autocomplete - Pgina 91
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 @Path("/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
qualquer, mas no nosso caso vai ser uma lista. Ao chamarmos a URI desse mtodo no browser, passando um
nome qualquer, por exemplo http://localhost:8080/goodbuy/produtos/busca.json?nome=a retornado um JSON
parecido com:
{"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
precisamos de uma lista de nomes, talvez com o preo. Para isso podemos excluir as outras propriedades:

//...
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 suficiente, mas o plugin AutoComplete espera que voc mande os dados separados por
pipe(|) ou um dado por linha. Como queremos usar JSON, precisamos configurar 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 {
data: produto, // todos os dados do produto
value: produto.nome, // o valor lgico do produto
result: produto.nome // o que vai aparecer ao selecionar
};
});
},
formatItem: function(produto) { // o que vai aparecer na lista de autocomplete
return produto.nome + "(" + produto.preco + ")";
}
});
Alm disso, o plugin passa como parmetro da requisio o que voc digitou no input, numa varivel chamada 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();
}
Para saber mais: c:url dentro de javascript

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 fizemos, somos obrigados a sempre fazer o deploy da aplicao 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 ficar mais difceis de entender.
11.6 - Exerccios
1) Modifique 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().
<fieldset>
</fieldset>
</form>
</script>
2) Tente adicionar um produto invlido.
3) (Opcional) As mensagens de erro esto em ingls. Tente procurar na documentao do plugin como fazer
para que as mensagens fiquem em portugus.
4) Crie um mtodo em ProdutosController para a listagem de produtos.
@Resource
Captulo 11 - AJAX e efeitos visuais - Exerccios - Pgina 95

//...
}
}
5) Use o atalho Ctrl+1 para criar o mtodo busca no ProdutoDao.
6) Implemente o mtodo busca no ProdutoDao.

@Component
//...
.list();
}
}
7) Crie o JSP de resultado da busca, em /WEB-INF/jsp/produto/busca.jsp

8) Abra o arquivo header.jspf e modifique o menu para incluir um formulrio de busca:

<div id="menu">
<ul>

</form>
</li>
</ul>
</div>
9) Faa buscas usando esse formulrio.
10) Modifique o formulrio de busca para usar o plugin Puts e deixar uma mensagem dentro do input.
<div id="menu">
<ul>
</form>
</script>
</li>
</ul>
</div>
11) Recarregue a pgina atual e veja que a mensagem apareceu no input.
12) Crie o mtodo de busca que retorna JSON no ProdutosController.

.from(dao.busca(q))
.serialize();
}
13) Adicione o cdigo javascript para que o autocomplete funcione.

dataType: "json",
parse: function(produtos) {
return {
data: produto,
value: produto.nome,
result: produto.nome
};
});
},
formatItem: function(produto) {
}
});
14) Recarregue a pgina e teste o autocomplete digitando algo no campo de busca.
C APTULO
12
Criando o Carrinho de Compras

12.1 - O modelo do Carrinho
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;
}
Pergunta importante: precisamos guardar esse carrinho no banco? O usurio no comprou ainda os produtos, ento no faz muito sentido guardar no banco de dados. Esse carrinho precisa ficar 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 modificar a classe do carrinho para incluir as anotaes:
@Component
@SessionScoped
99

//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.
12.2 - Controlando o carrinho de compras

Agora que temos o modelo do Carrinho, vamos criar uma maneira de adicionar produtos. O jeito mais
simples modificar a listagem de produtos adicionando um boto para comprar:
<table>
<thead>
<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>
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:
Captulo 12 - Criando o Carrinho de Compras - Controlando o carrinho de compras - Pgina 100
@Resource
public class CarrinhoController {
}
Vamos criar o mtodo que responde URI colocada no formulrio de compra:

@Resource
@Post @Path("/carrinho")
public void adiciona(Item item) {
}
}
Para adicionar o item ao carrinho, temos que receber um Carrinho no construtor, assim o VRaptor vai passar
para o CarrinhoController o carrinho da sesso do usurio:
@Resource
private final Carrinho carrinho;
public CarrinhoController(Carrinho carrinho) {
this.carrinho = 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;
}
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 voltar
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;
}
}
}
12.3 - Visualizando os itens do carrinho

J conseguimos adicionar itens no carrinho, mas no possvel ainda visualizar o que tem dentro dele.
Primeiro, vamos adicionar uma lugar em todas as pginas que mostra o estado atual do carrinho: quantos itens
ele tem e qual o valor total. Mas como vamos acessar o carrinho da sesso em todas 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 atributo 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>
</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();
}
}
Captulo 12 - Criando o Carrinho de Compras - Visualizando os itens do carrinho - Pgina 103
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><fmt:formatNumber type="currency"
value="${item.produto.preco }"/></td>
<td>${item.quantidade }</td>
value="${item.quantidade * item.produto.preco }"/></td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
<td colspan="2"></td>
<th colspan="2">Total:</th>
<th><fmt:formatNumber type="currency" value="${carrinho.total }"/></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
//...
result.redirectTo(this).visualiza();
}
}
12.4 - Removendo itens do carrinho

Para completar as funcionalidades do carrinho de compras, vamos modificar 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>
Captulo 12 - Criando o Carrinho de Compras - Removendo itens do carrinho - Pgina 105
</c:forEach>
</tbody>
...
</table>
Vamos criar, tambm, o mtodo que remove itens do carrinho no controller:

//...
@Delete @Path("/carrinho/{indiceItem}")
public void remove(int indiceItem) {
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();
}
}
12.5 - Exerccios
1) Crie os modelos Carrinho e Item:
package br.com.caelum.goodbuy.modelo;
@Component
@SessionScoped
//getters e setters
}
public class Item {
Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 106

//getters e setters
}
2) Modifique a listagem de produtos para incluir um boto para comprar o produto:

<table>
<thead>
<tr>
...
<th>Comprar</th>
...
</tr>
</thead>
<tbody>
<tr>
...
<td>
</form>
</td>
...
</tr>
</c:forEach>
</tbody>
</table>
3) Adicione o div do carrinho no cabealho da pgina (arquivo header.jspf)

<div id="header">
<div id="carrinho">
</c:if>
<ul>
</ul>
</c:if>
</div>
</div>
4) Crie o CarrinhoController, com um mtodo para adicionar itens no carrinho.

@Resource
this.dao = dao;
}
}
}

//...
itens.add(item);
}
}
}

//...
}
}
5) Compre alguns produtos e veja o carrinho sendo atualizado no header.
6) Crie a lgica e o jsp que visualiza os itens do carrinho. Mude tambm o redirecionamento do mtodo
adiciona para a nova lgica.
@Resource
//...
}
}
}
/WEB-INF/jsp/carrinho/visualiza.jsp
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
<th>Qtde</th>
<th>Total</th>
</tr>
</thead>
<tbody>
<tr>
<td><fmt:formatNumber type="currency" value="${item.produto.preco }"/></td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
</tr>
</tfoot>
</table>
7) Adicione mais produtos ao carrinho.
8) Crie a lgica de remover produtos do carrinho e adicione o boto de remoo na visualizao do carrinho.
//...
}
}

}
}
<table>
...
<tbody>
<tr>
...
<td>
</form>
</td>
</tr>
</c:forEach>
</tbody>
...
</table>
9) Adicione e remova itens do carrinho.
C APTULO
13
Autenticao
13.1 - Criando Usurios
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 identificador nico.
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
@Id
//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
112
tabelas do banco quando necessrio.

<session-factory>

<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() {
}
}
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>
Captulo 13 - Autenticao - Criando Usurios - Pgina 113
$(#usuariosForm).validate();
</script>
Precisamos tambm criar um link para esse cadastro. Para isso criaremos uma div no cabealho que
mostrar as informaes do usurio. Abra o arquivo header.jspf e modifique 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, Validator validator) {
this.dao = dao;
}
@Post @Path("/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;
}
Transaction tx = this.session.beginTransaction();
this.session.save(usuario);
tx.commit();
}
}
13.2 - Efetuando o login

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 @Path("/login")
public void loginForm() {
}
}
<form action="<c:url value="/login"/>" method="POST">

<fieldset>
<legend>Efetue o login</legend>
<input id="login" type="text" name="usuario.login"/>
<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
Captulo 13 - Autenticao - Efetuando o login - Pgina 115
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
verificar 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 @Path("/login")
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 Usuario carrega(Usuario usuario) {
return (Usuario) session.createCriteria(Usuario.class)
.add(Restrictions.eq("senha", usuario.getSenha()))
.uniqueResult();
}
}
E para mostrar que o usurio est logado mesmo, vamos modificar 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}">
</c:if>
</div>
...
</div>
Por ltimo vamos adicionar a lgica de logout:

//...
@Path("/logout")
public void logout() {
usuarioWeb.logout();
}
}

//...
this.logado = null;
}
}
13.3 - Restringindo funcionalidades para usurios logados
Captulo 13 - Autenticao - Restringindo funcionalidades para usurios logados - Pgina 117
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 }">
</c:if>
...
/WEB-INF/jsp/produto/lista.jsp
<table>
...
<tbody>
<tr>
...
<td>
</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
executar. Mas ser que isso o suficiente? O que impede o usurio de digitar na barra de endereos do browser:
http://localhost:8080/goodbuy/produtos/novo? Nada! Ele s precisa conhecer qual a URI. Precisamos, de
algum 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.
13.4 - Interceptor
Um Interceptor no VRaptor como se fosse um Servlet Filter: ele pode interceptar requisies, executando
algo antes e/ou depois da sua lgica. Mais ainda, ele pode impedir que sua lgica seja executada, redirecionando a requisio para outro lugar. Isso exatamente o que a gente queria: verificar 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
e implementar a interface Interceptor:
@Intercepts
Captulo 13 - Autenticao - Interceptor - Pgina 118
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 mtodo
do seu controller. Com esse objeto voc tem acesso classe do controller e ao mtodo java dele
(java.reflect.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 verificar 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 implementar 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 AutorizacaoInterceptor(UsuarioWeb usuario, Result result) {
}
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 modifique 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:
@Retention(RetentionPolicy.RUNTIME) //a anotao vai ficar disponvel em tempo de execucao
@Target(ElementType.METHOD) // anotao para mtodos
public @interface Restrito {
}
Assim, podemos anotar os mtodos restritos (adiciona, atualiza, remove, formulario e edita do ProdutosController):
@Resource
@Restrito
public void formulario() {}
@Restrito
@Restrito
@Restrito
@Restrito
...
}
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 APTULO
14
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.
14.1 - Exerccios
1) Modifique a pgina de edio de Produtos (/WEB-INF/jsp/produtos/edita.jsp), para incluir um formulrio
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>
2) 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 @Path("/produtos/{produto.id}/imagem")
public void upload(Produto produto, UploadedFile imagem) {
}
}
3) 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) {
122
if (that(imagem, is(notNullValue()), "imagem", "imagem.nula")) {
that(imagem.getContentType(), startsWith("image"), "imagem", "nao.eh.imagem");
}
}});
validator.onErrorRedirectTo(ProdutosController.class).edita(produto.getId());
}
4) Coloque as mensagens internacionalizadas no messages.properties:

imagem.nula = Digite uma imagem
nao.eh.imagem = Selecione uma imagem
5) Crie o componente do VRaptor que ser responsvel por guardar as imagens no servidor. Esse componente
vai criar uma pasta fixa onde todas as imagens sero guardadas. Para isso, precisamos conseguir 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;
@Component
public class Imagens {
private File pastaImagens;
public Imagens(ServletContext context) {
String caminhoImagens = context.getRealPath("/WEB-INF/imagens");
pastaImagens = new File(caminhoImagens);
pastaImagens.mkdir();
}
}
6) Crie um mtodo que salve a imagem do upload na pasta padro. Colocaremos uma extenso fixa para
facilitar. O IOUtils vem do projeto commons-io e copia um InputStream para algum OutputStream
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.commons.io.IOUtils;
@Component
//...
public void salva(UploadedFile imagem, Produto produto) {
Captulo 14 - Apndice - Download e Upload - Exerccios - Pgina 123
File destino = new File(pastaImagens, produto.getId() + ".imagem");

try {
IOUtils.copyLarge(imagem.getFile(), new FileOutputStream(destino));
} catch (IOException e) {
throw new RuntimeException("Erro ao copiar imagem", e);
}
}
}
7) Use a classe Imagens para salvar a imagem que veio no upload. E a classe Result para voltar para o
formulario de edio.
@Resource
private final Imagens imagens;
public ImagensController(Validator validator, Imagens imagens, Result result) {
this.imagens = imagens;
}
}
}});
imagens.salva(imagem, produto);
result.redirectTo(ProdutosController.class).edita(produto.getId());
}
}
8) Crie a lgica para fazer o download da imagem no ImagensController:

@Get @Path("/produtos/{produto.id}/imagem")
public File download(Produto produto) {
return imagens.mostra(produto);
}
9) Crie o mtodo mostra na classe Imagens:

public File mostra(Produto produto) {
return new File(pastaImagens, produto.getId() + ".imagem");

}
10) Mude o formulrio de edio para incluir a imagem do produto. Repare que estamos usando nosso controller
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 APTULO
15
Apndice - Integrando VRaptor e Spring

15.1 - Como fazer a integrao?
Para usar os componentes do Spring no VRaptor basta configur-los no applicationContext.xml da maneira que voc j est acostumado a fazer quando trabalha com o Spring.
Mas voc deve ter em mente que os componentes configurados pelo applicationContext.xml no enxergam os componentes configurados pelas anotaes do VRaptor, ento se algum componente do Spring
depender de algo que est no VRaptor, voc precisa converter a configurao para a do Spring para fazer
funcionar.
15.2 - Integrando o Transaction Manager do Spring

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.
O Spring possui um componente 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.
15.3 - Exerccios: Transaction Manager

1) 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>
126
2) Inclua o componente que gerencia as transaes, baseado em anotaes do Spring.

xmlns:tx="http://www.springframework.org/schema/tx"
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>
3) Esse componente de transaes genrico: funciona tanto com a JTA direto, com Hibernate/JPA, com JDBC,
etc. Ento para especificar qual dos gerenciadores de transao vai ser utilizado, voc precisa adicionar um
bean na configurao. No nosso caso, vamos usar transaes do Hibernate:
<beans xmlns...>
<bean id="transactionManager"
class="org.springframework.orm.hibernate3.HibernateTransactionManager">
<property name="sessionFactory" ref="sessionFactory" />
</bean>
</beans>
4) O transactionManager precisa de uma SessionFactory configurada. 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>
5) Ao usar a SessionFactory do Spring estamos presos ao seu controle de Sessions. Isso significa 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 modificar 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
Captulo 15 - Apndice - Integrando VRaptor e Spring - Exerccios: Transaction Manager - Pgina 127
uma Session no construtor do DAO, mas mesmo assim s pedir a Session pro Spring na hora de chamar
algum mtodo.
Modifique 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
}
}
6) Para usar o controle de transaes do Spring, remova a abertura e o fechamento de transaes dos
mtodos do DAO, e anote o mtodo com @Transactional. Repare que nem todos os mtodos precisam de
transaes, s os que modificam o banco.
import org.springframework.transaction.annotation.Transactional;
@Component
@Transactional
public void salva(Produto produto) {

//Transaction tx = session.beginTransaction();
//tx.commit();
}
return (Produto) session.load(Produto.class, id);
}
@Transactional
}
}
@Transactional
}
.list();
}
}
}
C APTULO
16
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.
16.1 - Exerccios: Configurando o Velocity

1) Entre no site de downloads do velocity (http://velocity.apache.org/download.cgi) e baixe os zips velocityx.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
2) 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>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
16.2 - Exerccios: Mudando o Template Engine de uma nica lgica

1) Se voc quiser usar o Velocity em uma nica ou poucas lgicas, voc no precisa de muita coisa. Com a
Servlet do Velocity configurada, 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>
2) Acesse a pgina do Velocity diretamente: http://localhost:8080/goodbuy/olamundo.vm

3) Crie um controller simples para redirecionar pra esse arquivo. Note que os objetos includos no Result ficam
acessveis no template do Velocity.
130
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 modifique o olamundo.vm para mostrar a mensagem includa:

<html>
<body>
Ol mundo. $mensagem.
</body>
</html>
4) Acesse a URL que cai nesse mtodo: http://localhost:8080/goodbuy/teste
16.3 - Exerccios: Mudando o resultado de todas as lgicas para Velocity

1) O VRaptor 3 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 Dependncia 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 {
Captulo 16 - Apndice: Mudando a View Padro: Velocity - Exerccios: Mudando o resultado de todas as lgicas para Velocity Pgina 131
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";
}
}
2) 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.
3) Remova o redirecionamento para a pgina olamundo.vm de dentro do TesteController:
}
@Path("/teste")
}
}
4) Acesse a url do mtodo teste (http://localhost:8080/goodbuy/teste), e veja que continua funcionando: ele
vai redirecionar automaticamente para a pgina /WEB-INF/velocity/teste/teste.vm.
5) Veja que agora nenhuma das outras pginas do sistema esto acessveis. Agora qualquer chamada vai dar
404, pois ele estar usando a nova conveno. O comportamento do VRaptor agora o da sua classe, e
no mais a padro dele!
ndice Remissivo
AnnotationConfiguration, 11
Criteria, 40
Driver, 5
Escopo, 67
Hibernate, 4
Hibernate Annotations, 5
Hibernate Core, 5
Injeo de Dependncias, 43
JPA, 4
Log4J, 5
Logging, 5
MySQL, 4
ORM, 4
POJO, 32
Result, 52
SL4J, 5
Validao, 72
133
Desmistificando o AJAX
Descrio : Explica o que , para que serve e como implementar o AJAX

Nvel: Iniciante
Responsvel : Raphael Paiva
Contato: raphael@sena.com.br MSN: raphaelpaiva@msn.com
Data : 14/11/2005
1. O QUE AJAX..............................................................................................................................................................2
2. A FINALIDADE DO AJAX..........................................................................................................................................2
3. A APLICABILIDADE DO AJAX ................................................................................................................................3
4.
A ARQUITETURA DO AJAX .................................................................................................................................4

4.1
5.
SINCRONISMO X ASSINCRONISMO ........................................................................................................................5
PRIMEIROS PASSOS: EXPLICANDO UM EXEMPLO SIMPLES ..................................................................7

Criando um objeto XMLHttpRequest .........................................................................................................................7
Utilizando o XMLHttpRequest para transportar dados para o servidor ...................................................................7
Declarando a Servlet a ser usada para o Ajax no web.xml........................................................................................8
Implementando a Servlet que receber as requisies das pginas ..........................................................................8
6.
UTILIZANDO NO DIA-A-DIA: UM EXEMPLO REAL....................................................................................10

6.1 REQUISITOS DO EXEMPLO .........................................................................................................................................11
6.2 MOS NA MASSA .......................................................................................................................................................12
7. CONCLUSO ..............................................................................................................................................................15
APNDICE.......................................................................................................................................................................16
1/16
1. O que AJAX
Antes de explicar o que AJAX, deve-se explicar o que ele no ; AJAX no um
framework, uma API nem uma tecnologia em si, uma funcionalidade implementada por um
conjunto de objetos de JavaScript, sendo o mais importante chamado XMLHttpRequest.
Este objeto, que trata uma requisio ou resposta de servidor com um documento XML
DOM, contm uma srie de mtodos que possibilita que o browser possa realizar requisies e
receber respostas do servidor sem que este tenha que atualizar(refresh) a tela.
2. A finalidade do AJAX
O principal problema resolvido com AJAX a substituio da conhecida tela escondida ou
hidden frame, que era implementado como nica soluo para a realizao de uma requisio sem
refresh da pgina principal.
Com hidden frame tnhamos vrios problemas:
Problemas com Hidden Frame
Pginas com vrios quadros
Quando ocorriam erros na pgina escondida, estes no eram rastreados com facilidade.
Dificuldade de manuteno.
O desenvolvedor, ao ver uma j implementada, tinha bastante receio em adicionar ou

modificar alguma funcionalidade dela, pois poderiam ocorrer erros em outros locais.
Normalmente deveria ser implementado um novo jsp para cada mtodo, assim, caso
fosse necessrio a utilizao de vrias funcionalidades, eram necessrios mais pginas
escondidas na mesma pgina.
No se tinha um local que centralizasse e controlasse todas as requisies.
AJAX resolve este problema, possibilitando, atravs de um nico mtodo, realizar request e
receber responses com ilimitadas respostas, ou seja, a comunicao cliente-servidor fica
transparente, fazendo com que sem nenhuma dificuldade o desenvolvedor possa acessar mtodos do
servidor quase como se fosse um mtodo JavaScript.
2/16
3. A Aplicabilidade do AJAX
Alguns usos mais comuns do AJAX podem ser listados:
1. Validao em tempo real: Validaes que no possam ser feitas do lado do cliente, como,
por exemplo, verificar se usurio j est cadastrado ou se a data informada anterior data
atual.
2. Auto Completion: Possibilita que o ao mesmo tempo em que o usurio for digitando, possa
aparecer uma lista de possveis respostas.
-Um bom exemplo o Google Suggest (http://www.google.com/webhp?complete=1&hl=en)
3. Visualizao de detalhes de um item: Ao invs de carregar todos os dados na tela ou ento
necessitar de popups, pode-se montar a lista de itens-pai e dependendo da escolha, montar
os detalhes do item.
-Para melhor exemplificao, um bom exemplo a seo de notcias e de empregos do portal
JavaFree(www.javafree.org).
4. Controles de interface de usurio sofisticados: Controles dinmicos como arvore de
diretrios, menus, barras de progresso e interface ricas como aplicaes RIA ou at mesmo
jogos podem ser implementados sem necessidade de refresh.
-Um exemplo de interface rica pode ser visualizada no site Flickr(http://flickr.com/), onde o
usurio pode organizar uma coleo de fotos com diversos recursos, como por exemplo com
utilizao de drag n drop.
-Um exemplo do famoso jogo Lemmings desenvolvido utilizando AJAX pode ser visto em
(http://193.151.73.87/games/lemmings/)
5. Atualizao de dados na pgina: Atualizao de informaes na pgina em tempo real sem
a necessidade de refresh possibilita, por exemplo, o desenvolvimento de chats,
acompanhamento de aes de bolsa, notcias ou aplicaes semelhantes.
-Um exemplo de chat existe no site QWAD(http://www.qwadchat.com).
-Um exemplo de atualizao de notcias segundo a segundo est em (http://digg.com/spy)
3/16
4.
A arquitetura do AJAX
AJAX(Asynchronous Javascript And XML) modifica um pouco a arquitetura das
aplicaes atuais.
Enquanto as aplicaes clssicas tinham seqncia de troca de informaes totalmente
sncrona, AJAX, por default tem uma seqncia assncrona, porm esta pode ser configurada para
ser sncrona como ser explicado depois.
Figura 1 - Comparativo entre a arquitetura clssica e a AJAX
Agora com o AJAX possvel termos um centralizador/controlador de requisies e

respostas, implementando assim o padro MVC-2 e possibilitando uma melhor manutenibilidade do
sistema. Mas a frente estaremos exemplificando.
4/16
4.1
Sincronismo X Assincronismo
A diferena entre requisies sncronas e assncronas quando se espera receber a
resposta.
Num modelo sncrono das aplicaes clssicas, temos chamadas e respostas seqenciais,
ou seja, necessrio recebermos a resposta da requisio anterior antes que passemos para a
prxima requisio. Este tipo de modelo o usado na arquitetura clssica, onde, caso precise chamar
o servidor, preciso realizar um refresh da pgina, e na pgina atualizada (ou na prxima pgina)
receber a resposta.
A ilustrao a seguir descreve a diferena dos modelos:
Figura 2 - Demonstrao de modelo sncrono e assncrono
5/16
No AJAX podemos utilizar ambos os modelos dependendo da necessidade, e em ambos

os casos, no precisamos nem sequer realizar refresh da pgina.
Por exemplo, imagine que estamos num cadastro de usurio e, desejamos procurar pela
cidade de acordo com o CEP informado; para este caso podemos utilizar o modelo assncrono, pois
no de grande importncia que essa informao chegue para que outras sejam executadas, assim,
outras lgicas e mtodos podem estar rodando em paralelo. Com o modelo assncrono, no momento
em que a resposta chegar ao cliente, ser disparado um mtodo que ir tratar e utilizar as
informaes retornadas do servidor.
Imagine agora, que na mesma tela de cadastro de usurio queremos verificar a idade deste
usurio que apenas informou a data de nascimento; caso o usurio for maior de 18 anos, podemos
habilitar algumas informaes e campos na tela, caso menor, no deve mostrar; para este caso
podemos utilizar o modelo sncrono; pois crucial que o usurio de 18 anos preencha ou verifique
tais dados antes de clicar em salvar. Com o modelo sncrono, ao chamar o mtodo que se deseja, a
aplicao cliente fica aguardando receber a resposta do servidor, e s executa os demais mtodos
depois deste ter retornado.
Ateno: Deve-se utilizar o modelo sncrono apenas em um caso de real necessidade,
pois caso o servidor nunca responda, a aplicao cliente ficar travada at que se d um
time-out.
6/16
5.
Primeiros passos: Explicando um exemplo simples

Como dito no incio, o AJAX na verdade se resume a um nico objeto javascript chamado
XMLHttpRequest, que possibilita chamadas ao servidor sem a necessidade de refresh.

Temos duas implementaes deste objeto, uma seguida pelo Internet Explorer e outra
seguida pelo Mozilla (a maioria dos outros browser do mercado seguem a implementao do
Mozilla) e podemos instanciar da seguinte forma:
Criando um objeto XMLHttpRequest
1. function chamaAjax(){
2. var req;
3. var isIE;
4. if (window.XMLHttpRequest) {
5.
req = new XMLHttpRequest();
6. }else if (window.ActiveXObject) {
7.
isIE = true;
8.
req = new ActiveXObject("Microsoft.XMLHTTP");
9. }
Com o cdigo acima, teremos nossa varivel req instanciada com um objeto
XMLHttpRequest para qualquer browser.
OBS: em algumas verses antigas do IE, deve ser instanciado o objeto
Msxml2.XMLHTTP ao invs de Microsoft.XMLHTTP. Um exemplo de cdigo mais
detalhado para todos os casos ser demonstrado no decorrer do tutorial.
10.
12.
13.
14.
15. }
Utilizando o XMLHttpRequest para transportar dados para o servidor

var url = "ajax?nome=raphael&tecnologia=java;
req.onreadystatechange = processRequest;
req.open("GET", url, true);
req.send(null);
O cdigo acima faz a tarefa de passar ao servidor, atravs do mtodo http GET, os
parmetros para processamento. Aps a linha 14 ser executada, a requisio transmitida.

OBS: Neste cdigo j aparecem 3 propriedades do objeto XMLHttpRequest, estas e
outras mais sero explicadas uma a uma posteriormente.
7/16
Declarando a Servlet a ser usada para o Ajax no web.xml
1. <servlet>
2. <servlet-name>ServletAjax</servlet-name>
3. <servlet-class>ServletAjax</servlet-class>
4. </servlet>
5. <servlet-mapping>
6. <servlet-name>ServletAjax</servlet-name>
7. <url-pattern>/ajax</url-pattern>
8. </servlet-mapping>
Acima demonstra como mapear no web.xml da aplicao o servlet que ficar responsvel por
receber as requisies. Qualquer requisio feita com o comando ajax ser redirecionada para a
Servlet descrita a seguir.
Implementando a Servlet que receber as requisies das pginas
1. import javax.servlet.*;
2. import javax.servlet.http.*;
3. public class ServletAjax extends HttpServlet {
4. protected void service(HttpServletRequest request, HttpServletResponse response)
5.
throws ServletException, IOException {
6.
String nome = request.getParameter("nome ").trim();
7.
String tecnologia = request.getParameter("tecnologia ").trim();
8.
//LGICAS NECESSRIAS
9.
response.getWriter().write(nome + gosta de + tecnologia);
10. }
11.}
Acima exemplificado o Servlet que ler toda requisio feita pelo Ajax neste nosso
exemplo. Nela, possvel pegar todos os parmetros passados na requisio, realizar as lgicas
necessrias, como acesso a banco, validao de valores, etc.
Atravs do mtodo write da classe PrintWriter, pode-se retornar qualquer valor que seja
String,
int
ou
array
de
chars
(para
maiores
detalhes,
JavaDoc
[http://java.sun.com/j2se/1.4.2/docs/api/index.html] nosso amigo).

Pronto! J temos nosso Servlet que recebe, trata e responde s requisies ao cliente! Tudo
isso, lembrando, sem refresh; agora precisamos escrever o mtodo no cliente para que este receba a
resposta e mostre-a ao usurio.
8/16
Implementando mtodo de recepo de respostas do servidor

1. function processRequest() {
2. if (req.readyState == 4) {
3.
if (req.status == 200) {
4.
var texto = req.responseText;
5.
alert("resposta = "+texto);
6.
}
7. }
8. }
O mtodo javascript acima responsvel por, simplesmente recuperar o texto enviado pelo
servidor e mostr-lo ao usurio.
9/16
6.
Utilizando no dia-a-dia: Um exemplo real

No exemplo anterior, tnhamos a tarefa apenas de enviar um dado ao servidor e retorn-lo ao
cliente e conseguimos execut-la com sucesso, ela j serve para algumas implementaes simples de
pedido de retorno de um dado simples para o usurio, porm, AJAX pode fazer bem mais! No
retornando apenas um dado, mas uma lista destes, podendo inclusive trabalhar com folhas-deestilo(CSS) para melhor visualizao do usurio.
J existem uma srie de frameworks que trabalham com AJAX, e estes podem ser
incorporados a qualquer aplicao web, com a utilizao de qualquer framework MVC, ou seja..
no ache que voc est preso ao framework ou ao AJAX, voc pode adicion-lo e retir-lo de onde
quiser e quando quiser.
Alguns exemplos de framework AJAX do mercado:
Framework e APIs de AJAX mais utilizadas na atualidade:
DWR - http://getahead.ltd.uk/dwr/
AjaxAnywhere - http://ajaxanywhere.sourceforge.net/
SaJax - http://www.modernmethod.com/sajax/
Rico - http://openrico.org/rico/home.page
BackBase - http://www.backbase.com
AjaxTags - http://ajaxtags.sourceforge.net/
Todos estes frameworks acima so bastante utilizados no mercado mundial, tm grande
suporte e uma srie de funcionalidades visuais, como dragn drop de componentes, preenchimento
de grids em tempo real, sugesto de escrita(como no google suggest), etc.
O exemplo que iremos dar neste tutorial no utilizar de nenhum desses frameworks, iremos
implementar o AJAX de forma pura, dessa vez retornando do servidor um XML com todos os
valores (ao invs de apenas um texto, como no exemplo anterior) e iremos preencher um uma lista
de valores.
10/16
6.1 Requisitos do exemplo
O que iremos implementar para este exemplo preenchimento de um combobox com uma
pequena lista de cidades de acordo com o estado selecionado em outra combo, e aps a seleo da
cidade, nos ser mostrado a quantidade de fs do Java.
Abaixo, a lista de cidades de acordo com o estado:
Estado
Cidade
CE
-Caucaia
-Fortaleza
-Sobral
PB
-Joo Pessoa
PE
-Caruaru
-Recife
N de Javaneses
60
400
1
200
40
550
Iremos dessa vez, ao invs de retornamos um texto para o servidor, um XML com os dados
limpos de formatao HTML, no caso, um arquivo com a seguinte caracterstica:
Arquivo xml de retorno para o cliente
<?xml version='
1.0'?>
<root>
<estado>
<cidade nome='
Caucaia'
>
<javaneses>15</javaneses>
</cidade>
<cidade nome='
Fortaleza'
>
</cidade>
<cidade nome='
Sobral'
>
</cidade>
</estado>
</root>
Para a utilizao de xml como passagem de valores, deveremos ter algumas modificaes
tanto no Servlet, quanto no javascript que tratar do retorno. O web.xml continuar o mesmo.
Nosso Servlet, que estamos chamando de ServletAjax sofrer duas pequenas mudanas
(alm da lgica de negcio).
Sero adicionadas duas linhas a serem passadas como parmetro para o HTML, uma para
informarmos que nossa resposta ser um xml e estar codificado no padro UTF-8; a segunda
apenas uma informao para que o browser no utilize seu cache.
11/16
6.2 Mos na massa

ServletAjax que receber as requisies das pginas e retornar um XML como resposta
1.import javax.servlet.*;
2.import javax.servlet.http.*;
3.public class ServletAjax extends HttpServlet {
4. protected void service(HttpServletRequest request, HttpServletResponse response)
5.
throws ServletException, IOException {
6.
String uf = request.getParameter("uf");
7.
String retorno = "<?xml version='
1.0'?><root>";
8.
if(uf.equalsIgnoreCase("CE")){
9.
retorno += "<estado>"+
10.
"<cidade nome='
Caucaia'
>"+
11.
"<javaneses>15</javaneses>"+
12.
"</cidade>"+
13.
"<cidade nome='
Fortaleza>"+
14.
15.
"</cidade>"+
16.
"<cidade nome='
Sobral'
>"+
17.
18.
"</cidade>"+
19.
"</estado>";
20.
}else if(uf.equalsIgnoreCase("PB")){
21.
22.
"<cidade nome='
Joo Pessoa'
>"+
23.
24.
"</cidade>"+
25.
"</estado>";
26.
}else if(uf.equalsIgnoreCase("PE")){
27.
28.
"<cidade nome='
Recife'
>"+
29.
30.
"</cidade>"+
31.
"<cidade nome='
Olinda'
>"+
32.
33.
"</cidade>"+
34.
"</estado>";
35.
}
36.
retorno += "</root>";
37.
response.setContentType("text/xml;charset=UTF-8");
38.
response.setHeader("Cache-Control", "no-cache");
39.
response.getWriter().write(retorno);
40.
}
41.}
12/16
O cdigo do SerletAjax acima espera receber como parmetro (como visto na linha 6) a UF
desejada pelo usurio, atravs dela faz-se uma pequena lgica para retornar o XML resultante.
Perceba que a linha 37 MUITO importante, sem ela, frases com caracteres com acento, por
exemplo, no seriam reconhecidas; no nosso caso, Joo Pessoa iria para o browser como Jo?o
Pessoa.
Logo abaixo, veremos como ficar a tela do nosso jsp:
E adiante, o fonte completo da jsp. Note que o javascript, a chamada ao AJAX e o HTML
esto na mesma pgina apenas para fins didticos:
13/16
JSP da pgina de escolha de cidades

1.<html>
2.<head>
3.<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4.<script type="text/JavaScript">
5.var req;
6.var isIE;
7.function initRequest(url) {
8.
if (window.XMLHttpRequest) {
9.
req = new XMLHttpRequest();
10.
} else if (window.ActiveXObject) {
11.
isIE = true;
12.
req = new ActiveXObject("Microsoft.XMLHTTP");
13.
}
14.}
15.function atualizaCidades(uf){
16.
if(uf != ''){
17.
var url = "ajax?uf="+escape(uf);
18.
initRequest(url);
19.
req.onreadystatechange = processRequest;
20.
req.open("GET", url, true);
21.
req.send(null);
22.
}else{
23.
var html = "<SELECT NAME='Cidades'><OPTION value=''>----</OPTION></SELECT>";
24.
document.getElementById("DivCidades").innerHTML = html;
25.
}
26.}
27.function processRequest() {
28.
if (req.readyState == 4) {
29.
if (req.status == 200) {
30.
var xml = req.responseXML;
31.
var html = "<SELECT NAME='Cidades' onChange='if(this.value!=\"\"){alert(\"Javaneses =
32.\"+this.value);}'><OPTION value=''>--Selecione Cidade--</OPTION>";
33.
var documento = xml.childNodes[0].nodeName;
34.
var estados = xml.getElementsByTagName("estado");
35.
for(i = 0; i < estados.length; i++){
36.
var cidades = estados[i].getElementsByTagName("cidade");
37.
for(j = 0; j < cidades.length; j++){
38.
var nomeCidade = cidades[j].getAttribute("nome");
39.
var javaneses = cidades[j].getElementsByTagName("javaneses").item(0).firstChild.data;
40.
html += "<OPTION value='"+javaneses+"'>"+nomeCidade+"</OPTION>";
41.
}
42.
}
43.
html += "</SELECT>";
44.
document.getElementById("DivCidades").innerHTML = html;
45.
}
46.
}
47.}
48.</script>
49.</head>
50.<body>
51.<form method="post" name="frm">
52.<h2>Tutorial de Ajax - Cejug 4Java</h2>
53.<h4>Estado:</h4>
54.<SELECT NAME='Estados' onchange="atualizaCidades(this.value);">
55.
<OPTION value=''>--Selecione--</OPTION>
56.
<OPTION value='CE'>Cear</OPTION>
57.
<OPTION value='PB'>Paraba</OPTION>
58.
<OPTION value='PE'>Pernambuco</OPTION>
59.</SELECT>
60.<h4>Cidade:</h4>
61.<div id="DivCidades" style="position: static;">
62.<SELECT NAME='Cidades'><OPTION value=''>----</OPTION></SELECT>
63.</div>
64.</form>
65.</body>
66.</html>
14/16
7. Concluso
No nosso caso, demonstramos um exemplo bem simples, porm capaz de apresentar a ponta
do iceberg do desenvolvimento Web com AJAX.
A popularizao do AJAX ajudou e muito no nascimento de novos termos, como a Web 2.0
(http://www.oreillynet.com/pub/a/oreilly/tim/news/2005/09/30/what-is-web-20.html),
uma
quase
renascena da Internet, desta vez, liderada pelo Google; e foi justamente o Google onde tivemos a
primeira aplicao com alta popularidade que utilizou o AJAX, o GMail.
O mais interessante que AJAX no novo! J era utilizado por inmeros desenvolvedores
mundo afora, porm, com a criao do acrnimo para referenci-lo a Javascript, XML e chamadas
assncronas, popularizou-se em poucas semanas; o artigo que batizou a velha tecnologia no
muito
difundida
foi
escrito
por
Jesse
James
Garret
no
site
(http://www.adaptivepath.com/publications/essays/archives/000385.php),
da
onde
Adaptive
me
serviu
Path
de
primeira base de estudos (e onde colei as duas figuras sobre o modelo assncrono e a arquitetura
do AJAX).
Aps a leitura do artigo, me interessei e fui atrs de novas fontes, principalmente com
exemplos, e onde eu fiz meu primeiro test-drive foi no catlogo de BluePrints do Java.net
(https://bpcatalog.dev.java.net/nonav/ajax/). A partir da, e at hoje, estou pesquisando mais sobre o
assunto
aos
poucos.
maior
melhor
fonte
que
posso
indicar
wikipedia
(http://en.wikipedia.org/wiki/AJAX) com inmeros artigos, frameworks, exemplos, scripts e

histrico sobre o tema.
Pessoalmente ainda no utilizo nenhum framework que implemente AJAX, pois
normalmente estes so voltados para a camada visual da aplicao, e ainda no tive oportunidade
(ou necessidade) de utilizar algo semelhante, porm, acho que um dia eu chegue a utilizar algum;
caso se interesse por algum framework, listei alguns que li no incio do captulo 6, vale a pena
escolher algum para estudar e usar. Pretendo que meu prximo artigo/tutorial sobre AJAX seja um
comparativo entre estes frameworks ou algo semelhante a isto (qualquer idia, pode entrar em
contato comigo
).
Durante o tutorial no cheguei a comentar em detalhes os mtodos do objeto

XMLHttpRequest para que ficasse algo mais direto prtica, j que falei razoavelmente sobre a
teoria por detrs; assim, no apndice a seguir, organizei os principais mtodos e suas funes.
15/16
Apndice
CRIANDO UM OBJETO
FORMA
BROWSER
var req = new XMLHttpRequest();
Mozilla e outros
var req = new ActiveXObject("Microsoft.XMLHTTP");
Internet Explorer
var req = new ActiveXObject("Msxml2.XMLHTTP");
Internet Explorer
MTODOS DO OBJETO
MTODO
FUNO
abort()
Cancela a atual requisio
getAllResponseHeaders()
Retorna a coleo de cabealhos do http como uma String
getResponseHeader("campoCabecalho") Retorna o valor do campo do cabealho
open("metodo","URL",assincrono)
Especifica o mtodo, a URL e outros atributos opcionais de uma requisio.
O parmetro mtodo pode ser GET, POST ou PUT.
O parmetro URL pode ser uma url relativa ou completa.
O parmetro assncrono informa se a requisio ser assncrona ou sncrona:
true significa que o script continuar aps a execuo do mtodo send; false
significa que o script ficar esperando a resposta do servidor no mtodo send.
send(conteudo)
Envia a requisio
setRequestHeader("campo","valor")
Adiciona um par (campo/valor) ao cabealho http a ser enviado
PROPRIEDADES DO OBJETO
PROPRIEDADE
DESCRIO
onreadystatechange
Indica o evento a ser chamado cada vez que o estado do objeto muda.
readyState
Informa o estado do objeto da requisio:
0 = objeto no inicializado
1 = carregando
2 = carregado
3 = interagindo
4 = completado
responseText
Retorna a resposta como uma string
responseXML
Retorna a resposta como um XML (que pode ser tratada como um W3C
DOM)
status
Retorna o estado da requisio como um nmero (ex: 404 para no
encontrado e 200 para OK)
statusText
Retorna o estado da requisio como uma string (ex: No encontrado ou
OK)
16/16
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 60 profissionais altamente qualificados 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 qualificao 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 tambm a equipe Caelum no Twitter:

twitter.com/caelumdev/equipe
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 tambm nossa Newsletter para receber as novidades e destaques dos

eventos, artigos e promoes da Caelum:
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:
FJ-25:
Java e Orientao a
objetos
Persistncia com JPA2 e

Hibernate
FJ-16:
FJ-26:
Laboratrio Java com Testes,

XML e Design Patterns
Laboratrio Web com JSF2 e

CDI
FJ-19:
FJ-31:
Preparatrio para Certificao

de Programador Java
Java EE avanado e
Web Services
FJ-21:
FJ-91:
Java para Desenvolvimento

Web
Arquitetura e Design de
Projetos Java
RR-71:
RR-75:
Desenvolvimento gil para Web

2.0 com Ruby on Rails
Ruby e Rails avanados: lidando

com problemas do dia a dia
Para mais informaes e outros cursos, visite: caelum.com.br/cursos
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 qualificados e experientes;
Apostilas disponveis no site.
Sobre esta apostila

Esta apostila da Caelum visa 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 final do ndice.
Baixe sempre a verso mais nova em: www.caelum.com.br/apostilas
Esse material parte integrante do treinamento Desenv. gil para Web 2.0 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
ndice
1 O curso
1.1 Objetivo do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Sobre o curso: Hibernate, VRaptor, JSP e AJAX . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3 Onde posso aprender mais do VRaptor?
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 O sistema
2.1 A necessidade do cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Partes do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Persistindo os dados com o Hibernate
3.1 A camada de persistncia do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 Preparando o Hibernate
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.4 Configurando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5 Exerccios: Configurando o banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 Cadastrando Produtos
4.1 Modelando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Anotando a classe Produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 Exerccios - Modelando o produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.4 Adicionando um produto no banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.6 Outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.7 Exercicios - outras operaes com produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
i
4.8 Discusso em sala - mais sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

5 Refatorando
17
5.1 Analisando o cdigo atual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.2 Refactoring
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5.3 Aprendendo a refatorar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

5.4 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.5 Comentrios so sempre necessrios? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.6 Refatorando para criar os DAOs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.8 Discusso em sala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6 VRaptor
31
6.1 Sobre o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

6.2 Como instalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.3 Como configurar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.4 Primeiro exemplo com o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.6 Redirecionando para uma view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
6.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
6.8 Disponibilizando informaes para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
6.9 Disponibilizando colees para a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.10 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7 Criando o Controlador de Produtos
40
7.1 Listando produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

7.2 Quais so minhas dependncias? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.3 Injeo de Dependncias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.4 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.5 Cadastrando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.6 Criando o formulrio HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.8 Redirecionar para listagem depois de adicionar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
ii
7.9 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
7.10 Atualizando e removendo produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.11 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
7.12 Discusso em sala - VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
8 Refatorando os DAOs
62
8.1 Injeo de dependncias no DAO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

8.2 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
8.3 Analisando o cdigo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.4 Escopos definidos pelo VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.5 Fechando a sesso do Hibernate
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
8.6 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
9 Validando formulrios
72
9.1 Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
9.2 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9.3 Para saber mais: Hibernate Validator
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
9.4 Exerccios Opcionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

10 REST
79
10.1 O que REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

10.2 Caractersticas e vantagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
10.3 O tringulo do REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
10.4 Mudando a URI da sua lgica: @Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
10.5 Mudando o verbo HTTP dos seus mtodos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
10.6 Refatorando o ProdutosController . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
10.7 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
11 AJAX e efeitos visuais
87
11.1 O que AJAX? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

11.2 Um pouco de JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
11.3 Validando formulrios com o JQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
11.4 Criando a busca de produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
11.5 Melhorando a busca: Autocomplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
11.6 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
iii
12 Criando o Carrinho de Compras
99
12.1 O modelo do Carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

12.2 Controlando o carrinho de compras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
12.3 Visualizando os itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.4 Removendo itens do carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
12.5 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
13 Autenticao
112
13.1 Criando Usurios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

13.2 Efetuando o login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
13.3 Restringindo funcionalidades para usurios logados . . . . . . . . . . . . . . . . . . . . . . . . . 117
13.4 Interceptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
14 Apndice - Download e Upload
122
14.1 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

15 Apndice - Integrando VRaptor e Spring
126
15.1 Como fazer a integrao? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

15.2 Integrando o Transaction Manager do Spring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
15.3 Exerccios: Transaction Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
16 Apndice: Mudando a View Padro: Velocity
130
16.1 Exerccios: Configurando o Velocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

16.2 Exerccios: Mudando o Template Engine de uma nica lgica . . . . . . . . . . . . . . . . . . . . 130
16.3 Exerccios: Mudando o resultado de todas as lgicas para Velocity . . . . . . . . . . . . . . . . . 131
Verso: 12.9.20
iv
C APTULO
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.
1.1 - Objetivo do curso

Uma das grandes vantagens de utilizar a plataforma Java a quantidade de opes: so centenas de
frameworks opensource de qualidade que podemos escolher para desenvolver um projeto. Mas qual deles
escolher?
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 ficar 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.
1.2 - Sobre o curso: Hibernate, VRaptor, JSP e 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 desenolvimento web, evitando
o contato com as classes pouco amigveis do javax.servlet, deixando o cdigo legvel e desacoplado, ideal
para testes.
JavaServer 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.
1.3 - Onde posso aprender mais do VRaptor?

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 oficial do VRaptor: http:
//www.guj.com.br/
Captulo 1 - O curso - Onde posso aprender mais do VRaptor? - Pgina 2
C APTULO
O sistema
Veremos como ser o sistema que iremos desenvolver e as tecnologias que utilizaremos.
2.1 - A necessidade do cliente

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 com a 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
desenvolver o sistema de forma incremental e iterativa, utilizando mtodos geis como Scrum (curso PM-83) e
prticas XP (curso FJ-16).
2.2 - Partes do projeto

Para facilitar o desenvolvimento, vamos separar em tarefas o que devemos fazer, que sero vistas a partir
do prximo captulo.
1) Deciso de tecnologias
2) Montagem do ambiente de desenvolvimento
3) CRUD produto
4) Carrinho de compras
5) CRUD usurio
6) login
7) Compra de produto
C APTULO
Persistindo os dados com o Hibernate

3.1 - A camada de persistncia do projeto
Nossa primeira tarefa ser cadastrar, atualizar, listar e remover produtos do sistema. Para realiz-la, precisamos 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 configurado, 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-21, 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 ficar fazendo todas as chamadas ao JDBC e ganharmos tempo e produtividade, vamos
utilizar um framework para a persistncia que j traz muitas funcionalidades j implementadas. O framework
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.
3.2 - Sobre o Hibernate

O Hibernate um framework ORM - Object Relational Mapping. uma ferramenta que nos ajuda a
persistir objetos Java em um banco de dados relacional. O trabalho do desenvolvedor definir 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
especifio oficial do Java, a JPA - Java Persistence API. A JPA uma especificao do JCP e possui vrias
implementaes (o Hibernate, o Oracle Toplink, EclipseLink, OpenJPA etc).
4
Mais sobre Hibernate

Neste curso, veremos muitos tpicos sobre Hibernate e como integr-lo em nosso projeto com
VRaptor3. Para tpicos avanados e mais detalhes, consulte o treinamento FJ-25:
http://www.caelum.com.br/curso/fj25
3.3 - Preparando o Hibernate

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 configurar nosso projeto com as 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 iremos precisar. A partir do Hibernate 3.5, esses jars
todos vem numa nica distribuio, a core.
Configurando o mecanismo de logging

O Hibernate 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.
Configurando 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.
Mais sobre JDBC e Drivers
Para mais informaes sobre o JDBC e como funcionam os Drivers, consulte o captulo inicial da
apostila do curso FJ-21.
3.4 - Configurando o Hibernate

Para configurar 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 configurar tudo que queremos, por exemplo as entidades. As entidades tm que ser configuradas no
cdigo, e as outras informaes no arquivo de properties.
Captulo 3 - Persistindo os dados com o Hibernate - Preparando o Hibernate - Pgina 5
J o XML, por mais que seja um pouco mais difcil em relao ao properties, permite que toda a configurao
seja feita nele. Por isso faremos nossa configurao no XML. O arquivo 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:
<session-factory>
<property name="hibernate.connection.username">root</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="show_sql">true</property>
<property name="format_sql">true</property>
</session-factory>
As configuraes 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 configurao o banco de dados que foi passado. Na configurao
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 configuraes 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 configurada de acordo com
documentao do banco de dados
hibernate.connection.driver_class - driver que deve ser utilizado

hibernate.hbm2ddl.auto - como o hibernate vai se comportar em relao s tabelas do banco. Com o
valor update ele vai criar ou modificar tabelas sempre que necessrio.
hibernate.dialect - dialeto a ser utilizado para a comunicao com o banco de dados

show_sql - flag que indica se os SQLs gerados devem ser impressos
format_sql - flag que indica se os SQLs devem ser formatados
Captulo 3 - Persistindo os dados com o Hibernate - Configurando o Hibernate - Pgina 6
Existem muitas outras configuraes possveis. Para maiores detalhes, acesse a documentao do Hibernate.
3.5 - Exerccios: Configurando o banco

1) 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.
2) Conecte-se no banco de dados para verificar 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 verificar os bancos de dados disponveis:

mysql> show databases;
Se o database fj28 aparecer, digite:

mysql> drop database fj28;
mysql> create database fj28;
Captulo 3 - Persistindo os dados com o Hibernate - Exerccios: Configurando o banco - Pgina 7
C APTULO
Cadastrando Produtos
No captulo anterior, configuramos o Hibernate para acessar o banco de dados. Neste captulo, nosso
objetivo cadastrar produtos.
4.1 - Modelando um produto

Agora que estamos com o ambiente configurado e com o banco de dados pronto, podemos partir para a
codificao.
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 ficar assim:
// getter e setters
}
BigDecimal
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 preciso fixa, 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));
4.2 - Anotando a classe 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 dificuldade e o trabalho de se fazer isso com XML.
Outra maneira, que est sendo bem aceita pela comunidade o uso de anotaes para a configurao.
Ao invs de usar um arquivo XML para configurar, basta ir na prpria classe e anot-la. Uma das grandes
vantagens, 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 especificao da Java Persistence API.
@Entity
// 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
}
Captulo 4 - Cadastrando Produtos - Anotando a classe Produto - Pgina 9
Pronto, agora nossa entidade est devidamente anotada. S temos que fazer mais uma coisa: avisar o
Hibernate dessa entidade, isso porque ele no encontra a entidade automaticamente. Para informar isso ao
Hibernate, utilizaremos o arquivo de configurao dele, o hibernate.cfg.xml.
O contedo do arquivo ficar assim:
<session-factory>

</session-factory>
Repare que temos que utilizar o nome completo da classe, ou seja, o nome da classe mais o pacote.
4.3 - Exerccios - Modelando o produto

1) Crie a classe Produto dentro do pacote br.com.caelum.goodbuy.modelo.
private Long id;

// getter e setters
}
2) Anote a classe com as anotaes da JPA.

@Entity
@Id @GeneratedValue
private Long id;
// getter e setters
}
Captulo 4 - Cadastrando Produtos - Exerccios - Modelando o produto - Pgina 10
3) Configure essa entidade no Hibernate, alterando o arquivo hibernate.cfg.xml.

<session-factory>


</session-factory>
4.4 - Adicionando um produto no banco

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
precisamos a Session, do pacote org.hibernate.
Esse objeto muito importante para ns porque ele quem vai encapsular todas as chamadas JDBC,
facilitando muito o mecanismo de acesso ao banco de dados.
Nosso primeiro passo para conseguir uma Session instanciar uma classe que representa a
configurao do Hibernate, portanto iniciamos instanciando a classe do Hibernate cujo nome
org.hibernate.cfg.AnnotationConfiguration.
// Cria uma configurao
Depois de criar esse objeto, vamos chamar o mtodo responsvel por ler o arquivo hibernate.cfg.xml, o
configure().
// L o hibernate.cfg.xml
Aps configurar, precisamos criar um objeto que cria as sesses, uma fbrica.
SessionFactory, que pode ser obtida com:
Esse objeto uma
Captulo 4 - Cadastrando Produtos - Adicionando um produto no banco - Pgina 11
Com a SessionFactory em mos conseguimos criar uma uma Session. O cdigo completo fica:
1 public class TesteDeSessao {
2
3
4
5
6
7
8
}
9 }
A partir desse objeto session, basta passarmos uma entidade que ele se encarregar de transformar do
modelo orientado a objetos para o modelo relacional.
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.
4.5 - Exerccios
1) Crie a seguinte classe, que adiciona produtos no banco.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import
import
import
import
org.hibernate.Session;
org.hibernate.SessionFactory;
org.hibernate.Transaction;
org.hibernate.cfg.AnnotationConfiguration;

Captulo 4 - Cadastrando Produtos - Exerccios - Pgina 12
18
19
20
21
22
23
24
25 }

tx.commit();
}
2) Execute a classe que adiciona o produto. Repare no console o sql que foi gerado.
3) Acesse o banco de dados e verifique se o produto foi inserido com sucesso.
4) (Opcional) Crie outros produtos no sistema.
4.6 - Outras operaes com produto

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 fizemos. Para alterar um produto, basta carregarmos esse produto, alterarmos e depois
atualizarmos.
2
3
4
5
6
7
8
Captulo 4 - Cadastrando Produtos - Outras operaes com produto - Pgina 13
9
10
11
12
13
14
15
16
17 }

tx.commit();
}
E para remover um produto:

2
3
4
5
6
7
8
9
10
11
12
13
14
tx.commit();
15
}
16 }
4.7 - Exercicios - outras operaes com produto

1) Crie a classe de alterao do produto.
2
4
5
6
7
8
9
10
11
12
13
14
15
16
17
tx.commit();
18
}
19 }
2) Execute a classe que altera o produto. Repare no console o sql que foi gerado.
4) Crie a classe de remoo do produto.

2
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18 }
tx.commit();
}
5) Execute a classe que remove o produto. Repare no console o sql que foi gerado.
4.8 - Discusso em sala - mais sobre o Hibernate

Por que utilizamos o Long e no o long para o campo id
Eu sempre fiz com que minhas entidades implementassem Serializable. mesmo necessrio?
Vale mesmo a pena utilizar o Hibernate? No vou perder performance?
Captulo 4 - Cadastrando Produtos - Discusso em sala - mais sobre o Hibernate - Pgina 16
C APTULO
Refatorando
5.1 - Analisando o cdigo atual
Se olharmos para o nosso projeto agora, temos a seguinte situao:
Tabela de produtos est no banco de dados

Hibernate configurado
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 ficaria 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.
5.2 - Refactoring
Uma prtica bastante comum e difundida no meio da Orientao a Objetos a chamada Refatorao (Refactoring). Refatorar um programa melhorar seu cdigo sem alterar sua funcionalidade. A ideia 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. um catlogo com dezenas de tcnicas de refatorao e instrues de como e quando
execut-las.
17
5.3 - Aprendendo a refatorar

Vamos abrir novamente a classe de insero de produtos.
package br.com.caelum.goodbuy.testes;
// imports
tx.commit();
}
}
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. Com base nessa diviso, vamos
pedir para o Eclipse nos ajudar a refatorar, para fazer essa diviso de uma maneira segura e automtica.
Apenas para ficar claro essa diviso, veja o cdigo novamente, agora com os comentrios mostrando onde
comea cada parte.
2
3 // imports
4
6
7
8
// Aquisio da sesso
9
10
11
12
13
14
15
// Criao do produto
16
17
18
19
Captulo 5 - Refatorando - Aprendendo a refatorar - Pgina 18
20
21
22
23
24
25
26 }

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.
5.4 - Exerccios
1) Altere a classe AdicaoDeProduto, que est no pacote br.com.caelum.goodbuy.testes, colocando os
comentrios para deixar claro a diviso das partes.
2
3 // imports
4
6
7
8
// Aquisio da sesso
9
10
11
12
13
14
15
// Criao do produto
16
17
18
19
20
21
22
23
24
tx.commit();
25
}
26 }
2) Selecione as linhas que fazem a aquisio da sesso, conforme a figura abaixo:
3) Com as linhas selecionadas, pressione as teclas Alt + Shift + M (Extract Method), para criar um mtodo
4) A tela que est sendo mostrada est esperando por um nome de mtodo. Digite getSession como nome do
mtodo e pressione OK.
5) Note como o Eclipse mudou seu cdigo, criando o mtodo getSession e fazendo a chamada a este mtodo.
A classe deve estar assim:

// Aquisio da sesso
// Criao do produto
tx.commit();
}
return session;
}
}
6) Faa o mesmo para as linhas de criao de produto e adio de produto no banco de dados. No final,
ficaremos com 3 mtodos, um chamado getSession, que j foi feito, outro chamado criaProduto e outro
chamado gravaProduto. Lembre-se de utilizar as teclas de atalho que vimos nesse exerccio.
7) Para conferncia, ficaremos com a classe da seguinte forma:
2
3 // imports
4
6
7
8
// Aquisio da sesso
9
10
11
// Criao do produto
12
13
14
15
16
}
17
18
19
20
21
tx.commit();
22
}
23
24
25
26
27
28
29
return produto;
30
}
31
32
33
34
35
36
37
38
return session;
39
}
40 }
5.5 - Comentrios so sempre necessrios?

Note que o que fizmos foi quebrar um mtodo grande em vrios 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 ficou muito mais legvel, intuitivo. Basta dar uma olhada rpida que podemos
entender o que ele faz.
Captulo 5 - Refatorando - Comentrios so sempre necessrios? - Pgina 22
Mas agora que o mtodo main foi quebrado em mtodos menores, ser que precisamos mesmo de comentrios? 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
}
5.6 - Refatorando para criar 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 em uma classe,
que ser responsvel por acessar os produtos no banco de dados. E a essa classe vamos dar o nome de
ProdutoDao.
5.7 - Exerccios
1) Crie uma classe chamada CriadorDeSession no pacote br.com.caelum.goodbuy.infra. Essa classe ser a
responsvel por criar uma Session.
2) Selecione o mtodo getSession da classe AdicaoDeProduto.
Captulo 5 - Refatorando - Refatorando para criar os DAOs - Pgina 23
3) Com as linhas selecionadas, pressione as teclas Alt + Shift + V (Move Method), para criar um mtodo
4) A tela que est sendo mostrada est esperando pela classe que ficar com esse mtodo. Pressione o boto
Browse..., e busque pela classe CriadorDeSession, conforme a imagem abaixo:
5) Aps encontrar a classe CriadorDeSession, pressione o boto OK para escolher essa classe, depois OK
novamente para confirmar a mudana do mtodo para essa classe.
6) Aparecer uma tela avisando que a visibilidade do mtodo getSession ser alterada public. Confirme essa
alterao pressionando o boto Continue.


}
tx.commit();
}
return produto;
}
}
8) Crie uma classe chamada ProdutoDao no pacote br.com.caelum.goodbuy.dao. Essa classe ser a responsvel por encapsular as chamadas ao Hibernate.
9) Mova o mtodo gravaProduto para a classe ProdutoDao. Utilize as teclas de atalho que vimos nesse exerccio.

ProdutoDao.gravaProduto(session, produto);
}
return produto;
}
}
11) Vamos refatorar agora a classe ProdutoDao, que est no momento assim:
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();
}
}
12) A classe AdicaoDeProduto agora no compila. Vamos trocar o acesso esttico por acesso a uma instncia
do dao:

new ProdutoDao().gravaProduto(session, produto);
}
//...
}
13) 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:

tx.commit();
}
}
Mude tambm a classe AdicaoDeProduto:


}
//...
}
14) 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:

public ProdutoDao() {
this.session = CriadorDeSession.getSession();
}

tx.commit();
}
}
15) Agora a chamada do mtodo gravaProduto est correta, porm repare como est um pouco redundante:
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.
16) (Opcional) Refatore as outras classes de teste, AlteracaoDeProduto e RemocaoDeProduto, para utilizar o
ProdutoDao.
5.8 - Discusso em sala

Ouvi falar do padro Repository. Ainda preciso dos daos?
O eclipse ajuda no refactoring?
Captulo 5 - Refatorando - Discusso em sala - Pgina 30
C APTULO
VRaptor
6.1 - Sobre o VRaptor
VRaptor 3 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.
6.2 - Como instalar

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-3.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>.
6.3 - Como configurar

Uma das grandes vantagens do VRaptor que ele usa muitas convenes, ou seja, ao invs de termos que
configurar tudo, como por exemplo no Struts, no precisamos configurar quase nada.
Seguindo as convenes que o VRaptor usa, podemos criar apenas nossas lgicas (cdigo java) sem precisar escrever xmls ou properties.
A nica configurao que precisamos fazer configurar o controlador do VRaptor. Essa configurao feita
dentro do arquivo web.xml, o arquivo de configurao da aplicao.
<web-app ...>

<filter>
<filter-class>br.com.caelum.vraptor.VRaptor</filter-class>
</filter>
<filter-mapping>
<url-pattern>/*</url-pattern>
<dispatcher>FORWARD</dispatcher>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
</web-app>
31
Essas configuraes j foram feitas no projeto base.

Servlet 3.0
Se voc estiver usando um Servlet Container que implementa a Servlet 3.0 voc nem precisa da
configurao do filtro no web.xml. Basta colocar o jar do VRaptor na pasta WEB-INF/lib e ele ser
configurado automaticamente.
6.4 - Primeiro exemplo com o VRaptor

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 elaborados.
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.
2
4
5
6
7
}
8
9 }
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 ficar assim:
1
2
3
4
5
6
7
8
9
@Resource
Captulo 6 - VRaptor - Primeiro exemplo com o VRaptor - Pgina 32
10
11
12 }
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:8080/goodbuy/mundo/boasVindas.
1
2
3
4
5
6
7
8
9
10
11
12
@Resource
}
}
6.5 - Exerccios
1) Crie a classe Mundo no pacote br.com.caelum.goodbuy.
2
4
5
6
7
}
8
9 }
2) Anote a classe Mundo com @Resource.

3) Abra um browser, por exemplo o Firefox, e digite a seguinte url: http://localhost:8080/goodbuy/mundo/
boasVindas
4) Ao acessar essa url, mostrada uma pgina com erro 404 (pgina no encontrada). Isso ocorreu porque
ainda no criamos a pgina de resultado. Ela ser criada na prxima seo. O importante verificar o log
da aplicao, na view Console do Eclipse, e ver que a mensagem apareceu.
5) (Opcional) Crie outro mtodo, parecido com o que fizemos, e acesse pelo browser. Se quiser, esse mtodo
pode ser em outra classe.
6.6 - Redirecionando para uma view

Nosso ltimo exemplo executava a lgica que tnhamos criado, mas a pgina de resultado no tinha sido
feita, e recebamos o erro 404.
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 configuraes. 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 ir fazer algumas modificaes 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 ir considerar os seguintes valores:
{nomeDoResource} = mundo
{lgica} = boasVindas
E a pgina que ele buscar ser a seguinte:
/WEB-INF/jsp/mundo/boasVindas.jsp
Captulo 6 - VRaptor - Redirecionando para uma view - Pgina 34
6.7 - Exerccios
1) Crie uma pasta chamada jsp dentro da pasta WEB-INF. Cuidado, o nome da pasta deve ser com letras
minsculas.
2) Crie uma pasta chamada mundo dentro da pasta WEB-INF/jsp. Cuidado, o nome da pasta deve ser com letras
minsculas.
3) Crie um jsp chamado boasVindas.jsp dentro da pasta WEB-INF/jsp/mundo. Seu projeto deve ficar assim:
4) Abra o arquivo boasVindas.jsp que acabamos de criar e digite o seguinte contedo:

Ol Mundo!
5) Vamos testar nossas alteraes. Inicie o Tomcat na view Servers, depois abra um browser e digite a seguinte
url: http://localhost:8080/goodbuy/mundo/boasVindas
6) Verifique se o console mostra a mensagem ol mundo!, e verifique se o browser exibe a mensagem Ol
Mundo.
6.8 - Disponibilizando informaes para a view

Nosso exemplo at agora s executa algo no servidor e depois a view chamada.
Mas para muitos casos precisamos que a lgica carregue informaes do banco de dados e depois a view
exiba essas informaes.
No VRaptor 3 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 ficava muito poluda com atributos, getters ou anotaes.
Vamos alterar nosso mtodo para enviar informaes para a view:
1
2
3
4
5
6
7
8
9
10
@Resource
return "ol mundo!";
}
}
Agora o mtodo boasVindas() no imprime nada, apenas retorna uma string. Aps a execuo desse
mtodo, 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
ficar assim:
${string}
Captulo 6 - VRaptor - Disponibilizando informaes para a view - Pgina 36
Como utilizamos o retorno do mtodo para disponibilizar informaes para a view, no temos como dar um
nome significativo para utilizar depois.
O VRaptor usa a conveno de buscar o tipo do retorno, nesse nosso caso uma String, e disponibilizar para
a view com o mesmo nome, apenas passando a primeira letra para minsculo. Por esse motivo que foi utilizado
a expression language ${string}.
6.9 - Disponibilizando colees para a view

Podemos utilizar a mesma maneira que fizemos com Strings para disponibilizar colees para a view. Utilizamos muito as colees do pacote java.util, seja pela facilidade no uso ou pela integrao com frameworks
como o Hibernate.
Se nossa lgica criasse uma coleo com informaes que vieram do banco de dados, poderamos retornar
essa coleo, assim como fizemos anteriormente. O cdigo ficaria assim:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@Resource
return "ol mundo!";
}
result.add("Japo");
return result;
}
}
Na nossa view, podemos imprimir os valores dessa coleo da seguinte forma:

${stringList}
Note que agora o valor passado na expression language foi ${stringList}. O VRaptor identifica que devolvemos uma lista, e essa lista genrica, informando que o tipo de informao dentro da lista ser String.
Para listas, o VRaptor ir adotar a seguinte conveno:
{tipoDaLista}List
Nosso exemplo era de uma lista de String, ou seja, List<String>, que virou ${stringList}.
Captulo 6 - VRaptor - Disponibilizando colees para a view - Pgina 37
6.10 - Exerccios
1) Altere o mtodo boasVindas() da classe Mundo para retornar uma String.
2
3 @Resource
5
6
7
return "ol mundo!";
8
}
9
10 }
2) Altere o jsp boasVindas.jsp, que est dentro da pasta WEB-INF/jsp/mundo.

${string}
3) Teste a lgica que acabamos de criar, acessando a seguinte url: http://localhost:8080/goodbuy/mundo/

boasVindas Sua pgina deve exibir o seguinte resultado:
4) Crie um mtodo chamado paises() na classe Mundo. Esse mtodo deve retornar uma lista de Strings. Seu
cdigo ficar assim:
result.add("Japo");
return result;
}
5) Crie um jsp em WEB-INF/jsp/mundo chamado paises.jsp. O contedo deve ser esse:

${stringList}
6) Teste a lgica que acabamos de criar, acessando a seguinte url:
http://localhost:8080/goodbuy/mundo/paises
Sua pgina deve exibir o seguinte resultado:
7) (Opcional) Crie outro mtodo que mande alguma informao para a view. Dessa vez, tente retornar um valor
inteiro ou um valor decimal.
8) (Opcional) Crie outro mtodo que retorne um Produto, com algumas informaes preenchidas. Tente imprimir essas informaes no jsp.
9) (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.
10) (Opcional) Um mtodo s pode retornar uma informao. Mas como faramos para disponibilizar para a view
mais de uma informao?
C APTULO
Criando o Controlador de Produtos

7.1 - Listando produtos
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 3, 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 sufixo Controller.
Vimos que o nome da classe utilizado pelo VRaptor para registrar esse componente, para que quando
fizermos uma chamada do browser, essa classe seja encontrada e algum mtodo seja invocado. Mas utilizando
o nome ProdutosController, o VRaptor ir mapear essa classe para apenas /produtos, removendo o sufixo
Controller que faz parte da conveno.
Dentro dessa classe, teremos um mtodo para listar todos os produto. Esse mtodo ser invocado pelo
VRaptor 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 operaes no banco de dados; uma delas listar tudo com o mtodo list().
Nosso mtodo listaTudo() no ProdutoDao fica assim:
//...
}
}
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:
}
}
40
Olhando para esse mtodo, que no incio tnhamos definido 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 dificuldade no acesso, e tambm por no fazer parte da regra de negcio, que tal se ao invs de cri-lo,
recebssemos o mesmo?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// imports
@Resource
private ProdutoDao dao;
this.dao = dao;
}
}
}
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, precisamos 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 retornamos uma lista de produtos, existe uma varivel chamada ${produtoList} disponvel no jsp.
Para podermos mostrar a listagem de um jeito mais fcil, vamos usar uma taglib da JSTL chamada
c:forEach, que capaz de iterar sobre uma lista passada.
</c:forEach>
Usando essa taglib, vamos criar uma tabela com todos os produtos do sistema:
<table>
<thead>
<tr>
<th>Nome</th>
Captulo 7 - Criando o Controlador de Produtos - Listando produtos - Pgina 41
<th>Descrio</th>
<th>Preo</th>
</tr>
</thead>
<tbody>
<tr>
</tr>
</c:forEach>
</tbody>
</table>
7.2 - Quais so minhas dependncias?

Tudo que um objeto 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 dependncias 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
necessidade 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?
1 ProdutoDao dao = new ProdutoDao();
2 ProdutosController controller = new ProdutosController(dao);
Repare que logo aps a segunda linha ser executada, tenho a confiana 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 ficar extremamente repetitivo e propcio a erro a medida que aumenta o nmero de dependncias
de nossa classe.
Captulo 7 - Criando o Controlador de Produtos - Quais so minhas dependncias? - Pgina 42
7.3 - Injeo de Dependncias

Sendo assim, fica muito mais fcil se fizermos uso de uma API que execute todo o processo de injeo
automaticamente.
No nosso caso, quem vai instanciar essa classe? Ns ou o VRaptor? Essa classe ser instanciada pelo
VRaptor. Mas se o VRaptor fizer isso, como ele descobrir sobre interligaes entre as dependncias?
Uma vez que precisamos da classe ProdutoDao como dependncia nossa, precisamos notificar o framework
que o mesmo se encarregar de gerenciar as instncias de ProdutoDao, isto , nesse caso especfico, ele criar
uma instncia e utilizar como argumento para o construtor. Para fazer isso, basta anotarmos essa classe com
@Component.
// imports
@Component
//...
}
Agora a classe ProdutoDao tambm ser controlada pelo VRaptor. Dessa forma, quando o VRaptor for instanciar a classe ProdutosController, ele verificar que ela depende de um ProdutoDao, 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.
O VRaptor 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.
Imagine que seu controlador de clientes necessita acessar um dao. Sendo assim, especifique claramente essa
necessidade.
Testando sua aplicao
Ao usarmos injeo de dependncias, ganhamos uma caracterstica muito boa na nossa aplicao:
a testabilidade. Se recebemos nossas dependncias no construtor, conseguimos passar implementaes falsas ou controladas e, assim, testar unitariamente nossas classes.
Voc pode encontrar um contedo mais aprofundado sobre testes no curso FJ-16 - Laboratrio
Java com Testes, XML e Design Patterns.
7.4 - Exerccios
1) Abra a classe ProdutoDao e adicione o mtodo para listar todos os produtos:
Captulo 7 - Criando o Controlador de Produtos - Injeo de Dependncias - Pgina 43

//...
}
}
2) Crie a classe ProdutosController no pacote br.com.caelum.goodbuy.controller. Crie tambm o mtodo

lista, que retorna uma List<Produto>.
3) Anote a classe com a anotao @Resource.
2
3
4
5
6
7
8
9
10
11
12
13
// imports
@Resource
}
}
4) Crie o construtor que recebe uma instncia de ProdutoDao, e guarde essa instncia em um atributo.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// imports
@Resource
this.dao = dao;
}
}
}
5) No mtodo lista, faa a chamada ao mtodo listaTudo do dao.

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// imports
@Resource
this.dao = dao;
}
}
6) Na pasta WEB-INF/jsp, crie a pasta produtos.

7) 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>
8) Acesse a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista.
9) Deu uma exception! A informao mais importante dela est no final 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....
Ou seja, 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.
10) Anote a classe ProdutoDao com @Component, para indicar que essa classe uma dependncia e pode ser
instanciada pelo VRaptor sempre que necessrio.
// imports
@Component
//...
}
11) Se acessarmos de novo a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista veremos a listagem de produtos:

. Adicione um link ao menu, para acessar a listagem de produtos:
<div id="menu">
<ul>
</ul>
</div>
7.5 - Cadastrando um produto

Para cadastrar um produto, bastar passarmos esse produto para o mtodo salva da classe ProdutoDao.
Vamos criar ento um mtodo no ProdutoController para adicionar produtos:
1
2
3
4
5
6
7
8
9
10
11
12
13
// imports
@Resource
dao.salva(produto);
}
}
7.6 - Criando o formulrio HTML

Nossa lgica para criar (salvar) produtos j est pronta. Mas como passar um produto populado para o
mtodo 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 20 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
Captulo 7 - Criando o Controlador de Produtos - Cadastrando um produto - Pgina 47
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.
Reflection no nome dos parmetros
Infelizmente, o Java no realiza reflection em cima de parmetros, esses dados no ficam disponveis em bytecode (a no ser se compilado 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 (exemplo no JAX-WS, onde comum encontrar um mtodo
como o acima com a assinatura void add(@WebParam(name="cliente) Cliente cliente).
O VRaptor 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
anotao. 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 ficar na pasta WEB-INF/jsp/produtos, com o nome de
formulario.jsp.
<fieldset>
</fieldset>
</form>
Como nossas pginas ficam 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
Captulo 7 - Criando o Controlador de Produtos - Criando o formulrio HTML - Pgina 48
// atributo, construtor e mtodos

}
}
Pelo browser, chamaremos a seguinte URL:
http://localhost:8080/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!
7.7 - Exerccios
1) Crie o mtodo adiciona que recebe um Produto como parmetro e faa a chamada ao mtodo salva do dao
passando esse produto.
2 public class ProdutosController {
3
4
//...
5
6
7
dao.salva(produto);
8
}
9
10 }
2) Na pasta WEB-INF/jsp/produtos, crie o arquivo formulario.jsp.
3) Abra o arquivo que acabamos de criar e coloque os campos para de digitao, assim como o boto e o
formulrio.
<fieldset>
</fieldset>
</form>
4) Na pasta WEB-INF/jsp/produtos, crie o arquivo adiciona.jsp com o contedo.

<h3>Produto adicionado com sucesso!</h3>
5) Acesse a listagem de produtos e veja os produtos que existem.

6) Acesse a URI do formulrio e adicione um produto. http://localhost:8080/goodbuy/produtos/formulario
7) Volte listagem, e veja se um usurio foi cadastrado com sucesso.
. 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>
</ul>
</div>
7.8 - Redirecionar para listagem depois de adicionar

Uma coisa no aparenta estar muito certa no nosso sistema: Quando adicionamos um produto, redirecionamos para uma pgina com a mensagem Produto adicionado com sucesso. Ser que essa pgina suficiente?
Ser que no melhor mostrar informaes mais relevantes?
Aps adicionar produtos podemos, por exemplo, mostrar uma lista com os 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 final do seu mtodo.
Primeiro precisamos de uma instncia de Result. Vamos dar um new nele? 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.
@Resource
this.dao = dao;
}
//...
}
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 ProdutosController.lista(). Ou em java:
Dentro do mtodo adiciona isso ficaria:

@Resource
this.dao = dao;
}

dao.salva(produto);
}
}
}
}
Repare que no foi necessrio criar arquivos de configurao para fazer essa mudana de conveno,
tudo feito no prprio mtodo. Ao olhar para o mtodo adiciona fica 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:
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 ir redirecionar internamente para a lgica especificada, 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 especificada.
result.redirectTo(/uma/outra/pagina.jsp): redirecionamento do lado do cliente para a pgina especificada.

result.of(ProdutosController.class).lista(): redireciona para a pgina da lgica especificada, sem executar
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 fizemos anteriormente 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
anteriormente 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

result.use(Results.http()).setStatusCode(404)
status
codes
Headers
HTTP.
Ex:
result.use(Results.referer()): Usa como resultado a pgina que originou a requisio. Usa um Header
HTTP chamado Referer que no obrigatrio, e que removido por alguns Proxies e Firewalls, ento
cuidado ao usar esse resultado.
7.9 - Exerccios
1) Receba um Result no construtor do ProdutosController e guarde-o em um atributo.
@Resource
this.dao = dao;
}
//...
}
2) Mude o resultado da lgica adiciona para redirecionar para a lgica lista.

@Resource
this.dao = dao;
}
dao.salva(produto);
}
}

}
}
3) Reinicie o tomcat para que ele carregue as suas mudanas, abra o formulrio e adicione mais um produto.
Repita essa operao e adicione mais produtos.
7.10 - Atualizando e removendo produtos

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.
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:
}
}
Agora podemos criar o formulrio de edio, passando os valores do produto carregado para os inputs:
<fieldset>
</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 controller.
Como usamos os nomes dos campos do formulrio do jeito certo, podemos simplesmente receber um Produto
como argumento na lgica altera.
//...
}
}
Assim como na lgica adiciona, fizemos 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>
</tr>
</c:forEach>
Vamos tambm remover produtos no nosso controller. Para remover um produto precisamos apenas do seu
id, ento basta criar a lgica:
}
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>
7.11 - Exerccios
1) Crie as lgicas para edio de produtos no ProdutosController:
}
}
2) Implemente os mtodos no ProdutoDao. Lembre-se de usar o Ctrl+1.

return (Produto) this.session.load(Produto.class, id);
}
this.session.update(produto);
tx.commit();
}
3) Crie o formulrio de edio no arquivo /WEB-INF/jsp/produtos/edita.jsp.

<fieldset>
</fieldset>
</form>
4) Modifique a listagem de produtos

/WEB-INF/jsp/produtos/lista.jsp:
para
incluir
um
link
para
edio,
no
arquivo

<tr>
</tr>
</c:forEach>
5) Reinicie o tomcat e acesse a listagem http://localhost:8080/goodbuy/produtos/lista. Escolha um dos produtos e clique em Editar.
Edite o produto e clique em Enviar.
6) Crie agora a lgica de remoo na classe ProdutosController:

}
7) Implemente o mtodo remove no ProdutoDao.

this.session.delete(produto);
tx.commit();
}
8) Modifique 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>
9) Reinicie o tomcat, acesse a listagem e remova algum produto.
7.12 - Discusso em sala - VRaptor

Mas o mercado usa mais o Struts. Vale a pena troc-lo?
Por que tantas convenes?
Captulo 7 - Criando o Controlador de Produtos - Discusso em sala - VRaptor - Pgina 61
C APTULO
Refatorando os DAOs
8.1 - Injeo de dependncias 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
}
//...
}
Mas como falar que a Session pode ser usada como dependncia?
Poderamos fazer a mesma alterao que fizemos no ProdutoDao, anotando a classe Session do pacote
org.hibernate com @Component. Assim, a sesso do Hibernate tambm seria 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 um mecanismo que nos auxilia a passar dependncias de outros
projetos para nossas classes. Basta criarmos uma classe que implementa a interface ComponentFactory. Essa
interface define um nico mtodo, o getInstance.
Criando essa classe, podemos definir 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 ficar assim:
@Component
62

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, configura, constri uma SessionFactory, e s ento abre uma sesso. No seria suficiente 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
}
return factory.openSession();
}
}
Podemos usar a mesma idia e criar um ComponentFactory para SessionFactory, com o cdigo que removemos da CriadorDeSession. No podemos nos esquecer da anotao @Component:
@Component
return factory;
}
}
Poderamos continuar esse processo, e criar uma ComponentFactory para AnnotationConfiguration tambm, 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 fizemos muita coisa s pra resolver o problema da Session. Mas a
vantagem de utilizarmos essa abordagem que para as nossas prximas lgicas, no precisaremos fazer
Captulo 8 - Refatorando os DAOs - Injeo de dependncias no DAO - Pgina 63
nada. Se tivermos que criar 50 DAOs no nosso sistema, no precisamos mais se preocupar com Sessions,
basta receber uma no construtor.
8.2 - Exerccios
1) Faa a classe ProdutoDao receber uma Session no construtor. Remova o mtodo getSession:
@Component
}
//...
}
2) Modifique 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.
@Component
return session;
}
}
3) A classe CriadorDeSession est fazendo coisas demais. Recorte a parte que cria uma SessionFactory e
receba uma SessionFactory no construtor. A classe deve ficar assim:
2
3 // imports
4
5 public class CriadorDeSession implements ComponentFactory<Session> {
6
7
8
}
9
10
11
12
return session;
13
14
15 }
4) 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 fix) no parmetro factory, e o Eclipse nos mostrar algumas
sugestes. Selecione a primeira opo, Assign parameter to new field.
6) Crie a classe CriadorDeSessionFactory no pacote br.com.caelum.goodbuy.infra que implementa a
interface ComponentFactory<SessionFactory>.
2
3 // imports
4
6
7 }
7) A classe no compila, pois falta implementar o mtodo que foi definido 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.
2
3 // imports
4
6
7
8
9
10
11
12
13
14
15 }
return factory;
}
9) 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);
10) Acesse o sistema e veja que ele continua funcionando como antes.
8.3 - Analisando o cdigo

J conseguimos cadastrar um produto pelo browser e j criamos algumas classes para injeo de dependncias 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 CriadorDeSessionFactory. 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.
8.4 - Escopos definidos pelo VRaptor

O VRaptor nos permite definir 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.
Alguns componentes devem ter 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.
Captulo 8 - Refatorando os DAOs - Analisando o cdigo - Pgina 66
Para alguns casos, um componente 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 ficaria
nica para toda a aplicao, e qualquer cliente que precisar de uma sesso, usaramos essa fbrica.
Para cada cenrio acima, o VRaptor definiu um tempo de vida. Esse tempo de vida no VRaptor chamado
de escopo. O VRaptor define 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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// imports
@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.
Para resolver esse problema, poderamos criar um atributo do tipo SessionFactory e colocar no construtor
da classe a criao da fbrica.
@Component
@ApplicationScoped
public CriadorDeSessionFactory() {
factory = configuration.buildSessionFactory();
}

return factory;
}
}
Mas o VRaptor permite a utilizao de anotaes bem teis do Java EE 5: 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 finalizado, ou seja, no
final 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 modificaes, nossa classe ficaria assim:
@Component
@ApplicationScoped
@PostConstruct
}
}
@PreDestroy
}
}
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.
8.5 - Fechando a sesso do Hibernate

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 final 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, um para 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 ficaria assim:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// imports
@Component
}
@PostConstruct
}
}
@PreDestroy
}
}
Note que criamos um atributo chamado session, que guardar uma sesso do Hibernate. Temos que
lembrar que componentes que controlados pelo VRaptor sempre tm um escopo, mesmo no estando anotado.
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
8.6 - Exerccios
Captulo 8 - Refatorando os DAOs - Fechando a sesso do Hibernate - Pgina 69
1) Anote a classe CriadorDeSessionFactory com @ApplicationScoped.

2
3
4
5
6
7
8
9
// imports
@Component
@ApplicationScoped
//...
}
2) Refatore essa classe para que seja criado apenas uma instncia da fbrica.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// imports
@Component
@ApplicationScoped
@PostConstruct
}
}
@PreDestroy
}
}
3) Refatore a classe CriadorDeSession, colocando os mtodos de callback e colocando a sesso do Hibernate

em um atributo.
@Component
}
@PostConstruct
}
}
@PreDestroy
}
}
4) Reinicie o tomcat, acesse o sistema e veja que tudo continua funcionando

5) (Opcional) Coloque System.out.println nos mtodos dos ComponentFactories, para ver a ordem que os
mtodos so chamados
6) (Opcional) Faa em uma folha de papel todo o fluxo de cadastro de um usurio. Esse fluxo pode ser feito de
qualquer forma, com flechas e caixas de texto por exemplo. O ponto importante desse exerccio ficar claro
como est a arquitetura do seu projeto.
C APTULO
Validando formulrios
Quando temos um formulrio para adicionar dados no nosso sistema, geralmente precisamos verificar 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 verificar se tudo est como esperamos. Chamamos isso de validao. Existem duas maneiras de fazer validao:
Validao do lado do cliente: verificamos 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 submetido caso acontea algum erro. A do lado do servidor feita em Java, e o VRaptor pode te ajudar a faz-la.
9.1 - Validator
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, especificar para onde deve ser
redirecionada a requisio. Para obter um Validator basta receb-lo no construtor do seu Controller:
@Resource
this.dao = dao;
}
//...
}
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.
72
Para isso vamos definir primeiro as regras de validao para um produto:
nome: deve ser obrigatrio, e ter pelo menos 3 letras.

descrio: deve ser obrigatrio, e ter menos de 40 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 ifs e adiciona as mensagens manualmente:

}
"Descrio obrigatria e no pode ter mais que 40 letras",
}
if (produto.getPreco() <= 0.0) {
}
dao.salva(produto);
}
maneira fluente: voc diz o que quer que seja verdade, e caso no seja adiciona uma mensagem
internacionalizada:
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 messages.properties:
nome.obrigatorio = Nome obrigatrio e precisa ter mais de 3 letras
Captulo 9 - Validando formulrios - Validator - Pgina 73
descricao.obrigatoria = Descrio obrigatria e no pode ter mais que 40 letras

preco.positivo = Preo precisa ser positivo
Em ambas as maneiras voc precisa especificar pra qual lgica voltar quando der erro de validao. No
nosso caso, ao dar erro queremos voltar pro formulrio, ento fazemos:
A lgica de redirecionamento a mesma que se voc estivesse usando o result.of(). Voc deve colocar essa
chamada logo no final 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.
Quando existem erros de validao, o VRaptor disponibiliza para a jsp um atributo 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, precisamos passar como valor dos inputs, o que foi mandado para a requisio:
<fieldset>
</fieldset>
</form>
9.2 - Exerccios
1) Receba um Validator no construtor do ProdutosController e guarde-o num atributo:
@Resource
this.dao = dao;
}
//...
}
2) Modifique o mtodo adiciona para que inclua a validao dos campos do produto. Se preferir, faa a
validao na forma fluente.
}
"Descrio obrigatria no pode ter mais que 40 letras",
}
if (produto.getPreco() <= 0) {
}
dao.salva(produto);
}
3) 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>
4) Adicione o cdigo para que o formulrio continue preenchido quando der erro de validao:
<fieldset>
</fieldset>
</form>
5) Abra o browser e tente adicionar um produto invlido.
6) (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?
9.3 - Para saber mais: Hibernate Validator

Hibernate Validator um poderoso framework para validao de objetos. Ele j vem com validadores que
verificam as regras mais comuns, como campos obrigatrios, tamanhos mnimos e cartes de crdito.
Alm disso, o framework tambm bastante flexvel, j que permite a criao dos seus prprios validadores.
Para definir 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
Captulo 9 - Validando formulrios - Para saber mais: Hibernate Validator - Pgina 76
@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:
@Entity
@Id @GeneratedValue
private Long id;
@NotNull
@Length(min=3)
@NotNull
@Length(max=40)
@Min(0)
private Double
preco;
Com nosso modelo anotado, podemos substituir as validaes que fizemos 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 ocorrerem sero adicionados ao validator automaticamente. Assim podemos substituir as validaes que tnhamos feito antes, pelas equivalentes do Hibernate Validator.
9.4 - Exerccios Opcionais

1) 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.
2) Anote os campos do produto para adicionar nossas regras de validao.
@Entity
@Id @GeneratedValue
private Long id;
@NotNull
@Length(min=3)
@NotNull
@Length(max=40)
@Min(0)
private Double
preco;
3) Mude a lgica de validao do mtodo adiciona do ProdutosController para usar o Hibernate Validator:
@Resource
//...
validator.validate(produto);
dao.salva(produto);
}
}
4) Acesse o browser e adicione algum produto invlido, para ver as mensagens de validao.
As mensagens esto em ingls e por enquanto no possvel internacionaliz-las, mas isso ser implementado em prximas verses do VRaptor.
C APTULO
10
REST
10.1 - O que REST
REST um conjunto de restries que define um padro arquitetural com caractersticas especficas: benefcios e dificuldades determinadas aparecero ao implementar um sistema seguindo o padro REST.
10.2 - Caractersticas e vantagens

Permitir o endereamento dos recursos do seu sistema de uma forma padronizada implica em algumas
vantagens 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 especficas 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 restfuliejava para entender mais como ele funciona e suas vantagens em um sistema: http://github.com/caelum/
restfulie-java
10.3 - O tringulo do 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 (Unified Resource Identifier ), ou seja, o identificador 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 identificando 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.
79
Verbos: Operaes
Uma das caracterstas mais importantes de REST que voc tenha um conjunto pequeno e fixo de operaes bem definidas, gerando uma interface uniforme. Desse modo, para duas aplicaes conversarem elas
no precisam implementar diversas operaes: basta usar as operaes definidas. 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 identificado pela URI. Ex: listar produtos, visualizar o produto
45. Uma requisio GET no deve modificar 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 modifica) um recurso na URI passada. Ex: atualizar um produto. A diferena fundamental entre um PUT e um POST que no POST a URI significa o lugar que vai tratar a informao, e no
PUT significa o lugar em que a informao ser armazenada.
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.
10.4 - Mudando a URI da sua lgica: @Path

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:
Captulo 10 - REST - Mudando a URI da sua lgica: @Path - Pgina 80
@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:
/produto/edita?id=10
As URIs devem identificar recursos (alm de no conter verbos, mas vamos tir-los em breve), e o id algo
que identifica o recurso que queremos acessar, ento ficaria 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 10. Para extrair esse 10 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 identificam verdadeiramente recursos especficos.
10.5 - Mudando o verbo HTTP dos seus mtodos

Podemos tambm mudar o(s) verbo(s) HTTP que os mtodos dos nossos controllers respondem. Por padro, voc pode acessar seus mtodos usando qualquer um dos 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:
Captulo 10 - REST - Mudando o verbo HTTP dos seus mtodos - Pgina 81
@Resource
@Path("/produtos")
@Get
}
}
Se quisermos permitir outros verbos HTTP, podemos usar as anotaes @Post, @Put, @Delete, @Trace e
@Head. A partir 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 um status 405 (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
@Path("/produtos")
@Post
//...
}
@Path("/produtos")
@Get
}
}
10.6 - Refatorando o ProdutosController

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 executar
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:
POST /produtos => adiciona um produto na lista de todos os produtos. Mtodo adiciona.
As URIs do tipo /produtos/42 representam um produto especfico, no caso de id 42. As operaes possveis
so:
Nem todas as URIs precisam representar recursos fixos, mas elas precisam semanticamente representar o
mesmo tipo de recurso. Por exemplo a URI /produtos/ultimo pode representar o ltimo produto adicionado e
a URI /produtos/maisVendidos pode representar uma lista dos produtos mais vendidos, que so recursos bem
definidos. No nosso caso precisamos de uma URI para identificar o formulrio de adio de um produto. Vamos
ento usar a seguinte:
Com essa especificao de operaes no recurso Produto, podemos usar as anotaes vistas anteriormente
para deixar o ProdutosController de acordo com ela:
@Resource
@Get @Path("/produtos/novo")
public void formulario() {...}
@Get @Path("/produtos/{id}")
@Put @Path("/produtos/{produto.id}")
@Post @Path("/produtos")
@Delete @Path("/produtos/{id}")
@Get @Path("/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.
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 conseguem 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, especificando 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 GET que 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>
</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:
<fieldset>
<!-vvvvvvv
vvv -->
</fieldset>
</form>
No precisamos mais passar o input hidden com produto.id, porque essa informao j est na URI!
button e o Internet Explorer
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"/>
10.7 - Exerccios
1) Anote os mtodos do ProdutosController para seguirmos a nossa especificao de Produto:
Recurso Produto:
POST /produtos => adiciona um novo produto. Mtodo adiciona.
2) Abra o formulario.jsp e mude a action do form:

3) 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>
4) Modifique o lista.jsp, colocando o link para Edio e o link para Remoo:

<td>
</form>
</td>
5) Abra o header.jspf e modifique os links do menu:

<div id="menu">
<ul>
</ul>
</div>
C APTULO
11
AJAX e efeitos visuais

11.1 - O que AJAX?
AJAX (Asynchronous Javascript and XML) um conjunto de tcnicas de desenvolvimento Web para executar
tarefas do lado do cliente, por exemplo modificar pedaos de uma pgina sem ter 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 em background. Na resposta dessa requisio vem um XML que o javascript processa
e modifica a pgina segundo essa resposta.
o efeito que tanto ocorre no gmail e google maps.
H vrias ferramentas para se trabalhar com Ajax em Java. DWR e 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 famosos: 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.
11.2 - Um pouco de JQuery

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)
Seletores
O JQuery suporta XPath e CSS 3, com seletores 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 especifico:
87
$(#meuDiv).show()
$(#meuDiv).hide()
Um outro ponto forte do JQuery que ele possui diversos plugins que fazem vrias 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/.
Mais sobre javascript
Nesse curso no daremos foco no desenvolvimento de cdigo javascript, boas prticas e caractersticas dessa linguagem, apenas usaremos plugins do JQuery. Mas o cdigo javascript uma parte
bastante 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-43 | Desenvolvimento Web com HTML, CSS e JavaScript.
11.3 - Validando formulrios com o JQuery

Quando fizemos a validao do formulrio de adio de produtos, precisvamos enviar uma requisio para
o servidor, executando algumas lgicas para decidir se os dados estavam corretos, para ento responder para o
usurio que os seus dados no esto vlidos. Isso pode ser evitado se fizermos a validao do lado do cliente.
Alm de ser bem mais rpido, evita que seja feita uma requisio desnecessria para o servidor.
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:
Existe
um
plugin
<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":
...
</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 3, a descrio tambm obrigatria e o tamanho tem que ser menor que
40, e o preo maior que zero:
<fieldset>
Captulo 11 - AJAX e efeitos visuais - Validando formulrios com o JQuery - Pgina 88

</fieldset>
</form>
Se voc no gosta de colocar mais atributos nos seus campos de formulrio, voc ainda pode definir 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>
11.4 - Criando a busca de produtos

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
//...
}
}
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 modificar 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
//...
.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:
Precisamos tambm passar o nome que foi buscado, ento podemos mudar o mtodo busca do
ProdutosController:
}
Por ltimo, vamos criar um formulrio para poder acessar essa busca. Abra o arquivo header.jspf e modifique o div menu:
<div id="menu">
<ul>
</form>
</li>
</ul>
</div>
Para que no fique 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>
...
</form>
</script>
</li>
Assim temos o seguinte resultado:
11.5 - Melhorando a busca: Autocomplete

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:
//...
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
qualquer, mas no nosso caso vai ser uma lista. Ao chamarmos a URI desse mtodo no browser, passando um
nome qualquer, por exemplo http://localhost:8080/goodbuy/produtos/busca.json?nome=a retornado um JSON
parecido com:
{"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
precisamos de uma lista de nomes, talvez com o preo. Para isso podemos excluir as outras propriedades:

//...
result.use(json()).from(dao.busca(nome))
.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():

.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 suficiente, mas o plugin AutoComplete espera que voc mande os dados separados por
pipe(|) ou um dado por linha. Como queremos usar JSON, precisamos configurar isso no plugin:
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 {
data: produto, // todos os dados do produto
value: produto.nome, // o valor lgico do produto
result: produto.nome // o que vai aparecer ao selecionar
};
});
},
formatItem: function(produto) { // o que vai aparecer na lista de autocomplete
}
});
Alm disso, o plugin passa como parmetro da requisio o que voc digitou no input, numa varivel chamada q ento voc precisa modicar a lgica de busca para o parmetro se chamar q:
.from(dao.busca(q))
.serialize();
}
Para saber mais: c:url dentro de javascript

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 fizemos, somos obrigados a sempre fazer o deploy da aplicao 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 ficar mais difceis de entender.
11.6 - Exerccios
1) Modifique 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().
<fieldset>
</fieldset>
</form>
</script>
2) Tente adicionar um produto invlido.
3) (Opcional) As mensagens de erro esto em ingls. Tente procurar na documentao do plugin como fazer
para que as mensagens fiquem em portugus.
4) Crie um mtodo em ProdutosController para a listagem de produtos.
@Resource

//...
}
}
5) Use o atalho Ctrl+1 para criar o mtodo busca no ProdutoDao.
6) Implemente o mtodo busca no ProdutoDao.

@Component
//...
.list();
}
}
7) Crie o JSP de resultado da busca, em /WEB-INF/jsp/produto/busca.jsp

8) Abra o arquivo header.jspf e modifique o menu para incluir um formulrio de busca:

<div id="menu">
<ul>

</form>
</li>
</ul>
</div>
9) Faa buscas usando esse formulrio.
10) Modifique o formulrio de busca para usar o plugin Puts e deixar uma mensagem dentro do input.
<div id="menu">
<ul>
</form>
</script>
</li>
</ul>
</div>
11) Recarregue a pgina atual e veja que a mensagem apareceu no input.
12) Crie o mtodo de busca que retorna JSON no ProdutosController.

.from(dao.busca(q))
.serialize();
}
13) Adicione o cdigo javascript para que o autocomplete funcione.

dataType: "json",
parse: function(produtos) {
return {
data: produto,
value: produto.nome,
result: produto.nome
};
});
},
formatItem: function(produto) {
}
});
14) Recarregue a pgina e teste o autocomplete digitando algo no campo de busca.
C APTULO
12
Criando o Carrinho de Compras

12.1 - O modelo do Carrinho
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:
}
Alm disso precisamos criar uma classe que representa um item do carrinho: um produto com a quantidade
selecionada.
public class Item {
}
Pergunta importante: precisamos guardar esse carrinho no banco? O usurio no comprou ainda os produtos, ento no faz muito sentido guardar no banco de dados. Esse carrinho precisa ficar 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 modificar a classe do carrinho para incluir as anotaes:
@Component
@SessionScoped
99

//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.
12.2 - Controlando o carrinho de compras

Agora que temos o modelo do Carrinho, vamos criar uma maneira de adicionar produtos. O jeito mais
simples modificar a listagem de produtos adicionando um boto para comprar:
<table>
<thead>
<tr>
...
<th>Comprar</th>
...
</tr>
</thead>
<tbody>
<tr>
...
<td>
</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
}
Vamos criar o mtodo que responde URI colocada no formulrio de compra:

@Resource
}
}
Para adicionar o item ao carrinho, temos que receber um Carrinho no construtor, assim o VRaptor vai passar
para o CarrinhoController o carrinho da sesso do usurio:
@Resource
public CarrinhoController(Carrinho carrinho) {
}
}
}
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);
}
//...
}
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;
}
}
}
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
//...
}
}
Por ltimo, precisamos ir para alguma pgina aps adicionar algum item no carrinho. Por ora, vamos voltar
pra pgina de listagem de produtos. Repare que como o redirecionamento para uma lgica de outro controller,
precisamos usar a classe deste controller:
@Resource
this.dao = dao;
}
}
}
12.3 - Visualizando os itens do carrinho

J conseguimos adicionar itens no carrinho, mas no possvel ainda visualizar o que tem dentro dele.
Primeiro, vamos adicionar uma lugar em todas as pginas que mostra o estado atual do carrinho: quantos itens
ele tem e qual o valor total. Mas como vamos acessar o carrinho da sesso em todas 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 atributo 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>
<ul>
</ul>
</c:if>
</div>
</div>
Estamos usando a expresso ${carrinho.totalDeItens} mas classe Carrinho no possui um getter para
esse total de itens. Ento vamos adicionar:
//...
}
}
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.
}
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.
<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>
value="${item.produto.preco }"/></td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
</tr>
</tfoot>
</table>
Para acessar essa visualizao, vamos criar um link na div do carrinho:

<div id="header">
<div id="carrinho">
Agora que temos uma pgina de visualizao, podemos redirecionar para ela quando adicionamos algum
produto ao carrinho.
@Resource
//...
}
}
12.4 - Removendo itens do carrinho

Para completar as funcionalidades do carrinho de compras, vamos modificar a visualizao do carrrinho
para ser possvel remover itens:
<table>
...
<tbody>
<tr>
...
<td>
</form>
</td>
</tr>
Captulo 12 - Criando o Carrinho de Compras - Removendo itens do carrinho - Pgina 105
</c:forEach>
</tbody>
...
</table>
Vamos criar, tambm, o mtodo que remove itens do carrinho no controller:

//...
}
}
E implementar o mtodo que remove o item do carrinho, atualizando o total:

//...
}
}
12.5 - Exerccios
1) Crie os modelos Carrinho e Item:
@Component
@SessionScoped
//getters e setters
}
public class Item {

//getters e setters
}
2) Modifique a listagem de produtos para incluir um boto para comprar o produto:

<table>
<thead>
<tr>
...
<th>Comprar</th>
...
</tr>
</thead>
<tbody>
<tr>
...
<td>
</form>
</td>
...
</tr>
</c:forEach>
</tbody>
</table>
3) Adicione o div do carrinho no cabealho da pgina (arquivo header.jspf)

<div id="header">
<div id="carrinho">
</c:if>
<ul>
</ul>
</c:if>
</div>
</div>
4) Crie o CarrinhoController, com um mtodo para adicionar itens no carrinho.

@Resource
this.dao = dao;
}
}
}

//...
itens.add(item);
}
}
}

//...
}
}
5) Compre alguns produtos e veja o carrinho sendo atualizado no header.
6) Crie a lgica e o jsp que visualiza os itens do carrinho. Mude tambm o redirecionamento do mtodo
adiciona para a nova lgica.
@Resource
//...
}
}
}
<table>
<thead>
<tr>
<th>Nome</th>
<th>Descrio</th>
<th>Preo</th>
<th>Qtde</th>
<th>Total</th>
</tr>
</thead>
<tbody>
<tr>
<td><fmt:formatNumber type="currency" value="${item.produto.preco }"/></td>
</tr>
</c:forEach>
</tbody>
<tfoot>
<tr>
</tr>
</tfoot>
</table>
7) Adicione mais produtos ao carrinho.
8) Crie a lgica de remover produtos do carrinho e adicione o boto de remoo na visualizao do carrinho.
//...
}
}

}
}
<table>
...
<tbody>
<tr>
...
<td>
</form>
</td>
</tr>
</c:forEach>
</tbody>
...
</table>
9) Adicione e remova itens do carrinho.
C APTULO
13
Autenticao
13.1 - Criando Usurios
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:
//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 identificador nico.
import javax.persistence.Entity;
import javax.persistence.Id;
@Entity
@Id
//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
112
tabelas do banco quando necessrio.

<session-factory>

<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 void novo() {
}
}
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 }"/>
<input id="login" class="required"
type="text" name="usuario.login" value="${usuario.login }"/>
<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 tambm criar um link para esse cadastro. Para isso criaremos uma div no cabealho que
mostrar as informaes do usurio. Abra o arquivo header.jspf e modifique 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, Validator validator) {
this.dao = dao;
}
@Post @Path("/usuarios")
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 UsuarioDao(Session session) {
}
public boolean existeUsuario(Usuario usuario) {
Usuario encontrado = (Usuario) session.createCriteria(Usuario.class)

.uniqueResult();
return encontrado != null;
}
Transaction tx = this.session.beginTransaction();
this.session.save(usuario);
tx.commit();
}
}
13.2 - Efetuando o login

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">
</div>
e a respectiva lgica e formulrio:

@Resource
//...
@Get @Path("/login")
public void loginForm() {
}
}
<form action="<c:url value="/login"/>" method="POST">

<fieldset>
<legend>Efetue o login</legend>
<input id="login" type="text" name="usuario.login"/>
<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
private Usuario logado;
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
verificar 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 @Path("/login")
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 Usuario carrega(Usuario usuario) {
return (Usuario) session.createCriteria(Usuario.class)
.add(Restrictions.eq("senha", usuario.getSenha()))
.uniqueResult();
}
}
E para mostrar que o usurio est logado mesmo, vamos modificar 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}">
</c:if>
</div>
...
</div>
Por ltimo vamos adicionar a lgica de logout:

//...
@Path("/logout")
usuarioWeb.logout();
}
}

//...
this.logado = null;
}
}
13.3 - Restringindo funcionalidades para usurios logados
Captulo 13 - Autenticao - Restringindo funcionalidades para usurios logados - Pgina 117
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>
...
/WEB-INF/jsp/produto/lista.jsp
<table>
...
<tbody>
<tr>
...
<td>
</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
executar. Mas ser que isso o suficiente? O que impede o usurio de digitar na barra de endereos do browser:
http://localhost:8080/goodbuy/produtos/novo? Nada! Ele s precisa conhecer qual a URI. Precisamos, de
algum 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.
13.4 - Interceptor
Um Interceptor no VRaptor como se fosse um Servlet Filter: ele pode interceptar requisies, executando
algo antes e/ou depois da sua lgica. Mais ainda, ele pode impedir que sua lgica seja executada, redirecionando a requisio para outro lugar. Isso exatamente o que a gente queria: verificar 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
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 mtodo
do seu controller. Com esse objeto voc tem acesso classe do controller e ao mtodo java dele
(java.reflect.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 verificar se o usurio est logado, e
essa informao est no UsuarioWeb.
@Intercepts
public AutorizacaoInterceptor(UsuarioWeb usuario) {
}
}
Mas s precisamos executar a lgica de autenticao caso o usurio no esteja logado, ento vamos implementar o mtodo accepts:
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 AutorizacaoInterceptor(UsuarioWeb usuario, Result result) {
}
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 modifique 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:
@Retention(RetentionPolicy.RUNTIME) //a anotao vai ficar disponvel em tempo de execucao
@Target(ElementType.METHOD) // anotao para mtodos
public @interface Restrito {
}
Assim, podemos anotar os mtodos restritos (adiciona, atualiza, remove, formulario e edita do ProdutosController):
@Resource
@Restrito
public void formulario() {}
@Restrito
@Restrito
@Restrito
@Restrito
...
}
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 APTULO
14
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.
14.1 - Exerccios
1) Modifique a pgina de edio de Produtos (/WEB-INF/jsp/produtos/edita.jsp), para incluir um formulrio
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>
2) Crie o Controller abaixo, que vai tratar dos uploads e downloads de imagens.
import br.com.caelum.vraptor.interceptor.multipart.UploadedFile;
@Resource
public void upload(Produto produto, UploadedFile imagem) {
}
}
3) 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:
122
}
}});
}
4) Coloque as mensagens internacionalizadas no messages.properties:

imagem.nula = Digite uma imagem
nao.eh.imagem = Selecione uma imagem
5) Crie o componente do VRaptor que ser responsvel por guardar as imagens no servidor. Esse componente
vai criar uma pasta fixa onde todas as imagens sero guardadas. Para isso, precisamos conseguir o
caminho de uma pasta do servidor, e a classe que consegue nos dar essa informao o ServletContext.
import javax.servlet.ServletContext;
@Component
private File pastaImagens;
public Imagens(ServletContext context) {
String caminhoImagens = context.getRealPath("/WEB-INF/imagens");
pastaImagens = new File(caminhoImagens);
pastaImagens.mkdir();
}
}
6) Crie um mtodo que salve a imagem do upload na pasta padro. Colocaremos uma extenso fixa para
facilitar. O IOUtils vem do projeto commons-io e copia um InputStream para algum OutputStream
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.commons.io.IOUtils;
@Component
//...
public void salva(UploadedFile imagem, Produto produto) {
File destino = new File(pastaImagens, produto.getId() + ".imagem");

try {
IOUtils.copyLarge(imagem.getFile(), new FileOutputStream(destino));
} catch (IOException e) {
throw new RuntimeException("Erro ao copiar imagem", e);
}
}
}
7) Use a classe Imagens para salvar a imagem que veio no upload. E a classe Result para voltar para o
formulario de edio.
@Resource
private final Imagens imagens;
public ImagensController(Validator validator, Imagens imagens, Result result) {
this.imagens = imagens;
}
}
}});
imagens.salva(imagem, produto);
result.redirectTo(ProdutosController.class).edita(produto.getId());
}
}
8) Crie a lgica para fazer o download da imagem no ImagensController:

@Get @Path("/produtos/{produto.id}/imagem")
public File download(Produto produto) {
return imagens.mostra(produto);
}
9) Crie o mtodo mostra na classe Imagens:

public File mostra(Produto produto) {
return new File(pastaImagens, produto.getId() + ".imagem");

}
10) Mude o formulrio de edio para incluir a imagem do produto. Repare que estamos usando nosso controller
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 APTULO
15
Apndice - Integrando VRaptor e Spring

15.1 - Como fazer a integrao?
Para usar os componentes do Spring no VRaptor basta configur-los no applicationContext.xml da maneira que voc j est acostumado a fazer quando trabalha com o Spring.
Mas voc deve ter em mente que os componentes configurados pelo applicationContext.xml no enxergam os componentes configurados pelas anotaes do VRaptor, ento se algum componente do Spring
depender de algo que est no VRaptor, voc precisa converter a configurao para a do Spring para fazer
funcionar.
15.2 - Integrando o Transaction Manager do Spring

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.
O Spring possui um componente 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.
15.3 - Exerccios: Transaction Manager

1) Crie o arquivo applicationContext.xml dentro da pasta src:
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
</beans>
126
2) Inclua o componente que gerencia as transaes, baseado em anotaes do Spring.

xmlns:tx="http://www.springframework.org/schema/tx"
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">
</beans>
3) Esse componente de transaes genrico: funciona tanto com a JTA direto, com Hibernate/JPA, com JDBC,
etc. Ento para especificar qual dos gerenciadores de transao vai ser utilizado, voc precisa adicionar um
bean na configurao. No nosso caso, vamos usar transaes do Hibernate:
<beans xmlns...>
<bean id="transactionManager"
class="org.springframework.orm.hibernate3.HibernateTransactionManager">
<property name="sessionFactory" ref="sessionFactory" />
</bean>
</beans>
4) O transactionManager precisa de uma SessionFactory configurada. 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>
5) Ao usar a SessionFactory do Spring estamos presos ao seu controle de Sessions. Isso significa 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 modificar 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.
Modifique 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
}
}
6) Para usar o controle de transaes do Spring, remova a abertura e o fechamento de transaes dos
mtodos do DAO, e anote o mtodo com @Transactional. Repare que nem todos os mtodos precisam de
transaes, s os que modificam o banco.
import org.springframework.transaction.annotation.Transactional;
@Component
@Transactional
public void salva(Produto produto) {

//Transaction tx = session.beginTransaction();
//tx.commit();
}
return (Produto) session.load(Produto.class, id);
}
@Transactional
}
}
@Transactional
}
.list();
}
}
}
C APTULO
16
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.
16.1 - Exerccios: Configurando o Velocity

1) Entre no site de downloads do velocity (http://velocity.apache.org/download.cgi) e baixe os zips velocityx.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
2) Abra o web.xml e adicione a servlet do Velocity.
<servlet>
<servlet-class>org.apache.velocity.tools.view.servlet.VelocityViewServlet</servlet-class>
</servlet>
<servlet-mapping>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
16.2 - Exerccios: Mudando o Template Engine de uma nica lgica

1) Se voc quiser usar o Velocity em uma nica ou poucas lgicas, voc no precisa de muita coisa. Com a
Servlet do Velocity configurada, 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>
2) Acesse a pgina do Velocity diretamente: http://localhost:8080/goodbuy/olamundo.vm

3) Crie um controller simples para redirecionar pra esse arquivo. Note que os objetos includos no Result ficam
acessveis no template do Velocity.
130

}
@Path("/teste")
result.forwardTo("/olamundo.vm");
}
}
e modifique o olamundo.vm para mostrar a mensagem includa:

<html>
<body>
Ol mundo. $mensagem.
</body>
</html>
4) Acesse a URL que cai nesse mtodo: http://localhost:8080/goodbuy/teste
16.3 - Exerccios: Mudando o resultado de todas as lgicas para Velocity

1) O VRaptor 3 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 Dependncia 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";
}
}
2) 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.
3) Remova o redirecionamento para a pgina olamundo.vm de dentro do TesteController:
}
@Path("/teste")
}
}
4) Acesse a url do mtodo teste (http://localhost:8080/goodbuy/teste), e veja que continua funcionando: ele
vai redirecionar automaticamente para a pgina /WEB-INF/velocity/teste/teste.vm.
5) Veja que agora nenhuma das outras pginas do sistema esto acessveis. Agora qualquer chamada vai dar
404, pois ele estar usando a nova conveno. O comportamento do VRaptor agora o da sua classe, e
no mais a padro dele!
ndice Remissivo
AnnotationConfiguration, 11
Criteria, 40
Driver, 5
Escopo, 67
Hibernate, 4
Hibernate Annotations, 5
Hibernate Core, 5
Injeo de Dependncias, 43
JPA, 4
Log4J, 5
Logging, 5
MySQL, 4
ORM, 4
POJO, 32
Result, 52
SL4J, 5
Validao, 72
133

Java Com Vraptor e Ajax

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Java Com Vraptor e Ajax

Enviado por

Direitos autorais:

Formatos disponíveis

FJ-28

Desenvolvimento gil para a

Acompanhe tambm a equipe Caelum no Twitter:

Assine tambm nossa Newsletter para receber as novidades e destaques dos

Conhea alguns de nossos cursos

Persistncia com JPA2 e

Laboratrio Java com Testes,

Laboratrio Web com JSF2 e

Preparatrio para Certificao

Java para Desenvolvimento

Desenvolvimento gil para Web

Ruby e Rails avanados: lidando

Para mais informaes e outros cursos, visite: caelum.com.br/cursos

Mais de 8000 alunos treinados;

Sobre esta apostila

1.1 Objetivo do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2 Sobre o curso: Hibernate, VRaptor, JSP e AJAX . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3 Onde posso aprender mais do VRaptor?

2.1 A necessidade do cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.2 Partes do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 Persistindo os dados com o Hibernate

3.1 A camada de persistncia do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.2 Sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.3 Preparando o Hibernate

3.4 Configurando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.5 Exerccios: Configurando o banco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.1 Modelando um produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.2 Anotando a classe Produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.3 Exerccios - Modelando o produto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.8 Discusso em sala - mais sobre o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

5.1 Analisando o cdigo atual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.3 Aprendendo a refatorar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

6.1 Sobre o VRaptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

7.1 Listando produtos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

8.1 Injeo de dependncias no DAO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

9.4 Exerccios Opcionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

10.1 O que REST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

11.1 O que AJAX? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

12 Criando o Carrinho de Compras

12.1 O modelo do Carrinho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

13.1 Criando Usurios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

14.1 Exerccios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

15.1 Como fazer a integrao? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

16.1 Exerccios: Configurando o Velocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

1.1 - Objetivo do curso

1.2 - Sobre o curso: Hibernate, VRaptor, JSP e AJAX

1.3 - Onde posso aprender mais do VRaptor?

Captulo 1 - O curso - Onde posso aprender mais do VRaptor? - Pgina 2

2.1 - A necessidade do cliente

Cadastrar, atualizar, listar e remover produtos

2.2 - Partes do projeto

Persistindo os dados com o Hibernate

3.2 - Sobre o Hibernate

Mais sobre Hibernate

3.3 - Preparando o Hibernate

Configurando o mecanismo de logging

Configurando o driver do MySQL

3.4 - Configurando o Hibernate

Captulo 3 - Persistindo os dados com o Hibernate - Preparando o Hibernate - Pgina 5

hibernate.connection.username - usurio do banco de dados

hibernate.connection.driver_class - driver que deve ser utilizado

hibernate.dialect - dialeto a ser utilizado para a comunicao com o banco de dados

Captulo 3 - Persistindo os dados com o Hibernate - Configurando o Hibernate - Pgina 6

3.5 - Exerccios: Configurando o banco