De klasse van het batchcompileerprogramma bevindt zich in de JDT Core-plugin. De naam van de klasse luidt org.eclipse.jdt.compiler.batch.BatchCompiler. De plugin is ingepakt in plugins/org.eclipse.jdt.core_<versie>.jar. Vanaf 3.2 kunt u de klasse ook afzonderlijk downloaden. De naam van het bestand is ecj.jar. Bovendien is de bijbehorende broncode verkrijgbaar. Als u deze wilt ophalen, gaat u naar de downloadpagina en zoekt u naar het gedeelte JDT Core Batch Compiler. Het JAR-bestand bevat het batchcompileerprogramma en de Ant-adapter javac.
Vanaf 3.3 ondersteunt dit JAR-bestand tevens jsr199 (compileer-API) en jsr269 (annotatieverwerking). Als u de ondersteuning voor annotatieverwerking wilt gebruiken, moet u over een VM van versie 1.6 beschikken.
U kunt het bestand dus als zelfstandige toepassing en in een Ant-build buiten Eclipse gebruiken.
java -jar org.eclipse.jdt.core_<versie>.jar -classpath rt.jar A.java
of:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter
errWriter, CompilationProgress progress)-methode van de BatchCompiler voor de klasse.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instance maken van uw subklasse org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Hoe de voortgang wordt gerapporteerd of hoe u het batchcompileerprogramma kunt annuleren, kunt u instellen door het maken van subklassen onder de klasse org.eclipse.jdt.compiler.CompilationProgress.
De aanbevolen opties hebben een oranje achtergrond.
Als sommige opties meerdere keren worden ingesteld, verwerkt het batchcompileerprogramma deze van links naar rechts. Wanneer de waarschuwingsoptie (-warn:....) wordt gebruikt zonder '+' of '-', wordt hierdoor de eerder opgegeven set waarschuwingen uitgeschakeld. De gebruiker dient er daarom voor te zorgen dat een dergelijke optie wordt opgegeven voorafgaande aan enig ander gebruik van de optie -warn.
Hetzelfde is van toepassing voor de optie -err: .
| Naam | Gebruik | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Klassenpadopties | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | Dit is een lijst met directory's of JAR-bestanden waarmee de CLASS-bestanden voor het compileerprogramma startbaar kunnen worden gemaakt. Standaard worden de bibliotheken van de actieve VM gebruikt. Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. Voor elke directory en elk bestand kunnen toegangsregels voor typen worden ingesteld tussen '[' en ']'. Als u geen opstartklassenpad opgeeft, wordt dit door het compileerprogramma afgeleid
met de systeemeigenschappen |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
Dit is een lijst met directory's of JAR-bestanden voor het compileren van de bronbestanden. De standaardwaarde is de waarde van de eigenschap "java.class.path". Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. Voor elke directory en elk bestand kunnen toegangsregels voor typen worden ingesteld tussen '[' en ']' (bijv. [-X] om geen toegang tot het type X te verlenen, [~X] om de toegang tot het type X af te raden, [+p/X:-p/*] om geen toegang tot alle typen van het pakket p te verlenen, behalve tot p/X). Het compileerprogramma volgt recursief de Class-Path-clausules van de manifesten van de
JAR-bestanden. Hierbij wordt elke verwijzing naar een JAR-bestand toegevoegd aan het einde van het
klassenpad, voor zover het nog niet in het klassenpad aanwezig was. |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | Dit is een lijst met directory's voor het opgeven van de locatie van uitbreidende ZIP- of JAR-bestanden. Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | Dit is een lijst met directory's voor het opgeven van de locatie van goedgekeurde ZIP- of JAR-bestanden. Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | Dit is een lijst met directory's waarin de bronbestanden zich bevinden. Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. Voor elke directory kunnen toegangsregels voor typen worden ingesteld tussen '[' en ']'. |
||||||||||||||
| -d <dir 1>|none | Dit is de directory waarin de gegenereerde CLASS-bestanden moeten worden geplaatst. Als u de optie weglaat, wordt geen pakketdirectorystructuur gemaakt. Gebruik -d none als u helemaal geen CLASS-bestand wilt genereren. |
||||||||||||||
| -encoding <coderingsnaam> | Hiermee geeft u de standaardcodering op voor alle bronbestanden. U kunt een aangepaste codering ook per bestand opgeven door [<coderingsnaam>] achter de namen van de invoerbestanden en -mappen te plaatsen. Met X.java[utf8] geeft u bijvoorbeeld de codering UTF-8 op voor compilatie-eenheid X.java in de huidige gebruikersdirectory.
Als er meerdere standaardcoderingen voor bronbestanden worden opgegeven, wordt de laatste ervan gebruikt. Bijvoorbeeld:
|
||||||||||||||
| Compatibiliteitsopties | |||||||||||||||
| -target 1.1 t/m 1.7 of (5, 5.0, enz.) | De doelinstelling voor de CLASS-bestanden. Geldige waarden:
U kunt clcd1.1 gebruiken voor het genereren van het kenmerk StackMap. |
||||||||||||||
| -1.3 | Compatibiliteitsniveau instellen op 1.3. Impliciet: -source 1.3 -target 1.1. | ||||||||||||||
| -1.4 | Compatibiliteitsniveau instellen op 1.4 (standaard). Impliciet: -source 1.3 -target 1.2. | ||||||||||||||
| -1.5 | Compatibiliteitsniveau instellen op 1.5. Impliciet: -source 1.5 -target 1.5. | ||||||||||||||
| -1.6 | Compatibiliteitsniveau instellen op 1.6. Impliciet: -source 1.6 -target 1.6. | ||||||||||||||
| -1.7 | Compatibiliteitsniveau instellen op 1.7. Impliciet: -source 1.7 -target 1.7. | ||||||||||||||
| -source 1.1 t/m 1.7 of (5, 5.0, enz.) | Hiermee kunt u het bronniveau opgeven dat door het compileerprogramma wordt gehanteerd. Geldige waarden:
|
||||||||||||||
| Waarschuwingsopties | |||||||||||||||
| -?:warn -help:warn | Geavanceerde waarschuwingsopties weergeven | ||||||||||||||
| -warn:... | Geef hier de set van geactiveerde waarschuwingen op. bijvoorbeeld -warn:unusedLocal,deprecation
|
||||||||||||||
| Standaardwaarde | Token | Beschrijving | |||||||||||||
| +/- | allDeadCode | lege code inclusief triviale if(DEBUG)-controle | |||||||||||||
| +/- | allDeprecation | depreciëring, zelfs in gedeprecieerde code | |||||||||||||
| - | allJavadoc | ongeldige of ontbrekende javadoc | |||||||||||||
| - | allOver-ann | alle ontbrekende @Override-annotaties (superklasse en superinterfaces) | |||||||||||||
| - | all-static-method | methode all kan worden gedeclareerd als statische waarschuwingen | |||||||||||||
| + | assertIdentifier | gebruik van assert als identificatie | |||||||||||||
| - | boxing | autoboxing-conversie | |||||||||||||
| + | charConcat | gebruik van een niet expliciet naar een tekenreeks geconverteerde tekenarray in een samenvoeging | |||||||||||||
| + | compareIdentical | identieke expressies vergelijken | |||||||||||||
| - | conditionAssign | mogelijk onbedoelde booleaanse toewijzing | |||||||||||||
| + | constructorName | methode zonder constructornaam | |||||||||||||
| + | deadCode | lege code zonder triviale if(DEBUG)-controle | |||||||||||||
| - | dep-ann | ontbrekende annotatie @Deprecated | |||||||||||||
| +/- | deprecation | gebruik van gedeprecieerd type of lid buiten gedeprecieerde code | |||||||||||||
| + | discouraged | typen die overeenkomen met een regel voor niet-aanbevolen toegang | |||||||||||||
| - | emptyBlock | niet-gedocumenteerde lege blokken | |||||||||||||
| + | enumIdentifier | voorval van enum gebruikt als ID | |||||||||||||
| + | enumSwitch | onvolledige enum switch-instructie | |||||||||||||
| - | enumSwitchPedantic | ontbrekende enum switch-cases melden, ook als er een standaard-case aanwezig is | |||||||||||||
| - | fallthrough | mogelijk niet-afgebakende case-instructie | |||||||||||||
| - | fieldHiding | verborgen variabele door veld | |||||||||||||
| + | finalBound | typeparameter met eindgrens | |||||||||||||
| + | finally | onjuiste beëindiging van finally-blok | |||||||||||||
| + | forbidden | typen die overeenkomen met een regel voor niet-verleende toegang | |||||||||||||
| - | hashCode | ontbrekende methode hashCode() bij uitschakelen equals() | |||||||||||||
| +/- | verbergen | macro voor fieldHiding, localHiding, typeHiding en maskedCatchBlock | |||||||||||||
| - | includeAssertNull | null-waarschuwingen geven voor onbruikbare variabelen in een assert-expressie | |||||||||||||
| - | indirectStatic | indirecte verwijzing naar statisch lid | |||||||||||||
| + | intfAnnotation | annotatietype gebruikt als superinterface | |||||||||||||
| + | intfNonInherited | compatibiliteit met niet-overgenomen interfacemethode | |||||||||||||
| - | intfRedundant | redundante superinterfaces zoeken | |||||||||||||
| - | javadoc | ongeldige javadoc | |||||||||||||
| - | localHiding | verborgen variabele door lokale variabele | |||||||||||||
| + | maskedCatchBlock | verborgen catch-blok | |||||||||||||
| - | nls | tekenreeksliteralen die niet van het type nls zijn (ontbrekende tags //$NON-NLS-<n>) | |||||||||||||
| + | noEffectAssign | toewijzing zonder effect | |||||||||||||
| +/- | null | potentiële ontbrekende of overbodige controle op null | |||||||||||||
| - | nullAnnot | annotatie op basis van null-analyse inschakelen. Desgewenst kunt u opgeven welke typen annotaties door het compileerprogramma moeten worden geïnterpreteerd. Dat doet u door (nullable|nonnull|nonnullbydefault) aan het eind toe te voegen, waarbij elk type annotatie wordt aangegeven met zijn volledige (fully qualified) naam. Zie ook -nonNullByDefault, verderop. |
|||||||||||||
| - | nullDereference | ontbrekende controle op null | |||||||||||||
| - | over-ann | ontbrekende @Override-annotatie (alleen superklasse) | |||||||||||||
| - | paramAssign | toewijzing aan parameter | |||||||||||||
| + | pkgDefaultMethod | poging tot vervanging van standaardmethode van pakket | |||||||||||||
| + | raw | onbewerkt type (in plaats van geparametriseerd type) | |||||||||||||
| +/- | resource | (mogelijk) onveilig gebruik van een resource van type Closeable | |||||||||||||
| - | semicolon | onnodige puntkomma of lege instructie | |||||||||||||
| + | serial | ontbrekend serialVersionUID | |||||||||||||
| - | specialParamHiding | verborgen veld door constructor of setter-parameter | |||||||||||||
| +/- | static-access | macro voor indirectStatic en staticReceiver | |||||||||||||
| - | static-method | een instancemethode die kan optreden als een statische methode | |||||||||||||
| + | staticReceiver | ophalen van statisch veld of aanroepen van statische methode door niet-statische ontvanger | |||||||||||||
| - | super | methodevervanging zonder superaanroep | |||||||||||||
| + | suppress | @SuppressWarnings inschakelen | |||||||||||||
| - | switchDefault | switch-statement heeft geen standaard-case | |||||||||||||
| - | syncOverride | synchronized ontbreekt in gesynchroniseerde methodevervanging | |||||||||||||
| - | syntheticAccess | synthetische toegang voor binnenklasse | |||||||||||||
| - | tasks | ondersteuning voor tasks-tags in broncode inschakelen | |||||||||||||
| + | typeHiding | verborgen type door typeparameter | |||||||||||||
| + | unavoidableGenericProblems | onvermijdbare problemen negeren over typeveiligheid vanwege onbewerkte API's | |||||||||||||
| + | unchecked | niet-gecontroleerde bewerking van type | |||||||||||||
| - | unnecessaryElse | onnodige else-clausule | |||||||||||||
| - | unqualifiedField | ongekwalificeerde verwijzing naar veld | |||||||||||||
| +/- | unused | macro voor unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown en unusedTypeArgs | |||||||||||||
| - | unusedAllocation | toewijzing van een object dat niet wordt gebruikt | |||||||||||||
| - | unusedArgument | niet-gebruikt methode-argument | |||||||||||||
| + | unusedImport | niet-gebruikte importverwijzing | |||||||||||||
| + | unusedLabel | niet-gebruikt label | |||||||||||||
| + | unusedLocal | niet-gebruikte lokale variabele | |||||||||||||
| + | unusedPrivate | niet-gebruikte declaratie van besloten lid | |||||||||||||
| - | unusedThrown | niet-gebruikte declaratie van verworpen uitzondering | |||||||||||||
| + | unusedTypeArgs | ongebruikte typeargumenten voor methode en constructor | |||||||||||||
| - | uselessTypeCheck | onnodige omzettings-/instanceof-bewerking | |||||||||||||
| + | varargsCast | varargs-parameter zonder expliciete omzetting | |||||||||||||
| +/- | warningToken | niet-afgehandeld of ongebruikt waarschuwingstoken in @SuppressWarnings | |||||||||||||
| -nowarn | Geen waarschuwing (gelijk aan -warn:none) | ||||||||||||||
| -err:... | Geef hier de set van geactiveerde waarschuwingen op die worden
omgezet in fouten. bijvoorbeeld -err:unusedLocal,deprecation unusedLocal- en deprecation-waarschuwingen worden omgezet in fouten. Alle andere waarschuwingen worden nog steeds aangegeven als waarschuwingen.
|
||||||||||||||
| -deprecation | Gelijk aan -warn:+deprecation. | ||||||||||||||
| -properties <bestand> | Optie voor waarschuwingen/fouten instellen op basis van de inhoud van het eigenschappenbestand. Deze optie kunt u gebruiken in combinatie met -nowarn, -err:.. of -warn:.. -opties, maar het laatste opgegeven item op de opdrachtregel bepaalt welke opties worden gebruikt. De inhoud van het eigenschappenbestand kan worden gegenereerd door het instellen van projectspecifieke instellingen voor een bestaand Java-project waarna u deze in ... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ... |
||||||||||||||
| Foutopsporingsopties | |||||||||||||||
| -g[:none|:lines,vars,source] | Het niveau van de foutopsporingskenmerken instellen.
|
||||||||||||||
| -preserveAllLocals | Het compileerprogramma expliciet verzoeken alle lokale variabelen te behouden voor foutopsporingsdoeleinden. Als u deze optie weglaat, worden niet-gebruikte lokale variabelen door het compileerprogramma verwijderd. | ||||||||||||||
| Annotatieverwerkingsopties (VM van versie 1.6 of nieuwer is vereist; alleen gebruikt bij compatibiliteit 1.6) | |||||||||||||||
| -Akey[=waarde] | Opties die worden doorgegeven aan annotatieprocessors. sleutel
bestaat uit identificaties die van elkaar zijn gescheiden door een punt. |
||||||||||||||
| -proc:[only|none] | Als u -proc:only opgeeft, worden de annotatieprocessors
wel uitgevoerd, maar er wordt niet gecompileerd. Als u -proc:none opgeeft,
worden de annotatieprocessors niet opgespoord of uitgevoerd. De compilatie vindt plaats
alsof er geen annotatieprocessors zijn gevonden. Standaard moet het compileerprogramma in
het klassenpad zoeken naar annotatieprocessors. Wanneer annotatieverwerking niet is vereist,
kunt u de compilatie mogelijk versnellen door -proc:none op te geven. |
||||||||||||||
| -processor <klasse1[,klasse2,...]> | De gekwalificeerde klassennamen van de annotatieprocessors die moeten worden uitgevoerd. Als u deze optie opgeeft, wordt de normale processoropsporing overgeslagen. | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | Een lijst met directory's of JAR-bestanden waarin wordt gezocht naar annotatieprocessors. Gebruik het padscheidingsteken van het platform om de items van elkaar te scheiden. Als u niets opgeeft, wordt het klassenpad doorzocht. | ||||||||||||||
| -s <dir> | De directory waarin gegenereerde bronbestanden worden gemaakt. | ||||||||||||||
| -XprintProcessorInfo | Informatie afdrukken over de annotaties en de elementen die door een processor moeten worden verwerkt. | ||||||||||||||
| -XprintRounds | Informatie afdrukken over annotatieverwerkingsronden. | ||||||||||||||
| -classNames <klasse1[,klasse2,...]> | De gekwalificeerde namen van binaire typen die moeten worden verwerkt. | ||||||||||||||
| Genegeerde opties (voor compatibiliteit met javac-opties) | |||||||||||||||
| -J<optie> | Optie doorgeven aan de Virtual Machine. | ||||||||||||||
| -X<optie> | Een niet-standaard optie opgeven. -Xemacs wordt niet genegeerd. | ||||||||||||||
| -X | Niet-standaard opties afdrukken en afsluiten. | ||||||||||||||
| -O | Optimaliseren voor runtime. | ||||||||||||||
| Geavanceerde opties | |||||||||||||||
| @<bestand> | Opdrachtregelargumenten ophalen uit bestand. | ||||||||||||||
| -maxProblems <n> | Maximumaantal problemen per compilatie-eenheid (standaard 100). | ||||||||||||||
| -log <bestandsnaam> | Een logboekbestand opgeven waarnaar alle uitvoer van het compileerprogramma wordt weggeschreven. Gebruik deze optie vooral wanneer u fouten met het batchcompileerprogramma wilt opsporen of wanneer u een bestand wilt ophalen waarin alle fouten en waarschuwingen van een als batch verwerkte bouwbewerking zijn opgeslagen. Als de extensie .xml is, wordt het gegenereerde logboek als XML-bestand opgeslagen. | ||||||||||||||
| -Xemacs | Fout- en waarschuwingsberichten in emacs-stijl in de console en gewone logboeken afbeelden. Deze optie is niet van invloed op XML-logboeken. Als deze optie actief is, ziet het bericht:2. WAARSCHUWING in /workspace/X.javaer als volgt uit: /workspace/X.java:8: waarschuwing: De methode... |
||||||||||||||
| -proceedOnError[:Fatal] | Compilatie voortzetten bij fouten en klassenbestanden met foutieve methoden of typen dumpen. Stel deze optie alleen in als u de toepassing wilt kunnen uitvoeren met resterende fouten. Met ":Fatal" worden alle optionele fouten behandeld als fataal, hetgeen leidt tot code die wordt afgebroken zodra tijdens runtime een fout optreedt. Zonder ":Fatal", verhinderen optionele fouten niet het genereren van de gewenste code en kunnen de gemaakte .class-bestanden zonder problemen worden uitgevoerd. |
||||||||||||||
| -verbose | Opgevraagde/verwerkte compilatie-eenheden wegschrijven naar de console of het logboekbestand (mits opgegeven). | ||||||||||||||
| -referenceInfo | Verwijzingsgegevens berekenen. Stel deze optie alleen in bij verwijzingen naar het bouwprogramma. Anders zijn de verwijzingsgegevens overbodig. | ||||||||||||||
| -progress | Voortgang afbeelden (alleen met -log). | ||||||||||||||
| -time | Snelheidsinformatie afbeelden. | ||||||||||||||
| -noExit | System.exit(n) niet aanroepen bij beëindiging van de compilatie (n=0 bij geen fouten). | ||||||||||||||
| -repeat <n> | Compilatieproces <n> keer herhalen (perf-analyse). | ||||||||||||||
| -inlineJSR | JSR-bytecode integreren (impliciet met target >= 1.5). | ||||||||||||||
| -enableJavadoc | Verwijzingen als interne javadoc-verwijzingen beschouwen. | ||||||||||||||
| -missingNullDefault | Als null-analyse op basis van annotaties ingeschakeld is (met behulp van "nullAnnot", zie boven), wordt er met deze optie een waarschuwing gegenereerd wanneer er voor een pakket of een type geen standaardannotatie aanwezig is. | ||||||||||||||
| Help-opties | |||||||||||||||
| -? -help | Het Help-bericht afbeelden. | ||||||||||||||
| -v -version | Het buildnummer van het compileerprogramma afbeelden. Gebruik deze optie vooral om fouten te rapporteren. | ||||||||||||||
| -showversion | Het buildnummer van het compileerprogramma afbeelden en doorgaan. Gebruik deze optie vooral om fouten te rapporteren. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Alle bronbestanden in d:\temp en de submappen worden gecompileerd. Het klassenpad is rt.jar. Alle foutopsporingskenmerken worden gegenereerd en alle gegenereerde CLASS-bestanden worden in d:\tmp opgeslagen. De snelheid van het compileerprogramma wordt na afloop van de batchverwerking afgebeeld. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Alleen Test.java en afhankelijke bestanden (indien aanwezig) worden gecompileerd. De afhankelijke bestanden worden uit d:\temp opgehaald. Het klassenpad is d:\temp, gevolgd door rt.jar. Alle benodigde klassen worden dus eerst opgezocht in d:\temp en vervolgens in rt.jar. Er worden geen foutopsporingskenmerken gegenereerd en alle CLASS-bestanden worden in d:\temp gedumpt. |