Använda batchkompilatorn

Leta upp batchkompilatorn

Batchkompilatorklassen finns i JDT Core-insticksprogrammet. Namnet på klassen är org.eclipse.jdt.compiler.batch.BatchCompiler. Den är paketerad i plugins/org.eclipse.jdt.core_<version>.jar. Detta därför att 3.2, också är tillgängligt som separat inläsning. Filen heter ecj.jar. Dess motsvarande källa är också tillgänglig. Du får tag i dem genom att gå till hämtningssidan och söker efter avsnittet JDT Core Batch Compiler. Denna jar innehåller batch-kompilatorn och javac-ant-adaptern.

Från och med 3.3 innehåller denna jar även funktioner för jsr199 (kompilerings-API) och jsr269 (kommentarsbearbetning). Om du ska kunna använda funktionen för kommentarsbearbetning krävs 1.6 VM.

Därför kan den användas som fristående tillämpning och inuti ett ant-bygge utanför Eclipse.

Köra batchkompilatorn

Vilka alternativ är tillgängliga?

De rekommenderade alternativen visas med orange bakgrund.

Om vissa alternativ anges flera gånger använder batchkompilatorn dem från vänster till höger. Om varningsalternativet (-warn:....) används utan '+' eller '-', åsidosätts de varningar som tidigare angetts. Användaren bör alltså se till att ett sådant alternativ ges före all annan användning av alternativet -warn.

Samma sak gäller för alternativet -err:.

Namn Användning
Classpath-alternativ
-bootclasspath <dir 1>;<dir 2>;...;<dir P> Det här är en lista över kataloger eller jar-filer som används för bootstrap-inläsning av de klassfiler som används av kompilatorn. Som standard används biblioteken i den VM som är igång. Poster avgränsas med plattformssökvägens avgränsare.
Varje katalog eller fil kan ange åtkomstregler för typer mellan "'[' och ']".

Om ingen bootclasspath anges använder kompilatorn systemegenskaperna sun.boot.class.path, vm.boot.class.path eller org.apache.harmony.boot.class.path i den ordningen.

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
Det här är en lista över kataloger eller jar-filer som används till att kompilera källfilerna. Standardvärdet är värdet för egenskapen "java.class.path". Poster avgränsas med plattformssökvägens avgränsare.
Varje katalog eller fil kan ange åtkomstregler för typer mellan "'[' och ']" (t.ex. [-X] för att förbjuda åtkomst till typ X, [~X] inte uppmuntra åtkomst till typ X, [+p/X:-p/*] förbjuda åtkomst till alla typer i paket p men tillåta åtkomst till p/X).
Kompilatorn följer Class-Path-satsdelarna för JAR-filernas manifest rekursivt och lägger till varje refererad JAR-fil till slutet av klassökvägen, förutsatt att den ännu inte finns i klassökvägen.
-extdirs <dir 1>;<dir 2>;...;<dir P> Det här är en lista över kataloger som används till att ange platsen för tilläggets zip-/jar-filer. Poster avgränsas med plattformssökvägens avgränsare.
-endorseddirs <dir 1>;<dir 2>;...;<dir P> Det här är en lista över kataloger som används till att ange platsen för godkända zip-/jar-filer. Poster avgränsas med plattformssökvägens avgränsare.
-sourcepath <dir 1>;<dir 2>;...;<dir P> Det här är en lista över kataloger som används till att ange källfilerna. Poster avgränsas med plattformssökvägens avgränsare.
Varje katalog kan ange åtkomstregler för typer mellan "'[' och ']".
-d <dir 1>|none Detta används till att ange i vilken katalog de genererade klassfilerna ska dumpas. Om värdet utelämnas, skapas ingen paketkatalogstruktur.
Om du inte vill generera någon klassfil alls, använder du -d none.
-encoding <kodningsnamn> Ange standardkodning för alla källfiler. Anpassad kodning kan också anges fil för fil genom att ange [<encoding name>] som suffix för varje indatakällfil/-mapp. Exempel: X.java[utf8] anger UTF-8-kodning för kompileringsenheten X.java som finns i den aktuella användarkatalogen.

Om flera standardkällfilskodningar anges kommer den sista att användas.

Exempel:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Alla källfiler kommer att läsas med UTF-8-kodning (detta inkluderar Z.java). X.java kommer att läsas med Cp1252-kodning och Y.java med UTF-16-kodning.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Alla källfiler kommer att läsas med UTF-16-kodning. Alternativet -encoding för UTF-8 ignoreras.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Alla källfiler kommer att läsas med Cp1252-kodning. X.java är den enda filen i katalogen /foo/bar som kommer att läsas med UTF-16. För alla andra filer i katalogen används UTF-8.
Kompatibilitetsalternativ
-target 1.1 till 1.7 eller (5, 5.0 osv) Detta ange klassfilens målinställning. Möjliga värden är:
  • 1.1 (stor version: 45 liten: 3)
  • 1.2 (stor version: 46 liten: 0)
  • 1.3 (stor version: 47 liten: 0)
  • 1.4 (stor version: 48 liten: 0)
  • 1.5, 5 eller 5.0 (stor version: 49 liten: 0)
  • 1.6, 6 eller 6.0 (stor version: 50 liten: 0)
  • 1.7, 7 eller 7.0 (stor version: 51 liten: 0)
Standardvärden är:
  • 1.1 i läge -1.3
  • 1.2 i läge -1.4
  • 1.5 i läge -1.5
  • 1.6 i läge -1.6
  • 1.7 i läge -1.7

clcd1.1 kan användas för att generera attributet StackMap.

-1.3 Ange kompatibilitetsnivå till 1.3. Implicit -source 1.3 -target 1.1.
-1.4 Ange kompatibilitetsnivå till 1.4 (standard). Implicit -source 1.3 -target 1.2.
-1.5 Ange kompatibilitetsnivå till 1.5. Implicit -source 1.5 -target 1.5.
-1.6 Ange kompatibilitetsnivå till 1.6. Implicit -source 1.6 -target 1.6.
-1.7 Ange kompatibilitetsnivå till 1.7. Implicit -source 1.7 -target 1.7.
-source 1.1 till 1.7 eller (5, 5.0 osv) Den används till att specificera den källnivå som kompilatorn förväntar sig.
Möjliga värden är:
  • 1.3
  • 1.4
  • 1.5, 5 eller 5.0
  • 1.6, 6 eller 6.0
  • 1.7, 7 eller 7.0
Standardvärden är:
  • 1.3 i läge -1.3
  • 1.3 i läge -1.4
  • 1.5 i läge -1.5
  • 1.6 i läge -1.6
  • 1.7 i läge -1.7
I 1.4, behandlas assert som ett nyckelord. I 1.5 och 1.6 behandlas enum som assert nyckelord.
Varningsalternativ
-?:warn -help:warn Visa avancerade varningsalternativ
-warn:... Ange uppsättningen med aktiverade varningar,
t.ex. -warn:unusedLocal,deprecation
-warn:none avaktiverar alla varningar
-warn:<varningar avgränsade med ,> aktiverar exakt de angivna varningarna
-warn:+<varningar avgränsade med ,> aktiverar ytterligare varningar
-warn:-<varningar avgränsade med ,> avaktiverar specifika varningar
I kolumnen Standard nedan anger markeringen "+/-" att ett alternativ omfattar flera finjusterade varningsvarianter, där vissa är aktiva som standard medan andra är inaktiva. Det innebär att om man anger ett visst alternativ med "+" kommer man att aktivera fler varningar än standard, medan "-" avaktiverar vissa som är aktiva som standard.
Standard Tokennamn Beskrivning
+/- allDeadCode död kod inklusive trivial if(DEBUG)-kontroll
+/- allDeprecation avskrivning även inuti avskriven kod
- allJavadoc ogiltig eller saknad Javadoc
- allOver-ann alla saknade @Override-kommentarer (superklass och supergränssnitt)
- all-static-method hela metoden kan deklareras som statiska varningar
+ assertIdentifier förekomst av assert används som identifierare
- boxing autoboxing-omvandling
+ charConcat när en char-matris används i en strängsammanfogning utan att konverteras explicit till en sträng
+ compareIdentical jämförelse av identiska uttryck
- conditionAssign möjlig oavsiktlig boolesk tilldelning
+ constructorName metod med konstruktornamn
+ deadCode död kod exklusive trivial if(DEBUG)-kontroll
- dep-ann saknad @Deprecated-kommentar
+/- deprecation användning av avskriven typ eller medlem utanför avskriven kod
+ discouraged används om typer överensstämmer med en avrådd åtkomstregel
- emptyBlock odokumenterat tomt block
+ enumIdentifier förekomst av enum används som identifierare
+ enumSwitch ofullständig enumerationsväxel
- enumSwitchPedantic rapport om saknade enum-växelskiftlägen även då det finns ett standardskiftläge
- fallthrough möjligt skiftläge som fångas upp
- fieldHiding fält som döljer en annan variabel
+ finalBound typparameter med slutlig bindning
+ finally slutligt block som inte slutförts normalt
+ forbidden används om typer överensstämmer med en förbjuden åtkomstregel
- hashCode saknad hashCode()-metod vid åsidosättning av equals()
+/- hiding makro för fieldHiding, localHiding, typeHiding och maskedCatchBlock
- includeAssertNull skicka null-varningar för variabler som fördärvats i ett assert-uttryck
- indirectStatic indirekt hänvisning till statisk medlem
+ intfAnnotation kommentarstyp som används som supergränssnitt
+ intfNonInherited gränssnitt för kompatibilitet med icke ärvd metod
- intfRedundant söka efter överflödiga supergränssnitt
- javadoc ogiltigt Javadoc
- localHiding lokal variabel som döljer en annan variabel
+ maskedCatchBlock dolt catch-block
- nls strängkonstant utan andra märkord än nls (märkord saknas //$NON-NLS-<n>)
+ noEffectAssign tilldelning utan effekt
+/- null möjlig saknad eller redundant null-kontroll
- nullAnnot aktivering av annoteringsbaserad null-analys.
Om så önskas kan de annoteringstyper som ska tolkas av kompilatorn anges genom att du lägger till (nullable|nonnull|nonnullbydefault), där varje annoteringstyp specificeras med det fullt kvalificerade namnet.
Se också -nonNullByDefault nedan.
- nullDereference saknad null-kontroll
- over-ann saknad @Override-kommentar (endast superklass)
- paramAssign tilldelning till en parameter
+ pkgDefaultMethod försök att åsidosätta paketstandardmetod
+ raw användning av rå typ (i stället för en parametriserad typ)
+/- resource (potentiellt) osäker användning av resurs av typen Closeable
- semicolon onödigt semikolon eller tom sats
+ serial saknat serialVersionUID
- specialParamHiding konstruktor eller setter-parameter som döljer annat fält
+/- static-access makro för indirectStatic och staticReceiver
- static-method en förekomstmetod som kunde vara en statisk metod
+ staticReceiver om en icke statisk mottagare används till att hämta ett statiskt fält eller anropa en statisk metod
- super åsidosätta en metod utan super-anrop
+ suppress aktivera @SuppressWarnings
- switchDefault växelsats som saknar ett standardskiftläge
- syncOverride saknad synkronisering i åsidosättning av metoden synchronized
- syntheticAccess vid utförande av syntetisk åtkomst för innerclass
- tasks aktivera funktioner för aktivitetsmärkord i källkod
+ typeHiding typ-parameter som döljer en annan typ
+ unavoidableGenericProblems ignorera oundvikliga typsäkerhetsproblem p.g.a. RAW-APIer
+ unchecked ej kontrollerad typåtgärd
- unnecessaryElse onödig else-sats
- unqualifiedField okvalificerad hänvisning till fält
+/- unused makro för unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown och unusedTypeArgs
- unusedAllocation allokerar ett objekt som inte används
- unusedArgument oanvänt metodargument
+ unusedImport oanvänd importhänvisning
+ unusedLabel oanvänd etikett
+ unusedLocal oanvänd lokal variabel
+ unusedPrivate oanvänd privat medlemsdeklaration
- unusedThrown oanvänd deklarerat utgivet undantag
+ unusedTypeArgs oanvända typargument för metoden och konstruktorn
- uselessTypeCheck onödig omvandling/förekomst av åtgärd
+ varargsCast varargs-argument behöver explicit omvandling
+/- warningToken ej hanterat eller oanvänt varningstoken i @SuppressWarnings
-nowarn Ingen varning (motsvarar -warn:none)
-err:... Ange uppsättningen med aktiverade varningar som ska konverteras till fel.
Exempel: -err:unusedLocal,deprecation
unusedLocal och avvecklade varningar konverteras till fel. Alla andra varningar rapporteras fortfarande som varningar.
-err:<varningar avgränsade med ,> konverterar enbart de angivna varningarna till fel
-err:+<varningar avgränsade med ,> konverterar ytterligare varningar till fel
-err:-<varningar avgränsade med ,> undantar specifika varningar från konverteringen till fel
-deprecation Motsvarar -warn:+deprecation.
-properties <fil> Ange alternativ för varningar/fel baserat på egenskapsfilens innehåll. Alternativet kan användas med alternativen -nowarn, -err:.. eller -warn:.. men det sista på kommandoraden bestämmer vilka alternativ som ska användas.

Du kan generera egenskapsfilens innehåll genom att göra projektspecifika inställningar i ett befintligt Java-projekt och använda filen i .settings/org.eclipse.jdt.core.prefs som egenskapsfil, eller genom att skapa en enkel textfil med inställnings-/värdepar som använder de konstanter som är definierade i klassen 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
...
Felsökningsalternativ
-g[:none|:lines,vars,source] Ange nivån för felsökningsattribut
-g All felsökningsinformation (motsvarar -g:lines,vars,source)
-g:none Ingen felsökningsinformation
-g:[lines,vars,source] Selektiv felsökningsinformation
-preserveAllLocals Explicit begäran till kompilatorn att behålla alla lokala variabler (i felsökningssyfte). Om värdet utelämnas tar kompilatorn bort oanvända lokaler.
Alternativ för kommentarsbearbetning (kräver VM 1.6 eller senare och används endast om kompatibilitetsnivån är 1.6)
-Akey[=value] Kommentarsbearbetningsalternativ som skickas till kommentarsprocessorer. key utgörs av identifierare avgränsade med punkter
-proc:[only|none] Om -proc:only anges körs kommentarsprocessorerna utan kompilering. Om -proc:only anges upptäcks eller körs inte kommentarsprocessorerna och kompileringen fortsätter som om ingen kommentarsprocessor hittades. Kompilatorn måste söka efter classpath för kommentarsprocessorerna så om du anger -proc:only kan kompileringen gå snabbare om ingen kommentarsbearbetning krävs.
-processor <klass1[,klass2,...]> Fullständiga klassnamn för kommentarsprocessorer som ska köras. Om de anges hoppas den vanliga processorupptäcktsfunktionen över.
-processorpath <dir 1>;<dir 2>;...;<dir P> En lista över kataloger eller JAR-filer som genomsöks efter kommentarsprocessorer. Poster avgränsas med plattformssökvägens avgränsare. Om du inte anger något genomsöks classpath i stället.
-s <dir> Den katalog där källfiler skapas.
-XprintProcessorInfo Utskriftsinformation om vilka kommentarer och vilka element en processor bearbetar
-XprintRounds Utskriftsinformation om kommentarsbearbetningsomgångar
-classNames <klass1[,klass2,...]> Fullständiga namn på binära typer som kräver bearbetning
Åsidosatta alternativ (för kompatibilitet med javac-alternativ)
-J<alternativ> Överför alternativ till den virtuella maskinen
-X<alternativ> Ange icke-standardalternativ -Xemacs åsidosätts inte.
-X Skriver alternativ som inte är standard och avslutar
-O Optimerar för körningstid
Avancerade alternativ
@<fil> Läs kommandoradsargument från fil
-maxProblems <n> Max. antal problem per kompileringsenhet (100 som standard)
-log <filnamn> Ange en loggfil där all utdata från kompilatorn dumpas. Detta är verkligen användbart om du vill felsöka batchkompilatorn eller få en fil som innehåller alla fel och varningar från ett batchbygge. Om tillägget är .xml, blir den genererade loggen en xml-fil.
-Xemacs Använd emacs-stil för att presentera fel och varningsplatser i konsolen och vanliga textloggar. XML-loggar påverkas inte av alternativet. När alternativet är aktivt visas meddelandet:
2. WARNING in /workspace/X.java
(at line 8)...

som:
/workspace/X.java:8: warning: The method...
-proceedOnError[:Fatal] Fortsätt kompilera trots fel, dumpa klassfiler med problemmetoder eller problemtyper. Detta rekommenderas bara om du vill kunna köra tillämpningen även om det finns återstående fel.
Med ":Fatal" behandlas alla valfria fel som allvarliga. Detta leder till att koden avbryts om ett fel påträffas under körningen. Utan alternativet ":Fatal" förhindrar inte valfria fel att koden genereras och de producerade klassfilerna kan köras utan problem.
-verbose Skriv ut använda/bearbetade kompileringsenheter i konsolen eller loggfilen om den angetts.
-referenceInfo Beräkna referensinformation. Detta är bara användbart om du är ansluten till byggaren. Hänvisningsinformationen är i annat fall oanvändbar.
-progress Visa förlopp (endast i -log-läge).
-time Visa hastighetsinformation
-noExit Anropa inte System.exit(n) i slutet av kompileringen (n=0 om inget fel).
-repeat <n> Upprepa kompileringsprocessen <n> gånger (prestandaanalys).
-inlineJSR Inbäddad JSR-bytekod (implicit om target >= 1.5).
-enableJavadoc Behandla hänvisningar inuti Javadoc.
-missingNullDefault När annoteringsbaserad nullanalys har aktiverats (med "nullAnnot" ovan) kommer alternativet att ge en varning när det saknas standardannotering på ett paket eller en typ.
Hjälpande alternativ
-? -help Visa hjälpmeddelandet.
-v -version Visa kompilatorns byggnummer. Detta är väldigt användbart för rapportering av ett programfel.
-showversion Visa kompilatorns byggnummer och fortsätt. Detta är väldigt användbart för rapportering av ett programfel.

Exempel

d:\temp -classpath rt.jar -time -g -d d:/tmp Den kompilerar alla källfiler i d:\temp och dess undermappar. Classpath är rt.jar. Den genererar alla felsökningsattribut och alla genererade klassfiler dumpas i d:\tmp. Kompilatorns hastighet visas när batchprocessen har slutförts.
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none Den kompilerar bara Test.java och dess beroende filer, om sådana finns, och hämtar beroende filer från d:\temp. Classpath är d:\temp följt av rt.jar, vilket betyder att alla nödvändiga klasser söks efter först i d:\temp och sedan i rt.jar. Den genererar inga felsökningsattribut och alla genererade klassfiler dumpas i d:\temp.