Ένα από τα πιο δύσκολα προβλήματα στην ανάπτυξη λογισμικού είναι η ονομασία. Η δημιουργία ονομάτων με νόημα για τις θεμελιώδεις πτυχές ενός προγράμματος, όπως οι κλάσεις και οι μέθοδοι, μπορεί να είναι δύσκολη. Οι περιορισμοί ονομασίας, όπως η απουσία απόστασης, ενισχύουν περαιτέρω αυτό το πρόβλημα.
Το πρόβλημα ονομασίας παραμένει σε κάθε πτυχή του κύκλου ζωής ανάπτυξης λογισμικού, συμπεριλαμβανομένων των δοκιμών. Εδώ είναι χρήσιμος ο σχολιασμός JUnit @DisplayName.
Τι είναι ο σχολιασμός @DisplayName;
Μια μεμονωμένη μέθοδος μπορεί να έχει πολλές μεθόδους δοκιμής που κάθε μια δοκιμάζει μια συγκεκριμένη συμπεριφορά. Ωστόσο, εάν αντιστοιχίσετε ονόματα συμπεριφοράς σε μεθόδους δοκιμής, μπορεί να γίνουν λεκτικά και δυσανάγνωστα.
Ο σχολιασμός @DisplayName είναι ένα στοιχείο JUnit που σας επιτρέπει να δημιουργείτε προσαρμοσμένα ονόματα για τις κλάσεις και τις μεθόδους δοκιμής σας. Αυτά τα ονόματα μπορεί να έχουν κενά, ειδικούς χαρακτήρες, ακόμη και emoji. Ο σχολιασμός @DisplayName θα σας βοηθήσει να δημιουργήσετε πιο περιγραφικά, ουσιαστικά ονόματα για τάξεις και μεθόδους δοκιμής.
Πώς να χρησιμοποιήσετε τον σχολιασμό @DisplayName
Σε ένα Τάξη δοκιμής JUnit, ο σχολιασμός @DisplayName εμφανίζεται πάνω από το όνομα της κλάσης ή ακριβώς πριν από τη δήλωση της μεθόδου. Ο σχολιασμός @DisplayName λαμβάνει ένα μόνο όρισμα (το όνομα). Αυτό το επιχείρημα εμφανίζεται αργότερα στις αναφορές δοκιμών, καθιστώντας την τεκμηρίωση δοκιμών πιο περιγραφική.
πακέτο εμφανιζόμενο όνομα?εισαγωγή org.junit.jupiter.api. DisplayName;
εισαγωγή org.junit.jupiter.api. Δοκιμή;@DisplayName("Δοκιμή τάξηεπιδεικνύονταςπωςο @DisplayNameσχόλιοέργα.")
τάξηDisplayNameTest{
@Δοκιμή
@DisplayName("Δοκιμή εμφανιζόμενου ονόματος που περιέχει ειδικούς χαρακτήρες: °□°）╯")
κενόςtestDisplayNameWithSpecialCharacters(){}@Δοκιμή
@DisplayName("Δοκιμή εμφανιζόμενου ονόματος που περιέχει διάστημα")
κενόςtestDisplayNameWithSpaces(){}
@Δοκιμή
@DisplayName("Δοκιμή εμφανιζόμενου ονόματος που περιέχει emoji: 😱")
κενόςtestDisplayNameWithEmoji(){}
}
Η εκτέλεση αυτής της κλάσης Java δημιουργεί την ακόλουθη αναφορά δοκιμής μονάδας JUnit:
Κάθε όρισμα σχολιασμού @DisplayName αντικαθιστά το αντίστοιχο όνομα κλάσης ή μεθόδου στην αναφορά δοκιμής JUnit. Ο σχολιασμός @DisplayName, "Τάξη δοκιμής που δείχνει πώς λειτουργεί ο σχολιασμός @DisplayName" είναι πολύ πιο εκφραστικός και περιεκτικός από το DisplayNameTest.
Τι ακολουθεί για τη δοκιμή;
Η γνώση του τρόπου χρήσης του σχολιασμού @DisplayName θα βελτιώσει σίγουρα την τεκμηρίωση δοκιμής μονάδας. Εκτός από τον σχολιασμό @DisplayName, θα διαπιστώσετε ότι όλες οι δοκιμές μονάδας JUnit θα χρειαστούν έναν ή περισσότερους ισχυρισμούς. Οι ισχυρισμοί είναι τα δομικά στοιχεία των δοκιμών μονάδων JUnit, επομένως, είναι καλό να μάθετε πώς να τις χρησιμοποιείτε.