Assert Object pattern to bardzo prosty wzorzec który możesz zastosować w kodzie testowym sprawiając, że będą prostsze i bardziej czytelne. Koncentruje się na fazie sprawdzania obiektów ukrywając złożoność sprawdzenia. Pokazuje znaczenie biznesowe jakie sprawdzamy.
Jako przykład weźmy klasę Basket reprezentującą koszyk zakupowy. Po dodaniu do koszyka produktu chcemy sprawdzić, czy znajduje się on w koszyku, ilość produktów jest równa 1, a cena za produkty wynosi dokładnie cenę tego produktu:
@Test
@DisplayName("Inserts single product into empty basket")
void insertsSingleProductIntoEmptyBasket() {
// given
var basket = make(an(EmptyBasket));
var product = make(a(BasicProduct));
// when
basket.insert(product);
// then
assertThat(basket.getInsertedProducts().size()).isEqualTo(1);
assertThat(basket.getInsertedProducts()).containsExactly(product);
assertThat(basket.getItemsTotalPrice()).isEqualTo(product.getPrice());
}
W fazie sprawdzenia (assert) w testach częstym problemem jest zbytnie skupianie się na technicznych aspektach. Powoduje to dwie konsekwencje:
- fazy assert są długie i mało czytelne,
- skupiają się na technikaliach zamiast wyrażać wartość biznesową.
Kod koncentruje się na wewnętrznym modelu. I dobrze, bo ma go przetestować. Natomiast jeżeli istnieje więcej testów, te asercje trzeba by było kopiować. Jeżeli dodanie produktu do koszyka tworzyłoby jeszcze jakiś dodatkowy efekt – wtedy należałoby zmodyfikować wszystkie testy.
Możesz zastosować prostą refaktoryzację wynosząc te sprawdzenia do osobnej metody w teście, albo zastosować Assert Object Pattern.
Assert Object Pattern
Ideą wzorca Assert Object jest „owinięcie” testowanego obiektu w obiekt Assert i stworzenie metod sprawdzających. W naszym przypadku będziemy testować obiekt Basket, więc utworzę BasketAssert:
@RequiredArgsConstructor(staticName = "assertThatBasket")
public class BasketAssert {
private final Basket basket;
public BasketAssert isEmpty() {
assertThat(basket.getInsertedProducts())
.isEmpty();
return this;
}
public BasketAssert holdsProducts(Product... products) {
assertThat(basket.getInsertedProducts())
.containsOnly(products)
.hasSize(products.length);
assertThat(basket.getItemsTotalPrice())
.isEqualTo(Stream.of(products)
.map(Product::getPrice)
.reduce(BigDecimal.ZERO, BigDecimal::add));
return this;
}
}
Wtedy użycie w teście wygląda tak:
@Test
@DisplayName("Inserts single product into empty basket")
void insertsSingleProductIntoEmptyBasket() {
// given
var basket = make(an(EmptyBasket));
var product = make(a(BasicProduct));
// when
basket.insert(product);
// then
assertThatBasket(basket).holdsProducts(product);
}
Faza assert skróciła się i sprawdza biznesowe znaczenie, zamiast technikalia, sprawdzając je pole po polu.
Dla bardziej złożonych obiektów, kiedy wiele pól reprezentuje jakiś spójny stan, dzięki Assert Object Pattern możesz sprawdzić je wszystkie. Kiedy testujesz logikę tworzącą takie obiekty (lub operujące na nich), możesz w łatwy sposób sprawdzić czy wszystkie pola się zgadzają.
Dodatkową korzyścią jest to, że w przypadku refaktoryzacji, możesz dołożyć kolejne pole do sprawdzenia, lub usunąć istniejące.
Inne uproszczenia fazy Assert
Innymi uproszczeniami w fazie assert może być:
- Podczas różnego rodzaju konwersji, porównanie obiektu nie pole-po-polu, ale jako całość korzystając z wzorcowego obiektu stworzonego przez Test Data Builder (czytaj więcej).
- W przypadku testów komponentowych, interakcji na mockach, można skorzystać z nazwanych klas Steps, które ukrywają złożoność procesową i sprawdzanie konkretnych argumentów (czytaj więcej).
Podsumowanie
Ideą wzorca Assert Object jest „owinięcie” testowanego obiektu w obiekt Assert i stworzenie metod sprawdzających. Metody sprawdzające mogą mieć biznesowe znaczenie i sprawdzać wiele pól określając, czy obiekt jest spójny.
Faza sprawdzenia w teście mocno się upraszcza. Można wyrazić biznesowe znaczenie, zamiast koncentrować się nad technikaliami. Wprowadza uwspólnienie kodu pomiędzy testami.
Podoba Ci się ten artykuł? Weź więcej.
Jeżeli uważasz ten materiał za wartościowy i chcesz więcej treści tego typu – nie przegap ich i otrzymuj je prosto na swoją skrzynkę. Nawiążmy kontakt.
Wpis który czytasz to zaledwie fragment wiedzy zawartej w Programie szkoleniowym Java Developera od SoftwareSkill. Mamy do przekazania sporo usystematyzowanej wiedzy z zakresu kluczowych kompetencji i umiejętności Java Developera. Program składa się z kilku modułów w cotygodniowych dawkach wiedzy w formie video.
Gdybyś potrzebował jeszcze więcej:
Jesteś Java Developerem?
Przejdź na wyższy poziom wiedzy
„Droga do Seniora” 🔥💪
Jesteś Team Leaderem? Masz zespół?
Podnieś efektywność i wiedzę swojego zespołu 👌
