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.
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
eller:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress) för klassen BatchCompiler (batchkompilator).
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instantiate your subclass org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Du kan styra hur statusen rapporteras eller hur batchkompilatorn avbryts, genom att göra klassen org.eclipse.jdt.compiler.CompilationProgress till underordnad klass.
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 |
||||||||||||||
| -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:
|
||||||||||||||
| Kompatibilitetsalternativ | |||||||||||||||
| -target 1.1 till 1.7 eller (5, 5.0 osv) | Detta ange klassfilens målinställning.
Möjliga värden är:
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:
|
||||||||||||||
| Varningsalternativ | |||||||||||||||
| -?:warn -help:warn | Visa avancerade varningsalternativ | ||||||||||||||
| -warn:... | Ange uppsättningen med aktiverade varningar, t.ex. -warn:unusedLocal,deprecation
|
||||||||||||||
| 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.
|
||||||||||||||
| -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 ... 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
|
||||||||||||||
| -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.javasom: /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. | ||||||||||||||
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. |