(Este é um post que publiquei no antigo blog da SEA Tecnologia. Como ainda é relevante, resolvi republicá-lo.)
Uma das muitas aprendizagens que adquiri na antiga SEA Tecnologia é a criação de utilitários de teste.
Utilitários de teste são uma maneira de reaproveitar código em testes unitários. Usualmente, isso é feito utilizando os métodos setUp
ou @Before
dos casos de teste, mas isso tem algumas desvantagens. Por exemplo, em um caso de teste, podemos ter a seguinte inicialização:
private Address address;
private AddressDAO addressDAO;
@Before
public void setUp() {
address = new Address();
address.setStreet("Rua fulano");
address.setNumber("123/A");
addressDAO = new AddressDAO();
}
Code language: PHP (php)
Essa inicialização funciona bem no teste abaixo…
@Test
public void testGetAllAddresses(){
addressDAO.addAddress(address);
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(1, addresses.size());
assertEquals("Rua fulano", addresses.get(0).getStreet());
assertEquals("123/A", addresses.get(0).getNumber());
}
Code language: PHP (php)
Agora, se tivermos o teste a seguir, o objeto criado é desperdiçado:
@Test
public void testGetNoAddress() {
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(0, addresses.size());
}
Code language: PHP (php)
Se o código for como o seguinte, teremos redundância de código. também temos de decidir SE o outro objeto deve ser criado no @Before
também ou no método.
@Test
public void testGetAllAddressesMoreThanOne() {
addressDAO.addAddress(address);
Address address2 = new Address();
address2.setStreet("Outra rua");
address2.setNumber("111");
addressDAO.addAddress(address2);
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(1, addresses.size());
assertEquals("Rua fulano", addresses.get(0).getStreet());
assertEquals("123/A", addresses.get(0).getNumber());
}
Code language: PHP (php)
Esses inconvenientes são menores quando comparados à tarefa de criar uma rede de dependências. Por exemplo, para testar uma classe Person
que agrega um Address
em um outro caso de teste, teremos de ter um @Before
semelhante a esse:
private Person person;
private Address address;
private PersonDAO personDAO;
@Before
public void setUp() {
address = new Address();
address.setStreet("Rua fulano");
address.setNumber("123/A");
person = new Person();
person.setName("João");
person.setAddress(address);
personDAO = new PersonDAO();
}
Code language: PHP (php)
O código para a criação de endereços foi duplicado, e é difícil criar as dependências. Nesses exemplos, vemos casos simples, mas é fácil visualizar como a situação irá se complicar.
Nós solucionamos esse problema criando uma classe para criar esses objetos. Essa classe seria algo como isso:
public class TestUtil {
public static Address utilCreateAddress(String street, String number) {
Address address = new Address();
address.setStreet("Rua fulano");
address.setNumber("123/A");
return address;
}
public static Person utilCreatePerson(String name, Address address) {
Person person = new Person();
person.setName(name);
person.setAddress(address);
return person;
}
}
Code language: JavaScript (javascript)
Nossos casos de teste estendiam a TestUtil
, facilitando a criação de objetos:
public class TestAddress2 extends TestUtil {
private AddressDAO addressDAO = new AddressDAO();
@Test
public void testGetAllAddresses() {
Address address = utilCreateAddress("Rua fulano", "123/A");
addressDAO.addAddress(address);
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(1, addresses.size());
assertEquals("Rua fulano", addresses.get(0).getStreet());
assertEquals("123/A", addresses.get(0).getNumber());
}
@Test
public void testGetNoAddress() {
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(0, addresses.size());
}
@Test
public void testGetAllAddressesMoreThanOne() {
Address address = utilCreateAddress("Rua fulano", "123/A");
Address address2 = utilCreateAddress("Outra rua", "111");
addressDAO.addAddress(address);
addressDAO.addAddress(address2);
List<Address> addresses = addressDAO.getAllAddresses();
assertEquals(2, addresses.size());
assertEquals("Rua fulano", addresses.get(0).getStreet());
assertEquals("123/A", addresses.get(0).getNumber());
}
}
Code language: PHP (php)
Como também precisávamos frequentemente de um objeto qualquer, ou que apenas um ou outro parâmetro fosse definido, criávamos variantes dos métodos:
public static Address utilCreateAddress() {
return utilCreateAddress("Qualquer", "Qualquer");
}
public static Person utilCreatePerson() {
return utilCreatePerson("José", utilCreateAddress());
}
Code language: PHP (php)
Aprendemos isto em um projeto um tanto complexo, com grandes redes de dependências de objetos. O uso desses utilitários de teste viabilizou a prática de TDD no sistema. Era emocionante descobrir que, para criar aquele documento que dependia de sete outros documentos e uns cinco ou seis usuários, bastava chamar um método.
Naturalmente, há mais sobre nossos utilitários de teste do que foi escrito aqui, e pode haver mais ainda que sequer fizemos. (Por exemplo, pode ser interessante produzir utilitários de teste para classes específicas, ao invés de um gigantesco utilitário) Entretanto, como a ideia é bem simples, esperamos que esse pontapé inicial lhe motive a pensar sobre o tema. Até mais!
Post Revisions:
- October 29, 2023 @ 19:15:35 [Current Revision] by brandizzi
- October 29, 2023 @ 19:15:35 by brandizzi
- October 26, 2023 @ 10:05:40 by brandizzi
- October 26, 2023 @ 10:04:43 by brandizzi