Vous êtes sur la page 1sur 141

Desenvolvimento gil para a Web 2.

0 com VRaptor, Hibernate e AJAX

FJ-28

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 prossionais altamente qualicados e de destaque do mercado, oferece treinamentos em Java, Ruby on Rails e Scrum em suas trs unidades - So Paulo, Rio de Janeiro e Braslia. Mais de 8 mil alunos j buscaram qualicao nos treinamentos da Caelum tanto em nas unidades como nas prprias empresas com os cursos incompany. O compromisso da Caelum oferecer um treinamento de qualidade, com material constantemente atualizado, uma metodologia de ensino cuidadosamente desenvolvida e instrutores capacitados tecnicamente e didaticamente. E oferecer ainda servios de consultoria gil, mentoring e desenvolvimento de projetos sob medida para empresas.

Comunidade
Nossa equipe escreve constantemente artigos no Blog da Caelum que j conta com 150 artigos sobre vrios assuntos de Java, Rails e computao em geral. Visite-nos e assine nosso RSS: blog.caelum.com.br

Acompanhe 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:
Java e Orientao a objetos

FJ-25:
Persistncia com JPA2 e Hibernate

FJ-16:
Laboratrio Java com Testes, XML e Design Patterns

FJ-26:
Laboratrio Web com JSF2 e CDI

FJ-19:
Preparatrio para Certificao de Programador Java

FJ-31:
Java EE avanado e Web Services

FJ-21:
Java para Desenvolvimento Web

FJ-91:
Arquitetura e Design de Projetos Java

RR-71:
Desenvolvimento gil para Web 2.0 com Ruby on Rails

RR-75:
Ruby e Rails avanados: lidando com problemas do dia a dia

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 qualicados 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 nal do ndice. Baixe sempre a verso mais nova em: www.caelum.com.br/apostilas Esse material parte integrante do treinamento Desenv. gil para Web 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 1 1 1 3 3 3 4 4 4 5 5 7 8 8 9

3.4 Congurando o Hibernate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.5 Exerccios: Congurando 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 congurar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 denidos 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: Congurando 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 car atento para a importncia de como vamos faz-los trabalhar junto. Essa costura pode ser aplicada em diversos outros casos, mesmo com outros frameworks, e baseada essencialmente no bom isolamento de classes, usando inverso de controle e injeo de dependncias, assunto que ser tratado recorrentemente durante o curso.

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 ocial 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 congurado, o MySQL pode ser acessado com o usurio chamado root e a senha vazia (sem senha). Para testar, basta abrir o terminal e digitar o comando:
mysql -u root

Esse comando tenta fazer o login no mysql, informando o usurio root (-u root) e omitindo a senha, j que esse usurio no tem senha. Para nos comunicarmos com o banco de dados, seja para uma consulta ou para algum tipo de alterao de dado, podemos usar a API que o Java SE disponibiliza, o JDBC. Um dos problemas do JDBC, quando usado diretamente, conforme mostramos no curso FJ-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 car 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 denir como os objetos so mapeados nas tabelas do banco e o Hibernate faz todo o acesso ao banco, gerando inclusive os comandos SQL necessrios. O Hibernate um projeto opensource do grupo JBoss com muitos anos de histria e liderana no mercado Java. Recentemente, boa parte das idias do Hibernate e outros frameworks ORM foram padronizadas em uma especio ocial do Java, a JPA - Java Persistence API. A JPA uma especicao do JCP e possui vrias implementaes (o Hibernate, o Oracle Toplink, EclipseLink, OpenJPA etc). 4

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 congurar 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.

Congurando 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.

Congurando 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 - Congurando o Hibernate


Para congurar o Hibernate, podemos utilizar ou um arquivo .properties ou um arquivo XML. O arquivo de properties mais simples, mais fcil de se criar, mas uma das desvantagens que ele no consegue congurar tudo que queremos, por exemplo as entidades. As entidades tm que ser conguradas no cdigo, e as outras informaes no arquivo de properties.

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

J o XML, por mais que seja um pouco mais difcil em relao ao properties, permite que toda a congurao seja feita nele. Por isso faremos nossa congurao 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 conguraes que passamos nesse arquivo so parecidas quando queremos nos conectar a um banco de dados. Para conectar em um banco de dados, precisamos informar qual o usurio, a senha, algumas informaes do banco, como host, porta, etc. Um detalhe importante da nossa congurao o banco de dados que foi passado. Na congurao hibernate.connection.url foi passado o nome do database que utilizaremos. Para esse caso escolhemos o database fj28. Abaixo segue a descrio de todas as conguraes que usamos.

hibernate.connection.username - usurio do banco de dados hibernate.connection.password - senha do usurio hibernate.connection.url - chamada de URL ou string de conexo, deve ser congurada de acordo com
documentao do banco de dados

hibernate.connection.driver_class - driver que deve ser utilizado hibernate.hbm2ddl.auto - como o hibernate vai se comportar em relao s tabelas do banco. Com o
valor update ele vai criar ou modicar tabelas sempre que necessrio.

hibernate.dialect - dialeto a ser utilizado para a comunicao com o banco de dados show_sql - ag que indica se os SQLs gerados devem ser impressos format_sql - ag que indica se os SQLs devem ser formatados

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Existem muitas outras conguraes possveis. Para maiores detalhes, acesse a documentao do Hibernate.

3.5 - Exerccios: Congurando 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 vericar se o database fj28 existe. Se ele no existir, teremos que cri-lo. Primeiro, abra um terminal pelo cone no Desktop. Depois digite:
mysql -u root

Depois de conectado, vamos vericar os bancos de dados disponveis:


mysql> show databases;

Se o database fj28 aparecer, digite:


mysql> drop database fj28;

mysql> create database fj28;

Captulo 3 - Persistindo os dados com o Hibernate - Exerccios: Congurando o banco - Pgina 7

C APTULO

Cadastrando Produtos
No captulo anterior, conguramos 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 congurado e com o banco de dados pronto, podemos partir para a codicao. A primeira classe que faremos ser a classe Produto. Ela representar os produtos que sero cadastrados no sistema, ou seja, quando algum produto for colocado no sistema, ns criaremos uma instncia dessa classe. Nossa classe Produto car assim:
public class Produto { private String nome; private String descricao; private Double preco; // getter e setters }

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 xa, portanto os problemas de arredondamento so facilmente contornveis. No usaremos BigDecimal pois ele um pouco mais complicado de usar:
double a, b, c, d; d = a+b/c;

com BigDecimal:
BigDecimal a, b, c, d; d = a.add(b.divide(c));

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 diculdade e o trabalho de se fazer isso com XML. Outra maneira, que est sendo bem aceita pela comunidade o uso de anotaes para a congurao. Ao invs de usar um arquivo XML para congurar, basta ir na prpria classe e anot-la. Uma das grandes 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 especicao da Java Persistence API.
@Entity public class Produto { private String nome; private String descricao; private Double preco; // 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 public class Produto { @Id @GeneratedValue private Long id; private String nome; private String descricao; private Double preco; // getter e setters }

Captulo 4 - Cadastrando Produtos - Anotando a classe Produto - Pgina 9

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 congurao dele, o hibernate.cfg.xml. O contedo do arquivo car assim:
<hibernate-configuration> <session-factory> <!-- todas as propriedades configuradas anteriormente --> <!-- entidades --> <mapping class="br.com.caelum.goodbuy.modelo.Produto" /> </session-factory> </hibernate-configuration>

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.
public class Produto {

private Long id; private String nome; private String descricao; private Double preco; // getter e setters }

2) Anote a classe com as anotaes da JPA.


@Entity public class Produto { @Id @GeneratedValue private Long id; private String nome; private String descricao; private Double preco; // getter e setters }

Captulo 4 - Cadastrando Produtos - Exerccios - Modelando o produto - Pgina 10

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

3) Congure essa entidade no Hibernate, alterando o arquivo hibernate.cfg.xml.


<!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- todas as propriedades configuradas anteriormente --> <!-- --> <!-- entidades --> <mapping class="br.com.caelum.goodbuy.modelo.Produto" /> </session-factory> </hibernate-configuration>

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 congurao do Hibernate, portanto iniciamos instanciando a classe do Hibernate cujo nome org.hibernate.cfg.AnnotationConfiguration.
// Cria uma configurao AnnotationConfiguration configuration = new AnnotationConfiguration();

Depois de criar esse objeto, vamos chamar o mtodo responsvel por ler o arquivo hibernate.cfg.xml, o configure().
// L o hibernate.cfg.xml configuration.configure();

Aps congurar, precisamos criar um objeto que cria as sesses, uma fbrica. SessionFactory, que pode ser obtida com:

Esse objeto uma

Captulo 4 - Cadastrando Produtos - Adicionando um produto no banco - Pgina 11

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

SessionFactory factory = configuration.buildSessionFactory();

Com a SessionFactory em mos conseguimos criar uma uma Session. O cdigo completo ca:
1 public class TesteDeSessao { 2 public static void main(String[] args) { 3 AnnotationConfiguration configuration = new AnnotationConfiguration(); 4 configuration.configure(); 5 6 SessionFactory factory = configuration.buildSessionFactory(); 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 { public static void main(String[] args) { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); Session session = factory.openSession(); Produto produto = new Produto(); produto.setNome("Prateleira");
Captulo 4 - Cadastrando Produtos - Exerccios - Pgina 12

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

18 19 20 21 22 23 24 25 }

produto.setDescricao("Uma prateleira para colocar livros"); produto.setPreco(35.90); Transaction tx = session.beginTransaction(); session.save(produto); 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 verique 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 zemos. Para alterar um produto, basta carregarmos esse produto, alterarmos e depois atualizarmos.
1 public class AlteracaoDeProduto { 2 public static void main(String[] args) { 3 AnnotationConfiguration configuration = new AnnotationConfiguration(); 4 configuration.configure(); 5 6 SessionFactory factory = configuration.buildSessionFactory(); 7 Session session = factory.openSession(); 8

Captulo 4 - Cadastrando Produtos - Outras operaes com produto - Pgina 13

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

9 10 11 12 13 14 15 16 17 }

// carrega o produto do banco de dados Produto produto = (Produto) session.load(Produto.class, 1L); Transaction tx = session.beginTransaction(); produto.setPreco(42.50); session.update(produto); tx.commit(); }

E para remover um produto:


1 public class RemocaoDeProduto { 2 public static void main(String[] args) { 3 AnnotationConfiguration configuration = new AnnotationConfiguration(); 4 configuration.configure(); 5 6 SessionFactory factory = configuration.buildSessionFactory(); 7 Session session = factory.openSession(); 8 9 // carrega o produto do banco de dados 10 Produto produto = (Produto) session.load(Produto.class, 1L); 11 12 Transaction tx = session.beginTransaction(); 13 session.delete(produto); 14 tx.commit(); 15 } 16 }

4.7 - Exercicios - outras operaes com produto


1) Crie a classe de alterao do produto.
1 package br.com.caelum.goodbuy.testes; 2 3 public class AlteracaoDeProduto { 4 public static void main(String[] args) { 5 AnnotationConfiguration configuration = new AnnotationConfiguration(); 6 configuration.configure(); 7 8 SessionFactory factory = configuration.buildSessionFactory(); 9 Session session = factory.openSession(); 10 11 // carrega o produto do banco de dados 12 Produto produto = (Produto) session.load(Produto.class, 1L); 13 14 Transaction tx = session.beginTransaction(); 15 produto.setPreco(42.50); 16 session.update(produto); 17 tx.commit(); 18 }

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

19 }

2) Execute a classe que altera o produto. Repare no console o sql que foi gerado.

3) Acesse o banco de dados e verique se o produto foi alterado com sucesso.

4) Crie a classe de remoo do produto.


1 package br.com.caelum.goodbuy.testes; 2 3 public class RemocaoDeProduto { 4 public static void main(String[] args) { 5 AnnotationConfiguration configuration = new AnnotationConfiguration(); 6 configuration.configure(); 7 8 SessionFactory factory = configuration.buildSessionFactory(); 9 Session session = factory.openSession(); 10 11 // carrega o produto do banco de dados 12 Produto produto = (Produto) session.load(Produto.class, 1L); 13 14 Transaction tx = session.beginTransaction(); 15 session.delete(produto);
Captulo 4 - Cadastrando Produtos - Exercicios - outras operaes com produto - Pgina 15

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

16 17 18 }

tx.commit(); }

5) Execute a classe que remove o produto. Repare no console o sql que foi gerado.

6) Acesse o banco de dados e verique se o produto foi alterado com sucesso.

4.8 - Discusso em sala - mais sobre o Hibernate


Por que utilizamos o Long e no o long para o campo id Eu sempre z com que minhas entidades implementassem Serializable. mesmo necessrio? Vale mesmo a pena utilizar o Hibernate? No vou perder performance?

Captulo 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 congurado Classes de testes para lidar com produtos
Mas ser que com o que temos agora podemos cadastrar produtos, conforme o cliente pediu? Repare na ltima parte da pergunta, que muito importante. Se entregarmos o que temos agora para o cliente, ele dir que isso intil e nosso sistema no tem nada ainda. O que faltou, que muito importante, integrar a parte visual (web) com as regras de negcios. Mas repare que o jeito que esto nossas classes que lidam com um produto no banco de dados. Todo nosso cdigo est em classes de testes, dentro do mtodo main(). Se deixarmos dessa maneira caria muito difcil de utilizar esse cdigo. Ento o que precisamos fazer melhorar nosso cdigo, para que possamos utilizar o que foi escrito dentro do main(), e tambm para melhorar a manuteno e a legibilidade.

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

5.3 - Aprendendo a refatorar


Vamos abrir novamente a classe de insero de produtos.
package br.com.caelum.goodbuy.testes; // imports public class AdicaoDeProduto { public static void main(String[] args) { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); Session session = factory.openSession(); 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(); } }

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 car claro essa diviso, veja o cdigo novamente, agora com os comentrios mostrando onde comea cada parte.
1 package br.com.caelum.goodbuy.testes; 2 3 // imports 4 5 public class AdicaoDeProduto { 6 7 public static void main(String[] args) { 8 // Aquisio da sesso 9 AnnotationConfiguration configuration = new AnnotationConfiguration(); 10 configuration.configure(); 11 12 SessionFactory factory = configuration.buildSessionFactory(); 13 Session session = factory.openSession(); 14 15 // Criao do produto 16 Produto produto = new Produto(); 17 produto.setNome("Prateleira"); 18 produto.setDescricao("Uma prateleira para colocar livros"); 19 produto.setPreco(35.90);
Captulo 5 - Refatorando - Aprendendo a refatorar - Pgina 18

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

20 21 22 23 24 25 26 }

// Adio do produto no banco de dados Transaction tx = session.beginTransaction(); session.save(produto); 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.
1 package br.com.caelum.goodbuy.testes; 2 3 // imports 4 5 public class AdicaoDeProduto { 6 7 public static void main(String[] args) { 8 // Aquisio da sesso 9 AnnotationConfiguration configuration = new AnnotationConfiguration(); 10 configuration.configure(); 11 12 SessionFactory factory = configuration.buildSessionFactory(); 13 Session session = factory.openSession(); 14 15 // Criao do produto 16 Produto produto = new Produto(); 17 produto.setNome("Prateleira"); 18 produto.setDescricao("Uma prateleira para colocar livros"); 19 produto.setPreco(35.90); 20 21 // Adio do produto no banco de dados 22 Transaction tx = session.beginTransaction(); 23 session.save(produto); 24 tx.commit(); 25 } 26 }

2) Selecione as linhas que fazem a aquisio da sesso, conforme a gura abaixo:

Captulo 5 - Refatorando - Exerccios - Pgina 19

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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.

Captulo 5 - Refatorando - Exerccios - Pgina 20

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

5) Note como o Eclipse mudou seu cdigo, criando o mtodo getSession e fazendo a chamada a este mtodo. A classe deve estar assim:
public class AdicaoDeProduto {

public static void main(String[] args) { // Aquisio da sesso Session session = getSession(); // Criao do produto Produto produto = new Produto(); produto.setNome("Prateleira"); produto.setDescricao("Uma prateleira para colocar livros"); produto.setPreco(35.90); // Adio do produto no banco de dados Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } private static Session getSession() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); Session session = factory.openSession(); return session; } }

6) Faa o mesmo para as linhas de criao de produto e adio de produto no banco de dados. No nal, caremos com 3 mtodos, um chamado getSession, que j foi feito, outro chamado criaProduto e outro
Captulo 5 - Refatorando - Exerccios - Pgina 21

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

chamado gravaProduto. Lembre-se de utilizar as teclas de atalho que vimos nesse exerccio. 7) Para conferncia, caremos com a classe da seguinte forma:
1 package br.com.caelum.goodbuy.testes; 2 3 // imports 4 5 public class AdicaoDeProduto { 6 7 public static void main(String[] args) { 8 // Aquisio da sesso 9 Session session = getSession(); 10 11 // Criao do produto 12 Produto produto = criaProduto(); 13 14 // Adio do produto no banco de dados 15 gravaProduto(session, produto); 16 } 17 18 private static void gravaProduto(Session session, Produto produto) { 19 Transaction tx = session.beginTransaction(); 20 session.save(produto); 21 tx.commit(); 22 } 23 24 private static Produto criaProduto() { 25 Produto produto = new Produto(); 26 produto.setNome("Prateleira"); 27 produto.setDescricao("Uma prateleira para colocar livros"); 28 produto.setPreco(35.90); 29 return produto; 30 } 31 32 private static Session getSession() { 33 AnnotationConfiguration configuration = new AnnotationConfiguration(); 34 configuration.configure(); 35 36 SessionFactory factory = configuration.buildSessionFactory(); 37 Session session = factory.openSession(); 38 return session; 39 } 40 }

5.5 - Comentrios so sempre necessrios?


Note que o que zmos 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 cou 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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:
public class AdicaoDeProduto { public static void main(String[] args) { Session session = getSession(); Produto produto = criaProduto(); gravaProduto(session, produto); } // 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

3) Com as linhas selecionadas, pressione as teclas Alt + Shift + V (Move Method), para criar um mtodo com essas linhas. Aps pressionar essas teclas, aparecer a seguinte tela:

4) A tela que est sendo mostrada est esperando pela classe que car com esse mtodo. Pressione o boto Browse..., e busque pela classe CriadorDeSession, conforme a imagem abaixo:

Captulo 5 - Refatorando - Exerccios - Pgina 24

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

5) Aps encontrar a classe CriadorDeSession, pressione o boto OK para escolher essa classe, depois OK novamente para conrmar a mudana do mtodo para essa classe. 6) Aparecer uma tela avisando que a visibilidade do mtodo getSession ser alterada public. Conrme essa alterao pressionando o boto Continue.

Captulo 5 - Refatorando - Exerccios - Pgina 25

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

7) Repare como cou a classe aps essa alterao:


public class AdicaoDeProduto {

public static void main(String[] args) { Session session = CriadorDeSession.getSession(); Produto produto = criaProduto(); gravaProduto(session, produto); } private static void gravaProduto(Session session, Produto produto) { Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } private static Produto criaProduto() { Produto produto = new Produto(); produto.setNome("Prateleira"); produto.setDescricao("Uma prateleira para colocar livros"); produto.setPreco(35.90); return produto; } }

Captulo 5 - Refatorando - Exerccios - Pgina 26

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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. 10) Repare como cou a classe aps essa alterao:
public class AdicaoDeProduto {

public static void main(String[] args) { Session session = CriadorDeSession.getSession(); Produto produto = criaProduto(); ProdutoDao.gravaProduto(session, produto); } private static Produto criaProduto() { Produto produto = new Produto(); produto.setNome("Prateleira"); produto.setDescricao("Uma prateleira para colocar livros"); produto.setPreco(35.90); 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) { Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } }

Primeiro vamos tirar o static do mtodo gravaProduto.


public class ProdutoDao {

public void gravaProduto(Session session, Produto produto) { Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } }

12) A classe AdicaoDeProduto agora no compila. Vamos trocar o acesso esttico por acesso a uma instncia do dao:
Captulo 5 - Refatorando - Exerccios - Pgina 27

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public class AdicaoDeProduto {

public static void main(String[] args) { Session session = CriadorDeSession.getSession(); Produto produto = criaProduto(); 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 class ProdutoDao {

public void gravaProduto(Produto produto) { Session session = CriadorDeSession.getSession(); Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } }

Mude tambm a classe AdicaoDeProduto:


public class AdicaoDeProduto {

public static void main(String[] args) { Produto produto = criaProduto(); 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:
public class ProdutoDao {

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

Captulo 5 - Refatorando - Exerccios - Pgina 28

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public void gravaProduto(Produto produto) { Transaction tx = session.beginTransaction(); session.save(produto); tx.commit(); } }

15) Agora a chamada do mtodo gravaProduto est correta, porm repare como est um pouco redundante:
new ProdutoDao().gravaProduto(produto);

Seria melhor se fosse assim:


new ProdutoDao().salva(produto);

Vamos fazer essa mudana de nome de mtodo utilizando o Eclipse. Pressione as teclas Alt + Shift + R (rename) mtodo da classe ProdutoDao, e o Eclipse pedir o novo nome para o mtodo.

Digite salva como novo nome do mtodo.

Captulo 5 - Refatorando - Exerccios - Pgina 29

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 congurar


Uma das grandes vantagens do VRaptor que ele usa muitas convenes, ou seja, ao invs de termos que congurar tudo, como por exemplo no Struts, no precisamos congurar quase nada. Seguindo as convenes que o VRaptor usa, podemos criar apenas nossas lgicas (cdigo java) sem precisar escrever xmls ou properties. A nica congurao que precisamos fazer congurar o controlador do VRaptor. Essa congurao feita dentro do arquivo web.xml, o arquivo de congurao da aplicao.
<web-app ...> <!-- configura o controlador do VRaptor --> <filter> <filter-name>vraptor</filter-name> <filter-class>br.com.caelum.vraptor.VRaptor</filter-class> </filter> <filter-mapping> <filter-name>vraptor</filter-name> <url-pattern>/*</url-pattern> <dispatcher>FORWARD</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> </web-app>

31

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Essas conguraes 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 congurao do ltro no web.xml. Basta colocar o jar do VRaptor na pasta WEB-INF/lib e ele ser congurado 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 car 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 { public void boasVindas() { System.out.println("ol mundo!");

Captulo 6 - VRaptor - Primeiro exemplo com o VRaptor - Pgina 32

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 package br.com.caelum.goodbuy; import br.com.caelum.vraptor.Resource; @Resource public class Mundo { public void boasVindas() { System.out.println("ol mundo!"); } }

6.5 - Exerccios
1) Crie a classe Mundo no pacote br.com.caelum.goodbuy.
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 }

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 vericar o log da aplicao, na view Console do Eclipse, e ver que a mensagem apareceu.

Captulo 6 - VRaptor - Exerccios - Pgina 33

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

5) (Opcional) Crie outro mtodo, parecido com o que zemos, 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 conguraes. A conveno de redirecionamento de pginas aps a lgica a seguinte:
/WEB-INF/jsp/{nomeDoResource}/{lgica}.jsp

Para nosso caso, temos a seguinte situao:

{nomeDoResource} = Mundo {lgica} = boasVindas()


O VRaptor ir fazer algumas modicaes nesses valores. A primeira letra do nome do resource, que para ns o nome da classe, ser passado para minsculo. O resto do nome continuar igual. J o nome da lgica continuar igual, mas sem os parnteses. Ento o VRaptor 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 car 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) Verique se o console mostra a mensagem ol mundo!, e verique se o browser exibe a mensagem Ol Mundo.

Captulo 6 - VRaptor - Exerccios - Pgina 35

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 cava 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 package br.com.caelum.goodbuy; @Resource public class Mundo { 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 car assim:
Mensagem vinda da lgica: ${string}

Captulo 6 - VRaptor - Disponibilizando informaes para a view - Pgina 36

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Como utilizamos o retorno do mtodo para disponibilizar informaes para a view, no temos como dar um nome signicativo para utilizar depois. O VRaptor usa a conveno de buscar o tipo do retorno, nesse nosso caso uma String, e disponibilizar para a 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 zemos 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 zemos anteriormente. O cdigo caria assim:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 package br.com.caelum.goodbuy; @Resource public class Mundo { public String boasVindas() { return "ol mundo!"; } public List<String> paises() { List<String> result = new ArrayList<String>(); result.add("Brasil"); result.add("Portugal"); result.add("Japo"); result.add("Canad"); result.add("Paraguai"); return result; } }

Na nossa view, podemos imprimir os valores dessa coleo da seguinte forma:


Pases vindos da lgica: ${stringList}

Note que agora o valor passado na expression language foi ${stringList}. O VRaptor identica que 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

6.10 - Exerccios
1) Altere o mtodo boasVindas() da classe Mundo para retornar uma String.
1 package br.com.caelum.goodbuy; 2 3 @Resource 4 public class Mundo { 5 6 public String boasVindas() { 7 return "ol mundo!"; 8 } 9 10 }

2) Altere o jsp boasVindas.jsp, que est dentro da pasta WEB-INF/jsp/mundo.


Mensagem vinda da lgica: ${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 car assim:
public List<String> paises() { List<String> result = new ArrayList<String>(); result.add("Brasil"); result.add("Portugal"); result.add("Japo"); result.add("Canad"); result.add("Paraguai"); return result; }

Captulo 6 - VRaptor - Exerccios - Pgina 38

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

5) Crie um jsp em WEB-INF/jsp/mundo chamado paises.jsp. O contedo deve ser esse:


Pases vindos da lgica: ${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?

Captulo 6 - VRaptor - Exerccios - Pgina 39

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 suxo Controller. Vimos que o nome da classe utilizado pelo VRaptor para registrar esse componente, para que quando zermos uma chamada do browser, essa classe seja encontrada e algum mtodo seja invocado. Mas utilizando o nome ProdutosController, o VRaptor ir mapear essa classe para apenas /produtos, removendo o suxo 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 ca assim:
public class ProdutoDao { //... 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Olhando para esse mtodo, que no incio tnhamos denido para ser nossa regra de negcio, ser que temos apenas isso? Ser que apenas listamos os produtos? Na verdade esse mtodo est fazendo mais tarefas do que deveria. Ele possui algumas responsabilidades extras, por exemplo criar o ProdutoDao. A nica parte que a regra de negcio para esse caso a chamada ao dao.listaTudo(). O resto apenas infraestrutura para permitir executar essa tarefa. Avaliando esse problema, podemos perceber que estamos buscando recursos, nesse caso um dao, e portanto nos preocupando demasiadamente com os mesmos. Se buscar um recurso ruim, seja pela complexidade ou diculdade no acesso, e tambm por no fazer parte da regra de negcio, que tal se ao invs de cri-lo, recebssemos o mesmo?
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 package br.com.caelum.goodbuy.controller; // imports @Resource public class ProdutosController { private ProdutoDao dao; public ProdutosController(ProdutoDao dao) { this.dao = dao; } public List<Produto> lista() { return dao.listaTudo(); } }

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<th>Descrio</th> <th>Preo</th> </tr> </thead> <tbody> <c:forEach items="${produtoList}" var="produto"> <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 conana de que o objeto referenciado pela varivel controller est preparado para ter seus mtodos invocados. Dessa maneira injetamos todas as nossas dependncias durante a instanciao do controlador, um trabalho manual que car extremamente repetitivo e propcio a erro a medida que aumenta o nmero de dependncias de nossa classe.

Captulo 7 - Criando o Controlador de Produtos - Quais so minhas dependncias? - Pgina 42

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

7.3 - Injeo de Dependncias


Sendo assim, ca muito mais fcil se zermos 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 zer isso, como ele descobrir sobre interligaes entre as dependncias? Uma vez que precisamos da classe ProdutoDao como dependncia nossa, precisamos noticar o framework que o mesmo se encarregar de gerenciar as instncias de ProdutoDao, isto , nesse caso especco, ele criar uma instncia e utilizar como argumento para o construtor. Para fazer isso, basta anotarmos essa classe com @Component.
package br.com.caelum.goodbuy.dao; // imports import br.com.caelum.vraptor.ioc.Component; @Component public class ProdutoDao { //... }

Agora a classe ProdutoDao tambm ser controlada pelo VRaptor. Dessa forma, quando o VRaptor for instanciar a classe ProdutosController, ele vericar 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, especique 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public class ProdutoDao { //... public List<Produto> listaTudo() { return this.session.createCriteria(Produto.class).list(); } }

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 import br.com.caelum.vraptor.Resource; @Resource public class ProdutosController { public List<Produto> lista() { } }

4) Crie o construtor que recebe uma instncia de ProdutoDao, e guarde essa instncia em um atributo.
1 package br.com.caelum.goodbuy.controller; 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// imports import br.com.caelum.vraptor.Resource; @Resource public class ProdutosController { private final ProdutoDao dao; public ProdutosController(ProdutoDao dao) { this.dao = dao; } public List<Produto> lista() { } }

5) No mtodo lista, faa a chamada ao mtodo listaTudo do dao.


1 package br.com.caelum.goodbuy.controller; 2
Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 44

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

// imports import br.com.caelum.vraptor.Resource; @Resource public class ProdutosController { private final ProdutoDao dao; public ProdutosController(ProdutoDao dao) { this.dao = dao; } public List<Produto> lista() { return dao.listaTudo(); }

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> <c:forEach items="${produtoList}" var="produto"> <tr> <td>${produto.nome }</td> <td>${produto.descricao }</td> <td>${produto.preco }</td> </tr> </c:forEach> </tbody> </table>

8) Acesse a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista.

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 45

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

9) Deu uma exception! A informao mais importante dela est no nal da Stacktrace:
... Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No unique bean of type [br.com.caelum.goodbuy.dao.ProdutoDao] is defined: Unsatisfied dependency of type [class br.com.caelum.goodbuy.dao.ProdutoDao]: expected at least 1 matching bean at org.springframework.beans.factory.support....

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.
package br.com.caelum.goodbuy.dao;

// imports import br.com.caelum.vraptor.ioc.Component; @Component public class ProdutoDao { //... }

11) Se acessarmos de novo a URI que executa o mtodo lista: http://localhost:8080/goodbuy/produtos/lista veremos a listagem de produtos:

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 46

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 package br.com.caelum.goodbuy.controller; // imports @Resource public class ProdutosController { public void adiciona(Produto produto) { ProdutoDao dao = new ProdutoDao(); 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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. Reection no nome dos parmetros Infelizmente, o Java no realiza reection em cima de parmetros, esses dados no cam 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 car 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 cam sempre na pasta WEB-INF, no temos como acessar diretamente pelo browser um jsp. Para acessar a pgina que acabamos de criar, vamos criar um mtodo na classe ProdutosController para chamar nossa pgina, usando a conveno do VRaptor.
@Resource public class ProdutosController {
Captulo 7 - Criando o Controlador de Produtos - Criando o formulrio HTML - Pgina 48

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

// 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.
1 package br.com.caelum.goodbuy.controller; 2 public class ProdutosController { 3 4 //... 5 6 public void adiciona(Produto produto) { 7 dao.salva(produto); 8 } 9 10 }

2) Na pasta WEB-INF/jsp/produtos, crie o arquivo formulario.jsp.

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 49

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

3) Abra o arquivo que acabamos de criar e coloque os campos para de digitao, assim como o boto e o formulrio.
<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>

4) Na pasta WEB-INF/jsp/produtos, crie o arquivo adiciona.jsp com o contedo.


<h3>Produto adicionado com sucesso!</h3>

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 50

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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. 8) Abra o arquivo header.jspf e procure a div com id="menu . Adicione um link dentro do menu para acessar o formulrio:
<div id="menu"> <ul> <li><a href="<c:url value="/produtos/formulario"/>">Novo Produto</a></li> <li><a href="<c:url value="/produtos/lista"/>">Lista Produtos</a></li> </ul> </div>

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 51

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 suciente? 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 nal 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 public class ProdutosController { private final ProdutoDao dao; 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 caria:


@Resource public class ProdutosController { private final ProdutoDao dao; private final Result result; public ProdutosController(ProdutoDao dao, Result result) { this.dao = dao; this.result = result; }

Captulo 7 - Criando o Controlador de Produtos - Redirecionar para listagem depois de adicionar - Pgina 52

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public void adiciona(Produto produto) { dao.salva(produto); result.redirectTo(ProdutosController.class).lista(); } public void formulario() { } public List<Produto> lista() { return dao.listaTudo(); } }

Repare que no foi necessrio criar arquivos de congurao para fazer essa mudana de conveno, tudo feito no prprio mtodo. Ao olhar para o mtodo adiciona ca claro que o resultado dele no vai ser o adiciona.jsp, vai ser a lgica lista do ProdutosController. Como o redirecionamento para uma lgica do mesmo controller voc pode ainda usar um comando mais enxuto:
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 especicada, desse modo possvel mudar o resultado de uma lgica sem mudanas do lado do cliente. No use esse redirecionamento em requisies POST. Alm disso, podemos redirecionar nossa requisio para pginas usando outros mtodos:

result.forwardTo(/uma/outra/pagina.jsp): redirecionamento do lado do servidor para a pgina especicada.

result.redirectTo(/uma/outra/pagina.jsp): redirecionamento do lado do cliente para a pgina especicada. result.of(ProdutosController.class).lista(): redireciona para a pgina da lgica especicada, 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 zemos anteriormente result.redirectTo(ProdutosController.class).lista() na verdade um atalho para result.use(Results.logic()).redirectTo(ProdutosController.class).lista().
Captulo 7 - Criando o Controlador de Produtos - Redirecionar para listagem depois de adicionar - Pgina 53

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 e 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.
import br.com.caelum.vraptor.Result;

@Resource public class ProdutosController { private final ProdutoDao dao; private final Result result; public ProdutosController(ProdutoDao dao, Result result) { this.dao = dao; this.result = result; } //... }

2) Mude o resultado da lgica adiciona para redirecionar para a lgica lista.


@Resource public class ProdutosController { private final ProdutoDao dao; private final Result result; public ProdutosController(ProdutoDao dao, Result result) { this.dao = dao; this.result = result; } public void adiciona(Produto produto) { dao.salva(produto); result.redirectTo(this).lista(); } public void formulario() { }
Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 54

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public List<Produto> lista() { return dao.listaTudo(); } }

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 class ProdutosController { 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 class ProdutosController { 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 }" /> <label for="nome">Nome:</label> <input id="nome" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </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 class ProdutosController { //... public void altera(Produto produto) { dao.atualiza(produto); } }

Captulo 7 - Criando o Controlador de Produtos - Atualizando e removendo produtos - Pgina 56

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Assim como na lgica adiciona, zemos um POST num formulrio, ento ao invs de colocar uma jsp com uma mensagem de Produto alterado com sucesso, vamos redirecionar para a listagem de produtos.
public class ProdutosController { //... public void altera(Produto produto) { dao.atualiza(produto); result.redirectTo(this).lista(); }

Agora precisamos de um jeito fcil de editar um produto. Vamos ento adicionar um link para editar o produto, na listagem:
<c:forEach items="${produtoList}" var="produto"> <tr> <td>${produto.nome }</td> <td>${produto.descricao }</td> <td>${produto.preco }</td> <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.
public void remove(Long id) { Produto produto = dao.carrega(id); dao.remove(produto); result.redirectTo(ProdutosController.class).lista(); }

Assim como criamos o link para a edio, vamos criar um link para a remoo:
<c:forEach items="${produtoList}" var="produto"> <tr> <td>${produto.nome }</td> <td>${produto.descricao }</td> <td>${produto.preco }</td> <td><a href="edita?id=${produto.id }">Editar</a></td> <td><a href="remove?id=${produto.id }">Remover</a></td> </tr> </c:forEach>

Captulo 7 - Criando o Controlador de Produtos - Atualizando e removendo produtos - Pgina 57

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

7.11 - Exerccios
1) Crie as lgicas para edio de produtos no ProdutosController:
public Produto edita(Long id) { return dao.carrega(id); } public void altera(Produto produto) { dao.atualiza(produto); result.redirectTo(this).lista(); }

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) { Transaction tx = session.beginTransaction(); this.session.update(produto); tx.commit(); }

3) Crie o formulrio de edio no arquivo /WEB-INF/jsp/produtos/edita.jsp.


<form action="altera"> <fieldset> <legend>Editar Produto</legend> <input type="hidden" name="produto.id" value="${produto.id }" /> <label for="nome">Nome:</label> <input id="nome" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </fieldset> </form>

4) Modique a listagem de produtos /WEB-INF/jsp/produtos/lista.jsp:

para

incluir

um

link

para

edio,

no

arquivo

<c:forEach items="${produtoList}" var="produto"> <tr>


Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 58

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<td>${produto.nome }</td> <td>${produto.descricao }</td> <td>${produto.preco }</td> <td><a href="edita?id=${produto.id }">Editar</a></td> </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.

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 59

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

6) Crie agora a lgica de remoo na classe ProdutosController:


public void remove(Long id) { Produto produto = dao.carrega(id); dao.remove(produto); result.redirectTo(this).lista(); }

7) Implemente o mtodo remove no ProdutoDao.


public void remove(Produto produto) { Transaction tx = session.beginTransaction(); this.session.delete(produto); tx.commit(); }

8) Modique a listagem de produtos, adicionando o link para remoo


<c:forEach items="${produtoList}" var="produto"> <tr> <td>${produto.nome }</td> <td>${produto.descricao }</td> <td>${produto.preco }</td> <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.

Captulo 7 - Criando o Controlador de Produtos - Exerccios - Pgina 60

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 class ProdutoDao { private final Session session; public ProdutoDao(Session session) { this.session = session; } //... }

Mas como falar que a Session pode ser usada como dependncia? Poderamos fazer a mesma alterao que zemos no ProdutoDao, anotando a classe Session do pacote org.hibernate com @Component. Assim, a sesso do Hibernate 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 dene um nico mtodo, o getInstance. Criando essa classe, podemos denir a lgica de criao de um determinado objetos, e o VRaptor usar a instncia retornada para passar como dependncia para outras classes. No nosso caso, podemos criar uma classe que cria sesses do Hibernate. J temos uma classe que cria uma classe que nos d uma instncia de Session: a CriadorDeSession, ento para transform-la em um ComponentFactory basta implementar a interface. Mas o mtodo que nos d a Session se chama getSession, e a interface espera que o mtodo se chame getInstance. E, por ltimo, anotamos a classe com @Component para que o VRaptor saiba como cri-la. A classe car assim:
import br.com.caelum.vraptor.ioc.ComponentFactory; @Component public class CriadorDeSession implements ComponentFactory<Session> { public Session getInstance() {

62

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); Session session = factory.openSession(); 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, congura, constri uma SessionFactory, e s ento abre uma sesso. No seria suciente s abrir uma sesso a partir da SessionFactory? A SessionFactory uma dependncia para criar uma Session. Ento vamos receb-la no construtor da classe.
@Component public class CriadorDeSession implements ComponentFactory<Session> { private final SessionFactory factory; public CriadorDeSession(SessionFactory factory) { this.factory = factory; } public Session getInstance() { 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() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); 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 zemos 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 public class ProdutoDao { private final Session session; public ProdutoDao(Session session) { this.session = session; } //... }

2) Modique a classe CriadorDeSession. Faa com que essa classe implemente a interface ComponentFactory, passando a Session como tipo genrico. Renomeie o mtodo getSession para getInstance, e remova o static.
import br.com.caelum.vraptor.ioc.ComponentFactory;

@Component public class CriadorDeSession implements ComponentFactory<Session> { public Session getInstance() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); SessionFactory factory = configuration.buildSessionFactory(); Session session = factory.openSession(); 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 car assim:
1 package br.com.caelum.goodbuy.infra; 2 3 // imports 4 5 public class CriadorDeSession implements ComponentFactory<Session> { 6 7 public CriadorDeSession(SessionFactory factory) { 8 } 9 10 public Session getInstance() { 11 Session session = factory.openSession(); 12 return session;
Captulo 8 - Refatorando os DAOs - Exerccios - Pgina 64

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 x) 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>.
1 package br.com.caelum.goodbuy.infra; 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 denido na interface. Para isso utilize as teclas de atalho do Eclipse: coloque o cursor no nome da classe e digite Ctrl+1. Selecione a opo Add unimplemented methods. Coloque a criao da fbrica de sesses que voc tinha recortado da outra classe nesse mtodo.
1 package br.com.caelum.goodbuy.infra; 2 3 // imports 4 5 public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory> { 6 7 public SessionFactory getInstance() { 8 AnnotationConfiguration configuration = new AnnotationConfiguration(); 9 configuration.configure(); 10 11 SessionFactory factory = configuration.buildSessionFactory();
Captulo 8 - Refatorando os DAOs - Exerccios - Pgina 65

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

12 13 14 15 }

return factory; }

8) Anote a classe com @Component, para indicar que essa classe uma dependncia e pode ser instanciada pelo VRaptor sempre que necessrio. 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 denidos pelo VRaptor


O VRaptor nos permite denir o tempo de vida de instncias de determinada classe. Esse tempo de vida importante porque cada componente tem uma responsabilidade, e alguns devem sobreviver por mais tempo que outros. 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 caria nica para toda a aplicao, e qualquer cliente que precisar de uma sesso, usaramos essa fbrica. Para cada cenrio acima, o VRaptor deniu um tempo de vida. Esse tempo de vida no VRaptor chamado de escopo. O VRaptor dene quatro escopos, e para utiliz-los, basta anotarmos nossos componentes com uma das seguintes anotaes:

@RequestScoped - o componente ser criado a cada requisio. o escopo padro dos componentes. @SessionScoped - o componente ser criado uma vez por sesso (HttpSession) de usurio @ApplicationScoped - o componente ser criado uma nica vez na aplicao. @PrototypeScoped - o componente ser criado toda vez que for solicitado.
Para nossa classe CriadorDeSessionFactory, queremos ter apenas uma instncia dessa classe para toda nossa aplicao, ento vamos anot-la com @ApplicationScoped.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 package br.com.caelum.goodbuy.infra; // imports @Component @ApplicationScoped public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory> { public SessionFactory getInstance() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); 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>{ private final SessionFactory factory; public CriadorDeSessionFactory() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); factory = configuration.buildSessionFactory(); }
Captulo 8 - Refatorando os DAOs - Escopos denidos pelo VRaptor - Pgina 67

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public SessionFactory getInstance() { 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 nalizado, ou seja, no
nal da requisio, sesso de usurio ou da aplicao. Desse modo, podemos usar um mtodo anotado com @PostConstruct para criar a fbrica de sesses, e como uma boa prtica fechar todos os recursos que abrimos, devemos criar um mtodo anotado com @PreDestroy que vai fechar a fbrica. Fazendo essas modicaes, nossa classe caria assim:
@Component @ApplicationScoped public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory>{ private SessionFactory factory; @PostConstruct public void abre() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); this.factory = configuration.buildSessionFactory();; } public SessionFactory getInstance() { 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.

Captulo 8 - Refatorando os DAOs - Escopos denidos pelo VRaptor - Pgina 68

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 nal da requisio? Utilizando as anotaes que vimos na sesso anterior, @PostConstruct e @PreDestroy, conseguimos fazer um cdigo muito elegante e de fcil entendimento. Na classe CriadorDeSession, podemos criar dois mtodos, 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 caria 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 package br.com.caelum.goodbuy.infra; // imports @Component public class CriadorDeSession implements ComponentFactory<Session> { private final SessionFactory factory; private Session session; public CriadorDeSession(SessionFactory factory) { this.factory = factory; } @PostConstruct public void abre() { this.session = factory.openSession(); } public Session getInstance() { return this.session; } @PreDestroy public void fecha() { 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

1) Anote a classe CriadorDeSessionFactory com @ApplicationScoped.


1 package br.com.caelum.goodbuy.infra; 2 3 4 5 6 7 8 9

// imports @Component @ApplicationScoped public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory> { //... }

2) Refatore essa classe para que seja criado apenas uma instncia da fbrica.
1 package br.com.caelum.goodbuy.infra; 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 public class CriadorDeSessionFactory implements ComponentFactory<SessionFactory>{ private SessionFactory factory; @PostConstruct public void abre() { AnnotationConfiguration configuration = new AnnotationConfiguration(); configuration.configure(); this.factory = configuration.buildSessionFactory();; } public SessionFactory getInstance() { return this.factory; } @PreDestroy public void fecha() { this.factory.close(); } }

3) Refatore a classe CriadorDeSession, colocando os mtodos de callback e colocando a sesso do Hibernate em um atributo.
@Component public class CriadorDeSession implements ComponentFactory<Session> { private final SessionFactory factory; private Session session; public CriadorDeSession(SessionFactory factory) { this.factory = factory;
Captulo 8 - Refatorando os DAOs - Exerccios - Pgina 70

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

} @PostConstruct public void abre() { this.session = factory.openSession(); } public Session getInstance() { return this.session; } @PreDestroy public void fecha() { this.session.close(); } }

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 uxo de cadastro de um usurio. Esse uxo pode ser feito de qualquer forma, com echas e caixas de texto por exemplo. O ponto importante desse exerccio car claro como est a arquitetura do seu projeto.

Captulo 8 - Refatorando os DAOs - Exerccios - Pgina 71

C APTULO

Validando formulrios
Quando temos um formulrio para adicionar dados no nosso sistema, geralmente precisamos vericar se os dados esto corretos e consistentes. Por exemplo no gostaramos que o usurio digitasse vinte e trs reais no campo preo, ou que o campo nome fosse vazio. Ento, antes de salvar esses dados no banco precisamos vericar se tudo est como esperamos. Chamamos isso de validao. Existem duas maneiras de fazer validao:

Validao do lado do cliente: vericamos os dados antes de mandar os dados para o servidor, assim o
feedback da validao instantneo.

Validao do lado do servidor: os dados so enviados para o servidor, e se houver erros, o servidor
devolve esses erros para o cliente. A validao do lado do cliente geralmente feita usando javascript, impedindo que o formulrio seja 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, especicar para onde deve ser redirecionada a requisio. Para obter um Validator basta receb-lo no construtor do seu Controller:
import br.com.caelum.vraptor.Validator; @Resource public class ProdutosController { private final ProdutoDao dao; private final Result result; private final Validator validator; public ProdutosController(ProdutoDao dao, Result result, Validator validator) { this.dao = dao; this.result = result; 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Para isso vamos denir 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:


public void adiciona(Produto produto) { 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) { validator.add(new ValidationMessage( "Descrio obrigatria e no pode ter mais que 40 letras", "produto.descricao")); } if (produto.getPreco() <= 0.0) { validator.add(new ValidationMessage( "Preo precisa ser positivo", "produto.preco")); } dao.salva(produto); result.redirectTo(this).lista(); }

maneira uente: 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); result.redirectTo(this).lista(); }

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

descricao.obrigatoria = Descrio obrigatria e no pode ter mais que 40 letras preco.positivo = Preo precisa ser positivo

Em ambas as maneiras voc precisa especicar pra qual lgica voltar quando der erro de validao. No nosso caso, ao dar erro queremos voltar pro formulrio, ento fazemos:
validator.onErrorUsePageOf(ProdutosController.class).formulario();

A lgica de redirecionamento a mesma que se voc estivesse usando o result.of(). Voc deve colocar essa chamada logo no nal da sua lgica de validao, no momento em que, se houver algum erro, a execuo deve parar e voltar para o formulrio, mostrando os erros. 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:
<form action="adiciona"> <fieldset> <legend>Adicionar Produto</legend> <label for="nome">Nome:</label> <input id="nome" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </fieldset> </form>

9.2 - Exerccios
1) Receba um Validator no construtor do ProdutosController e guarde-o num atributo:
import br.com.caelum.vraptor.Validator;

Captulo 9 - Validando formulrios - Exerccios - Pgina 74

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

@Resource public class ProdutosController { private final ProdutoDao dao; private final Result result; private final Validator validator; public ProdutosController(ProdutoDao dao, Result result, Validator validator) { this.dao = dao; this.result = result; this.validator = validator; } //... }

2) Modique o mtodo adiciona para que inclua a validao dos campos do produto. Se preferir, faa a validao na forma uente.
public void adiciona(final Produto produto) { 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) { validator.add(new ValidationMessage( "Descrio obrigatria no pode ter mais que 40 letras", "produto.descricao")); } if (produto.getPreco() <= 0) { validator.add(new ValidationMessage( "Preo precisa ser positivo", "produto.preco")); } validator.onErrorUsePageOf(ProdutosController.class).formulario(); dao.salva(produto); result.redirectTo(this).lista(); }

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:
<form action="adiciona">
Captulo 9 - Validando formulrios - Exerccios - Pgina 75

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<fieldset> <legend>Adicionar Produto</legend> <label for="nome">Nome:</label> <input id="nome" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </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 vericam as regras mais comuns, como campos obrigatrios, tamanhos mnimos e cartes de crdito. Alm disso, o framework tambm bastante exvel, j que permite a criao dos seus prprios validadores. Para denir as regras de validao, basta anotar os campos do nosso modelo que precisam ser validados. Para tal, usaremos as anotaes prontas no Hibernate Validator. Alguns exemplos:

@NotNull, para campos obrigatrios @NotEmpty, idem, mas tambm no aceita String vazia @Length, para impor restries sobre o tamanho (min e max) @Min e @Max, para restringir o valor de nmeros
Captulo 9 - Validando formulrios - Para saber mais: Hibernate Validator - Pgina 76

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

@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 public class Produto { @Id @GeneratedValue private Long id; @NotNull @Length(min=3) private String nome; @NotNull @Length(max=40) private String descricao; @Min(0) private Double }

preco;

Com nosso modelo anotado, podemos substituir as validaes que zemos pelo Hibernate Validator. O interface Validator do VRaptor possui um mtodo chamado validate que valida qualquer objeto usando o Hibernate Validator. Assim, se voc chamar:
validator.validate(produto)

todos os erros de validao que 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.
import org.hibernate.validator.Length; import org.hibernate.validator.Min; import org.hibernate.validator.NotNull;
Captulo 9 - Validando formulrios - Exerccios Opcionais - Pgina 77

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

@Entity public class Produto { @Id @GeneratedValue private Long id; @NotNull @Length(min=3) private String nome; @NotNull @Length(max=40) private String descricao; @Min(0) private Double }

preco;

3) Mude a lgica de validao do mtodo adiciona do ProdutosController para usar o Hibernate Validator:
@Resource public class ProdutosController { //... public void adiciona(final Produto produto) { validator.validate(produto); validator.onErrorUsePageOf(ProdutosController.class).formulario(); dao.salva(produto); result.redirectTo(this).lista(); } }

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.

Captulo 9 - Validando formulrios - Exerccios Opcionais - Pgina 78

C APTULO

10

REST
10.1 - O que REST
REST um conjunto de restries que dene um padro arquitetural com caractersticas especcas: benefcios e diculdades 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 especcas para aumentar a escalabilidade ou a segurana do seu sistema. Utilizar o protocolo HTTP no somente como uma maneira de transmitir dados mas tambm como um protocolo de aplicao permite maior visibilidade para os componentes intermedirios. Contedo hipermdia permite a navegabilidade de um cliente atravs do seu sistema, alm de diminuir o acoplamento entre o cliente e o servidor, que costuma ser muito alto em aplicaes orientadas a servio. O tpico de hipermdia bem amplo e no ser abordado no curso, sugerimos a visita ao site do 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 (Unied Resource Identier ), ou seja, o identicador nico de um recurso. Ento ao criar as URIs do nosso sistema devemos levar em conta que elas representam recursos, no aes. Em sistemas REST, nossas URIs devem conter apenas substantivos, que so nossos recursos: /produtos/adiciona no boa, pois contm um verbo e no est identicando um recurso, mas sim uma operao. Para representar a adio de um produtos podemos usar a URI /produtos com o mtodo HTTP POST, que representa que estamos adicionando alguma informao no sistema.

79

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Verbos: Operaes
Uma das caracterstas mais importantes de REST que voc tenha um conjunto pequeno e xo de operaes bem denidas, gerando uma interface uniforme. Desse modo, para duas aplicaes conversarem elas no precisam implementar diversas operaes: basta usar as operaes denidas. Perceba que adicionar um produto e adicionar um usurio no sistema so operaes equivalentes. O protocolo HTTP possui sete operaes -- os mtodos GET, POST, PUT, DELETE, HEAD, OPTIONS e TRACE. Duas delas (GET e POST) j so bem conhecidas e utilizadas: GET quando clicamos em links ou digitamos o endereo no navegador, e POST quando preenchemos formulrios de cadastro. Cada mtodo tem uma semntica diferente e juntando o mtodo URI deveramos conseguir representar todas as aes do nosso sistema. As semnticas principais so:

GET - recupera informaes sobre o recurso identicado pela URI. Ex: listar produtos, visualizar o produto
45. Uma requisio GET no deve modicar nenhum recurso do seu sistema, ou seja, no deve ter nenhum efeito colateral, voc apenas recupera informaes do sistema.

POST - adiciona informaes usando o recurso da URI passada. Ex: adicionar um produto. Pode adicionar informaes a um recurso ou criar um novo recurso.

PUT - adiciona (ou modica) um recurso na URI passada. Ex: atualizar um produto. A diferena fundamental entre um PUT e um POST que no POST a URI signica o lugar que vai tratar a informao, e no PUT signica 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

import br.com.caelum.vraptor.Path; @Resource public class ProdutosController { @Path("/produtos") public List<Produto> lista() { return dao.listaTudo(); } }

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 identicar recursos (alm de no conter verbos, mas vamos tir-los em breve), e o id algo que identica o recurso que queremos acessar, ento caria melhor se passssemos esse id dentro da URI, como por exemplo:
/produto/10/edita

ou seja, uma URI que representa a edio do produto de id 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") public Produto edita(Long id) { return dao.carrega(id); }

Assim possvel criar URIs mais representativas, que identicam verdadeiramente recursos especcos.

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

import br.com.caelum.vraptor.Path; import br.com.caelum.vraptor.Get; @Resource public class ProdutosController { @Path("/produtos") @Get public List<Produto> lista() { return dao.listaTudo(); } }

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.Path; import br.com.caelum.vraptor.Get; import br.com.caelum.vraptor.Post; @Resource public class ProdutosController { @Path("/produtos") @Post public void adiciona(Produto produto) { //... } @Path("/produtos") @Get public List<Produto> lista() { return dao.listaTudo(); } }

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

A URI /produtos representa a lista de todos os produtos do sistema. E as operaes possveis so:
GET /produtos => recupera a lista de todos os produtos. Mtodo lista. POST /produtos => adiciona um produto na lista de todos os produtos. Mtodo adiciona.

As URIs do tipo /produtos/42 representam um produto especco, no caso de id 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 xos, 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 denidos. No nosso caso precisamos de uma URI para identicar o formulrio de adio de um produto. Vamos ento usar a seguinte:
GET /produtos/novo => mostra o formulrio para adicionar um novo produto. Mtodo formulario.

Com essa especicao de operaes no recurso Produto, podemos usar as anotaes vistas anteriormente para deixar o ProdutosController de acordo com ela:
@Resource public class ProdutosController { @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.
Captulo 10 - REST - Refatorando o ProdutosController - Pgina 83

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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, especicando qual deveria ser o mtodo da requisio. No VRaptor, esse
parmetro deve se chamar _method. Ento, para criar o link de remoo, precisamos criar um formulrio (no podemos usar um <a href> pois isso geraria uma requisio 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:
<!-- Esse pedao de css j est adicionado no projeto base --> <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> <legend>Editar Produto</legend>

Captulo 10 - REST - Refatorando o ProdutosController - Pgina 84

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<label for="nome">Nome:</label> <input id="nome" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" type="text" name="produto.preco" value="${produto.preco }"/> <!-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 especicao de Produto:
Recurso Produto: GET /produtos => recupera a lista de todos os produtos. Mtodo lista. POST /produtos => adiciona um novo produto. Mtodo adiciona. GET /produtos/4 => mostra o produto de id 4. Mtodo edita. PUT /produtos/10 => atualiza o produto de id 10. Mtodo atualiza. DELETE /produtos/3 => remove o produto de id 3. Mtodo remove. GET /produtos/novo => mostra o formulrio para adicionar um novo produto. Mtodo formulario.

2) Abra o formulario.jsp e mude a action do form:


<form action="<c:url value="/produtos"/>" method="POST">

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 action="<c:url value="/produtos/${produto.id }"/>" method="POST"> <!-- ... --> <button type="submit" name="_method" value="PUT">Enviar</button> </form>

4) Modique 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<td> <form action="<c:url value="/produtos/${produto.id}"/>" method="POST"> <button class="link" name="_method" value="DELETE">Remover</button> </form> </td>

5) Abra o header.jspf e modique os links do menu:


<div id="menu"> <ul> <li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li> <li><a href="<c:url value="/produtos"/>">Lista Produtos</a></li> </ul> </div>

Captulo 10 - REST - Exerccios - Pgina 86

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 modicar 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 modica 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 especico: 87

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

$(#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 zemos 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 zermos 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:
<form action="<c:url value="/produtos"/>" method="POST"> <fieldset> <legend>Adicionar produtos</legend> <label for="nome">Nome:</label> <input id="nome" class="required" minlength="3"
Captulo 11 - AJAX e efeitos visuais - Validando formulrios com o JQuery - Pgina 88

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" class="required" maxlength="40" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" min="0" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </fieldset> </form>

Se voc no gosta de colocar mais atributos nos seus campos de formulrio, voc ainda pode denir todas as regras de validao de uma vez s, usando os names dos inputs, dentro da parte rules:
<script type="text/javascript"> $(#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 class ProdutosController { //... public List<Produto> busca(String nome) { return dao.busca(nome); } }

Captulo 11 - AJAX e efeitos visuais - Criando a busca de produtos - Pgina 89

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Repare que o nosso dao ainda no possui o mtodo busca, mas podemos usar o eclipse para criar esse mtodo pra ns. Para isso, coloque o cursor em cima do erro de compilao e aperte Ctrl+1. No menu que apareceu selecione Create method busca(String) in type ProdutoDao.

Agora podemos modicar o mtodo criado no ProdutoDao para realmente buscar os produtos que contm a string passada no nome. Para isso usaremos a API de Criteria do Hibernate:
@Component public class ProdutoDao { //... public List<Produto> busca(String nome) { 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:
public List<Produto> busca(String nome) { result.include("nome", nome); return dao.busca(nome); }

Captulo 11 - AJAX e efeitos visuais - Criando a busca de produtos - Pgina 90

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Por ltimo, vamos criar um formulrio para poder acessar essa busca. Abra o arquivo header.jspf e modique o div menu:
<div id="menu"> <ul> <li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li> <li><a href="<c:url value="/produtos"/>">Lista Produtos</a></li> <li><form action="<c:url value="/produto/busca"/>"> <input name="nome"/> </form> </li> </ul> </div>

Para que no que um input perdido no menu, sem que as pessoas saibam o que ele faz, podemos usar um plugin do JQuery bem simples chamado Puts (http://github.com/cairesvs/Puts). Esse plugin coloca um texto em cima do input, e quando a pessoa clica nele, o texto some. Assim podemos colocar o texto Busca de produtos por nome no nosso input. Para usar esse plugin, precisamos baixar o javascript e import-lo na nossa pgina, e ento usar o mtodo puts() para colocar nosso texto.
<script type="text/javascript" src="<c:url value="/javascripts/jquery.puts.js"/>"></script> ... <li><form action="<c:url value="/produto/busca"/>"> <input id="busca" name="nome"/> </form> <script type="text/javascript"> $("#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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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:

Captulo 11 - AJAX e efeitos visuais - Melhorando a busca: Autocomplete - Pgina 92

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

import static br.com.caelum.vraptor.view.Results.*; //... @Get @Path("/produtos/busca.json") public void buscaJson(String nome) { result.use(json()).from(dao.busca(nome)) .exclude("id", "descricao") .serialize(); }

Gerando o seguinte json:


{"list": [ { "nome": "Sabonete", "preco": "3.53" }, { "nome": "Sapato", "preco": "132.00" } ]}

Podemos tambm remover o {list": } usando o mtodo .withoutRoot():


result.use(json()).withoutRoot() .from(dao.busca(nome)) .exclude("id", "descricao") .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"

Captulo 11 - AJAX e efeitos visuais - Melhorando a busca: Autocomplete - Pgina 93

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

src="<c:url value="/javascripts/jquery.autocomplete.min.js"/>"></script> ... <script type="text/javascript"> $("#busca").puts("Busca produtos por nome"); $("#busca").autocomplete(/goodbuy/produtos/busca.json); </script>

Isso deveria ser o suciente, mas o plugin AutoComplete espera que voc mande os dados separados por pipe(|) ou um dado por linha. Como queremos usar JSON, precisamos congurar isso no plugin:
$("#busca").autocomplete(/goodbuy/produtos/busca.json, { dataType: "json", // pra falar que vamos tratar um json parse: function(produtos) { // para tratar o json // a funo map vai iterar por toda a lista, // e transformar os dados usando a funo passada return $.map(produtos, function(produto) { return { 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:
@Get @Path("/produtos/busca.json") public void buscaJson(String q) { result.use(json()).withoutRoot() .from(dao.busca(q)) .exclude("id", "descricao") .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 zemos, 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.

Captulo 11 - AJAX e efeitos visuais - Melhorando a busca: Autocomplete - Pgina 94

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

11.6 - Exerccios
1) Modique os formulrios de adio e edio de produtos para incluir a validao do lado do cliente. Os javascripts do plugin j esto importados no projeto base. Se preferir use a outra forma de validao, passando as opes para o mtodo validate().
<form id="produtosForm" action="<c:url value="/produtos"/>" method="POST"> <fieldset> <legend>Adicionar produtos</legend> <label for="nome">Nome:</label> <input id="nome" class="required" minlength="3" type="text" name="produto.nome" value="${produto.nome }"/> <label for="descricao">Descrio:</label> <textarea id="descricao" class="required" maxlength="40" name="produto.descricao">${produto.descricao }</textarea> <label for="preco">Preo:</label> <input id="preco" min="0" type="text" name="produto.preco" value="${produto.preco }"/> <button type="submit">Enviar</button> </fieldset> </form> <script type="text/javascript"> $(#produtosForm).validate(); </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 quem em portugus. 4) Crie um mtodo em ProdutosController para a listagem de produtos.
@Resource
Captulo 11 - AJAX e efeitos visuais - Exerccios - Pgina 95

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public class ProdutosController { //... public List<Produto> busca(String nome) { result.include("nome", nome); return dao.busca(nome); } }

5) Use o atalho Ctrl+1 para criar o mtodo busca no ProdutoDao.

6) Implemente o mtodo busca no ProdutoDao.


@Component public class ProdutoDao { //... public List<Produto> busca(String nome) { return session.createCriteria(Produto.class) .add(Restrictions.ilike("nome", nome, MatchMode.ANYWHERE)) .list(); } }

7) Crie o JSP de resultado da busca, em /WEB-INF/jsp/produto/busca.jsp


<h3>Resultados da busca pelo nome <b>"${nome }"</b></h3> <%@ include file="lista.jsp" %>

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


<div id="menu"> <ul> <li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li>

Captulo 11 - AJAX e efeitos visuais - Exerccios - Pgina 96

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<li><a href="<c:url value="/produtos"/>">Lista Produtos</a></li> <li><form action="<c:url value="/produto/busca"/>"> <input name="nome"/> </form> </li> </ul> </div>

9) Faa buscas usando esse formulrio.

10) Modique o formulrio de busca para usar o plugin Puts e deixar uma mensagem dentro do input.
<div id="menu"> <ul> <li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li> <li><a href="<c:url value="/produtos"/>">Lista Produtos</a></li> <li><form action="<c:url value="/produto/busca"/>"> <input id="busca" name="nome"/> </form> <script type="text/javascript"> $("#busca").puts("Busca produtos por nome"); </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.


@Get @Path("/produtos/busca.json") public void buscaJson(String q) { result.use(json()).withoutRoot()
Captulo 11 - AJAX e efeitos visuais - Exerccios - Pgina 97

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

.from(dao.busca(q)) .exclude("id", "descricao") .serialize(); }

13) Adicione o cdigo javascript para que o autocomplete funcione.


$("#busca").autocomplete(/goodbuy/produtos/busca.json, { dataType: "json", parse: function(produtos) { return $.map(produtos, function(produto) { return { data: produto, value: produto.nome, result: produto.nome }; }); }, formatItem: function(produto) { return produto.nome + "(" + produto.preco + ")"; } });

14) Recarregue a pgina e teste o autocomplete digitando algo no campo de busca.

Captulo 11 - AJAX e efeitos visuais - Exerccios - Pgina 98

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; // getters e setters }

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 car disponvel enquanto o usurio estiver navegando no sistema, ento podemos apenas colocar o carrinho na sesso. Como vimos antes, para que um componente seja nico durante a sesso do usurio basta anot-lo com @SessionScoped, ento basta modicar a classe do carrinho para incluir as anotaes:
@Component @SessionScoped public class Carrinho { private List<Item> itens = new ArrayList<Item>();

99

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

private Double total = 0.0; //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 modicar a listagem de produtos adicionando um boto para comprar:
<table> <thead> <tr> ... <th>Comprar</th> ... </tr> </thead> <tbody> <c:forEach items="${produtoList}" var="produto"> <tr> ... <td> <!-- Adicionando o produto no carrinho de compras --> <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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

package br.com.caelum.goodbuy.controller; import br.com.caelum.vraptor.Resource; @Resource public class CarrinhoController { }

Vamos criar o mtodo que responde URI colocada no formulrio de compra:


@Resource public class CarrinhoController { @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 public class CarrinhoController { private final Carrinho carrinho; public CarrinhoController(Carrinho carrinho) { this.carrinho = carrinho; } @Post @Path("/carrinho") public void adiciona(Item item) { 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:
public class Carrinho { private List<Item> itens = new ArrayList<Item>(); private Double total = 0.0; public void adiciona(Item item) { itens.add(item); total += item.getProduto().getPreco() * item.getQuantidade(); }

Captulo 12 - Criando o Carrinho de Compras - Controlando o carrinho de compras - Pgina 101

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

//... }

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 class CarrinhoController { private final Carrinho carrinho; private final ProdutoDao dao; public CarrinhoController(Carrinho carrinho, ProdutoDao dao) { this.carrinho = carrinho; this.dao = dao; } @Post @Path("/carrinho") public void adiciona(Item item) { dao.recarrega(item.getProduto()); carrinho.adiciona(item); } }

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 class ProdutoDao { //... 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 class CarrinhoController { private final Carrinho carrinho; private final ProdutoDao dao; private final Result result; public CarrinhoController(Carrinho carrinho, ProdutoDao dao, Result result) { this.carrinho = carrinho; this.dao = dao; this.result = result;
Captulo 12 - Criando o Carrinho de Compras - Controlando o carrinho de compras - Pgina 102

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

} @Post @Path("/carrinho") public void adiciona(Item item) { dao.recarrega(item.getProduto()); carrinho.adiciona(item); result.redirectTo(ProdutosController.class).lista(); } }

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 class Carrinho { //... public Integer getTotalDeItens() { return itens.size(); } }

Captulo 12 - Criando o Carrinho de Compras - Visualizando os itens do carrinho - Pgina 103

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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> <td><fmt:formatNumber type="currency" value="${item.quantidade * item.produto.preco }"/></td> </tr> </c:forEach> </tbody> <tfoot> <tr>
Captulo 12 - Criando o Carrinho de Compras - Visualizando os itens do carrinho - Pgina 104

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<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 public class CarrinhoController { //... @Post @Path("/carrinho") public void adiciona(Item item) { dao.recarrega(item.getProduto()); carrinho.adiciona(item); result.redirectTo(this).visualiza(); } }

12.4 - Removendo itens do carrinho


Para completar as funcionalidades do carrinho de compras, vamos modicar a visualizao do carrrinho para ser possvel remover itens:
<table> ... <tbody> <c:forEach items="${carrinho.itens}" var="item" varStatus="s"> <tr> ... <td> <form action="<c:url value="/carrinho/${s.index }"/>" method="POST"> <button class="link" name="_method" value="DELETE">Remover</button> </form> </td> </tr>
Captulo 12 - Criando o Carrinho de Compras - Removendo itens do carrinho - Pgina 105

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

</c:forEach> </tbody> ... </table>

Vamos criar, tambm, o mtodo que remove itens do carrinho no controller:


public class CarrinhoController { //... @Delete @Path("/carrinho/{indiceItem}") public void remove(int indiceItem) { carrinho.remove(indiceItem); result.redirectTo(this).visualiza(); } }

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


public class Carrinho { //... public void remove(int indiceItem) { 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 public class Carrinho { private List<Item> itens = new ArrayList<Item>(); private Double total = 0.0; //getters e setters }

package br.com.caelum.goodbuy.modelo; public class Item { private Produto produto;

Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 106

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

private Integer quantidade; //getters e setters }

2) Modique a listagem de produtos para incluir um boto para comprar o produto:


<table> <thead> <tr> ... <th>Comprar</th> ... </tr> </thead> <tbody> <c:forEach items="${produtoList}" var="produto"> <tr> ... <td> <!-- Adicionando o produto no carrinho de compras --> <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>

3) Adicione o div do carrinho no cabealho da pgina (arquivo header.jspf)


<div id="header"> <div id="carrinho"> <h3><a href="<c:url value="/carrinho"/>">Meu carrinho:</a></h3> <c:if test="${empty carrinho or carrinho.totalDeItens eq 0 }"> <span>Voc no possui itens no seu carrinho</span> </c:if> <c:if test="${carrinho.totalDeItens > 0 }"> <ul> <li><strong>Itens:</strong> ${carrinho.totalDeItens }</li> <li><strong>Total:</strong> <fmt:formatNumber type="currency" value="${carrinho.total }"/></li> </ul> </c:if> </div>

Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 107

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

</div>

4) Crie o CarrinhoController, com um mtodo para adicionar itens no carrinho.


package br.com.caelum.goodbuy.controller;

@Resource public class CarrinhoController { private final Carrinho carrinho; private final ProdutoDao dao; private final Result result; public CarrinhoController(Carrinho carrinho, ProdutoDao dao, Result result) { this.carrinho = carrinho; this.dao = dao; this.result = result; } @Post @Path("/carrinho") public void adiciona(Item item) { dao.recarrega(item.getProduto()); carrinho.adiciona(item); result.redirectTo(ProdutosController.class).lista(); } }

public class Carrinho { //... public void adiciona(Item item) { itens.add(item); total += item.getProduto().getPreco() * item.getQuantidade(); } public Integer getTotalDeItens() { return itens.size(); } }

public class ProdutoDao { //... public void recarrega(Produto produto) { session.refresh(produto); } }

5) Compre alguns produtos e veja o carrinho sendo atualizado no header.

Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 108

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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 public class CarrinhoController { //... @Get @Path("/carrinho") public void visualiza() { } @Post @Path("/carrinho") public void adiciona(Item item) { dao.recarrega(item.getProduto()); carrinho.adiciona(item); result.redirectTo(this).visualiza(); } } /WEB-INF/jsp/carrinho/visualiza.jsp <h3>Itens do seu carrinho de compras</h3> <table> <thead> <tr> <th>Nome</th> <th>Descrio</th> <th>Preo</th> <th>Qtde</th> <th>Total</th> </tr> </thead> <tbody> <c:forEach items="${carrinho.itens}" var="item" varStatus="s"> <tr> <td>${item.produto.nome }</td> <td>${item.produto.descricao }</td> <td><fmt:formatNumber type="currency" value="${item.produto.preco }"/></td> <td>${item.quantidade }</td> <td><fmt:formatNumber type="currency" value="${item.quantidade * item.produto.preco }"/></td> </tr>

Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 109

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

</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>

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.
public class CarrinhoController { //... @Delete @Path("/carrinho/{indiceItem}") public void remove(int indiceItem) { carrinho.remove(indiceItem); result.redirectTo(this).visualiza(); } }

public class Carrinho { public void remove(int indiceItem) { Item removido = itens.remove(indiceItem); total -= removido.getProduto().getPreco() * removido.getQuantidade(); } } /WEB-INF/jsp/carrinho/visualiza.jsp <table> ... <tbody> <c:forEach items="${carrinho.itens}" var="item" varStatus="s"> <tr> ... <td> <form action="<c:url value="/carrinho/${s.index }"/>" method="POST"> <button class="link" name="_method" value="DELETE">Remover</button> </form> </td> </tr>
Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 110

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

</c:forEach> </tbody> ... </table>

9) Adicione e remova itens do carrinho.

Captulo 12 - Criando o Carrinho de Compras - Exerccios - Pgina 111

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:
package br.com.caelum.goodbuy.modelo; public class Usuario { private String login; private String senha; private String nome; //getters e setters }

uma boa idia guardar os usurios no banco de dados, ento vamos adicionar as anotaes do hibernate. No h a necessidade de criar um campo id para usurios, pois o login j ser um identicador nico.
package br.com.caelum.goodbuy.modelo; import javax.persistence.Entity; import javax.persistence.Id; @Entity public class Usuario { @Id private String login; private String senha; private String nome; //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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

tabelas do banco quando necessrio.


<hibernate-configuration> <session-factory> <!--...--> <property name="hibernate.hbm2ddl.auto">update</property> <mapping class="br.com.caelum.goodbuy.modelo.Produto" /> <mapping class="br.com.caelum.goodbuy.modelo.Usuario" /> </session-factory> </hibernate-configuration>

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:
package br.com.caelum.goodbuy.controller; import br.com.caelum.vraptor.Resource; @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> <label for="nome">Nome:</label> <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"/> <button type="submit">Enviar</button> </fieldset> </form>

Captulo 13 - Autenticao - Criando Usurios - Pgina 113

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

<script type="text/javascript"> $(#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 modique a div header:
<div id="header"> <div id="usuario"> Voc no est logado. <a href="<c:url value="/usuarios/novo"/>">Cadastre-se</a> </div> ... </div>

Para completar o cadastro, vamos criar a lgica que adiciona o usurio de fato, validando se o login escolhido ainda no existe no sistema:
@Resource public class UsuariosController { private final UsuarioDao dao; private final Result result; private final Validator validator; public UsuariosController(UsuarioDao dao, Result result, Validator validator) { this.dao = dao; this.result = result; this.validator = validator; } @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); result.redirectTo(ProdutosController.class).lista(); } //... }

O UsuarioDao ainda no existe. Use o Ctrl+1 para criar o dao e os seus mtodos:
@Component public class UsuarioDao { private final Session session; public UsuarioDao(Session session) { this.session = session; } public boolean existeUsuario(Usuario usuario) {
Captulo 13 - Autenticao - Criando Usurios - Pgina 114

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Usuario encontrado = (Usuario) session.createCriteria(Usuario.class) .add(Restrictions.eq("login", usuario.getLogin())) .uniqueResult(); return encontrado != null; } public void adiciona(Usuario usuario) { Transaction tx = this.session.beginTransaction(); this.session.save(usuario); tx.commit(); } }

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 public class UsuariosController { //... @Get @Path("/login") public void loginForm() { } }

<form action="<c:url value="/login"/>" method="POST"> <fieldset> <legend>Efetue o login</legend> <label for="login">Login:</label> <input id="login" type="text" name="usuario.login"/> <label for="senha">Senha:</label> <input id="senha" type="password" name="usuario.senha"/> <button type="submit">Login</button> </fieldset> </form>

Quando o usurio faz o login, precisamos guardar a informao de que ele j est logado. A melhor forma

Captulo 13 - Autenticao - Efetuando o login - Pgina 115

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

guardar a informao de login na sesso, que mantm os dados enquanto o usurio estiver navegando pela aplicao. Para isso, vamos criar uma classe que guarda o usurio logado. Essa classe ser acessada nos jsps para acessar as informaes do usurio, ento adicionamos alguns getters para expor as informaes relevantes.
@Component @SessionScoped public class UsuarioWeb { private Usuario logado; public void login(Usuario usuario) { this.logado = usuario; } public String getNome() { return logado.getNome(); } public boolean isLogado() { return logado != null; } }

Ento na nossa lgica de login, podemos colocar o usurio logado dentro da classe acima, depois de vericar que o usurio digitou o login e senha certos.
@Resource public class UsuariosController { private final UsuarioWeb usuarioWeb; //... public UsuariosController(UsuarioDao dao, Result result, Validator validator, UsuarioWeb usuarioWeb) { //... this.usuarioWeb = usuarioWeb; } @Post @Path("/login") public void login(Usuario usuario) { Usuario carregado = dao.carrega(usuario); if (carregado == null) { validator.add(new ValidationMessage("Login e/ou senha invlidos", "usuario.login")); } validator.onErrorUsePageOf(UsuariosController.class).loginForm(); usuarioWeb.login(carregado); result.redirectTo(ProdutosController.class).lista(); } }

Para carregar o usurio, crie o mtodo no UsuarioDao que busca um usurio por login e senha:
Captulo 13 - Autenticao - Efetuando o login - Pgina 116

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

@Component public class UsuarioDao { //... public Usuario carrega(Usuario usuario) { return (Usuario) session.createCriteria(Usuario.class) .add(Restrictions.eq("login", usuario.getLogin())) .add(Restrictions.eq("senha", usuario.getSenha())) .uniqueResult(); } }

E para mostrar que o usurio est logado mesmo, vamos modicar o cabealho:
<div id="header"> <div id="usuario"> <c:if test="${usuarioWeb.logado}"> Ol, ${usuarioWeb.nome }! <a href="<c:url value="/logout"/>">Logout</a> </c:if> <c:if test="${empty usuarioWeb or not usuarioWeb.logado}"> Voc no est logado. <a href="<c:url value="/login"/>">Login</a> <a href="<c:url value="/usuarios/novo"/>">Cadastre-se</a> </c:if> </div> ... </div>

Por ltimo vamos adicionar a lgica de logout:


public class UsuariosController { //... @Path("/logout") public void logout() { usuarioWeb.logout(); result.redirectTo(ProdutosController.class).lista(); } }

public class UsuarioWeb { //... public void logout() { this.logado = null; } }

13.3 - Restringindo funcionalidades para usurios logados

Captulo 13 - Autenticao - Restringindo funcionalidades para usurios logados - Pgina 117

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

Como falamos no comeo do captulo, no legal que todo mundo consiga adicionar, remover e editar produtos. Vamos, ento, fazer com que s usurios logados consigam acessar essas funcionalidades. Um primeiro passo retirar os links para elas quando o usurio no est logado: /header.jspf:
<div id="menu"> <ul> <c:if test="${usuarioWeb.logado }"> <li><a href="<c:url value="/produtos/novo"/>">Novo Produto</a></li> </c:if> ...

/WEB-INF/jsp/produto/lista.jsp
<table> ... <tbody> <c:forEach items="${produtoList}" var="produto"> <tr> ... <c:if test="${usuarioWeb.logado }"> <td><a href="<c:url value="/produtos/${produto.id}"/>">Editar</a></td> <td> <form action="<c:url value="/produtos/${produto.id}"/>" method="POST"> <button class="link" name="_method" value="DELETE">Remover</button> </form> </td> </c:if> </tr> </c:forEach> </tbody> </table>

Agora os usurios que no esto logados no conseguem mais ver os links das aes que ele no pode executar. Mas ser que isso o suciente? 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: vericar se o usurio est logado antes de ir pro controller, e se ele no estiver, redirecionar para o login. Para implementar um Interceptor do VRaptor precisamos de duas coisas: anotar a classe com @Intercepts e implementar a interface Interceptor:
@Intercepts
Captulo 13 - Autenticao - Interceptor - Pgina 118

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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.reect.Method) para poder, por exemplo, ver qual o nome do mtodo, ou se ele tem alguma anotao

public void intercept(InterceptorStack stack, ResourceMethod method, Object


resourceInstance) throws InterceptionException { - intercepta a requisio. O parmetro stack possibilita continuar a execuo normal da requisio e, portanto, executar de fato a lgica de negcios. O parmetro method o mesmo do mtodo accepts, e o resourceInstance o controller instanciado.

Como qualquer classe registrada no VRaptor, voc pode receber qualquer componente da sua aplicao (e do VRaptor) pelo construtor do seu interceptor. No nosso caso precisamos vericar se o usurio est logado, e essa informao est no UsuarioWeb.
@Intercepts public class AutorizacaoInterceptor implements Interceptor { private final UsuarioWeb usuario; public AutorizacaoInterceptor(UsuarioWeb usuario) { this.usuario = usuario; } }

Mas s precisamos executar a lgica de autenticao caso o usurio no esteja logado, ento vamos 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 class AutorizacaoInterceptor implements Interceptor { private final UsuarioWeb usuario; private final Result result; public AutorizacaoInterceptor(UsuarioWeb usuario, Result result) { this.usuario = usuario;
Captulo 13 - Autenticao - Interceptor - Pgina 119

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

this.result = result; } public boolean accepts(ResourceMethod method) { return false; } public void intercept(InterceptorStack stack, ResourceMethod method, Object resourceInstance) throws InterceptionException { result.redirectTo(UsuariosController.class).loginForm(); } }

No o caso, mas se quisssemos continuar a requisio normalmente, poderamos fazer:


stack.next(method, resourceInstance);

Mas temos um pequeno problema: se o usurio no estiver logado ele no vai conseguir acessar nada no sistema, nem o login! Na verdade, s queremos proibir que o usurio adicione e modique produtos, ento nosso interceptor s pode executar para essas operaes. Poderamos at colocar no Interceptor uma lista dos mtodos que sero interceptados, mas assim toda vez que adicionarmos uma operao nova que precise de autenticao precisaramos mudar o interceptor. Um jeito mais legal de fazer isso marcar os mtodos que precisam de autenticao. Para isso podemos criar uma anotao para ser colocada nos mtodos:
@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 public class ProdutosController {

@Restrito public void formulario() {} @Restrito public Produto edita(Long id) {...} @Restrito public void altera(Produto produto) {...} @Restrito public void adiciona(final Produto produto) {...}

Captulo 13 - Autenticao - Interceptor - Pgina 120

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

@Restrito public void remove(Long id) {...} ... }

E do lado do Interceptor, apenas fazemos:


public boolean accepts(ResourceMethod method) { 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.

Captulo 13 - Autenticao - Interceptor - Pgina 121

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) Modique 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" /> <button type="submit">Enviar</button> </fieldset> </form>

2) Crie o Controller abaixo, que vai tratar dos uploads e downloads de imagens.
package br.com.caelum.goodbuy.controller;

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:
@Post @Path("/produtos/{produto.id}/imagem") public void upload(Produto produto, final UploadedFile imagem) {

122

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

validator.checking(new Validations() {{ 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 xa 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; import br.com.caelum.vraptor.ioc.Component; @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 xa para facilitar. O IOUtils vem do projeto commons-io e copia um InputStream para algum OutputStream
package br.com.caelum.goodbuy.imagens;

import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import org.apache.commons.io.IOUtils; @Component public class Imagens { //... public void salva(UploadedFile imagem, Produto produto) {

Captulo 14 - Apndice - Download e Upload - Exerccios - Pgina 123

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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.
package br.com.caelum.goodbuy.controller;

@Resource public class ImagensController { private final Validator validator; private final Imagens imagens; private final Result result; public ImagensController(Validator validator, Imagens imagens, Result result) { this.validator = validator; this.imagens = imagens; this.result = result; } @Post @Path("/produtos/{produto.id}/imagem") public void upload(Produto produto, final UploadedFile imagem) { validator.checking(new Validations() {{ if (that(imagem, is(notNullValue()), "imagem", "imagem.nula")) { that(imagem.getContentType(), startsWith("image"), "imagem", "nao.eh.imagem"); } }}); validator.onErrorRedirectTo(ProdutosController.class).edita(produto.getId()); 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) {

Captulo 14 - Apndice - Download e Upload - Exerccios - Pgina 124

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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"/>

Captulo 14 - Apndice - Download e Upload - Exerccios - Pgina 125

C APTULO

15

Apndice - Integrando VRaptor e Spring


15.1 - Como fazer a integrao?
Para usar os componentes do Spring no VRaptor basta congur-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 congurados pelo applicationContext.xml no enxergam os componentes congurados pelas anotaes do VRaptor, ento se algum componente do Spring depender de algo que est no VRaptor, voc precisa converter a congurao 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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

2) Inclua o componente que gerencia as transaes, baseado em anotaes do Spring.


<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.0.xsd"> <tx:annotation-driven /> </beans>

3) Esse componente de transaes genrico: funciona tanto com a JTA direto, com Hibernate/JPA, com JDBC, etc. Ento para especicar qual dos gerenciadores de transao vai ser utilizado, voc precisa adicionar um bean na congurao. No nosso caso, vamos usar transaes do Hibernate:
<beans xmlns...> <tx:annotation-driven /> <bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager"> <property name="sessionFactory" ref="sessionFactory" /> </bean> </beans>

4) O transactionManager precisa de uma SessionFactory congurada. J temos uma no VRaptor, mas ela no poder ser usada. Remova a anotao @Component do CriadorDeSessionFactory, e adicione o bean que cria uma SessionFactory no Spring:
<beans xmlns....> <!--...--> <bean id="sessionFactory" class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean"> <property name="configLocation"> <value>classpath:/hibernate.cfg.xml</value> </property> </bean> </beans>

5) Ao usar a SessionFactory do Spring estamos presos ao seu controle de Sessions. Isso signica que no podemos fazer o sessionFactory.openSession para obter Sessions. O Spring controla isso para voc, ento voc obrigado a usar componentes do Spring para conseguir uma Session, para poder usar a mesma que est participando da transao. Mas ao invs de mudar todo o nosso sistema para usar as sessions do Spring, vamos modicar o nosso CriadorDeSession para usar-las. Por causa do jeito que o Spring trabalha, temos que pedir uma Session para ele no momento que vamos us-la, e no na criao do DAO, por exemplo. Ento vamos usar um Proxy Dinmico para poder passar
Captulo 15 - Apndice - Integrando VRaptor e Spring - Exerccios: Transaction Manager - Pgina 127

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

uma Session no construtor do DAO, mas mesmo assim s pedir a Session pro Spring na hora de chamar algum mtodo. Modique o CriadorDeSession.
import net.vidageek.mirror.dsl.Mirror;

import org.springframework.orm.hibernate3.SessionFactoryUtils; import br.com.caelum.vraptor.proxy.MethodInvocation; import br.com.caelum.vraptor.proxy.Proxifier; import br.com.caelum.vraptor.proxy.SuperMethod; @Component public class CriadorDeSession implements ComponentFactory<Session> { private final SessionFactory factory; private final Proxifier proxifier; private Session session; public CriadorDeSession(SessionFactory factory, Proxifier proxifier) { this.factory = factory; this.proxifier = proxifier; } @PostConstruct public void abre() { 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); } }); } public Session getInstance() { return this.session; } @PreDestroy public void fecha() { this.session.close(); } }

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 modicam o banco.
import org.springframework.transaction.annotation.Transactional;

@Component public class ProdutoDao { @Transactional


Captulo 15 - Apndice - Integrando VRaptor e Spring - Exerccios: Transaction Manager - Pgina 128

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public void salva(Produto produto) { //Transaction tx = session.beginTransaction(); session.save(produto); //tx.commit(); } public Produto carrega(Long id) { return (Produto) session.load(Produto.class, id); } @Transactional public void atualiza(Produto produto) { session.update(produto); } public List<Produto> listaTudo() { return this.session.createCriteria(Produto.class).list(); } @Transactional public void remove(Produto produto) { session.delete(produto); } public List<Produto> busca(String nome) { return session.createCriteria(Produto.class) .add(Restrictions.ilike("nome", nome, MatchMode.ANYWHERE)) .list(); } public void recarrega(Produto produto) { session.refresh(produto); } }

Captulo 15 - Apndice - Integrando VRaptor e Spring - Exerccios: Transaction Manager - Pgina 129

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: Congurando 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> <servlet-name>velocity</servlet-name> <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 congurada, para criar uma pgina com o velocity basta criar um arquivo com a extenso .vm. Por exemplo, crie o arquivo olamundo.vm na pasta WebContent.
<html> <body> Ol mundo. </body> </html>

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 cam acessveis no template do Velocity. 130

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

public class TesteController { private Result result; public TesteController(Result result) { this.result = result; } @Path("/teste") public void teste() { result.include("mensagem", "Estou usando o Velocity"); result.forwardTo("/olamundo.vm"); } }

e modique o olamundo.vm para mostrar a mensagem includa:


<html> <body> Ol mundo. $mensagem. </body> </html>

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

Material do Treinamento Desenv. gil para Web 2.0 com VRaptor, Hibernate e AJAX

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:
public class TesteController { private Result result; public TesteController(Result result) { this.result = result; } @Path("/teste") public void teste() { result.include("mensagem", "Estou usando o Velocity"); } }

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!

Captulo 16 - Apndice: Mudando a View Padro: Velocity - Exerccios: Mudando o resultado de todas as lgicas para Velocity Pgina 132

ndice Remissivo
AnnotationConguration, 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