toString() Generator: Πρότυπα μορφοποίησης

Τα πρότυπα μορφοποίησης χρησιμοποιούνται από ένα απλό μηχανισμό που επιτρέπει την αλλαγή της μορφής της σειράς χαρακτήρων εξόδου της δημιουργημένης μεθόδου: αρχή, τέλος, διαχωριστικό, κ.λπ. Τα πρότυπα αυτά είναι παρόμοια με τα πρότυπα κώδικα JDT, ωστόσο δεν επηρεάζουν απευθείας τον δημιουργημένο κώδικα (αυτό γίνεται με χρήση των Στυλ κώδικα). Ακολουθεί μια λίστα με τις διαθέσιμες μεταβλητές προτύπων:

${object.className}εισάγει το όνομα κλάσης ως απλή σειρά χαρακτήρων
${object.getClassName}εισάγει μια κλήση στο this.getClass.getName()
${object.superToString}εισάγει μια κλήση στο super.toString()
${object.hashCode}εισάγει μια κλήση στο this.hashCode()
${object.identityHashCode}εισάγει μια κλήση στο System.identityHashCode(this)
${member.name}εισάγει το όνομα του πρώτου μέλους
${member.name()}εισάγει το όνομα του πρώτου μέλους και στη συνέχεια δύο παρενθέσεις εάν πρόκειται για μεθόδους
${member.value}εισάγει την τιμή του πρώτου μέλους
${otherMembers}εισάγει τα υπόλοιπα μέλη. Για κάθε μέλος, το τμήμα προτύπου μεταξύ της πρώτης και της τελευταίας μεταβλητής ${member.*} αποτιμάται και προστίθεται στο τέλος. Οι χαρακτήρες μεταξύ του τελευταίου ${member.*} και του ${otherMembers} ορίζουν το διαχωριστικό που εισαγάγεται μεταξύ των μελών (το ${otherMembers} πρέπει να τοποθετηθεί μετά την τελευταία μεταβλητή ${member.*}).

Για να λειτουργήσει σωστά το πρότυπο, η μεταβλητή ${otherMembers} πρέπει να χρησιμοποιηθεί ακριβώς μία φορά σε ένα πρότυπο και δεν πρέπει να ακολουθείται από καμία μεταβλητή ${member.*}. Οι μεταβλητές ${object.*} μπορούν να τοποθετηθούν οπουδήποτε σε ένα πρότυπο, παρόλο που αν κάποια τοποθετηθεί σε τμήμα που σχετίζεται με μέλος (το οποίο βρίσκεται μεταξύ της πρώτης μεταβλητής ${member.*} και του ${otherMembers}), θα επαναληφθεί για κάθε μέλος, το οποίο δεν είναι η ενδεδειγμένη συμπεριφορά.

Η παραπάνω περιγραφή μπορεί να μοιάζει πολύπλοκη, ωστόσο η μορφή του προτύπου είναι πολύ εύχρηστη. Όταν μελετήσετε τα παρακάτω παραδείγματα, θα κατανοήσετε τα πάντα.

Παραδείγματα προτύπων

  1. Το προεπιλεγμένο πρότυπο αποτελεί ένα καλό παράδειγμα:

    ${class.name} [${member.name()}=${member.value}, ${otherMembers}]

    Η συμβολοσειρά εξόδου για αυτό το πρότυπο έχει τη μορφή:

    FooClass[aFloat=1.0, aString=hello, anInt=10, anObject=null, aCharMethod()=a]
  2. Τα στοιχεία εξόδου εμφανίζονται και σε μορφή πολλαπλών γραμμών:

    ${object.getClassName} {
    	${member.name}: ${member.value}
    	${otherMembers}
    }

    Αποτέλεσμα παραδείγματος:

    FooClass {
    	aFloat: 1.0
    	aString: hello
    	anInt: 10
    	anObject: null
    	aCharMethod: a
    }
  3. Αν περικλείσετε ένα μέλος σε άγκιστρα, μην ξεχάσετε να κάνετε το ίδιο και με τη μεταβλητή ${otherMembers}:

    {${member.name}=${member.value}},
    {${otherMembers}}

    Το αποτέλεσμα:

    {aFloat=1.0},
    {aString=hello},
    {anInt=10},
    {anObject=null},
    {aCharMethod=a}
  4. Οι μεταβλητές ${object.*} μπορούν να χρησιμοποιηθούν στην αρχή ή στο τέλος του προτύπου:

    ${object.getClassName} (hashcode:${object.hashCode})
    	members: ${member.name} = ${member.value}; ${otherMembers}
    [super: ${object.superToString}]

    Τα στοιχεία εξόδου του προτύπου έχουν την εξής μορφή:

    FooClass (hashCode:232198409832)
    	members: aFloat = 1.0; aString = hello; anInt = 10; anObject = null; aCharMethod = a
    [super: SuperFooClass[aField=null]]

Σχετικές παραπομπές

Πλαίσιο διαλόγου δημιουργίας μεθόδου toString()
toString() Generator: Στυλ κώδικα
toString() Generator: Κατάσταση περιεχομένου