Het batchcompileerprogramma gebruiken

Het batchcompileerprogramma zoeken

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.

Het batchcompileerprogramma uitvoeren

Overzicht van beschikbare opties

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 sun.boot.class.path, vm.boot.class.path of org.apache.harmony.boot.class.path (in deze volgorde).

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

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Alle bronbestanden worden gelezen met de UTF-8-codering (hiertoe behoort ook Z.java). X.java wordt gelezen met de Cp1252-codering en Y.java wordt gelezen met de UTF-16-codering.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Alle bronbestanden worden gelezen met de UTF-16-codering. De -encoding optie voor UTF-8 wordt genegeerd.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Alle bronbestanden worden gelezen met de Cp1252-codering. X.java is het enige bestand in de directory /foo/bar dat wordt gelezen met de codering UTF-16. Alle andere bestanden in die directory worden gelezen met UTF-8.
Compatibiliteitsopties
-target 1.1 t/m 1.7 of (5, 5.0, enz.) De doelinstelling voor de CLASS-bestanden. Geldige waarden:
  • 1.1 (hoofdversie: 45, subversie: 3)
  • 1.2 (hoofdversie: 46, subversie: 0)
  • 1.3 (hoofdversie: 47, subversie: 0)
  • 1.4 (hoofdversie: 48, subversie: 0)
  • 1.5, 5 of 5.0 (hoofdversie: 49 subversie: 0)
  • 1.6, 6 of 6.0 (hoofdversie: 50 subversie: 0)
  • 1.7, 7 of 7.0 (hoofdversie: 51 subversie: 0)
Standaardwaarden:
  • 1.1 in de werkstand -1.3
  • 1.2 in de werkstand -1.4
  • 1.5 in de werkstand -1.5
  • 1.6 in de werkstand -1.6
  • 1.7 in de werkstand -1.7

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:
  • 6.0
  • 1.4
  • 1.5, 5 of 5.0
  • 1.6, 6 of 6.0
  • 1.7, 7 of 7.0
Standaardwaarden:
  • 1.3 in de werkstand -1.3
  • 1.3 in de werkstand -1.4
  • 1.5 in de werkstand -1.5
  • 1.6 in de werkstand -1.6
  • 1.7 in de werkstand -1.7
In 1.4 wordt assert als sleutelwoord beschouwd. In 1.5 en 1.6 worden enum en assert als sleutelwoorden beschouwd.
Waarschuwingsopties
-?:warn -help:warn Geavanceerde waarschuwingsopties weergeven
-warn:... Geef hier de set van geactiveerde waarschuwingen op.
bijvoorbeeld -warn:unusedLocal,deprecation
-warn:none alle waarschuwingen uitschakelen
-warn:<waarschuwingstokens die van elkaar worden gescheiden met een ,> activeren de vermelde waarschuwingen
-warn:+<waarschuwingstokens die van elkaar worden gescheiden met een ,> activeren aanvullende waarschuwingen
-warn:-<waarschuwingstokens die van elkaar worden gescheiden met een ,> schakelen specifieke waarschuwingen uit
In de onderstaande kolom Standaardwaarde geeft "+/-" aan dat de desbetreffende optie diverse nauwkeurig afgestemde varianten van waarschuwingen dekt. Sommige daarvan zijn standaard ingeschakeld, andere uitgeschakeld. Dit betekent dat er, als u de optie opgeeft met "+", méér waarschuwingen worden gegeneerd dan standaard het geval zou zijn en dat er, als u de optie opgeeft met "-", bepaalde waarschuwingen worden uitgeschakeld die standaard ingeschakeld zijn.
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.
-err:<waarschuwingstokens die van elkaar worden gescheiden met een ,> zetten de vermelde waarschuwingen om in fouten
-err:+<waarschuwingstokens die van elkaar worden gescheiden met een ,> zetten aanvullende waarschuwingen om in fouten
-err:-<waarschuwingstokens die van elkaar worden gescheiden met een ,> zetten specifieke waarschuwingen juist niet om in fouten
-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 .settings/org.eclipse.jdt.core.prefs kunt gebruiken als eigenschappenbestand, of als een eenvoudig tekstbestand met paren van items en waarden, aan de hand van de constanten die zijn gedefinieerd in de klasse org.eclipse.jdt.core.JavaCore.

...
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.
-g Alle foutopsporingsgegevens (gelijk aan -g:lines,vars,source)
-g:none Geen foutopsporingsgegevens
-g:[lines,vars,source] Selectieve foutopsporingsgegevens
-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.java
(op regel 8)...

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

Voorbeelden

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.