Documentação

1. 01 VRaptor3 - O guia inicial de 1 minuto
2. 02 VRaptor3 - O guia inicial de 10 minutos
3. 03 Resources-Rest
4. 04 Componentes
5. 05 Conversores
6. 06 Interceptadores
7. 07 Validação
8. 08 View e Ajax
9. 09 Injeção de dependências
10. 10 Download e Upload
11. 11 Componentes utilitários opcionais
12. 12 Sobrescrevendo as convenções e o comportamento do VRaptor
13. 13 Spring, Joda Time e Hibernate
14. 14 Google App Engine
15. 15 Testando componentes e controllers
16. 16 Scala
17. 17 Otimizações
18. 18 VRaptor Scaffold
19. 19 Tratamento de Exceções
20. 20 Como contribuir com o VRaptor
21. 21 Changelog
22. 22 Migrando do VRaptor2 para o VRaptor3

15Testando componentes e controllers

Criar um teste unitário do seu controller VRaptor costuma ser muito fácil: dado o desacoplamento das suas classes com a API javax.servlet e os parâmetros serem populados por meio do request, seu teste será como o de uma classe qualquer, sem mistérios.

Como o VRaptor3 gerencia as dependências da sua classe, você não precisa se preocupar com a criação dos seus componentes e controllers, basta receber suas dependências no construtor que o VRaptor3 vai procurá-las e instanciar sua classe.

Na hora de testar suas classes você pode aproveitar que todas as dependências estão sendo recebidas no construtor e passar implementações falsas (mocks) dessas dependências, para testar unitariamente sua classe. No entanto, os componentes do VRaptor3 que vão ser mais presentes na sua aplicação - o Result e o Validator - possuem a interface fluente, o que dificulta a criação de implementações falsas (mocks). Por causa disso existem implementações falsas já disponíveis no VRaptor3: MockResult e MockValidator. Isso facilita em muito os seus testes que seriam mais complexos.

MockResult

O MockResult ignora os redirecionamentos que você fizer, e acumula os objetos incluídos, para você poder inspecioná-los e fazer as suas asserções. Um exemplo de uso seria:

MockResult result = new MockResult();
ClienteController controller = new ClienteController(..., result);
controller.list(); // vai chamar result.include("clients", algumaCoisa);
List<Client> clients = result.included("clients"); // o cast é automático
Assert.assertNotNull(clients);
// mais asserts

Quaisquer chamadas do tipo result.use(...) vão ser ignoradas.

MockValidator

O MockValidator vai acumular os erros gerados, e quando o validator.onErrorUse for chamado, vai lançar um ValidationError caso haja algum erro. Desse jeito, você pode inspecionar os erros adicionados, ou simplesmente ver se deu algum erro:

@Test(expected=ValidationException.class)
public void testaQueVaiDarErroDeValidacao() {
    ClienteController controller = new ClienteController(..., new MockValidator());
    controller.adiciona(new Cliente());
}

ou

@Test
public void testaQueVaiDarErroDeValidacao() {
    ClienteController controller = new ClienteController(..., new MockValidator());
    try {
        controller.adiciona(new Cliente());
        Assert.fail();
    } catch (ValidationException e) {
        List<Message> errors = e.getErrors();
        //asserts nos erros
    }
}

Se você usa o Hibernate Validator e tem a chamada validator.validate(objeto) no método do seu controller, você pode usar a classe HibernateMockValidator, que validará o objeto com as regras definidas pelo Hibernate Validator.