Você está na página 1de 37

VRaptor

http://vraptor.caelum.com.br

Automatically generated by Caelum Objects Tubaina


10 de outubro de 2011

ndice

1 Aceitando URLs com ou sem barra no final

2 Colocando objetos na sesso

3 ComponentFactory como seletor de implementaes

4 Desabilitar exception do Page Result

5 Gerando aplicao com VRaptor3 usando Maven

6 Usando tiles com vraptor3

10

7 Interceptando recursos anotados

13

8 Job Scheduling com vRaptor3 e Spring

17

8.1 O Task Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17


8.2 As Tasks/Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
8.3 Observaes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

8.4 O escopo Prototype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19


9 Poupando recursos - LAZY Dependency Injection

21

10 Evitando que o browser faa cache das pginas

25

11 Usando Objectify com VRaptor

27

12 Usando o Static Scanning no GAE/J

29

13 Usando o Header Referer para fazer redirecionamentos

30

14 Configurando o VRaptor na Locaweb

31

15 VRaptor e Tiles 2.2

32
Version: 14.1.10

ii

C APTULO

Aceitando URLs com ou sem barra no final


por Tomaz Lavieri
Para quem teve dificuldade como eu em conseguir determinar urls como

@Path("produto/{produto.id}")
quando digitava a URI /produto/1/ e o link no funcionava, segue abaixo uma modificao que corrige o
problema.

Nota do editor
Isso no necessariamente um problema... a URL /abc diferente da /abc/ portanto o comportamento de dar 404 o esperado. Mas se voc quiser que sejam urls equivalentes voc pode
escrever a classe abaixo.

import
import
import
import
import
import
import
import
import

br.com.caelum.vraptor.Result;
br.com.caelum.vraptor.core.RequestInfo;
br.com.caelum.vraptor.http.route.ResourceNotFoundException;
br.com.caelum.vraptor.http.route.Router;
br.com.caelum.vraptor.ioc.Component;
br.com.caelum.vraptor.ioc.RequestScoped;
br.com.caelum.vraptor.resource.DefaultResourceNotFoundHandler;
br.com.caelum.vraptor.resource.HttpMethod;
br.com.caelum.vraptor.view.Results;

@Component
@RequestScoped
public class Error404 extends DefaultResourceNotFoundHandler
private final Router router;
private final Result result;
public Error404(Router router, Result result) {
this.router = router;
this.result = result;
}
@Override
public void couldntFind(RequestInfo requestInfo) {
try {
String uri = requestInfo.getRequestedUri();
if (uri.endsWith("/")) {
1

tryMovePermanentlyTo(requestInfo, uri.substring(0, uri.length()-1));


} else {
tryMovePermanentlyTo(requestInfo, uri + "/");
}
} catch (ResourceNotFoundException ex) {
super.couldntFind(requestInfo);
}

private void tryMovePermanentlyTo(RequestInfo requestInfo, String newUri) {


router.parse(newUri, HttpMethod.of(requestInfo.getRequest()),
requestInfo.getRequest());
result.use(Results.http()).movedPermanentlyTo(newUri);
}

C APTULO

Colocando objetos na sesso


Se voc precisa colocar algum objeto na Sesso (e est usando o Spring como DI provider) voc pode criar
um componente Session scoped:

@Component
@SessionScoped
public class UserInfo {
private User user;
}

// getter e setter

e se voc quiser usar ou colocar o usurio na sesso, de dentro de algum Controller, por exemplo, voc
pode receber essa classe que voc acabou de criar no construtor:

@Resource
public class LoginController {
private UserInfo info;
public LoginController(UserInfo info) {
this.info = info;
}

//...
public void login(User user) {
//valida o usuario
this.info.setUser(user);
}

E para acessar esse usurio a partir da view, existe um atributo no HttpSession com o nome userInfo,
assim voc pode usar numa jsp:

${userInfo.user}

C APTULO

ComponentFactory como seletor de


implementaes
O uso tpico para as ComponentFactories para quando a dependncia que voc quer usar no faz parte
do VRaptor nem da sua aplicao, como o caso da Session do Hibernate.
Mas voc pode usar as ComponentFactories para disponibilizar implementaes de interfaces de acordo
com alguma condio, por exemplo alguma configurao adicional.
Vamos supor que voc quer fazer um enviador de Email, mas s quer usar o enviador de verdade quando o
sistema estiver em produo, em desenvolvimento voc quer um enviador falso:

public interface EnviadorDeEmail {


}

void enviaEmail(Email email);

public class EnviadorDeEmailPadrao implements EnviadorDeEmail {


//envia o email de verdade
}
public class EnviadorDeEmailFalso implements EnviadorDeEmail {
//no faz nada, ou apenas loga o email
}
Sem anotar nenhuma dessas classes com @Component, voc pode criar um ComponentFactory de
EnviadorDeEmail, e anot-lo com @Component:

@Component
@ApplicationScoped //ou @RequestScoped se fizer mais sentido
public class EnviadorDeEmailFactory implements ComponentFactory<EnviadorDeEmail> {
private EnviadorDeEmail enviador;
public EnviadorDeEmail(ServletContext context) {
if ("producao".equals(context.getInitParameter("tipo.de.ambiente"))) {
enviador = new EnviadorDeEmailPadrao();
} else {
enviador = new EnviadorDeEmailFalso();
}
}

public EnviadorDeEmail getInstance() {


return this.enviador;
}

C APTULO

Desabilitar exception do Page Result


Quando voc usa redirecionamentos para pgina:

result.use(Results.page()).forward(url);

e tenta passar uma URL que tratada por alguma lgica da sua aplicao, o VRaptor vai lanar uma
exceo falando para voc usar o result.use(logic()) correspondente. Por exemplo:

public class TesteController {


@Path("/teste")
public void teste() {}

public void redireciona() {


result.use(page()).redirect("/teste");
// vai lanar uma exceo, falando para voc usar o cdigo
// result.use(logic()).redirectTo(TesteController.class).teste();
}

Se voc quiser desabilitar esta exceo, voc pode criar a seguinte classe:

@Component
public class MyPageResult extends DefaultPageResult {
// delega o construtor
@Override
protected void checkForLogic(String url, HttpMethod httpMethod) {
//nada aqui, ou algum outro tipo de checkagem
}
}

C APTULO

Gerando aplicao com VRaptor3 usando


Maven
por Lucas H. G. Toniazzo no blog

http://www.lucas.hgt.nom.br/wordpress/?p=107

Algum tempo sem atualizar as coisas por aqui, resolvi tirar um tempo para me atualizar no framework que
acompanho j faz algum tempo, VRAPTOR.
Ultimamente tenho utilizado o Maven para controlar as dependncias de Jars das aplicaes que trabalho, e
tem me ajudado bastante. Ento resolvi tirar um tempo para gerar um POM para o VRaptor, j que na estrutura
original dele esse arquivo no o acompanha.
Utilizei o Eclipse com suporte ao Maven para gerar o projeto aps ter gerado o POM do VRaptor.
Alguns passos para se ter sucesso na criao da estrutura:
1) Faa o download do Vraptor e coloque o seu jar numa pasta qualquer.
2) Instale o Maven ou utilize o recurso que est disponvel em sua IDE.
3) Execute o comando abaixo:

mvn install:install-file -DgroupId=br.com.caelum -DartifactId=vraptor


-Dpackaging=jar -Dversion=3.0.0-SNAPSHOT
-Dfile=LOCAL_ONDE_ESTA\vraptor3-3.0.0-SNAPSHOT.jar -DgeneratePom=true
4) Edite
o
pom.xml
do
VRaptor
que
deve
estar
no
($USER_HOME/.m2/Repository/br/com/caelum/vraptor) com o seguinte contedo:

<?xml version="1.0" encoding="UTF-8"?>


<project
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd"
xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>
<groupId>br.com.caelum</groupId>
<artifactId>vraptor</artifactId>
<version>3.0.0-SNAPSHOT</version>
<description>POM was created from install:install-file</description>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring</artifactId>
<version>2.5.5</version>
6

repositrio

local

Caelum VRaptor

</dependency>
<dependency>
<groupId>com.thoughtworks.paranamer</groupId>
<artifactId>paranamer</artifactId>
<version>1.3</version>
</dependency>
<dependency>
<groupId>org.objenesis</groupId>
<artifactId>objenesis</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<groupId>com.google.code.google-collections</groupId>
<artifactId>google-collect</artifactId>
<version>snapshot-20080530</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>1.6.0</version>
</dependency>
<dependency>
<groupId>cglib</groupId>
<artifactId>cglib-nodep</artifactId>
<version>2.2</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.1</version>
<exclusions>
<exclusion>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-io</artifactId>
<version>1.3.2</version>
</dependency>
<dependency>
<groupId>javassist</groupId>
<artifactId>javassist</artifactId>
<version>3.8.0.GA</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.1.2</version>
</dependency>
Captulo 5 - Gerando aplicao com VRaptor3 usando Maven - 7

Caelum VRaptor

<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
<dependency>
<groupId>net.vidageek</groupId>
<artifactId>mirror</artifactId>
<version>1.5.1</version>
</dependency>
<dependency>
<groupId>ognl</groupId>
<artifactId>ognl</artifactId>
<version>2.7.3</version>
<exclusions>
<exclusion>
<groupId>jboss</groupId>
<artifactId>javassist</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.5.6</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.5.6</version>
</dependency>
</dependencies>
</project>
5) Crie um projeto Maven.
6) Edite o pom.xml do mesmo com o seguinte contedo:

<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>GERALMENTE_ESTRUTURA_DO_PACKAGE</groupId>
<artifactId>ARTIFACT_ID_QUE_DESEJAR</artifactId>
<packaging>war</packaging>
<name>NOME_QUE_DESEJAR</name>
<version>0.0.1-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>br.com.caelum</groupId>
<artifactId>vraptor</artifactId>
<version>3.0.0-SNAPSHOT</version>
Captulo 5 - Gerando aplicao com VRaptor3 usando Maven - 8

</dependency>
</dependencies>
</project>
7) Clique com boto direito, opo Maven, update dependecies
Pronto, libs adicionadas ao projeto, tudo organizado para iniciar as atividades.

C APTULO

Usando tiles com vraptor3


por Otvio Scherer Garcia
Caso voc queira integrar Tiles 2 com VRaptor fazendo com que seja feito forward diretamente para o tiles
e no para o JSP (padro no VRaptor3), basta escrever uma classe que implemente PathResolver com sua
conveno.
A primeira coisa a fazer colocar o tiles para responder como servlet. Assim toda requisio vinda por
*.tiles ser redirecionada ao tiles, e no ao VRaptor. Lembre-se de colocar a declarao do tiles servlet antes
do vraptor filter.
web.xml:

<!-- arquivo de definies do tiles -->


<context-param>
<param-name>org.apache.tiles.impl.BasicTilesContainer.DEFINITIONS_CONFIG</param-name>
<param-value>/WEB-INF/classes/tiles.xml</param-value>
</context-param>
<!-- servlet de inicializao do tiles -->
<servlet>
<servlet-name>TilesServlet</servlet-name>
<servlet-class>org.apache.tiles.web.startup.TilesServlet</servlet-class>
<load-on-startup>2</load-on-startup>
</servlet>
<!-- servlet que responde as requisies do tiles -->
<servlet>
<servlet-name>TilesDispatchServlet</servlet-name>
<servlet-class>org.apache.tiles.web.util.TilesDispatchServlet</servlet-class>
</servlet>
<!-- o tiles responder por toda requisio *.tiles -->
<servlet-mapping>
<servlet-name>TilesDispatchServlet</servlet-name>
<url-pattern>*.tiles</url-pattern>
</servlet-mapping>
No meu caso usei como padro para o tiles a conveno /package.controller.metodo. Sendo assim criei o
seguinte path resolver.

@Component
public class TilesPathResolver
implements PathResolver {
static final String VIEW_SUFIX = ".tiles";
10

Caelum VRaptor

static final String CLASS_SUFIX = "Controller";


@Override
public String pathFor(ResourceMethod method) {
final Class<?> clazz = method.getResource().getType();
final StringBuilder s = new StringBuilder();
s.append("/");
// retorna apenas o nome do ltimo pacote
s.append(StringUtils.substringAfterLast(clazz.getPackage().getName(), "."));
s.append(".");
//remove o sufixo controller
s.append(StringUtils.substringBefore(clazz.getSimpleName(), CLASS_SUFIX));
s.append(".");
s.append(method.getMethod().getName());
s.append(VIEW_SUFIX);

// definies do tile em minusculo, mas voc pode alterar isso


return s.toString().toLowerCase();

Se voc no quiser utilizar a classe StringUtils do projeto commons-lang, voc pode alterar o metodo para:

final Class<?> clazz = method.getResource().getType();


String pkgname = clazz.getPackage().getName();
final StringBuilder s = new StringBuilder();
s.append("/");
// retorna apenas o nome do ltimo pacote
s.append(pkgname.substring(pkgname.lastIndexOf(".") + 1));
s.append(".");
//remove o sufixo controller
s.append(clazz.getSimpleName().substring(0, clazz.getSimpleName().indexOf(CLASS_SUFIX)));
s.append(".");
s.append(method.getMethod().getName());
s.append(VIEW_SUFIX);
// definies do tile em minusculo, mas voc pode alterar isso
return s.toString().toLowerCase();
Nesse caso se voc tiver o controler CustomerController e chamar o mtodo list, a view ser redirecionada ao URI /admin.customer.list.tiles, que ser executado pelo tiles servlet.

package xpto.admin;
@Resource
public class CustomerController {
public List<Customer> list() {
return myServiceClass.listAllCustomers();
// ser redirecionado para a definio admin.customer.list
}
}
<definition name="admin.customer.list" extends="default">

Captulo 6 - Usando tiles com vraptor3 - 11

<put-attribute name="body" value="/WEB-INF/jspx/admin/customer.list.jspx" />


</definition>
Referncias:

http://tiles.apache.org/
VRaptor View e PathResolver: http://vraptor.caelum.com.br/documentacao/view-e-ajax/

Apache Tiles:

C APTULO

Interceptando recursos anotados


por

Tomaz

Lavieri,

no

vraptor3-interceptando-recursos-anotados/

blog

http://blog.tomazlavieri.com.br/2009/

Em primeira lugar, gostaria de tecer meus mais sinceros elogios a equipe VRaptor, a verso 3 esta muito
boa, bem mais intuitiva e fcil de usar que a 2.6
Neste artigo vou mostar como interceptar um mtodo de um Resource especifico, identificando-o a partir de
uma anotao e executar aes antes do mtodo executar, e aps ele executar.
Vamos supor que ns temos o seguinte Resource para adicionar produtos no nosso sistema

@Resource
public class ProdutoController {
private final DaoFactory factory;
private final ProdutoDao dao;
public ProdutoController(DaoFactory factory) {
this.factory = factory;
this.dao = factory.getProdutoDao();
}
public List<Produto> listar() {
return dao.list();
}
public Produto atualizar(Produto produto) {
try {
factory.beginTransaction();
produto = dao.update(produto);
factory.commit();
return produto;
} catch (DaoException ex) {
factory.rollback();
throw ex;
}
}
public Produto adicionar(Produto produto) {
try {
factory.beginTransaction();
produto = dao.store(produto);
factory.commit();
return produto;
} catch (DaoException ex) {
factory.rollback();
throw ex;
}
}
13

Caelum VRaptor

}
Agora nos queremos que um interceptador intercepte meu recurso, e execute a lgica dentro de um escopo
transacional, como fazer isso? s criar um interceptador assim.

import org.hibernate.Session;
import org.hibernate.Transaction;
import
import
import
import

br.com.caelum.vraptor.Intercepts;
br.com.caelum.vraptor.core.InterceptorStack;
br.com.caelum.vraptor.interceptor.Interceptor;
br.com.caelum.vraptor.resource.ResourceMethod;

@Intercepts
public class TransactionInterceptor implements Interceptor {
private final Session session;
public HibernateTransactionInterceptor(Session session) {
this.session = session;
}
public void intercept(InterceptorStack stack, ResourceMethod method,
Object instance) {
Transaction transaction = null;
try {
transaction = session.beginTransaction();
stack.next(method, instance);
transaction.commit();
} finally {
if (transaction.isActive()) {
transaction.rollback();
}
}
}
public boolean accepts(ResourceMethod method) {
return true; //aceita todas as requisies
}
}
Ok, o interceptador vai rodar e abrir transao antes e depois de executar a logica, e os mtodos transacionais da minha lgica iro se reduzir a isto

public Produto atualizar(Produto produto) {


}

return dao.update(produto);

public Produto adicionar(Produto produto) {


return dao.store(produto);
}
Ok mas, neste caso temos o problema de que mtodos que no exigem transao esto abrindo e fechando
transao a cada requisio sem necessidade.
Como ento selecionar apenas algumas lgicas para serem transacionais? podem criar uma anotao para
isto, desta forma:

import java.lang.annotation.ElementType;

Captulo 7 - Interceptando recursos anotados - 14

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Usado para garantir que um determinado recurso interceptado seja executada em um
* escopo de transao.
* @author Tomaz Lavieri
* @since 1.0
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD,ElementType.TYPE})
public @interface Transactional {}
Agora precisamos marcar os pontos onde queremos que o escopo seja transacional com esta anotao.

@Resource
public class ProdutoController {
private final ProdutoDao dao;
public ProdutoController(ProdutoDao dao) {
this.dao = dao;
}
public List<Produto> listar() {
return dao.list();
}
@Transactional
public Produto atualizar(Produto produto) {
return dao.update(produto);
}

@Transactional
public Produto adicionar(Produto produto) {
return dao.store(produto);
}

Ok o cdigo ficou bem mais enxuto, mas como interceptar apenas os mtodos marcados com esta anotao?? para tal basta no nosso accepts do TransactionInterceptor verificarmos se a anotao esta presente
no mtodo, ou no proprio rescurso (quando marcado no recurso todos os mtodos do recurso seriam transacionais).
A modificao do mtodo ficaria assim

public boolean accepts(ResourceMethod method) {


return

method
.getMethod() //metodo anotado
.isAnnotationPresent(Transactional.class)
|| method
.getResource() //ou recurso anotado
.getType()
.isAnnotationPresent(Transactional.class);

Caelum VRaptor

Pronto agora somente os mtodos com a anotao @Transacional so executados em escopo de transao
e economisamos linhas e linhas de cdigos de try{commit}catch{rollback throw ex}

Captulo 7 - Interceptando recursos anotados - 16

C APTULO

Job Scheduling com vRaptor3 e Spring


Por

Mrio

Peixoto

no

blog

job-scheduling-com-vraptor3-e-spring3/

http://mariopeixoto.wordpress.com/2009/11/17/

Este artigo tem como objetivo mostrar um caminho simples para fazer job scheduling no vRaptor3 quando o
Spring for o seu container IoC sem que seja necessrio o uso de XML para configurao.
Verses utilizadas:

vRaptor 3.0.2
Spring 3.0.0.RC2

8.1- O Task Scheduler


O Spring j vem com suporte a task scheduling/executing, ele precisa apenas que uma implementao
de org.springframework.scheduling.TaskScheduler esteja disponvel no escopo de aplicao (singleton no
Spring). Para isso precisamos implementar um ComponentFactory:

@Component
@ApplicationScoped
public class TaskSchedulerFactory implements ComponentFactory<TaskScheduler> {
private ThreadPoolTaskScheduler scheduler;
@PostConstruct
public void create() {
scheduler = new ThreadPoolTaskScheduler();
scheduler.initialize();
}
public TaskScheduler getInstance() {
return scheduler;
}
@PreDestroy
public void destroy() {
scheduler.destroy();
}
}
Neste exemplo utilizaremos o ThreadPoolTaskScheduler como implementao para o TaskScheduler, porm
vrias outras classes vem com o Spring e podem ser usadas da mesma maneira (documentao).

17

Caelum VRaptor

8.2- As Tasks/Jobs
Vamos criar interfaces para nossas tasks.

public interface Task extends Runnable {


void schedule(TaskScheduler scheduler);
}
public interface ApplicationTask extends Task {
}
public interface RequestTask extends Task {
}
Registrando tasks em escopo de application
Para registrar esse tipo de task, precisaremos de um bean em escopo de application:

@Component
@ApplicationScoped
public class MyFirstApplicationTask implements ApplicationTask {
public MyFirstApplicationTask(TaskScheduler scheduler) {
//Aqui voc poder receber componentes que no estejam em
//escopo de request ou session
...
this.schedule(scheduler);
}
public void schedule(TaskScheduler scheduler) {
scheduler.schedule(this, new CronTrigger("0 0 23 * * *"));
//Neste caso, a task rodar sempre s 23h0min0s
}
}
Registrando tasks em escopo de request
Para registrar esse tipo de task, basta receber o scheduler no construtor do seu Resource e registrar a task
no mtodo adequado.

@Component
@RequestScoped
public class MyFirstRequestTask implements RequestTask {
public MyFirstApplicationTask() {
//Aqui voc poder receber qualquer componente que precisar
...
}
public void schedule(TaskScheduler schedule) {
Calendar now = GregorianCalendar.getInstance();
now.add(Calendar.MINUTE,5);
scheduler.schedule(this, now.getTime());
//Neste caso, a task rodar apenas uma vez, 5 min depois da
//execuo deste mtodo
}
}
@Resource
public class MyResource {
private MyFirstRequestTask task;
Captulo 8 - Job Scheduling com vRaptor3 e Spring - As Tasks/Jobs 18

Caelum VRaptor

private TaskScheduler scheduler;


public MyResource(MyFirstRequestTask task, TaskScheduler scheduler) {
this.task = task;
this.scheduler = scheduler;
}
...
public void taskInit() {
task.schedule(scheduler);
}
...

8.3- Observaes
Criamos 3 interfaces, pois deste modo ficar mais fcil injetar diferentes tipos de tasks no construtor, por
exemplo podemos receber todas as tasks em escopo de request dentro de um resource assim:

@Resource
public class MyResource {
private List<RequestTask> tasks;
private TaskScheduler scheduler;
public MyResource(List<RequestTask> tasks, TaskScheduler scheduler) {
this.tasks = tasks;
this.scheduler = scheduler;
}
...
public void tasksInit() {
for (RequestTask task : tasks) {
task.schedule(scheduler);
}
}
...
}

8.4- O escopo Prototype


O Spring possui um escopo chamado prototype que define que o componente ter uma nova instncia
sempre que for requisitada, este escopo ainda no existe no vRaptor3 mas ser implementado em breve. Este
escopo servir para definir compenentes utilizados por tasks em escopo de application que naturalmente no
so singletons, como DAOs.
Voc no poder receber a Session no construtor do seu DAO prototyped pois geralmente a SessionFactory
est em escopo de request, e o vRaptor ainda no possui suporte s scoped-proxies do Spring. Ento precisar
fazer assim:

@Component
@PrototypeScoped
public class MyPrototypedDAO extends ... implements ... {
private Session session;
public MyPrototypedDAO(SessionFactory sessionFactory) {
this.session = sessionFactory.openSession();
}
Captulo 8 - Job Scheduling com vRaptor3 e Spring - Observaes 19

...

Deste modo, ser criado uma instncia do seu DAO para cada requisio de instncia (l-se: sempre que
voc receber uma instncia pelo construtor, ser uma nova), assim como uma Session separada.

C APTULO

Poupando recursos - LAZY Dependency


Injection
http://blog.tomazlavieri.com.br/2009/
vraptor-3-poupando-recursos-lazy-dependence-injection/
por

Tomaz

Lavieri

no

blog

Objetivo: Ao final deste artigo espera-se que voc saiba como poupar recursos caros, trazendo eles de
forma LAZY, ou como prefiro chamar Just-in-Time (no momento certo).
No VRaptor3 a injeo de dependncia ficou bem mais fcil, os interceptadores que eram os responsveis
para injetar a dependncia sumiram e agora fica tudo a cargo do container, que pode ser o Spring ou o Pico.
A facilidade na injeo de dependencia tem um custo, como no mais controlado pelo programador que
cria o interceptor sempre que declaramos uma dependncia no construtor de um @Component, @Resource ou
@Intercepts ele injetado no incio, logo na construo, porm s vezes o fluxo de um requisio faz com que
no usemos algumas destas injees de dependncia, disperdiando recursos valiosos.
Por exemplo, vamos supor o seguinte @Resource abaixo, que cadastra produtos

import java.util.List;
import org.hibernate.Session;
import br.com.caelum.vraptor.Result;
import br.com.caelum.vraptor.view.Results;
@Resource
public class ProdutoController {
/**
* O recurso que queremos poupar.
*/
private final Session session;
private final Result result;
public ProdutoController(final Session session, final Result result) {
this.session = session;
this.result = result;
}
/**
* apenas renderiza o formulrio
*/
public void form() {}
public List<Produto> listar() {
return session.createCriteria(Produto.class).list();
}
public Produto adiciona(Produto produto) {
session.persist(produto);
21

Caelum VRaptor

result.use(Results.logic()).redirectTo(getClass()).listar();
return produto;

Sempre que alguem faz uma requisio a qualquer lgica dentro do recurso ProdutoController uma
Session aberta, porem note que abrir o formulrio para adicionar produtos no requer sesso com o banco,
ele apenas renderiza uma pgina, cada vez que o formulrio de produtos aberto um importante e caro recurso
do sistema esta sendo requerido, e de forma totalmente ociosa.

Nota do editor
criada no mximo uma Session por requisio. A mesma coisa para qualquer componente Request scoped.

Como agir neste caso? Isolar o formulrio poderia resolver este problema mais recairia em outro, da mantenabilidade.
O ideal que este recurso s fosse realmente injetado no tempo certo (Just in Time) como seria possvel
fazer isso? A soluo usar proxies dinmicos, enviando uma Session que s realmente abrir a conexo com
o banco quando um de seus mtodos for invocado.

import java.lang.reflect.Method;
import
import
import
import
import
import
import
import
import
import
import

javax.annotation.PreDestroy;
org.hibernate.classic.Session;
org.hibernate.SessionFactory;
net.vidageek.mirror.dsl.Mirror;
br.com.caelum.vraptor.ioc.ApplicationScoped;
br.com.caelum.vraptor.ioc.Component;
br.com.caelum.vraptor.ioc.ComponentFactory;
br.com.caelum.vraptor.ioc.RequestScoped;
br.com.caelum.vraptor.proxy.MethodInvocation;
br.com.caelum.vraptor.proxy.Proxifier;
br.com.caelum.vraptor.proxy.SuperMethod;

/**
* <b>JIT (Just-in-Time) {@link Session} Creator</b> fbrica para o
* componente {@link Session} gerado de forma LAZY ou JIT(Just-in-Time)
* a partir de uma {@link SessionFactory}, que normalmente se encontra
* em um ecopo de aplicativo @{@link ApplicationScoped}.
*
* @author Tomaz Lavieri
* @since 1.0
*/
@Component
@RequestScoped
public class JITSessionCreator implements ComponentFactory<Session> {
private static final Method CLOSE =
new Mirror().on(Session.class).reflect().method("close").withoutArgs();
private static final Method FINALIZE =
new Mirror().on(Object.class).reflect().method("finalize").withoutArgs();

Captulo 9 - Poupando recursos - LAZY Dependency Injection - 22

Caelum VRaptor

private final SessionFactory factory;


/** Guarda a Proxy Session */
private final Session proxy;
/** Guarada a Session real. */
private Session session;
public JITSessionCreator(SessionFactory factory, Proxifier proxifier) {
this.factory = factory;
this.proxy = proxify(Session.class, proxifier); // *1*
}
/**
* Cria o JIT Session, que repassa a invocao de qualquer mtodo, exceto
* {@link Object#finalize()} e {@link Session#close()}, para uma session real,
* criando uma se necessrio.
*/
private Session proxify(Class<? extends Session> target, Proxifier proxifier) {
return proxifier.proxify(target, new MethodInvocation<Session>() {
@Override // *2*
public Object intercept(Session proxy, Method method, Object[] args,
SuperMethod superMethod) {
if (method.equals(CLOSE)
|| (method.equals(FINALIZE) && session == null)) {
return null; //skip
}
return new Mirror().on(getSession()).invoke().method(method)
.withArgs(args);
}
});
}
public Session getSession() {
if (session == null) // *3*
session = factory.openSession();
return session;
}
@Override
public Session getInstance() {
return proxy; // *4*
}

@PreDestroy
public void destroy() { // *5*
if (session != null && session.isOpen()) {
session.close();
}
}

Explicando alguns pontos chaves, comentados com // *N*

O Proxfier um objeto das libs do VRaptor que auxilia na criao de objetos proxys ele responsvel por
escolher a biblioteca que implementa o proxy dinmico, e ento invocar via callback um mtodo interceptor,
como falamos abaixo.

Neste ponto temos a implementao do nosso interceptor, sempre que um mtodo for invocado em nosso
proxy, esse intereptor invocado primeiro, ele filtra as chamadas ao mtodo finalize caso a Session real
Captulo 9 - Poupando recursos - LAZY Dependency Injection - 23

ainda no tenha sido criada, isso evita criar a Session apenas para finaliza-la. O mtodo close tambm
filtrado, isso feito para evitar criar uma session apenas para fech-la, e tambm por que o nosso
SessionCreator que o responsavel por fechar a session ao final do scopo, quando a request acabar.
Todos os outros mtodos so repassados para uma session atravs do mtodo getSession() onde
realmente que acontece o LAZY ou JIT.

Aqui onde acontece a mgica, da primeira vez que getSession() invocado a sesso criada, e ento
repassada, todas as outras chamadas a getSession() repassam a sesso anteriormente criada, assim,
se getSession() nunca for invocado, ou seja, se nenhum mtodo for invocado no proxy, getSession()
nunca ser invocado, e a sesso real no ser criada.

O retorno desse ComponentFactory a Session proxy, que s criar a session real se um de seus mtodos
for invocado.

Ao final do escopo o destroy invocado, ele verifica se a session real existe, existindo verifica se esta
ainda esta aberta, e estando ele fecha, desta forma possivel garantir que o recurso ser sempre liberado.
Assim podemos agora pedir uma Session sempre que acharmos que vamos precisar de uma, sabendo que
o recurso s ser realmente solicitado quando formos usar um de seus mtodos, salvando assim o recurso.
Esta mesma abordagem pode ser usada para outros recursos caros do sistema.
Os cdigos fonte para os ComponentFactory de EntityManager e Session que utilizo podem ser encontrados
neste link:

http://guj.com.br/posts/list/141500.java

C APTULO

10

Evitando que o browser faa cache das


pginas
por Otvio Scherer Garcia e Lucas Cavalcanti
Este interceptor indica ao browser para no efetuar cache das pginas, adicionando headers indicando que
a pgina atual est expirada.

@Intercepts
@RequestScoped
public class NoCacheInterceptor
implements Interceptor {
private final HttpServletResponse response;
public NoCacheInterceptor(HttpServletResponse response) {
this.response = response;
}
@Override
public boolean accepts(ResourceMethod method) {
return true; // allow all requests
}
@Override
public void intercept(InterceptorStack stack, ResourceMethod method,
Object resourceInstance)
throws InterceptionException {
// set the expires to past
response.setHeader("Expires", "Wed, 31 Dec 1969 21:00:00 GMT");
// no-cache headers for HTTP/1.1
response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
// no-cache headers for HTTP/1.1 (IE)
response.addHeader("Cache-Control", "post-check=0, pre-check=0");
// no-cache headers for HTTP/1.0
response.setHeader("Pragma", "no-cache");

stack.next(method, resourceInstance);

Voc pode tambm criar uma anotao para que apenas as classes anotadas evitem o cache.

@Target({ElementType.METHOD, ElementType.TYPE})

25

@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface NoCache {
}
E alterar o mtodo accepts do interceptor para o cdigo abaixo:

@Override
public boolean accepts(ResourceMethod method) {
return method.containsAnnotation(NoCache.class);
}

C APTULO

11

Usando Objectify com VRaptor


por Otvio Scherer Garcia
Para trabalhar de forma simples no VRaptor com a Objectify necessrio criar uma classe que inicie a
instncia da ObjectifyFactory. Como precisamos apenas de uma nica instncia esta classe pode possuir
escopo de aplicao:

@Component
@ApplicationScoped
public class ObjectifyFactoryCreator
implements ComponentFactory<ObjectifyFactory> {
private final ObjectifyFactory instance = new ObjectifyFactory();
@PostConstruct
public void create() {
instance.register(MyFirstEntity.class);
instance.register(MySecondEntity.class);
}

public ObjectifyFactory getInstance() {


return instance;
}

Aps criamos a classe que vai ser responsvel por criar as intncias de Objectify. Como precisamos de
uma nica instncia para cada requisio, o escopo deste componente ser request.

@Component
@RequestScoped
public class ObjectifyCreator
implements ComponentFactory<Objectify> {
private final ObjectifyFactory factory;
private Objectify ofy;
public ObjectifyCreator(ObjectifyFactory factory) {
this.factory = factory;
}
@PostConstruct
public void create() {
ofy = factory.begin();
}
public Objectify getInstance() {
return ofy;
27

Para utilizar a Objectify basta injet-la no construtor conforme o exemplo abaixo:

public class MyController {


private final Objectify ofy;
public MyController(Objectify ofy) {
this.ofy = ofy;
}

public void anything() {


ofy.get(new Key<MyFirstEntity>(MyFirstEntity.class, 1L));
}

C APTULO

12

Usando o Static Scanning no GAE/J


por Otvio Scherer Garcia
Uma das formas para diminuir o tempo de inicializao do VRaptor no GAE/J utilizar o Static Scanning.
Com esta funcionalidade o VRaptor busca pelos componentes no tempo de build. Desta forma o Scanning
Dinmico no necessrio.
Basta adicionar as seguintes linhas no seu build.xml e logo aps incluir esta task como dependncia da
task update.

<target name="vraptor-scanning" depends="compile">


<path id="build.classpath">
<fileset dir="war/WEB-INF/lib" includes="*.jar" />
</path>
<java classpathref="build.classpath"
classname="br.com.caelum.vraptor.scan.VRaptorStaticScanning" fork="true">
<arg value="war/WEB-INF/web.xml" />
<classpath refid="build.classpath" />
<classpath path="war/WEB-INF/classes" />
</java>
</target>

C APTULO

13

Usando o Header Referer para fazer


redirecionamentos
Geralmente quando voc clica em um link, ou submete um formulrio, o browser envia uma requisio para
o servidor da sua aplicao, colocando um Header chamado Referer, que contm qual a pgina atual, que
originou a requisio.
Voc pode usar esse Header com o VRaptor, para fazer os redirecionamentos:

import static br.com.caelum.vraptor.view.Results.referer;


@Resource
public class ShoppingController {
//...
public void adicionaItem(Item item) {
validator.checking(...);
validator.onErrorUse(referer()).forward();
dao.adiciona(item);

result.use(referer()).redirect();

O problema em usar o Referer que ele no obrigatrio. Ento quando o Referer no vem na requisio,
o VRaptor vai lanar uma IllegalStateException, e assim voc pode especificar uma outra lgica para ir caso o
Referer no seja especificado:

try {
result.use(referer()).redirect();
} catch (IllegalStateException e) {
result.use(logic()).redirectTo(HomeController.class).index();
}

C APTULO

14

Configurando o VRaptor na Locaweb


por Flavio Gabriel Duarte
Este tutorial tem como objetivo orientar o deploy de sistemas usando o framework VRaptor na Locaweb com
JVM decidado em ambiente Linux compartilhado.
Preparando o ambiente:
Toda a requisio que chega at a Locaweb vai primeiramente para o Apache e se necessrio no mod_jk
(
) passar enviar a requisio para o Tomcat, como explicado nessa
pgina

http://en.wikipedia.org/wiki/Mod_jk
http://wiki.locaweb.com.br/pt-br/Tomcat_integrado_com_o_Apache

A configurao sugerida pela Locaweb leva em conta que a sua aplicao no usa nenhum framework,
apenas arquivos jsps e servlets configurado pelo arquivo web.xml.
Como o VRaptor no usa o web.xml para definir as urls a configurao sugerida pela Locaweb no funcionar. Para funcionar voc precisa abrir um chamado na Locaweb informando que gostaria de usar o framework e escrever a seguinte regra: JkMount /* [login] >> TOMCAT e a pasta do servidor que deseja aplicar a regra
caso no seja a raiz.
Aguarde a resposta do chamado para saber quando estar funcionando. O procedimento leva +- 24h para
eles realizarem, ento pea com antecedncia.
Aps isso basta enviar a sua aplicao para a Locaweb e reinicar o ambiente que ela estar funcionando. A Locaweb no aceita deploy com arquivos WAR, para enviar os arquivos pelo WAR voc
precisaria envi-lo pelo FTP e depois descompactar pelo SSH. Se voc est usando o eclipse para
desenvolver a sua aplicao e o recurso servers do prprio eclipse, a sua aplicao fica dentro de
workspace/.metadata/.plugins/org.eclipse.wst.server.core. Dentro deve ter algumas pasta tmp isso vai de
acordo com a quantidade de servidores que voc tenha, alguma delas deve ser a sua aplicao. Como a
aplicao est disposta dentro desta pasta, ela poderia ir para a locaweb e ser executada. Essa no a melhor
de fazer o deploy, mas uma das aceitas neste tipo de ambiente na Locaweb.
A Locaweb define um timeout de 15 segundos em suas conexes MySQL, se voc tiver usando este
banco e no atentar para isso ter problemas, para contornar essa problema voc pode seguir a sugesto da Locaweb
ou configurar o c3p0 como descrito nesse post
respeitando o tempo imposto pela Locaweb.

http://wiki.locaweb.com.br/pt-br/Resolvendo_Problemas_Conex%C3%A3o_JAVA_
com_MYSQL
http://blog.caelum.com.br/2009/10/19/
a-java-net-socketexception-broken-pipe/

C APTULO

15

VRaptor e Tiles 2.2


por Rogerio Alcantara em

http://www.guj.com.br/posts/list/215206.java#1098196

baixar o tiles-jsp.jar. Como estou utilizando maven2:

<dependency>
<groupId>org.apache.tiles</groupId>
<artifactId>tiles-jsp</artifactId>
<version>2.2.2</version>
<type>jar</type>
<scope>compile</scope>
</dependency>
No web.xml:

<!-- tiles configuration -->


<servlet>
<servlet-name>TilesServlet</servlet-name>
<servlet-class>org.apache.tiles.web.startup.TilesServlet</servlet-class>
<init-param>
<param-name>org.apache.tiles.factory.TilesContainerFactory.MUTABLE</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
<!-- /tiles configuration -->
<!-- vraptor configuration -->
<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>
<!-- vraptor configuration -->
Repare que no declarado o DEFINITIONS_CONFIG, nem registrado o TilesDispatchServlet. Pois no
utilizaremos arquivo para guardar as definitions, e quem cuidara dos redirecionamentos continuar sendo o
VRaptor, que j faz isso muito bem obrigado! ;D Outro detalhe importante, deixar o TilesContainerFactory
como MUTABLE. ;)
32

Caelum VRaptor

TilesPathResolver?
Nessa abordagem, no necessrio criar implementar esse PathResolver, j que essa responsabilidade
continuar sendo do VRaptor. ;D
/WEB-INF/jsp/template.jsp - servir de base para todas as pginas

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>


<%@ taglib prefix="tiles" uri="http://tiles.apache.org/tags-tiles" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>site</title>
</head>
<body>
<div id="divHeader">
<tiles:insertTemplate template="/WEB-INF/jsp/header.jsp"/>
</div>
<div id="divContent">
<tiles:insertAttribute name="body"/>
</div>
<div id="divFooter">
<tiles:insertTemplate template="/WEB-INF/jsp/footer.jsp"/>
</div>
</body>
</html>
/WEB-INF/jsp/home/index.jsp - exemplo que utilizar o template - repare que o path mantm a conveno do VRaptor3! ^^

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>


<%@ taglib prefix="tiles" uri="http://tiles.apache.org/tags-tiles" %>
<tiles:insertTemplate template="/WEB-INF/jsp/template.jsp">
<tiles:putAttribute name="body">
ol mundo!
</tiles:putAttribute>
</tiles:insertTemplate>
HomeController.java - e finalmente o controler para redirecionar para index.jsp

@Resource
public class HomeController {
private Result result;
public HomeController(final Result result) {

}
}

super();
this.result = result;

public void index() { }

Captulo 15 - VRaptor e Tiles 2.2 - 33

Caelum VRaptor

Prontinho! Estamos utilizando o tiles apenas para montar o template das pginas, o redirecionamento
continua sendo cargo do VRaptor! ^^
S tem um detalhe que eu gostaria de compartilhar, pois me deu muito trabalho de descobrir: suponha que
eu queria estender o template.jsp para incluir um outro body. (tive essa necessidade na seo about do site..)
/WEB-INF/jsp/about/about_base.jsp - base que estender a template.jsp para alterar o layout

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>


<%@ taglib prefix="tiles" uri="http://tiles.apache.org/tags-tiles" %>
<tiles:insertTemplate template="/WEB-INF/jsp/template.jsp">
<tiles:putAttribute name="body">
<div id="divCenter">
<tiles:insertAttribute name="content" />
</div>
<div id="divRight">
<p>
<tiles:insertAttribute name="content_right" />
</p>
</div>
</tiles:putAttribute>
</tiles:insertTemplate>
Pronto, agora a minha pgina do about, estender about_base.jsp e no template.jsp, por exemplo:
/WEB-INF/jsp/about/whyUse.jsp - estender o about_base.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>


<%@ taglib prefix="tiles" uri="http://tiles.apache.org/tags-tiles" %>
<tiles:insertTemplate template="/WEB-INF/jsp/about/about_base.jsp" flush="true">
<tiles:putAttribute name="content" cascade="true">
o contedo central!
</tiles:putAttribute>
<tiles:putAttribute name="content_right" cascade="true">
o contedo da direita!
</tiles:putAttribute>
</tiles:insertTemplate>
Repare que dessa vez, o insertTemplate possui o atributo flush="true": isso importante para que
a about_base.jsp seja reinderizado primeiro. Note tambm que os putAttributes possuem o atributo cascade="true": que serve para disponibilizar esses atributos para os templates de cima.
Bom, isso foi bem chatinho de descobrir, mas agora a aplicao est rodando bunitinha, sem um xml, com
o layout definido nas JSPs e com o mnimo de interferncia no VRaptor3! ^^

Captulo 15 - VRaptor e Tiles 2.2 - 34