Μεταβλητές προτύπων λειτουργίας επεξεργασίας Java

Οι μεταβλητές προτύπων μπορούν να χρησιμοποιηθούν στο μοτίβο προτύπου. Οι μεταβλητές αντικαθίστανται από μια συγκεκριμένη τιμή κατά την αποτίμηση του προτύπου στο περιβάλλον του. Οι μεταβλητές μπορούν να οριστούν με τη χρήση απλής ή πλήρους σύνταξης:

Αν υπάρχουν διάφορα πιθανά αποτελέσματα για μια μεταβλητή, μπορούν να παρουσιαστούν στο χρήστη ως προτάσεις.

Γενικές μεταβλητές προτύπων

Τα περιβάλλοντα Java και Javadoc ορίζουν τις ακόλουθες μεταβλητές:

Μεταβλητή Περιγραφή
${cursor} Ορίζει τη θέση του δρομέα όταν εγκαταλείπεται η λειτουργία τροποποίησης προτύπου. Αυτό είναι χρήσιμο όταν ο δρομέας θα πρέπει να μεταβεί σε κάποια άλλη θέση εκτός του τέλους του προτύπου κατά το κλείσιμο της λειτουργίας τροποποίησης προτύπου.
${date} Αποτιμάται στην τρέχουσα ημερομηνία.
${dollar} Αποτιμάται στο σύμβολο του δολαρίου $. Εναλλακτικά μπορούν να χρησιμοποιηθούν δύο σύμβολα δολαρίου: $$.
${enclosing_method} Αποτιμάται στο όνομα της περικλείουσας μεθόδου.
${enclosing_method_arguments} Αποτιμάται σε μια λίστα των ονομάτων ορισμάτων της περικλείουσας μεθόδου τα οποία χωρίζονται με κόμματα. Αυτή η μεταβλητή μπορεί να αποδειχθεί πολύ χρήσιμη κατά τη δημιουργία αρχείων καταγραφής για πολλές μεθόδους.
${enclosing_package} Αποτιμάται στο όνομα του περικλείοντος πακέτου.
${enclosing_project} Αποτιμάται στο όνομα του περικλείοντος έργου.
${enclosing_type} Αποτιμάται στο όνομα του περικλείοντος είδους.
${file} Αποτιμάται στο όνομα του αρχείου.
${line_selection} Αποτιμάται στο περιεχόμενο όλων των επιλεγμένων γραμμών.
${primary_type_name} Αποτιμάται στο κύριο είδος ονόματος της τρέχουσας μονάδας μεταγλώττισης.
${return_type} Αποτιμάται στο είδος επιστροφής της περικλείουσας μεθόδου.
${time} Αποτιμάται στην τρέχουσα ώρα.
${user} Αποτιμάται στο όνομα χρήστη.
${word_selection} Αποτιμάται στο περιεχόμενο της τρέχουσας επιλογής κειμένου.
${year} Αποτιμάται στο τρέχον έτος.

Μεταβλητές προτύπων Java

Το περιβάλλον Java ορίζει επιπρόσθετα τις ακόλουθες μεταβλητές. Σημείωση: Στον παρακάτω πίνακα, id είναι ένα όνομα που επιλέγεται από το χρήστη για μια νέα μεταβλητή.

Μεταβλητή Περιγραφή
${id:field(type[,type]*)} Αποτιμάται σε ένα πεδίο στην τρέχουσα εμβέλεια που αποτελεί υπο-είδος οποιουδήποτε από τα καθορισμένα είδη. Αν δεν καθοριστεί είδος, συμφωνεί οποιοδήποτε μη στοιχειώδες πεδίο.

Παράδειγμα:
${count:field(int)}

${id:var(type[,type]*)} Αποτιμάται σε ένα πεδίο, μια τοπική μεταβλητή ή μια παράμετρο ορατή στην τρέχουσα εμβέλεια που αποτελεί υπο-είδος οποιουδήποτε από τα καθορισμένα είδη. Αν δεν καθοριστεί είδος, συμφωνεί οποιαδήποτε μη στοιχειώδης μεταβλητή.

Παράδειγμα:
${container:var(java.util.List, 'java.lang.Object[]')}

${id:localVar(type[,type]*)} Αποτιμάται σε μια τοπική μεταβλητή ή παράμετρο ορατή στην τρέχουσα εμβέλεια που αποτελεί υπο-είδος οποιουδήποτε από τα καθορισμένα είδη. Αν δεν καθορίζεται είδος, συμφωνεί οποιαδήποτε μη στοιχειώδης τοπική μεταβλητή.

Το ${array} αποτελεί συντόμευση του ${array:localVar('java.lang.Object[]')}, αλλά επίσης συμφωνεί με πίνακες στοιχειωδών ειδών.
Το ${collection} αποτελεί συντόμευση του ${collection:localVar(java.util.Collection)}.
Το ${iterable} αποτελεί συντόμευση του ${iterable:localVar(java.lang.Iterable)}, αλλά συμφωνεί επίσης με πίνακες.

${:argType(variable, n)} Αποτιμάται στο nστό όρισμα είδους της μεταβλητής προτύπου στην οποία γίνεται παραπομπή. Η παραπομπή θα πρέπει να είναι το όνομα μιας άλλης μεταβλητής προτύπου. Αναλύεται σε java.lang.Object εάν η μεταβλητή στην οποία γίνεται παραπομπή δεν μπορεί να βρεθεί ή δεν είναι παραμετροποιήσιμου είδους.

Παράδειγμα:
${type:argType(vector, 0)} ${first:name(type)} = ${vector:var(java.util.Vector)}.get(0)

${id:elemType(variable)} Αποτιμάται στο είδος στοιχείου της μεταβλητής προτύπου στο οποίο γίνεται παραπομπή. Η παραπομπή θα πρέπει να είναι το όνομα μιας άλλης μεταβλητής προτύπου που αναλύεται σε πίνακα ή σε μια χρήση του java.lang.Iterable. Το είδος μεταβλητής elemType είναι παρόμοιο με το ${id:argType(reference,0)}, με τη διαφορά ότι αναλύει επίσης το είδος στοιχείου ενός πίνακα.

Το ${array_type} αποτελεί συντόμευση του ${array_type:elemType(array)}.
Το ${iterable_type} αποτελεί συντόμευση του ${iterable_type:elemType(iterable)}.

${id:newName(reference)} Αποτιμάται σε ένα επιτρεπτό όνομα για μια νέα τοπική μεταβλητή του είδους που καθορίζεται από την παραπομπή. Η παραπομπή μπορεί να είναι είτε όνομα είδους Java είτε το όνομα άλλης μεταβλητής προτύπου. Το δημιουργημένο όνομα συμμορφώνεται με τις ρυθμίσεις στυλ κώδικα.

Το ${index} αποτελεί συντόμευση του ${index:newName(int)}.
Το ${iterator} αποτελεί συντόμευση του ${iterator:newName(java.util.Iterator)}.
Το ${array_element} αποτελεί συντόμευση του ${array_element:newName(array)}.
Το ${iterable_element} αποτελεί συντόμευση του ${iterable_element:newName(iterable)}.

${id:newType(qualifiedTypeName)} Αποτιμάται σε ένα όνομα είδους με δεδομένο το πλήρες όνομα είδους Java. Αποτιμάται σε απλό όνομα είδους και πρόταση εισαγωγής αν δεν υπάρχει διένεξη με άλλο είδος. Διαφορετικά, αποτιμάται σε πλήρες όνομα είδους.

Παράδειγμα:
${type:newType(java.util.Iterator)}

${:import(type[,type]*)} Προσθέτει μια πρόταση εισαγωγής για κάθε είδος. Δεν εκτελεί καμία ενέργεια αν η πρόταση εισαγωγής υπάρχει ήδη. Δεν εκτελεί καμία ενέργεια αν υπάρχει διένεξη με άλλη πρόταση εισαγωγής. Αποτιμάται ως κενή τιμή.

Παράδειγμα:
${:import(java.util.List, java.util.Collection)}

${:importStatic([qualifiedName[,qualifiedName]*])} Προσθέτει μια πρόταση εισαγωγής στατικών μελών για κάθε πλήρες όνομα που δεν έχει ήδη εισαχθεί. Η παράμετρος qualifiedName είναι το πλήρες όνομα ενός στατικού πεδίου ή μιας στατικής μεθόδου ή το πλήρες όνομα ενός είδους με το επίθημα .*, το οποίο περικλείεται σε μονά εισαγωγικά ''. Δεν εκτελεί καμία ενέργεια αν υπάρχει διένεξη με άλλη πρόταση εισαγωγής. Αποτιμάται ως κενή τιμή.

Παράδειγμα:
${is:importStatic(java.util.Collections.EMPTY_SET, 'java.lang.System.*')}

${id:link(proposal[,proposal]*)} Αποτιμάται σε id αν η λίστα των προτάσεων είναι κενή, διαφορετικά αποτιμάται στην πρώτη πρόταση. Η αποτιμημένη τιμή τοποθετείται σε κατάσταση διασύνδεσης. Οι προτάσεις που καθορίστηκαν εμφανίζονται σε ένα παράθυρο.

Παράδειγμα:
java.util.Collections.${kind:link(EMPTY_SET, EMPTY_LIST, EMPTY_MAP)}

${array} Αποτιμάται σε μια πρόταση για έναν πίνακα ορατό στην τρέχουσα εμβέλεια.
${array_element} Αποτιμάται σε ένα όνομα για μια νέα τοπική μεταβλητή για ένα στοιχείο της αντιστοιχίας της μεταβλητής ${array}.
${array_type} Αποτιμάται στο είδος στοιχείου της αντιστοιχίας της μεταβλητής ${array}.
${collection} Αποτιμάται σε μια πρόταση για μια συλλογή ορατή στην τρέχουσα εμβέλεια.
${exception_variable_name} Όνομα μεταβλητής εξαίρεσης σε ενότητες catch.
${index} Αποτιμάται σε μια πρόταση για ένα μη δηλωμένο ευρετήριο πίνακα.
${iterator} Αποτιμάται σε ένα μη χρησιμοποιούμενο όνομα για μια νέα τοπική μεταβλητή του είδους java.util.Iterator.
${iterable} Αποτιμάται σε μια πρόταση για ένα επαναλήψιμο στοιχείο ή έναν πίνακα ορατό στην τρέχουσα εμβέλεια.
${iterable_element} Αποτιμάται σε ένα όνομα για μια νέα τοπική μεταβλητή για ένα στοιχείο της αντιστοιχίας της μεταβλητής ${iterable}.
${iterable_type} Αποτιμάται στο είδος στοιχείου της αντιστοιχίας της μεταβλητής ${iterable}.
${todo} Αποτιμάται σε μια πρόταση για το καθορισμένο προεπιλεγμένο προσδιοριστικό εργασίας.

Σχετικές έννοιες

Πρότυπα

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

Τροποποίηση προτύπων
Σελίδα προτιμήσεων Πρότυπα
Αυτόματη συμπλήρωση περιεχομένου Java
Προτιμήσεις προσδιοριστικών εργασίας
Προτιμήσεις προτύπων κώδικα
Προτιμήσεις στυλ κώδικα