documentação
documentação toda em português, configuração, migração e utilização.
- 1. VRaptor3 - Guia de 1 minuto
- 2. VRaptor3 - o guia inicial de 10 minutos
- 3. Resources-Rest
- 4. Componentes
- 5. Conversores
- 6. Interceptadores
- 7. Validação
- 8. View e Ajax
- 9. Injeção de dependências
- 10. Download e Upload
- 11. Componentes Utilitários Opcionais
- 12. Configurações avancadas: sobrescrevendo as convenções e comportamento do VRaptor
- 13. Spring, Joda Time, Hibernate
- 14. Google App Engine
- 15. Testando componentes e controllers
- 16. Scala
- 17. Otimizações
- 18. VRaptor Scaffold
- 19. Exception handling
- 20. Como contribuir com o VRaptor
- 21. ChangeLog
- 22. Migrando do VRaptor2 para o VRaptor3
Componentes
O que são componentes?
Componentes são instâncias de classes que seu projeto precisa para executar tarefas ou armazenar estados em diferentes situações.
Exemplos clássicos de uso de componentes seriam os Daos, enviadores de email etc.
A sugestão de boa prática indica sempre criar uma interface para seus componentes. Dessa maneira seu código também fica mais fácil de testar unitariamente.
O exemplo a seguir mostra um componente a ser gerenciado pelo vraptor:
@Component
public class ClienteDao {
private final Session session;
public ClienteDao(Session session) {
this.session = session;
}
public void adiciona(Cliente cliente) {
session.save(cliente);
}
}Escopos
Assim como os recursos, os componentes vivem em um escopo específico e seguem as mesmas regras, por padrão pertencendo ao escopo de requisicão, isto é, a cada nova requisição seu componente será novamente instanciado.
O exemplo a seguir mostra o fornecedor de conexoes com o banco baseado no hibernate. Esse fornecedor esta no escopo de aplicacação, portanto será instanciado somente uma vez por contexto:
@ApplicationScoped
@Component
public class HibernateControl {
private final SessionFactory factory;
public HibernateControl() {
this.factory = new AnnotationConfiguration().configure().buildSessionFactory();
}
public Session getSession() {
return factory.openSession();
}
}Os escopos implementados são:
@RequestScoped - o componente é o mesmo durante uma requisição
@SessionScoped - o componente é o mesmo durante uma http session
@ApplicationScoped - component é um singleton, apenas um por aplicação
@PrototypeScoped - component é instanciado sempre que requisitado.
ComponentFactory
Muitas vezes você quer receber como dependência da sua classe alguma classe que não é do seu projeto, como por exemplo uma Session do hibernate ou um EntityManager da JPA.
Para poder fazer isto, basta criar um ComponentFactory:
@Component
public class SessionCreator implements ComponentFactory<Session> {
private final SessionFactory factory;
private Session session;
public SessionCreator(SessionFactory factory) {
this.factory = factory;
}
@PostConstruct
public void create() {
this.session = factory.openSession();
}
public Session getInstance() {
return session;
}
@PreDestroy
public void destroy() {
this.session.close();
}
}Note que você pode adicionar os listeners @PostConstruct e @PreDestroy para controlar a criação e destruição dos recursos que você usa. Isso funciona para qualquer componente que você registrar no VRaptor.
Injeção de dependências
O VRaptor utiliza um de seus provedores de injeção de dependências para controlar o que é necessário para instanciar cada um de seus componentes e recursos.
Sendo assim, os dois exemplos anteriores permitem que qualquer um de seus recursos ou componentes receba um ClienteDao em seu construtor, por exemplo:
@Resource
public class ClienteController {
private final ClienteDao dao;
public ClienteController(ClienteDao dao) {
this.dao = dao;
}
@Post
public void adiciona(Cliente cliente) {
this.dao.adiciona(cliente);
}
}
