Die Klasse des Stapelcompilers befindet sich im JDT-Kern-Plug-in. Der Name der Klasse ist org.eclipse.jdt.compiler.batch.BatchCompiler. Sie befindet sich im Paket plugins/org.eclipse.jdt.core_<version>.jar. Seit Version 3.2 ist sie ebenfalls als separater Download verfügbar. Der Name der Datei lautet ecj.jar. Die entsprechende Quelle ist ebenfalls verfügbar. Zum Abrufen gehen Sie zu Seite
herunterladen und suchen nach dem Abschnitt zum Thema JDT-Kernstapelcompiler. Diese JAR-Datei enthält
den Stapelcompiler und den javac-ant-Adapter.
Ab 3.3 enthält diese JAR auch Unterstützung für jsr199 (Compiler-API) und die Unterstützung für jsr269 (Anmerkungsverarbeitung). Damit die Unterstützung der Anmerkungsverarbeitung verwendet werden kann, ist VM 1.6 erforderlich.
Auf diese Weise kann er als eigenständige Anwendung und innerhalb eines Ant-Builds außerhalb von Eclipse verwendet werden.
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
oder:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress) der Klasse BatchCompiler.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // Unterklasse instanziieren org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Sie können steuern, wie der Fortschritt dokumentiert wird bzw. wie der Stapelcompiler abgebrochen wird durch Bildung einer Unterklasse der Klasse org.eclipse.jdt.compiler.CompilationProgress.
Die empfohlenen Optionen haben einen orangefarbenen Hintergrund.
Wenn bestimmte Optionen mehrmals gesetzt werden, verarbeitet sie der Stapelcompiler von links nach rechts. Wenn die Option für Warnung (-warn:....) ohne '+' oder '-' verwendet wird, wird dadurch die Gruppe an Warnungen außer Kraft gesetzt, die zuvor angegeben wurde. Daher sollten Benutzer sicherstellen, dass eine solche Option vor einer weiteren Verwendung der Option '-warn' angegeben wird.
Gleiches gilt für die Option '-err:'.
| Name | Verwendung | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Klassenpfad-Optionen | |||||||||||||||
| -bootclasspath <verz 1>;<verz 2>;...;<verz P> | Dies ist eine Liste der Verzeichnisse oder JAR-Dateien, die für das Bootprogramm der
Klassendateien vom Compiler verwendet werden. Standardmäßig werden die Bibliotheken der aktiven VM verwendet. Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. Jedes Verzeichnis oder jede Datei kann Zugriffsregeln für Typen zwischen '[' und ']' angeben. Wenn bootclasspath nicht angegeben ist, ermittelt der Compiler dies anhand der folgenden Systemeigenschaften: |
||||||||||||||
| -cp -classpath <verz 1>;<verz 2>;...;<verz P> |
Dies ist eine Liste der Verzeichnisse und JAR-Dateien, die
zum Kompilieren der Quellendateien verwendet werden. Der Standardwert ist der Wert der Eigenschaft "java.class.path". Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. Jedes Verzeichnis oder jede Datei kann Zugriffsregeln für Typen zwischen '[' und ']' angeben. (Zum Beispiel [-X] für verbotenen Zugriff auf den Typ X, [~X] nicht empfohlener Zugriff auf den Typ X, [+p/X:-p/*] für verbotenen Zugriff auf alle Typen im Paket p, wobei der Zugriff auf p/X erlaubt ist). Der Compiler folgt rekursiv den Klauseln klassenpfad der JAR-Dateien-Manifeste, fügt jede referenzierte
JAR-Datei an das Ende des Klassenpfades an, sofern sie sich noch nicht im Klassenpfad befindet. |
||||||||||||||
| -extdirs <verz 1>;<verz 2>;...;<verz P> | Dies ist eine Liste der Verzeichnisse, die für die Angabe der Position der zip/jar-Erweiterungsdateien verwendet werden. Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. | ||||||||||||||
| -endorseddirs <verz 1>;<verz 2>;...;<verz P> | Dies ist eine Liste der Verzeichnisse, die zur Angabe der Position gebilligter zip/jar-Dateien verwendet werden. Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. | ||||||||||||||
| -sourcepath <verz 1>;<verz 2>;...;<verz P> | Dies ist eine Liste der Verzeichnisse, die zur Angabe der Quellendatei verwendet werden. Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. Jedes Verzeichnis kann Zugriffsregeln für Typen zwischen '[' und ']' angeben. |
||||||||||||||
| -d <verz 1>|none | Dies wird verwendet um anzugeben, in welchem Verzeichnis Speicherauszüge der generierten .class-Dateien erstellt werden sollen. Wird dies übergangen, wird keine Paketverzeichnisstruktur erstellt. Wenn keine Datei mit der Erweiterung .class generieren möchten, verwenden Sie -d none. |
||||||||||||||
| -encoding <codierungsname> | Gibt die Standardcodierung für alle Quellendateien an. Es kann auch für jede Datei eine angepasste Codierung angegeben werden, indem jeder
eingegebene
Quellendateiname bzw. Quellenordnername mit dem Suffix [<Codierungsname>] versehen wird. Beispiel:
Mit X.java[utf8] wird die Codierung UTF-8 für die Kompiliereinheit 'X.java' im aktuellen Benutzerverzeichnis angegeben.
Werden mehrere Standardcodierungen für Quellendateien angegeben, wird die letzte Codierung verwendet. Zum Beispiel:
|
||||||||||||||
| Optionen für Kompatibilität | |||||||||||||||
| -target 1.1 bis 1.7 oder (5, 5.0 usw.) | Dadurch wird die Zieleinstellung der .class-Datei angegeben. Folgende Werte sind möglich:
clcd1.1 kann zum Generieren des 'StackMap'-Attributs verwendet werden. |
||||||||||||||
| -1.3 | Konformitätsstufe auf 1.3 setzen. Implizit -source 1.3 -target 1.1. | ||||||||||||||
| -1.4 | Konformitätsstufe auf 1.4 (Standard) setzen. Implizit -source 1.3 -target 1.2. | ||||||||||||||
| -1.5 | Konformitätsstufe auf 1.5 setzen. Implizit -source 1.5 -target 1.5. | ||||||||||||||
| -1.6 | Konformitätsstufe auf 1.6 setzen. Implizit -source 1.6 -target 1.6. | ||||||||||||||
| -1.7 | Konformitätsstufe auf 1.7 setzen. Implizit -source 1.7 -target 1.7. | ||||||||||||||
| -source 1.1 bis 1.7 oder (5, 5.0 usw.) | Diese Einstellung wird verwendet, um die vom Compiler erwarteten Quellenebenen anzugeben. Folgende Werte sind möglich:
|
||||||||||||||
| Optionen für Warnung | |||||||||||||||
| -?:warn -help:warn | Zeigt erweiterte Optionen für Warnungen an. | ||||||||||||||
| -warn:... | Geben Sie die Gruppe aktivierter Warnung an. Z. B. -warn:unusedLocal,deprecation
|
||||||||||||||
| Standardwert | Tokenname | Beschreibung | |||||||||||||
| +/- | allDeadCode | Inaktiver Code einschließlich trivialer Prüfung 'if(DEBUG)' | |||||||||||||
| +/- | allDeprecation | Veraltung selbst innerhalb eines veralteten Codes | |||||||||||||
| - | allJavadoc | Ungültiges oder fehlendes Javadoc | |||||||||||||
| - | allOver-ann | Alle fehlenden Anmerkungen vom Typ '@Override' (Superklasse und Superschnittstellen) | |||||||||||||
| - | all-static-method | Die Methode all kann als statische Warnung deklariert werden | |||||||||||||
| + | assertIdentifier | Vorkommen von assert in Verwendung als Kennung | |||||||||||||
| - | boxing | Konvertierung durch automatisches Boxing | |||||||||||||
| + | charConcat | Verwendung eines Zeichenbereichs in einer Verkettung von Zeichenfolgen, ohne ohne explizit in eine Zeichenfolge konvertiert worden zu sein | |||||||||||||
| + | compareIdentical | Vergleich identischer Ausdrücke | |||||||||||||
| - | conditionAssign | Mögliche unbeabsichtigte boolesche Zuordnung | |||||||||||||
| + | constructorName | Methode mit einem Konstruktornamen | |||||||||||||
| + | deadCode | Inaktiver Code ausschließlich trivialer Prüfung 'if(DEBUG)' | |||||||||||||
| - | dep-ann | Fehlende Anmerkung '@Deprecated' | |||||||||||||
| +/- | deprecation | Verwendung eines veralteten Typs oder Members außerhalb eines veralteten Codes | |||||||||||||
| + | discouraged | Verwendung von Typen, die einer nicht empfohlenen Zugriffsregel entsprechen | |||||||||||||
| - | emptyBlock | Nicht dokumentierter leerer Block | |||||||||||||
| + | enumIdentifier | Vorkommen von enum in Verwendung als Kennung | |||||||||||||
| + | enumSwitch | Unvollständige enum-switch-Anweisung | |||||||||||||
| - | enumSwitchPedantic | Melden fehlender enum-switch-case-Anweisungen, auch wenn eine case-Standardanweisung vorhanden ist | |||||||||||||
| - | fallthrough | Mögliche Auslassung von 'case' | |||||||||||||
| - | fieldHiding | Feld, das weitere Variable verdeckt | |||||||||||||
| + | finalBound | Typparameter mit Endbindung | |||||||||||||
| + | finally | finally-Block wird nicht normal beendet | |||||||||||||
| + | forbidden | Verwendung von Typen, die einer verbotenen Zugriffsregel entsprechen | |||||||||||||
| - | hashCode | Fehlende Methode 'hashCode()' bei Außerkraftsetzung von 'equals()' | |||||||||||||
| +/- | hiding | Makro für fieldHiding, localHiding, typeHiding und maskedCatchBlock | |||||||||||||
| - | includeAssertNull | Auslösen von Nullwarnungen für Variablen, die in einem Assert-Ausdruck verdorben wurden | |||||||||||||
| - | indirectStatic | Indirekter Verweis auf statisches Member | |||||||||||||
| + | intfAnnotation | Anmerkungstyp wird als Superschnittstelle verwendet | |||||||||||||
| + | intfNonInherited | Kompatibilität mit nicht übernommener Schnittstelle | |||||||||||||
| - | intfRedundant | Sucht redundante Superschnittstellen | |||||||||||||
| - | javadoc | Ungültiges Javadoc | |||||||||||||
| - | localHiding | Lokale Variable, die weitere Variable verdeckt | |||||||||||||
| + | maskedCatchBlock | Verdeckter catch-Block | |||||||||||||
| - | nls | Nicht-NLS Zeichenfolgeliteral (fehlende Tags //$NON-NLS-<n>) | |||||||||||||
| + | noEffectAssign | Zuordnung ohne Auswirkung | |||||||||||||
| +/- | null | Möglicherweise fehlende oder redundante Nullüberprüfung | |||||||||||||
| - | nullAnnot | Anmerkungsbasierte Nullanalyse aktivieren. Falls dies gewünscht wird, können die Anmerkungstypen, die vom Compiler interpretiert werden sollen, angegeben werden, indem (nullable|nonnull|nonnullbydefault) angefügt wird. Dabei wird jeder Anmerkungstyp mithilfe seines vollständig qualifizierten Namens angegeben. Siehe auch -nonNullByDefault unten. |
|||||||||||||
| - | nullDereference | Fehlende Nullüberprüfung | |||||||||||||
| - | over-ann | Fehlende Anmerkung vom Typ '@Override' (nur Superklasse) | |||||||||||||
| - | paramAssign | Zuordnung zu einem Parameter | |||||||||||||
| + | pkgDefaultMethod | Versuch des Überschreibens der Standardmethode eines Pakets | |||||||||||||
| + | raw | Verwendung des unformatierten Typs (anstelle des parametrisierten Typs) | |||||||||||||
| +/- | Ressource | (Potenziell) unsichere Verwendung der Ressource des Typs Closeable | |||||||||||||
| - | semicolon | Unnötiges Semikolon oder leere Anweisung | |||||||||||||
| + | serial | Fehlen von 'serialVersionUID' | |||||||||||||
| - | specialParamHiding | Konstruktor oder Setter-Parameter verdeckt anderes Feld | |||||||||||||
| +/- | static-access | Makro für 'indirectStatic' und 'staticReceiver' | |||||||||||||
| - | static-method | Eine Instanzmethode, die als statische Methode verwendet werden könnte | |||||||||||||
| + | staticReceiver | Prüft, ob ein nicht statischer Empfänger verwendet wird, um ein statisches Feld abzurufen oder eine statische Methode aufzurufen | |||||||||||||
| - | super | Überschreiben einer Methode ohne super-Aufruf | |||||||||||||
| + | suppress | Aktiviert '@SuppressWarnings' | |||||||||||||
| - | switchDefault | In switch-Anweisung fehlt die case-Standardanweisung | |||||||||||||
| - | syncOverride | Fehlen von 'synchronized' bei Außerkraftsetzung von sychronisierter Methode | |||||||||||||
| - | syntheticAccess | Bei der Durchführung eines synthetischen Zugriffs für eine untergeordnete Klasse | |||||||||||||
| - | tasks | Unterstützung für Task-Tags im Quellcode aktivieren | |||||||||||||
| + | typeHiding | Typparameter verdeckt einen anderen Typ | |||||||||||||
| + | unavoidableGenericProblems | Ignorieren von unvermeidbaren Typsicherheitsproblemen aufgrund nicht formatierter APIs | |||||||||||||
| + | unchecked | Nicht überprüfte Typoperation | |||||||||||||
| - | unnecessaryElse | Nicht erforderliche ELSE-Klausel | |||||||||||||
| - | unqualifiedField | Nicht qualifizierter Verweis auf Feld | |||||||||||||
| +/- | unused | Makro für unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown und unusedTypeArgs | |||||||||||||
| - | unusedAllocation | Zuordnung eines nicht verwendeten Objekts | |||||||||||||
| - | unusedArgument | Nicht verwendetes Methodenargument | |||||||||||||
| + | unusedImport | Nicht verwendeter Importverweis | |||||||||||||
| + | unusedLabel | Nicht verwendete Bezeichnung | |||||||||||||
| + | unusedLocal | Nicht verwendete lokale Variable | |||||||||||||
| + | unusedPrivate | Nicht verwendete Deklaration von privatem Member | |||||||||||||
| - | unusedThrown | Nicht verwendete ausgelöste Ausnahmebedingung | |||||||||||||
| + | unusedTypeArgs | Nicht verwendete Typargumente für Methode und Konstruktor | |||||||||||||
| - | uselessTypeCheck | Nicht erforderliche cast/instanceof-Operation | |||||||||||||
| + | varargsCast | Argument 'varargs' erfordert explizite Umsetzung | |||||||||||||
| +/- | warningToken | Nicht bearbeitetes oder nicht verwendetes Warnungstoken in @SuppressWarnings | |||||||||||||
| -nowarn | Keine Warnung (entspricht -warn:none) | ||||||||||||||
| -err:... | Geben Sie die Gruppe aktivierter Warnungen an, die in Fehler umgewandelt werden. Beispiel: -err:unusedLocal,deprecation Die Warnungen 'unusedLocal' und 'deprecation' werden in Fehler umgewandelt. Alle anderen Warnungen werden weiterhin als Warnungen gemeldet.
|
||||||||||||||
| -deprecation | Äquivalent zu -warn:+deprecation | ||||||||||||||
| -properties <datei> | Option zum Festlegen von Warnungen/Fehlern auf der Grundlage des Inhalts der Eigenschaftendatei. Diese Option kann mit den Optionen -nowarn, -err:.. or -warn:.. verwendet werden. Das letzte Element der Befehlszeile legt die zu verwendenden Optionen fest. Der Inhalt der Eigenschaftendatei kann generiert werden, indem projektspezifische Einstellungen für ein vorhandenes Java-Projekt festgelegt werden
und die Datei in der Datei ... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ... |
||||||||||||||
| Optionen für Debug | |||||||||||||||
| -g[:none|:lines,vars,source] | Debugattributstufen festlegen
|
||||||||||||||
| -preserveAllLocals | Den Compiler explizit auffordern, alle lokalen Variablen beizubehalten (für Debugzwecke). Der Compiler entfernt nicht verwendete lokale Variablen, wenn diese Angabe fehlt. | ||||||||||||||
| Optionen für die Anmerkungsverarbeitung (Voraussetzung: VM ab 1.6 VM und Kompatibilität mit 1.6) | |||||||||||||||
| -Akey[=wert] | Optionen für die Anmerkungsverarbeitung werden an Anmerkungsfunktionen übergeben. key besteht aus Kennungen, die mit Punkten getrennt sind. |
||||||||||||||
| -proc:[only|none] | Wenn -proc:only angegeben wird, werden die Anmerkungsfunktionen ausgeführt, es wird jedoch keine
Kompilierung ausgeführt. Wenn -proc:none angegeben wird, werden Anmerkungsfunktionen
weder erkannt noch ausgeführt; die Kompilierung erfolgt so, als ob keine Anmerkungsfunktionen gefunden
wurden. Der Compiler muss standardmäßig im Klassenpfad nach Anmerkungsfunktionen suchen. Daher beschleunigt
die Angabe -proc:none möglicherweise die Kompilierung, falls keine Anmerkungsverarbeitung
erforderlich ist. |
||||||||||||||
| -processor <klasse1[,klasse2,...]> | Qualifizierte Klassennamen auszuführender Anmerkungsfunktionen. Wenn dies angegeben ist, wird der normale Erkennungsprozess für Funktionen übersprungen. | ||||||||||||||
| -processorpath <verz 1>;<verz 2>;...;<verz P> | Dies ist eine Liste von Verzeichnissen oder JAR-Dateien, die nach Anmerkungsfunktionen durchsucht werden. Die Einträge werden durch das Pfadtrennzeichen der Plattform getrennt. Wenn dies nicht angegeben ist, wird stattdessen der Klassenpfad durchsucht. | ||||||||||||||
| -s <verz> | Gibt das Verzeichnis an, in dem generierte Quellendateien erstellt werden. | ||||||||||||||
| -XprintProcessorInfo | Druckt Informationen darüber, welche Anmerkungen und welche Elemente an eine Anmerkungsfunktion zur Verarbeitung übergeben werden. | ||||||||||||||
| -XprintRounds | Druckt Informationen zu Anmerkungsverarbeitungsrunden. | ||||||||||||||
| -classNames <klasse1[,klasse2,...]> | Qualifizierte Namen binärer Typen, die verarbeitet werden müssen. | ||||||||||||||
| Ignorierte Optionen (zur Kompatibilität mit javac-Optionen) | |||||||||||||||
| -J<option> | Übergibt Option an die virtuelle Maschine. | ||||||||||||||
| -X<option> | Gibt vom Standard abweichende Option an. -Xemacs wird nicht ignoriert. | ||||||||||||||
| -X | Druckt vom Standard abweichende Optionen und beendet. | ||||||||||||||
| -O | Optimiert die Ausführungszeit. | ||||||||||||||
| Erweiterte Optionen | |||||||||||||||
| @<datei> | Befehlszeilenargumente aus Datei lesen. | ||||||||||||||
| -maxProblems <n> | Maximale Anzahl an Fehlern pro Kompiliereinheit (standardmäßig 100). | ||||||||||||||
| -log <dateiname> | Angabe einer Protokolldatei, in der ein Speicherauszug aller Ausgaben des Compilers erstellt wird. Dies ist sehr hilfreich, wenn Sie ein Debug für den Stapelcompiler ausführen oder eine Datei abrufen möchten, die alle Fehler und Warnungen aus einem Stapelbuild enthält. Wenn die Erweiterung .xml ist, wird das generierte Protokoll eine xml-Datei sein. | ||||||||||||||
| -Xemacs | emacs-Darstellung verwenden, um Fehler- und Warnungspositionen in der Konsole und regulären Textprotokollen
darzustellen. XML-Protokolle sind von dieser Option nicht betroffen. Wenn diese Option aktiv ist,
wird die Nachricht:2. WARNUNG in /workspace/X.javawie folgt dargestellt: /workspace/X.java:8: warning: The method... |
||||||||||||||
| -proceedOnError[:Fatal] | Kompilieren trotz Fehlern, Speicherauszugsklassendateien mit Fehlermethoden oder Fehlertypen fortsetzen. Dies ist nur dann zu empfehlen, wenn Sie Ihre Anwendung selbst dann ausführen möchten, wenn noch Fehler vorhanden sind. Bei ":Fatal" werden alle optionalen Fehler als schwer wiegend behandelt. Daraus ergibt sich Code, der fehlschlägt, wenn zur Laufzeit ein Fehler auftritt. Ohne ":Fatal" wird die Generierung von ordnungsgemäßem Code nicht durch optionale Fehler verhindert, und die erstellten .class-Dateien können ohne Probleme ausgeführt werden. |
||||||||||||||
| -verbose | Druckt, wenn angegeben, zugegriffene/verarbeitete Kompiliereinheiten in der Konsole oder der Protokolldatei. | ||||||||||||||
| -referenceInfo | Verweisinformationen berechnen. Dies ist nur dann hilfreich, wenn eine Verbindung zu dem Builder besteht. Andernfalls sind die Verweisinformationen nutzlos. | ||||||||||||||
| -progress | Fortschritt anzeigen (nur im Protokollmodus -log). | ||||||||||||||
| -time | Geschwindigkeitsdaten anzeigen. | ||||||||||||||
| -noExit | Kein Aufruf von System.exit(n) am Ende der Kompilierung (n=0 wenn kein Fehler vorliegt). | ||||||||||||||
| -repeat <n> | Kompilierungsprozess <n>-mal wiederholen (perf-Analyse). | ||||||||||||||
| -inlineJSR | Integrierter JSR-Bytecode (implizit wenn Ziel >= 1.5). | ||||||||||||||
| -enableJavadoc | Verweise innerhalb von javadoc beachten. | ||||||||||||||
| -missingNullDefault | Wenn die anmerkungsbasierte Nullanalyse (mit "nullAnnot") aktiviert wird, dann löst diese Option eine Warnung aus, wenn keine Standardanmerkung für ein Paket oder einen Typ vorhanden ist. | ||||||||||||||
| Optionen für die Hilfe | |||||||||||||||
| -? -help | Hilfenachricht anzeigen. | ||||||||||||||
| -v -version | Buildnummer des Compilers anzeigen. Dies ist sehr nützlich, um einen Programmfehler zu melden. | ||||||||||||||
| -showversion | Buildnummer des Compilers anzeigen und fortfahren. Dies ist sehr nützlich, um einen Programmfehler zu melden. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Kompiliert alle Quellendateien in 'd:\temp' und seinen Unterordnern. Der Klassenpfad ist einfach 'rt.jar'. Es werden alle Debugattribute generiert und von allen generierten .class-Dateien wird in 'd:\tmp' ein Speicherauszug erstellt. Die Geschwindigkeit des Compilers wird angezeigt, wenn der Stapelprozess abgeschlossen ist. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Kompiliert nur Test.java und seine gegebenenfalls vorhandenen abhängigen Dateien im Verzeichnis 'd:\temp'. Der Klassenpfad lautet 'd:\temp' gefolgt von 'rt.jar'. Das bedeutet, dass alle notwendigen Klassen zuerst in 'd:\temp' und anschließend in 'rt.jar' gesucht werden. Es werden keine Debugattribute generiert und für alle generierten Dateien mit der Erweiterung .class wird ein Speicherauszug in 'd:\temp' erstellt. |