Wdrażanie migracji z JUnit 4 do JUnit 5 można przeprowadzić krok po kroku, a przez pewien czas możesz pracować z podejściem hybrydowym dla dojrzałych projektów. W artykule zostaną porównane wymagane zależności JUnit 4 i JUnit 5. Następnie porówna równoważne adnotacje JUnit 4 i JUnit 5.

1. Kroki między JUnit 4 i JUnit 5

JUnit 5 to nowy paradygmat wprowadzający nową architekturę. Wprowadza również nowe pakiety, adnotacje, metody i klasy. Niektóre funkcje JUnit 5 są podobne do funkcji JUnit 4; inne są nowe, zapewniając nowe możliwości. Model programowania i rozszerzeń JUnit Jupiter nie obsługuje natywnie funkcji JUnit 4, takich jak reguły i elementy uruchamiające. Nie musimy aktualizować wszystkich istniejących testów, rozszerzeń testów i niestandardowej infrastruktury testowej, aby migrować projekty do JUnit Jupiter - przynajmniej nie natychmiast.

JUnit zapewnia ścieżkę migracji za pomocą silnika testowego JUnit Vintage; Tabela 1 podsumowuje najważniejsze kroki. Daje to możliwość wykonywania testów w oparciu o stare wersje JUnit z wykorzystaniem infrastruktury Platformy JUnit. Wszystkie klasy i adnotacje specyficzne dla JUnit Jupiter znajdują się w nowym pakiecie podstawowym org.junit.jupiter. Wszystkie klasy i adnotacje specyficzne dla JUnit 4 znajdują się w starym pakiecie podstawowym org.junit. Tak więc posiadanie zarówno JUnit 4, jak i JUnit 5 Jowisza w ścieżce klas nie powoduje konfliktu. Dzięki temu nasze projekty mogą zachować wdrożone wcześniej testy JUnit 4 razem z testami JUnit Jupiter. JUnit 5 i JUnit 4 mogą współistnieć, dopóki nie sfinalizujemy naszej migracji, kiedy tylko jest to możliwe, a migrację tę można zaplanować i przeprowadzić powoli w oparciu o priorytety zadań i wyzwania poszczególnych etapów.

Główny krok	Komentarz
Zastąp potrzebne zależności.	Niektóre adnotacje JUnit 5 odzwierciedlają stare JUnit 4. Niektóre nowe adnotacje wprowadzają nowe udogodnienia i pomagają nam pisać lepsze testy.
Zastąp adnotacje i wprowadź nowe.	Niektóre adnotacje JUnit 5 odzwierciedlają stare JUnit 4. Niektóre nowe adnotacje wprowadzają nowe udogodnienia i pomagają nam pisać lepsze testy.
Zastąp klasy i metody testujące.	Asercje i założenia JUnit 5 zostały przeniesione do różnych klas w różnych pakietach.
Zastąp reguły JUnit 4 i biegaczy modelem rozszerzenia JUnit 5.	Ten krok zazwyczaj wymaga więcej wysiłku niż pozostałe kroki w tej tabeli. Ponieważ JUnit 4 i JUnit 5 mogą współistnieć przez długi czas, reguły i elementy uruchamiające mogą pozostać w kodzie lub zostać zastąpione znacznie później.

Przed opracowaniem i uruchomieniem testów JUnit

• JUnit 4 wymaga Java 5 lub nowszej
• JUnit 5 wymaga oprogramowania Java 8 lub nowszego

W związku z tym migracja z JUnit 4 do JUnit 5 może wymagać aktualizacji wersji Java używanej w projekcie.

Zainteresowany JUnit? Sprawdź nasze szkolenia.

Catalin Tudose
Java and Web Technologies Expert