Η κλάση του μεταγλωττιστή μαζικής επεξεργασίας βρίσκεται στην πρόσθετη λειτουργία JDT
Core. Το όνομα της κλάσης είναι org.eclipse.jdt.compiler.batch.BatchCompiler. Περιλαμβάνεται
στο πακέτο plugins/org.eclipse.jdt.core_<έκδοση>.jar. Από την
έκδοση 3.2, είναι επίσης διαθέσιμη για ξεχωριστή μεταφόρτωση. Το όνομα του αρχείου είναι ecj.jar. Ο αντίστοιχος πρωτογενής κώδικάς του
είναι επίσης διαθέσιμος. Για να μεταφορτώσετε αυτά τα αρχεία, μεταβείτε στη
σελίδα μεταφόρτωσης και
αναζητήστε την ενότητα JDT Core Batch Compiler. Αυτό το αρχείο jar περιέχει τον
μεταγλωττιστή μαζικής επεξεργασίας και τον προσαρμογέα javac ant.
Από την έκδοση 3.3, αυτό το αρχείο jar περιέχει επίσης την υποστήριξη για το jsr199 (API μεταγλώττισης) και το jsr269 (επεξεργασία σημειώσεων). Για να είναι δυνατή η χρήση της υποστήριξης για την επεξεργασία σημειώσεων, απαιτείται ένα VM έκδοσης 1.6.
Με τον τρόπο αυτό μπορεί να χρησιμοποιηθεί ως ανεξάρτητη εφαρμογή και σε μια δόμηση Ant εκτός του Eclipse.
java -jar org.eclipse.jdt.core_<έκδοση>.jar -classpath rt.jar A.java
ή:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter
outWriter, PrintWriter errWriter, CompilationProgress progress) της κλάσης
BatchCompiler.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instantiate your subclass org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Μπορείτε να ελέγξετε τον τρόπο αναφοράς της προόδου ή τον τρόπο ακύρωσης του μεταγλωττιστή μαζικής επεξεργασίας δημιουργώντας υποκλάσεις της κλάσης org.eclipse.jdt.compiler.CompilationProgress.
Οι συνιστώμενες επιλογές έχουν πορτοκαλί φόντο.
Όταν για ορισμένες επιλογές ορίζονται πολλαπλοί χρόνοι, ο μεταγλωττιστής πατρίδας τις εκτελεί από τα αριστερά προς τα δεξιά. Όταν η επιλογή προειδοποίησης (-warn:....) χρησιμοποιείται χωρίς το '+' ή '-', αντικαθίσταται η ομάδα των προειδοποιήσεων που καθορίστηκαν προηγουμένως. Επομένως ο χρήστης πρέπει να εξασφαλίσει ότι υπάρχει μια τέτοια επιλογή πριν οποιαδήποτε άλλη χρήση της επιλογής -warn.
Το ίδιο ισχύει και για την επιλογή -err:.
| Όνομα | Χρήση | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Επιλογές διαδρομής κλάσεων | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | Είναι μια λίστα καταλόγων ή αρχείων jar που
χρησιμοποιούνται για την εκκίνηση των αρχείων κλάσεων που χρησιμοποιούνται από το
μεταγλωττιστή. Ως προεπιλογή χρησιμοποιούνται οι βιβλιοθήκες του VM που εκτελείται. Οι καταχωρήσεις διαχωρίζονται με το διαχωριστικό διαδρομών της πλατφόρμας. Για κάθε κατάλογο ή αρχείο μπορούν να οριστούν κανόνες πρόσβασης για είδη, οι οποίοι περικλείονται μεταξύ '[' και ']'. Αν δεν καθοριστεί η επιλογή bootclasspath, ο μεταγλωττιστής θα τη συμπεράνει
χρησιμοποιώντας τις ακόλουθες ιδιότητες συστήματος |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
Είναι μια λίστα καταλόγων ή αρχείων jar που
χρησιμοποιούνται για τη μεταγλώττιση των αρχείων πρωτογενούς κώδικα. Η προεπιλεγμένη τιμή είναι η τιμή της ιδιότητας "java.class.path". Οι καταχωρήσεις διαχωρίζονται με το διαχωριστικό διαδρομών της πλατφόρμας. Για κάθε κατάλογο ή αρχείο μπορούν να καθοριστούν κανόνες πρόσβασης για είδη, οι οποίο περικλείονται μεταξύ '[' και ']' (π.χ. [-X] για απαγόρευση πρόσβασης στο είδος X, [~X] για μη συνιστώμενη πρόσβαση στο είδος X, [+p/X:-p/*] για απαγόρευση πρόσβασης σε όλα τα είδη του πακέτου p αλλά για πρόσβαση στο p/X). Ο μεταγλωττιστής ακολουθεί αναδρομικά τις συνθήκες Class-Path των αρχείων manifest των
jar και επισυνάπτει κάθε παραπεμπόμενο αρχείο jar στο τέλος της διαδρομής κλάσεων,
εφόσον δεν υπάρχει ήδη στη διαδρομή κλάσεων. |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | Είναι μια λίστα καταλόγων που χρησιμοποιούνται για τον προσδιορισμό της θέσης των αρχείων επέκτασης zip/jar. Οι καταχωρήσεις διαχωρίζονται με το διαχωριστικό διαδρομών της πλατφόρμας. | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | Είναι μια λίστα καταλόγων που χρησιμοποιούνται για τον προσδιορισμό της θέσης των υποστηριζόμενων αρχείων zip/jar. Οι καταχωρήσεις διαχωρίζονται με το διαχωριστικό διαδρομών της πλατφόρμας. | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | Είναι μια λίστα καταλόγων που χρησιμοποιούνται για τον προσδιορισμό των
αρχείων πρωτογενούς κώδικα. Οι καταχωρήσεις διαχωρίζονται με το διαχωριστικό διαδρομών της πλατφόρμας. Για κάθε κατάλογο ή αρχείο μπορούν να καθοριστούν κανόνες πρόσβασης για είδη, οι οποίοι περικλείονται μεταξύ '[' και ']'. |
||||||||||||||
| -d <dir 1>|none | Χρησιμοποιείται για τον προσδιορισμό του καταλόγου στον οποίο θα
πρέπει να καταγραφούν τα αρχεία .class που δημιουργούνται. Αν παραλειφθεί, δεν
δημιουργείται δομή καταλόγων πακέτου. Αν δεν θέλετε να δημιουργηθεί αρχείο .class, χρησιμοποιήστε την επιλογή -d none. |
||||||||||||||
| -encoding <όνομα κωδικοποίησης> | Ορίζει την προεπιλεγμένη κωδικοποίηση για όλα τα αρχεία
πρωτογενούς κώδικα. Μπορείτε επίσης να ορίσετε προσαρμοσμένη κωδικοποίηση
ανά αρχείο, προσθέτοντας το κατάλληλο επίθημα [<όνομα κωδικοποίησης>] στο όνομα
κάθε αρχείου/φακέλου πρωτογενούς κώδικα. Για παράδειγμα, η τιμή X.java[utf8] ορίζει τη χρήση κωδικοποίησης UTF-8 για τη μονάδα μεταγλώττισης X.java στον τρέχοντα
κατάλογο χρήστη.
Αν οριστούν περισσότερες από μία κωδικοποιήσεις για τα αρχεία πρωτογενούς κώδικα, θα χρησιμοποιηθεί η τελευταία. Για παράδειγμα:
|
||||||||||||||
| Επιλογές συμβατότητας | |||||||||||||||
| -target 1.1 έως 1.7 ή (5, 5.0 κ.ο.κ.) | Προσδιορίζει τη ρύθμιση του προορισμού του αρχείου .class. Οι πιθανές τιμές είναι:
Το clcd1.1 μπορεί να χρησιμοποιηθεί για τη δημιουργία του γνωρίσματος StackMap. |
||||||||||||||
| -1.3 | Ορίζει το επίπεδο συμβατότητας 1.3. Αυτόματα -source 1.3 -target 1.1. | ||||||||||||||
| -1.4 | Ορίζει το επίπεδο συμβατότητας 1.4 (προεπιλογή). Αυτόματα -source 1.3 -target 1.2. | ||||||||||||||
| -1.5 | Ορίζει το επίπεδο συμβατότητας 1.5. Αυτόματα -source 1.5 -target 1.5. | ||||||||||||||
| -1.6 | Ορίζει το επίπεδο συμβατότητας 1.6. Αυτόματα -source 1.6 -target 1.6. | ||||||||||||||
| -1.7 | Ορίζει το επίπεδο συμβατότητας 1.7. Αυτόματα -source 1.7 -target 1.7. | ||||||||||||||
| -source 1.1 έως 1.7 ή (5, 5.0 κ.ο.κ.) | Χρησιμοποιείται για τον καθορισμό του επιπέδου πρωτογενούς κώδικα που αναμένεται από
το μεταγλωττιστή. Οι πιθανές τιμές είναι:
|
||||||||||||||
| Επιλογές προειδοποίησης | |||||||||||||||
| -?:warn -help:warn | Εμφανίζονται οι σύνθετες επιλογές προειδοποιήσεων | ||||||||||||||
| -warn:... | Καθορίστε την ομάδα των ενεργοποιημένων προειδοποιήσεων. π.χ. -warn:unusedLocal,deprecation
|
||||||||||||||
| Προεπιλογή | Όνομα διακριτικού | Περιγραφή | |||||||||||||
| +/- | allDeadCode | ανενεργός κώδικας συμπεριλαμβανομένου του ελέγχου if(DEBUG) | |||||||||||||
| +/- | allDeprecation | κατάργηση ακόμα και εντός καταργημένου κώδικα | |||||||||||||
| - | allJavadoc | μη έγκυρο ή ανύπαρκτο javadoc | |||||||||||||
| - | allOver-ann | all missing @Override annotations (υπερκλάση και υπερδιεπαφές) | |||||||||||||
| - | all-static-method | όλες οι μέθοδοι μπορούν να δηλωθούν ως στατικές προειδοποιήσεις | |||||||||||||
| + | assertIdentifier | χρήση του assert ως ταυτότητας | |||||||||||||
| - | boxing | αυτόματη μετατροπή boxing | |||||||||||||
| + | charConcat | όταν ένας πίνακας χαρακτήρων χρησιμοποιείται σε μια συνένωση σειρών χαρακτήρων χωρίς να μετατρέπεται ρητά σε σειρά χαρακτήρων | |||||||||||||
| + | compareIdentical | σύγκριση πανομοιότυπων εκφράσεων | |||||||||||||
| - | conditionAssign | πιθανή εσφαλμένη λογική αντιστοίχιση | |||||||||||||
| + | constructorName | μέθοδος με όνομα λειτουργίας κατασκευής | |||||||||||||
| + | deadCode | ανενεργός κώδικας εξαιρουμένου του ελέγχου if(DEBUG) | |||||||||||||
| - | dep-ann | δεν υπάρχει σημείωση @Deprecated | |||||||||||||
| +/- | deprecation | χρήση καταργημένου είδους ή μέλους εκτός του καταργημένου κώδικα | |||||||||||||
| + | discouraged | χρήση ειδών που ταιριάζουν με κανόνα μη συνιστώμενης πρόσβασης | |||||||||||||
| - | emptyBlock | μη τεκμηριωμένη κενή ενότητα | |||||||||||||
| + | enumIdentifier | χρήση του enum ως ταυτότητας | |||||||||||||
| + | enumSwitch | μη ολοκληρωμένη περίπτωση αλλαγής για απαρίθμηση | |||||||||||||
| - | enumSwitchPedantic | αναφορά έλλειψης προτάσεων enum switch ακόμα και αν υπάρχει προεπιλεγμένη πρόταση case | |||||||||||||
| - | fallthrough | πιθανή συνέχιση πρότασης case | |||||||||||||
| - | fieldHiding | το πεδίο αποκρύπτει μια άλλη μεταβλητή | |||||||||||||
| + | finalBound | πληκτρολόγηση παραμέτρου με τελικό όριο | |||||||||||||
| + | finally | η ενότητα finally δεν ολοκληρώνεται κανονικά | |||||||||||||
| + | forbidden | χρήση ειδών που ταιριάζουν με κανόνα απαγορευμένης πρόσβασης | |||||||||||||
| - | hashCode | δεν υπάρχει μέθοδος hashCode() κατά την αντικατάσταση του equals() | |||||||||||||
| +/- | hiding | η μακροεντολή για τα fieldHiding, localHiding, typeHiding και maskedCatchBlock | |||||||||||||
| - | includeAssertNull | δημιουργία προειδοποιήσεων null τιμών για μεταβλητές που καταστράφηκαν σε μια έκφραση επαλήθευσης | |||||||||||||
| - | indirectStatic | έμμεση παραπομπή προς ένα στατικό μέλος | |||||||||||||
| + | intfAnnotation | είδος σημείωσης που χρησιμοποιείται ως υπερ-διεπαφή | |||||||||||||
| + | intfNonInherited | μη μεταβιβασμένη συμβατότητα μεθόδων διεπαφής | |||||||||||||
| - | intfRedundant | εύρεση πλεονάζουσας υπερ-διεπαφής | |||||||||||||
| - | javadoc | μη έγκυρο javadoc | |||||||||||||
| - | localHiding | η τοπική μεταβλητή αποκρύπτει μια άλλη μεταβλητή | |||||||||||||
| + | maskedCatchBlock | κρυφή ενότητα catch | |||||||||||||
| - | nls | λεκτικές σταθερές σειράς χαρακτήρων non-nls (λείπουν τα προσδιοριστικά //$NON-NLS-<n>) | |||||||||||||
| + | noEffectAssign | αντιστοίχιση χωρίς αποτέλεσμα | |||||||||||||
| +/- | null | δυνητικά απών ή πλεονάζων έλεγχος null | |||||||||||||
| - | nullAnnot | ενεργοποίηση ανάλυσης null βάσει σημειώσεων Αν το επιθυμείτε, μπορείτε να καθορίσετε τα είδη σημειώσεων που θα ερμηνευτούν από τον μεταγλωττιστή, προσθέτοντας την κατάλληλη λέξη (nullable|nonnull|nonnullbydefault). Κάθε είδος σημείωσης καθορίζεται με χρήση του πλήρους ονόματος. Βλ. επίσης -nonNullByDefault παρακάτω. |
|||||||||||||
| - | nullDereference | λείπει έλεγχος null | |||||||||||||
| - | over-ann | λείπει σημείωση @Override (μόνο υπερκλάση) | |||||||||||||
| - | paramAssign | αντιστοίχιση σε παράμετρο | |||||||||||||
| + | pkgDefaultMethod | προσπάθεια αντικατάστασης της προεπιλεγμένης μεθόδου για το πακέτο | |||||||||||||
| + | raw | χρήση ενός αδιαμόρφωτου είδους (αντί ενός παραμετροποιημένου είδους) | |||||||||||||
| +/- | resource | (πιθανώς) μη ασφαλής χρήση πόρου είδους Closeable | |||||||||||||
| - | semicolon | μη απαραίτητο ελληνικό ερωτηματικό ή κενή πρόταση | |||||||||||||
| + | serial | λείπει το serialVersionUID | |||||||||||||
| - | specialParamHiding | η λειτουργία κατασκευής ή η παράμετρος μεθόδου ορισμού αποκρύπτει ένα άλλο πεδίο | |||||||||||||
| +/- | static-access | η μακροεντολή για τα indirectStatic και staticReceiver | |||||||||||||
| - | static-method | μια μέθοδος χρήσης που μπορεί να χρησιμοποιηθεί ως στατική μέθοδος | |||||||||||||
| + | staticReceiver | αν μια μη στατική λειτουργία λήψης χρησιμοποιείται για τη λήψη ενός στατικού πεδίου ή την κλήση μιας στατικής μεθόδου | |||||||||||||
| - | super | αντικατάσταση μεθόδου χωρίς κλήση υπερκλάσης | |||||||||||||
| + | suppress | ενεργοποίηση @SuppressWarnings | |||||||||||||
| - | switchDefault | πρόταση switch χωρίς προεπιλεγμένη πρόταση case | |||||||||||||
| - | syncOverride | δεν υπάρχει συγχρονισμένη μέθοδος για την αντικατάσταση | |||||||||||||
| - | syntheticAccess | για την πραγματοποίηση συνθετικής πρόσβασης για innerclass | |||||||||||||
| - | tasks | ενεργοποίηση υποστήριξης για προσδιοριστικά εργασιών στον πρωτογενή κώδικα | |||||||||||||
| + | typeHiding | παράμετρος είδους που αποκρύπτει ένα άλλο είδος | |||||||||||||
| + | unavoidableGenericProblems | αγνόηση αναπόφευκτων προβλημάτων ασφάλειας ειδών εξαιτίας μη επεξεργασμένων API | |||||||||||||
| + | unchecked | μη ελεγμένη λειτουργία γενικού είδους | |||||||||||||
| - | unnecessaryElse | μη απαραίτητη συνθήκη else | |||||||||||||
| - | unqualifiedField | μη προσδιορισμένη παραπομπή προς το πεδίο | |||||||||||||
| +/- | unused | μακροεντολή για unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown και unusedTypeArgs | |||||||||||||
| - | unusedAllocation | κατανομή αντικειμένου που δεν είναι σε χρήση | |||||||||||||
| - | unusedArgument | μη χρησιμοποιούμενο όρισμα μεθόδου | |||||||||||||
| + | unusedImport | παραπομπή σε μη χρησιμοποιούμενη εισαγωγή | |||||||||||||
| + | unusedLabel | αχρησιμοποίητη ετικέτα | |||||||||||||
| + | unusedLocal | μη χρησιμοποιούμενη τοπική μεταβλητή | |||||||||||||
| + | unusedPrivate | μη χρησιμοποιούμενη δήλωση ιδιωτικού μέλους | |||||||||||||
| - | unusedThrown | μη χρησιμοποιούμενη δηλωθείσα εξαίρεση που προέκυψε | |||||||||||||
| + | unusedTypeArgs | μη χρησιμοποιούμενα ορίσματα είδους για μέθοδο και λειτουργία κατασκευής | |||||||||||||
| - | uselessTypeCheck | μη απαραίτητη λειτουργία cast/instanceof | |||||||||||||
| + | varargsCast | το όρισμα varargs πρέπει να μετατραπεί ρητά | |||||||||||||
| +/- | warningToken | διακριτικό στοιχείο προειδοποίησης που δεν έχει αντιμετωπιστεί ή χρησιμοποιηθεί στο @SuppressWarnings | |||||||||||||
| -nowarn | Καμία προειδοποίηση (ισοδύναμη της -warn:none) | ||||||||||||||
| -err:... | Καθορίστε την ομάδα των ενεργοποιημένων προειδοποιήσεων που μετατρέπονται σε σφάλματα. για παράδειγμα -err:unusedLocal,deprecation Οι προειδοποιήσεις unusedLocal και κατάργησης θα μετατραπούν σε σφάλματα . Όλες οι άλλες προειδοποιήσεις συνεχίζουν να αναφέρονται ως προειδοποιήσεις.
|
||||||||||||||
| -deprecation | Ισοδύναμο με το -warn:+deprecation. | ||||||||||||||
| -properties <αρχείο> | Ορισμός επιλογών προειδοποίησης ή σφάλματος με βάση τα
περιεχόμενα του αρχείου ιδιοτήτων. Η επιλογή αυτή μπορεί να συνδυαστεί με
τις επιλογές -nowarn, -err:... ή -warn:... Ωστόσο, η τελευταία στη γραμμή
εντολών καθορίζει τις επιλογές που θα χρησιμοποιηθούν. Τα περιεχόμενα του αρχείου ιδιοτήτων μπορούν να δημιουργηθούν με τον
ορισμό ρυθμίσεων που αφορούν το έργο σε ένα υπάρχον έργο java και με χρήση
του αρχείου ... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ... |
||||||||||||||
| Επιλογές εντοπισμού και διόρθωσης σφαλμάτων | |||||||||||||||
| -g[:none|:lines,vars,source] | Ορισμός του επιπέδου γνωρισμάτων της λειτουργίας εντοπισμού και διόρθωσης σφαλμάτων
|
||||||||||||||
| -preserveAllLocals | Ρητή υποβολή αιτήματος προς το μεταγλωττιστή για τη διατήρηση όλων των τοπικών μεταβλητών (για λόγους εντοπισμού και διόρθωσης σφαλμάτων). Αν παραλειφθεί, ο μεταγλωττιστής θα αφαιρέσει τα μη χρησιμοποιούμενα τοπικά στοιχεία. | ||||||||||||||
| Επιλογές επεξεργασίας σημειώσεων (απαιτείται VM έκδοσης 1.6 ή μεταγενέστερη, χρησιμοποιούνται μόνο αν η συμβατότητα είναι 1.6) | |||||||||||||||
| -Akey[=τιμή] | Επιλογές επεξεργασίας σημειώσεων που μεταβιβάζονται σε επεξεργαστές σημειώσεων.
Το key αποτελείται από προσδιοριστικά διαχωρισμένα με τελείες. |
||||||||||||||
| -proc:[only|none] | Αν καθορίσετε -proc:only, οι επεξεργαστές
σημειώσεων θα εκτελεστούν αλλά δεν θα πραγματοποιηθεί μεταγλώττιση
(compilation). Αν καθορίσετε -proc:none, δεν θα εντοπιστούν ή εκτελεστούν
επεξεργαστές σημειώσεων. Η μεταγλώττιση θα συνεχιστεί όπως στην περίπτωση
που δεν εντοπίζονται επεξεργαστές σημειώσεων. Η προεπιλεγμένη ρύθμιση είναι ο μεταγλωττιστής να αναζητήσει επεξεργαστές
σημειώσεων στη διαδρομή κλάσεων (classpath). Συνεπώς, με την επιλογή
-proc:none επιταχύνεται η μεταγλώττιση όταν δεν απαιτείται η
επεξεργασία σημειώσεων. |
||||||||||||||
| -processor <class1[,class2,...]> | Πλήρη ονόματα κλάσεων των επεξεργαστών σημειώσεων που θα εκτελεστούν. Αν καθοριστεί αυτή η επιλογή, θα παραλειφθεί η κανονική διεργασία εντοπισμού επεξεργαστών. | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | Θα αναζητηθούν επεξεργαστές σημειώσεων σε μια λίστα καταλόγων ή αρχείων jar. Οι καταχωρήσεις διαχωρίζονται από το διαχωριστικό διαδρομής πλατφόρμας. Αν δεν καθοριστεί αυτή η επιλογή, θα γίνει αναζήτηση στη διαδρομή κλάσεων (classpath). | ||||||||||||||
| -s <dir> | Ο κατάλογος στον οποίο θα δημιουργηθούν τα παραγόμενα αρχεία πρωτογενούς κώδικα. | ||||||||||||||
| -XprintProcessorInfo | Εκτύπωση πληροφοριών σχετικά με τις σημειώσεις και τα στοιχεία που καλείται να επεξεργαστεί ένας επεξεργαστής. | ||||||||||||||
| -XprintRounds | Εκτύπωση πληροφοριών σχετικά με τους κύκλους επεξεργασίας σημειώσεων | ||||||||||||||
| -classNames <class1[,class2,...]> | Πλήρη ονόματα των δυαδικών ειδών των οποίων πρόκειται να γίνει επεξεργασία. | ||||||||||||||
| Επιλογές που αγνοούνται (για συμβατότητα με επιλογές javac) | |||||||||||||||
| -J<επιλογή> | Μεταβίβαση επιλογής στην εικονική μηχανή | ||||||||||||||
| -X<επιλογή> | Καθορισμός μη τυπικής επιλογής. Η επιλογή -Xemacs δεν παραβλέπεται. | ||||||||||||||
| -X | Εκτύπωση μη τυπικών επιλογών και έξοδος | ||||||||||||||
| -O | Βελτιστοποίηση για χρόνο εκτέλεσης | ||||||||||||||
| Ειδικές επιλογές | |||||||||||||||
| @<file> | Ανάγνωση ορισμάτων γραμμής εντολών από αρχείο | ||||||||||||||
| -maxProblems <n> | Μέγιστος αριθμός προβλημάτων ανά μονάδα μεταγλώττισης (προεπιλογή 100) | ||||||||||||||
| -log <filename> | Προσδιορισμός ενός αρχείου καταγραφής όπου καταγράφονται όλα τα δεδομένα εξόδου από το μεταγλωττιστή. Αυτό είναι ιδιαίτερα χρήσιμο αν θέλετε να πραγματοποιήσετε εντοπισμό και διόρθωση σφαλμάτων στο μεταγλωττιστή μαζικής επεξεργασίας ή να δημιουργήσετε ένα αρχείο το οποίο περιέχει όλα τα σφάλματα και τις προειδοποιήσεις από μια μαζική δόμηση. Εάν η επέκταση είναι .xml, το αρχείο καταγραφής που θα δημιουργηθεί θα είναι ένα αρχείο xml. | ||||||||||||||
| -Xemacs | Χρήση στυλ emacs για την παρουσίαση των θέσεων σφαλμάτων και προειδοποιήσεων στην
κονσόλα και στα κανονικά αρχεία καταγραφής κειμένου. Τα αρχεία καταγραφής XML δεν
επηρεάζονται από αυτές τις επιλογές. Με αυτή την επιλογή ενεργή, το μήνυμα:2. WARNING in /workspace/X.javaπαρουσιάζεται ως: /workspace/X.java:8: warning: The method... |
||||||||||||||
| -proceedOnError[:Fatal] | Συνέχιση της μεταγλώττισης παρά την εμφάνιση σφαλμάτων, καταγραφή των αρχείων
κλάσης
με προβληματικές μεθόδους ή είδη προβλημάτων. Συνιστάται μόνο για την περίπτωση που
θέλετε να έχετε τη δυνατότητα εκτέλεσης της εφαρμογής σας ακόμη κι αν παραμένουν κάποια
σφάλματα. Με το ":Fatal", όλα τα προαιρετικά σφάλματα θεωρούνται ως ανεπανόρθωτα, με αποτέλεσμα κωδικό ο οποίος θα προχωρήσει σε ματαίωση εάν παρουσιαστεί σφάλμα κατά τον χρόνο εκτέλεσης. Χωρίς το ":Fatal", τα προαιρετικά σφάλματα δεν εμποδίζουν τη δημιουργία κατάλληλου κωδικού και τα παραγόμενα αρχεία .class μπορούν να εκτελεστούν χωρίς πρόβλημα. |
||||||||||||||
| -verbose | Εκτύπωση μονάδων μεταγλώττισης στις οποίες έχει πραγματοποιηθεί πρόσβαση/επεξεργασία, στην κονσόλα ή στο αρχείο καταγραφής, αν καθορίζεται. | ||||||||||||||
| -referenceInfo | Υπολογισμός πληροφοριών παραπομπών. Χρησιμοποιείται μόνο αν υπάρχει σύνδεση με το εργαλείο δόμησης. Διαφορετικά, οι πληροφορίες παραπομπών είναι άχρηστες. | ||||||||||||||
| -progress | Εμφάνιση προόδου (μόνο σε κατάσταση -log). | ||||||||||||||
| -time | Εμφάνιση πληροφοριών ταχύτητας. | ||||||||||||||
| -noExit | Δεν γίνεται κλήση του System.exit(n) στο τέλος της μεταγλώττισης (n=0 εάν δεν υπάρχει σφάλμα). | ||||||||||||||
| -repeat <n> | Επανάληψη της διεργασίας μεταγλώττισης <n> φορές (για ανάλυση perf). | ||||||||||||||
| -inlineJSR | Ενσωμάτωση κώδικα JSR byte (αυτόματα εάν ο προορισμός >= 1.5). | ||||||||||||||
| -enableJavadoc | Λαμβάνονται υπόψη παραπομπές μέσα σε javadoc. | ||||||||||||||
| -missingNullDefault | Όταν ενεργοποιηθεί η ανάλυση null βάσει σημειώσεων (με χρήση του "nullAnnot" που αναφέρεται παραπάνω), αυτή η επιλογή θα επιστρέψει προειδοποίηση όταν δεν υπάρχει προεπιλεγμένη σημείωση σε ένα πακέτο ή είδος. | ||||||||||||||
| Βοηθητικές επιλογές | |||||||||||||||
| -? -? -help | Εμφάνιση του μηνύματος βοήθειας. | ||||||||||||||
| -v -version | Εμφάνιση του αριθμού δόμησης του μεταγλωττιστή. Πολύ χρήσιμη για την αναφορά ενός σφάλματος. | ||||||||||||||
| -showversion | Εμφάνιση του αριθμού δόμησης του μεταγλωττιστή και συνέχεια. Πολύ χρήσιμη για την αναφορά ενός σφάλματος. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Μεταγλωττίζει όλα τα αρχεία πρωτογενούς κώδικα του καταλόγου d:\temp και των υποφακέλων. Η διαδρομή κλάσεων είναι απλά rt.jar. Δημιουργεί όλα τα γνωρίσματα εντοπισμού και διόρθωσης σφαλμάτων και όλα τα αρχεία .class που προκύπτουν καταγράφονται στον κατάλογο d:\tmp. Η ταχύτητα του μεταγλωττιστή θα εμφανιστεί μόλις ολοκληρωθεί η μαζική διεργασία. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Μεταγλωττίζει μόνο το Test.java και τα εξαρτημένα αρχεία του εάν υπάρχουν, ανακτώντας τα εξαρτημένα αρχεία από τον d:\temp. Η διαδρομή κλάσεων είναι d:\temp ακολουθούμενο από το rt.jar, που σημαίνει ότι πραγματοποιείται αναζήτηση για όλες τις απαραίτητες κλάσεις πρώτα στον d:\temp και έπειτα στο rt.jar. Δεν δημιουργεί γνωρίσματα εντοπισμού και διόρθωσης σφαλμάτων και όλα τα αρχεία .class που προκύπτουν καταγράφονται στον d:\temp. |