JUnit: τι είναι, βασικές έννοιες και πώς λειτουργεί

Τι είναι το JUnit;

Το JUnit είναι ένα framework ανοιχτού κώδικα για τη σύνταξη και εκτέλεση επαναλαμβανόμενων αρθρωματικών δοκιμών σε Java και Kotlin. Ανήκει στο οικοσύστημα xUnit — μια οικογένεια frameworks που βασίζονται στην αρχιτεκτονική των Kent Beck και Erich Gamma, και είναι το τυπικό εργαλείο δοκιμών στο Android Studio και στο IntelliJ IDEA.

Η κύρια αποστολή του JUnit είναι να απομονώσει ένα μικρό τμήμα κώδικα (μέθοδο, κλάση) και να ελέγξει τη συμπεριφορά του σε ελεγχόμενες συνθήκες. Οι δοκιμές γράφονται ως συνηθισμένες κλάσεις Java/Kotlin με annotations, και το framework αναλαμβάνει την ανίχνευση δοκιμών, την διαχείριση του κύκλου ζωής τους και τη συλλογή στατιστικών εκτέλεσης.

Η πρώτη έκδοση του JUnit εμφανίστηκε το 1997 και άλλαξε ριζικά την προσέγγιση στην ανάπτυξη, διαδίδοντας τις πρακτικές Test-Driven Development (TDD). Σήμερα, το JUnit 5 (Jupiter) είναι η τρέχουσα έκδοση, πλήρως επανασχεδιασμένη με αρθρωματική αρχιτεκτονική και υποστήριξη για Java 8+ και επεκτάσεις.

Πώς λειτουργεί το JUnit

Ο μηχανισμός εκτέλεσης του JUnit βασίζεται στο μοτίβο Test Runner, το οποίο σαρώνει το classpath, βρίσκει μεθόδους με την annotation @Test, δημιουργεί ένα στοιχείο της κλάσης δοκιμής και εκτελεί τις μεθόδους σε μια συγκεκριμένη σειρά. Το Test Runner διαχειρίζεται τον κύκλο ζωής: κλήση BeforeAll → BeforeEach → Test → AfterEach → AfterAll.

Κύκλος ζωής της κλάσης δοκιμής

Το JUnit περιτυλίσσει κάθε μέθοδο δοκιμής σε ξεχωριστό στοιχείο της κλάσης, πράγμα που εγγυάται απομόνωση μεταξύ δοκιμών. Αυτό σημαίνει ότι τα πεδία της κλάσης δεν διατηρούν κατάσταση μεταξύ διαφορετικών μεθόδων @Test — κάθε δοκιμή ξεκινάει με ένα καθαρό αντικείμενο.

Βασική δομή δοκιμής

Η απλούστερη δοκιμή στο JUnit μοιάζει με μία μέθοδο με την annotation @Test, μέσα στην οποία καλείται ο δοκιμαζόμενος κώδικας και ελέγχεται το αποτέλεσμα μέσω μιας assertion. Εάν η assertion αποτύχει — η δοκιμή θεωρείται αποτυχημένη και το JUnit αναφέρει σφάλμα.

@Test
void additionShouldReturnCorrectSum() {
    var calculator = new Calculator();
    var result = calculator.add(2, 3);
    assertEquals(5, result);
}

Το Test Runner βρίσκει αυτόματα μία τέτοια μέθοδο, την εκτελεί και αναφέρει το αποτέλεσμα. Εάν η μέθοδος δεν πετάει εξαίρεση — η δοκιμή είναι επιτυχημένη (green). Εάν η assertion δεν λειτουργεί — η δοκιμή αποτυχάνει (red).

Annotations JUnit: κύκλος ζωής δοκιμής

Οι annotations του JUnit καθορίζουν πότε και πώς πρέπει να εκτελείται ο κώδικας δοκιμής. Στο JUnit 5, οι annotations βρίσκονται στο πακέτο org.junit.jupiter.api και καλύπτουν όλα τα στάδια: προετοιμασία δεδομένων, εκτέλεση δοκιμής, καθαρισμός πόρων.

Παράδειγμα χρήσης annotations

Ας δούμε μια πλήρη κλάση δοκιμής με σωστό κύκλο ζωής. Η μέθοδος setUp δημιουργεί μία νέα περίπτωση Calculator πριν από κάθε δοκιμή, και η tearDown απελευθερώνει πόρους — για παράδειγμα, κλείνει δείκτες αρχείων ή συνδέσεις βάσης δεδομένων.

class CalculatorTest {

    private Calculator calculator;

    @BeforeEach
    void setUp() {
        calculator = new Calculator();
    }

    @Test
    void subtractionShouldReturnCorrectResult() {
        int result = calculator.subtract(10, 4);
        assertEquals(6, result);
    }

    @AfterEach
    void tearDown() {
        calculator.reset();
    }
}

Assertions: έλεγχος αποτελεσμάτων στο JUnit

Οι Assertions είναι στατικές μεθοδοι που συγκρίνουν το πραγματικό αποτέλεσμα με το αναμενόμενο και πετάνε εξαίρεση σε περίπτωση αναντιστοιχίας. Το JUnit 5 προσφέρει την κλάση org.junit.jupiter.api.Assertions με πάνω από 25 μεθόδους για διαφορετικά σενάρια ελέγχου — από την απλή σύγκριση τιμών μέχρι τον έλεγχο timeout και ομαδικών assertions.

• assertEquals(expected, actual) — ελέγχει την ισότητα μέσω equals().
• assertTrue(condition) — ελέγχει ότι η συνθήκη είναι αληθής.
• assertFalse(condition) — ελέγχει ότι η συνθήκη είναι ψευδής.
• assertNotNull(object) — ελέγχει ότι το αντικείμενο δεν είναι null.
• assertNull(object) — ελέγχει ότι το αντικείμενο είναι null.
• assertThrows(exception, executable) — ελέγχει ότι ο κώδικας πετάει την καθορισμένη εξαίρεση.
• assertAll(executables) — ομαδοποιεί πολλά διαβασματικά και τα εκτελεί όλα χωρίς να σταματάει στο πρώτο σφάλμα.

assertThrows για έλεγχο εξαιρέσεων

Η μέθοδος assertThrows αξίζει ιδιαίτερη προσοχή — επιτρέπει τον έλεγχο ότι ο κώδικας διαχειρίζεται σωστά τις λανθασμένες καταστάσεις — διαίρεση διά μηδενός, μεταβίβαση null, υπέρβαση ορίων.

@Test
void divisionByZeroShouldThrowException() {
    Calculator calc = new Calculator();

    ArithmeticException exception = assertThrows(
        ArithmeticException.class,
        () -> calc.divide(10, 0)
    );

    assertEquals("Cannot divide by zero", exception.getMessage());
}

Παραμετροποιημένες δοκιμές στο JUnit

Οι παραμετροποιημένες δοκιμές επιτρέπουν την εκτέλεση της ίδιας μεθόδου δοκιμής με διαφορετικά σύνολα ορισμάτων. Στο JUnit 5, για αυτό χρησιμοποιείται η annotation @ParameterizedTest σε συνδυασμό με μια πηγή δεδομένων — @ValueSource, @CsvSource, @MethodSource ή @EnumSource.

Αυτή η προσέγγιση μειώνει δραστικά την επανάληψη κώδικα: αντί για δέκα παρόμοιες δοκιμές για διαφορετικές τιμές, γράφεται μία παραμετροποιημένη μέθοδος. Σύμφωνα με το Google Testing Blog, η παραμετροποίηση μειώνει τον όγκο κώδικα δοκιμής κατά 40–60% χωρίς απώλεια καλύψης.

Παράδειγμα με CsvSource

Η annotation @CsvSource στέλνει πολλές γραμμές με διαχωριστή το κόμμα στη δοκιμή. Κάθε γραμμή αντιστοιχεί σε μία εκτέλεση δοκιμής. Το JUnit μετατρέπει αυτόματα τις τιμές συμβολοσειρών στους απαιτούμενους τύπους: int, long, String και άλλα.

@ParameterizedTest
@CsvSource({
    "1,    1,   2",
    "2,    3,   5",
    "10,  20,  30",
    "-1,   1,   0"
})
void additionWithMultipleInputs(int a, int b, int expected) {
    assertEquals(expected, a + b);
}

MethodSource για σύνθετα αντικείμενα

Όταν τα δεδομένα εισόδου είναι πιο σύνθετα από απλούς αριθμούς ή συμβολοσειρές, χρησιμοποιείται το @MethodSource. Αναφέρεται σε μια στατική μέθοδο που επιστρέφει ένα Stream ορισμάτων — για παράδειγμα, Stream of Arguments ή ένα Stream αντικειμένων User για τη δοκιμή του επιπέδου DAO.

Ενσωμάτωση JUnit με έργα Android

Στην ανάπτυξη Android, το JUnit χρησιμοποιείται με το AndroidX Test, το οποίο παρέχει επεκτάσεις για τη δοκιμή Activity, Content Provider και άλλων συνιστωσών Android. Το JUnit είναι υπεύθυνο για τις αρθρωματικές δοκιμές (unit tests) που εκτελούνται στο JVM χωρίς εμπλαιστηωτή, και το AndroidX Test για τις εργαλειακές δοκιμές στη συσκευή.

Ρύθμιση Gradle

Για τη σύνδεση JUnit 5 σε ένα έργο Android, αρκεί η προσθήκη της εξάρτησης org.junit.jupiter:junit-jupiter στο build.gradle σε επίπεδο αρθρώματος. Το AGP Gradle plugin υποστηρίζει την εκτέλεση δοκιμών JUnit 5 στο JVM μέσω του τυπικού Test Runner.

// build.gradle.kts
android {
    testOptions {
        unitTests.isIncludeAndroidResources = true
    }
}

dependencies {
    testImplementation("org.junit.jupiter:junit-jupiter:5.11.0")
    testImplementation("androidx.test:core-ktx:1.6.1")
}

Δοκιμή ViewModel με JUnit

Στην πράξη, το JUnit χρησιμοποιείται συχνότερα για τη δοκιμή ViewModel και αποθηκών — επιπέδων που δεν απαιτούν περιβάλλον Android ή εμπλαιστωτή. Μια τέτοια δοκιμή εκτελείται σε χιλιοστά δευτερολέπτου και μπορεί να εκτελεστεί εκατοντάδες φορές χωρίς απώλεια χρόνου.

• ViewModel — έλεγχος καταστάσεων: loading, success, error.
• Repository — έλεγχος απεικόνισης δεδομένων και διαχείρισης σφαλμάτων.
• UseCase — έλεγχος επιχειρηματικής λογικής με mocks εξαρτήσεων.

JUnit 4 vs JUnit 5: βασικές διαφορές

Το JUnit 5 (Jupiter) δεν είναι απλώς μια νέα έκδοση, αλλά μια πλήρως επανασχεδιασμένη πλατφόρμα χωρισμένη σε τρία αρθρώματα: JUnit Platform (εκτέλεση δοκιμών στο JVM), JUnit Jupiter (API για σύνταξη δοκιμών) και JUnit Vintage (προς τα πίσω συμβατότητα με JUnit 4). Αυτή η αρθρωματικότητα επιτρέπει τη σύνδεση διαφορετικών Test Engine — για παράδειγμα, Spek για Kotlin ή TestNG.

Η μετανάστευση από JUnit 4 σε JUnit 5 δεν απαιτεί την επαναγραφή όλων των δοκιμών — αρκεί η σύνδεση του JUnit Vintage Engine, και οι παλιές δοκιμές θα συνεχίσουν να λειτουργούν. Οι νέες δοκιμές συνιστάται να γράφονται σε JUnit 5 για να αξιοποιηθούν οι επεκτάσεις, τα lambdas στις assertions και η ενσωματωμένη υποστήριξη για παραμετροποίηση.