Verwendung des Stapelcompilers

Finden des Stapelcompilers

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.

Ausführen des Stapelcompilers

Welche Optionen stehen zur Verfügung?

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: sun.boot.class.path, vm.boot.class.path oder org.apache.harmony.boot.class.path (jeweils in dieser Reihenfolge).

-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:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Alle Quellendateien werden mithilfe der Codierung UTF-8 gelesen (einschließlich Z.java). X.java wird mit Cp1252-Codierung und Y.java wird mit UTF-16-Codierung gelesen.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Alle Quellendateien werden mithilfe der Codierung UTF-16 gelesen. Die Option -encoding für UTF-8 wird ignoriert.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Alle Quellendateien werden mithilfe der Codierung Cp1252 gelesen. X.java ist die einzige Datei im Verzeichnis '/foo/bar', die mithilfe der Codierung UTF-16 gelesen wird. Alle anderen Dateien in diesem Verzeichnis verwenden die Codierung UTF-8.
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:
  • 1.1 (übergeordnete Version: 45, untergeordnete: 3)
  • 1.2 (übergeordnete Version: 46, untergeordnete: 0)
  • 1.3 (übergeordnete Version: 47, untergeordnete: 0)
  • 1.4 (übergeordnete Version: 48, untergeordnete: 0)
  • 1.5, 5 oder 5.0 (übergeordnete Version: 49, untergeordnete: 0)
  • 1.6, 6 oder 6.0 (übergeordnete Version: 50, untergeordnete: 0)
  • 1.7, 7 oder 7.0 (übergeordnete Version: 51, untergeordnete: 0)
Die Standardwerte sind:
  • 1.1 im Modus -1.3
  • 1.2 im Modus -1.4
  • 1.5 im Modus -1.5
  • 1.6 im Modus -1.6
  • 1.7 im Modus -1.7

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:
  • 1.3
  • 1.4
  • 1.5, 5 oder 5.0
  • 1.6, 6 oder 6.0
  • 1.7, 7 oder 7.0
Die Standardwerte sind:
  • 1.3 im Modus -1.3
  • 1.3 im Modus -1.4
  • 1.5 im Modus -1.5
  • 1.6 im Modus -1.6
  • 1.7 im Modus -1.7
In 1.4 wird assert als Schlüsselwort behandelt. In 1.5 und 1.6, werden enum und assert als Schlüsselwörter behandelt.
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
-warn:none Alle Warnungen werden inaktiviert
-warn:<durch Komma (,) getrennte Warnungstoken> Nur die aufgelisteten Warnungen werden aktiviert
-warn:+<durch Komma (,) getrennte Warnungstoken> Zusätzliche Warnungen werden aktiviert
-warn:-<durch Komma (,) getrennte Warnungstoken> Bestimmte Warnungen werden inaktiviert
In der Spalte Standard unten gibt die Markierung "+/-" an, dass eine Option mehrere differenzierte Warnungsvarianten abdeckt, von denen einige standardmäßig aktiviert, andere hingegen inaktiviert sind. Dies bedeutet, dass die Angabe der Option mit "+" mehr Warnungen aktiviert als die Standardeinstellung und die Angabe von "-" einige Optionen inaktiviert, die standardmäßig aktiviert sind.
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.
-err:<durch Komma (,) getrennte Warnungstoken> Nur die aufgelisteten Warnungen werden in Fehler umgewandelt
-err:+<durch Komma (,) getrennte Warnungstoken> Zusätzliche Warnungen werden in Fehler umgewandelt
-err:-<durch Komma (,) getrennte Warnungstoken> Bestimmte Warnungen werden entfernt und nicht in Fehler umgewandelt
-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 .settings/org.eclipse.jdt.core.prefs als Eigenschaftendatei verwendet wird oder als einfache Textdatei mit definierten Eintrag/Wert-Paaren unter Verwendung der in der Klasse org.eclipse.jdt.core.JavaCore definierten Konstanten.

...
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
-g Alle Debuginformationen (entspricht -g:lines,vars,source)
-g:none Keine Debuginformationen
-g:[lines,vars,source] Selektive Debuginformationen
-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.java
(in Zeile 8)...

wie 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.

Beispiele

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.