Den satsvise kompilatorklassen befinner seg i plugin-modulen
for JDT-kjerne. Navnet på klassen er org.eclipse.jdt.compiler.batch.BatchCompiler. Den er pakket i
plugins/org.eclipse.jdt.core_<versjon>.jar. Siden
3.2 har den også vært tilgjengelig som separat nedlasting. Navnet på filen er ecj.jar. Den tilhørende kilden er også tilgjengelig. Gå til
nedlastingssiden og søk
etter delen JDT Core Batch Compiler. Denne JAR-filen inneholder både den
satsvise kompilatoren og javac ant-adapteren.
Siden 3.3 inneholder denne jar-filen også støtte for jsr199 (kompilator-API) og støtte for jsr269 (annotasjonsbehandling). En 1.6 VM er nødvendig for å bruke støtte for annotasjonsbehandling.
Dermed kan den brukes som en frittstående applikasjon, og innenfor et Ant-bygg utenfor Eclipse.
java -jar org.eclipse.jdt.core_<versjon>.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) for klassen BatchCompiler.
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 kontrollere hvordan fremdrift rapporteres eller hvordan satskompilatoren avbrytes, ved å opprette subklasser for klassen org.eclipse.jdt.compiler.CompilationProgress.
De anbefalte alternativene har oransje bakgrunn.
Når noen alternativer defineres flere ganger, behandler den satsvise kompilatoren dem fra venstre mot høyre. Når advarselsalternativet (-warn:....) brukes uten '+' eller '-', overstyrer dette settet med advarsler som er oppgitt tidligere. Brukeren må derfor kontrollere at et slikt alternativ oppgis før all annen bruk av alternativet -warn.
Det samme gjelder for alternativet -err:.
| Navn | Bruk | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Klassebanealternativer | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | Dette er en liste over kataloger eller jar-filer som
brukes til å primærlaste klassefilene som brukes av kompilatoren. Som standard brukes bibliotekene på VM som kjøres. Oppføringer atskilles med plattformens baneskilletegn. Hver katalog eller fil kan angi tilgangsregler for typer mellom '[' og ']'. Hvis det ikke er oppgitt noen bootclasspath, vil kompilatoren utlede den ved hjelp av systemegenskapene |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
Dette er en liste over kataloger eler jar-filer som
brukes til å kompilere kildefilene. Standardverdien
er verdien til egenskapen "java.class.path". Oppføringer atskilles med plattformens baneskilletegn. Hver katalog eller fil kan angi tilgangsregler for typer mellom '[' og ']' (f.eks. [-X] for å forby tilgang til type X, [~X] for å fraråde tilgang til type X, [+p/X:-p/*] for å forby tilgang til alle typer i pakke p, men tillate tilgang til p/X). Kompilatoren følger Class-Path-leddene i jar-filenes
manifester rekursivt og legger til hver refererte jar-fil til slutt i klassebanen
hvis den ikke allerede finnes i klassebanen. |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | Dette er en liste over kataloger som brukes til å angi plasseringen av zip-/jar-filer. Oppføringer atskilles med plattformens baneskilletegn. | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | Dette er en liste over kataloger som brukes til å angi plasseringen av støttede zip/jar-filer. Oppføringer atskilles med plattformens baneskilletegn. | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | Dette er en liste over kataloger som brukes til å oppgi kildefilene. Oppføringer atskilles med plattformens baneskilletegn. Hver katalog kan angi tilgangsregler for typer mellom '[' og ']'. |
||||||||||||||
| -d <dir 1>|none | Denne brukes til å oppgi i hvilken katalog de genererte *.class-filene skal dumpes. Hvis den utelates,
opprettes ingen pakkekatalogstruktur. Hvis du ikke vil generere noen .class-filer, bruker du -d none. |
||||||||||||||
| -encoding <encoding name> | Oppgi standardkoding for alle kildefiler. Tilpasset koding kan også oppgis
for hver enkelt fil ved at hvert navn på inndatakildefil eller mappe får [<kodingsnavn>] som suffiks. X.java[utf8] oppgir for eksempel UTF-8-koding for kompileringsenheten
X.java i gjeldende brukerkatalog.
Hvis det er oppgitt flere standardkodinger for kildefiler, blir den siste brukt. Eksempel:
|
||||||||||||||
| Samsvarsalternativer | |||||||||||||||
| -target 1.1 til 1.7 eller (5, 5.0 etc) | Spesifiserer *.class-filmålets innstilling. Mulige alternativene er:
clcd1.1 kan brukes til å generere StackMap-attributtet. |
||||||||||||||
| -1.3 | Definer samsvarsnivå til 1.3. Implisitt -source 1.3 -target 1.1. | ||||||||||||||
| -1.4 | Definer samsvarsnivå til 1.4 (standard). Implisitt -source 1.3 -target 1.2. | ||||||||||||||
| -1.5 | Definer samsvarsnivå til 1.5. Implisitt -source 1.5 -target 1.5. | ||||||||||||||
| -1.6 | Definer samsvarsnivå til 1.6. Implisitt -source 1.6 -target 1.6. | ||||||||||||||
| -1.7 | Definer samsvarsnivå til 1.7. Implisitt -source 1.7 -target 1.7. | ||||||||||||||
| -source 1.1 til 1.7 eller (5, 5.0 etc) | Dette brukes for å angi kildenivået som forventes av kompilatoren. Mulige alternativene er:
|
||||||||||||||
| Advarselsalternativer | |||||||||||||||
| -?:warn -help:warn | Vis avanserte advarselsalternativer | ||||||||||||||
| -warn:... | Oppgi settet med aktiverte alternativer. f.eks. -warn:unusedLocal,deprecation
|
||||||||||||||
| Standardverdi | Tokennavn | Beskrivelse | |||||||||||||
| +/- | allDeadCode | Død kode inkludert trivial if(DEBUG)-sjekk | |||||||||||||
| +/- | allDeprecation | Forelding selv inne i foreldet kode | |||||||||||||
| - | allJavadoc | Ugyldig eller manglende Javadoc | |||||||||||||
| - | allOver-ann | Alle manglende @Override-annotasjoner (superklasse og supergrensesnitt) | |||||||||||||
| - | all-static-method | Hele metoden kan deklareres som statisk advarsler | |||||||||||||
| + | assertIdentifier | Forekomst av assert brukt som identifikator | |||||||||||||
| - | ruting | Autorutingskonvertering | |||||||||||||
| + | charConcat | Når en tegnmatrise brukes i en strengsammenkjeding uten eksplisitt konvertering til streng | |||||||||||||
| + | compareIdentical | Sammenlikner identiske uttrykk | |||||||||||||
| - | conditionAssign | Mulig uheldig boolsk tildeling | |||||||||||||
| + | constructorName | Metode med konstruktørnavn | |||||||||||||
| + | deadCode | Død kode ekskludert trivial if(DEBUG)-sjekk | |||||||||||||
| - | dep-ann | Manglende @Deprecated-annotasjon | |||||||||||||
| +/- | deprecation | Bruk av foreldet type eller medlem utenfor foreldet kode | |||||||||||||
| + | discouraged | Bruk av typer som tilsvarer en frarådet tilgangsregel | |||||||||||||
| - | emptyBlock | Udokumentert tom blokk | |||||||||||||
| + | enumIdentifier | Forekomst av enum brukt som identifikator | |||||||||||||
| + | enumSwitch | Ufullstendig enum-bryter | |||||||||||||
| - | enumSwitchPedantic | Rapport mangler enum switch cases selv når det finnes standard case | |||||||||||||
| - | fallthrough | Mulig fallthrough-tilfelle | |||||||||||||
| - | fieldHiding | Felt som skjuler en annen variabel | |||||||||||||
| + | finalBound | Typeparameter med finalBound (endelig binding) | |||||||||||||
| + | finally | finally-blokk som ikke fullføres normalt | |||||||||||||
| + | forbidden | Bruk av typer som tilsvarer en forbudt tilgangsregel | |||||||||||||
| - | hashCode | Manglende hashCode()-metode ved overstyring av equals() | |||||||||||||
| +/- | hiding | Makro for fieldHiding, localHiding, typeHiding og maskedCatchBlock | |||||||||||||
| - | includeAssertNull | Gi null-advarsler for variabler som ble 'tainted' i et assert-uttrykk | |||||||||||||
| - | indirectStatic | Indirekte referanse til statisk medlem | |||||||||||||
| + | intfAnnotation | Annotasjonstype brukt som supergrensesnitt | |||||||||||||
| + | intfNonInherited | Metodekompatibilitet ikke arvet fra grensesnitt | |||||||||||||
| - | intfRedundant | Finn overflødige supergrensesnitt | |||||||||||||
| - | javadoc | Ugyldig Javadoc | |||||||||||||
| - | localHiding | Lokal variabel skjuler en annen variabel | |||||||||||||
| + | maskedCatchBlock | Skjult catch-blokk | |||||||||||||
| - | nls | Ikke-nls-strengkonstanter (mangler koder //$NON-NLS-<n>) | |||||||||||||
| + | noEffectAssign | Tildeling uten virkning | |||||||||||||
| +/- | null | Potensielt manglende eller overflødig nullkontroll | |||||||||||||
| - | nullAnnot | Aktiver annotasjoner basert på null-analyse. Hvis det er ønskelig, kan annotasjonstypene som skal tolkes av kompilatoren, angis ved å legge til by (nullable|nonnull|nonnullbydefault), der hver annotasjonstype er oppgitt med det fullt kvalifiserte navnet. Se også -nonNullByDefault nedenfor. |
|||||||||||||
| - | nullDereference | Manglende nullkontroll | |||||||||||||
| - | over-ann | Manglende @Override-annotasjon (bare superklasse) | |||||||||||||
| - | paramAssign | Tildeling til en parameter | |||||||||||||
| + | pkgDefaultMethod | Forsøk på å overstyre package-default-metode | |||||||||||||
| + | raw | Bruk av en ubehandlet type (i stedet for type med parameter) | |||||||||||||
| +/- | ressurs | (Potentielt) usikker bruk av ressursen av typen Closeable | |||||||||||||
| - | semicolon | Unødvendig semikolon eller tom setning | |||||||||||||
| + | serial | Manglende serialVersionUID | |||||||||||||
| - | specialParamHiding | Konstruktør eller setter-parameter skjuler et annet felt | |||||||||||||
| +/- | static-access | Makro for indirectStatic og staticReceiver | |||||||||||||
| - | static-method | En instance-metode som kunne være en static-metode | |||||||||||||
| + | staticReceiver | Hvis en ikke-statisk mottaker brukes til å hente et statisk felt eller kalle opp en statisk metode | |||||||||||||
| - | super | Overstyrer en metode uten å gjøre en superaktivering | |||||||||||||
| + | suppress | Aktiver @SuppressWarnings | |||||||||||||
| - | switchDefault | switch-setning mangler default case | |||||||||||||
| - | syncOverride | Manglende synchronized i synkroniseringsmetodeoverstyring | |||||||||||||
| - | syntheticAccess | Ved utførelse av syntetisk tilgang for indre klasse | |||||||||||||
| - | tasks | Aktiver støtte for tasks-koder i kildekode | |||||||||||||
| + | typeHiding | Typeparameter skjuler annen type | |||||||||||||
| + | unavoidableGenericProblems | Ignorer uunngåelige typesikkerhetsproblemer på grunn av rå APIer | |||||||||||||
| + | unchecked | Usjekket typeoperasjon | |||||||||||||
| - | unnecessaryElse | Unødvendig else-ledd | |||||||||||||
| - | unqualifiedField | Ukvalifisert referanse til felt | |||||||||||||
| +/- | unused | Makro for unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown og unusedTypeArgs | |||||||||||||
| - | unusedAllocation | Tildeling av et objekt som ikke er brukt | |||||||||||||
| - | unusedArgument | Ubrukt metodeargument | |||||||||||||
| + | unusedImport | Ubrukt importreferanse | |||||||||||||
| + | unusedLabel | Ubrukt etikett | |||||||||||||
| + | unusedLocal | Ubrukt lokal variabel | |||||||||||||
| + | unusedPrivate | Ubrukt privat medlemsdeklarasjon | |||||||||||||
| - | unusedThrown | Ubrukt deklarert kastet unntak | |||||||||||||
| + | unusedTypeArgs | Ubrukte typeargumenter for metode og konstruktør | |||||||||||||
| - | uselessTypeCheck | Unødvendig cast/instanceof-operasjon | |||||||||||||
| + | varargsCast | varargs-argument trenger eksplisitt cast | |||||||||||||
| +/- | warningToken | Ubehandlet eller ubrukt advarselstoken i @SuppressWarnings | |||||||||||||
| -nowarn | Ingen advarsel (tilsvarer -warn:none) | ||||||||||||||
| -err:... | Oppgi settet med aktiverte alternativer som skal konverteres til feil. f.eks. -err:unusedLocal,deprecation unusedLocal- og deprecation-advarsler blir konvertert til feil. Alle andre advarsler rapporteres fortsatt som advarsler.
|
||||||||||||||
| -deprecation | Tilsvarer -warn:+deprecation. | ||||||||||||||
| -properties <fil> | Definer alternativ for advarsler/feil i egenskapsfilinnholdet. Dette alternativet kan brukes med -nowarn, -err:.. eller -warn:.. men det siste på kommandolinjen definerer alternativene som skal brukes. Innholdet i egenskapsfilen kan genereres ved at du oppgir prosjektspesifikke innstillinger for et eksisterende Java-prosjekt
og bruker 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 ... |
||||||||||||||
| Feilsøkingsalternativer | |||||||||||||||
| -g[:none|:lines,vars,source] | Definer feilsøkingsattributtnivå
|
||||||||||||||
| -preserveAllLocals | Be eksplisitt kompilatoren om å bevare alle lokale variabler (til feilsøkingsformål). Utelates denne, vil kompilatoren fjerne ubrukte lokale. | ||||||||||||||
| Alternativer for annotasjonsbehandling (krever 1.6 VM eller nyere, og brukes bare hvis samsvaret er 1.6) | |||||||||||||||
| -Akey[=value] | Alternativer for annotasjonsbehandler som blir sendt til annotasjonsbehandlere. key består av identifikatorer atskilt av punktumer |
||||||||||||||
| -proc:[only|none] | Hvis -proc:only er oppgitt, kjører annotasjonsbehandlerne, men det blir ikke utført noen kompilering. Hvis -proc:none er oppgitt, vil ikke annotasjonsbehandlerne bli oppdaget eller kjørt, kompileringen fortsetter som om det ikke er funnet noen annotasjonsbehandlere. Kompilatoren må som standard søke i klassebanen etter annotasjonsbehandlere, så å oppgi -proc:none kan øke hastigheten på kompileringen hvis annotasjonsbehandling ikke er nødvendig. |
||||||||||||||
| -processor <class1[,class2,...]> | Kvalifiserte klassenavn for annotasjonsbehandlere som skal kjøre. Hvis oppgitt, vil den normale -prosessen for prosessoroppdaging bli hoppet over. | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | En liste over kataloger eller jar-filer der det blir søkt etter annotasjonsbehandlere. Oppføringer atskilles med plattformens baneskilletegn. Hvis dette ikke er oppgitt, blir det søkt i klassebanen i stedet. | ||||||||||||||
| -s <dir> | Katalogen der det blir opprettet genererte kildefiler. | ||||||||||||||
| -XprintProcessorInfo | Utskriftsinformasjon om hvilke annotasjoner og elementer en behandler blir bedt om å behandle | ||||||||||||||
| -XprintRounds | Utskriftsinformasjon om annotasjonsbehandlingsrunder | ||||||||||||||
| -classNames <class1[,class2,...]> | Kvalifiserte navn på binære typer som må behandles | ||||||||||||||
| Ignorerte alternativer (for kompatibilitet med javac-alternativer) | |||||||||||||||
| -J<alternativ> | Overfør alternativ til den virtuelle maskinen | ||||||||||||||
| -X<alternativ> | Oppgi ikke-standard alternativ. -Xemacs blir ikke ignorert. | ||||||||||||||
| -X | Skriv ut ikke-standard alternativer og avslutt | ||||||||||||||
| -O | Optimaliser for utføringstid | ||||||||||||||
| Avanserte alternativer | |||||||||||||||
| @<file> | Les kommandolinjeargumenter fra fil | ||||||||||||||
| -maxProblems <n> | Maks antall problemer per kompileringsenhet (100 er standard) | ||||||||||||||
| -log <filnavn> | Oppgi en loggfil der alle utdata fra kompilatoren dumpes. Dette er svært nyttig hvis du vil feilsøke satskompilatoren eller hente en fil som inneholder alle feil og advarsler fra en satsvis bygging. Hvis filtypen er .xml, er den genererte loggfilen en xml-fil. | ||||||||||||||
| -Xemacs | Bruk emacs-stil for å presentere feil og advarselplasseringer i konsollen og
regulære tekstlogger. XML-logger blir ikke påvirket av dette alternativet. Hvis dette
alternativet er aktivert, vil meldingen:2. ADVARSEL i /workspace/X.javavises som: /workspace/X.java:8: warning: The method... |
||||||||||||||
| -proceedOnError[:Fatal] | Fortsett kompilering ved feil, idet klassefiler med problemmetoder eller problemtyper
dumpes. Dette anbefales bare hvis du ønsker å kunne kjøre applikasjonen selv om det er gjenværende feil. Med ":Fatal" behandles alle valgfrie feil som kritiske, og dette gir kode som blir avbrutt når en feil nås under kjøretiden. Uten ":Fatal" vil ikke valgfrie feil forhindre riktig kodegenerering, og produktets .class-filer kan kjøres uten problemer. |
||||||||||||||
| -verbose | Skriv ut brukte/behandlede kompileringsenheter i konsollen eller loggfilen om spesifisert. | ||||||||||||||
| -referenceInfo | Beregn referanseinfo. Nyttig bare om koblet til byggeren. Referanseinfo er ubrukelig ellers. | ||||||||||||||
| -progress | Vis fremdrift (bare i -log-modus). | ||||||||||||||
| -time | Vis hastighetsinformasjon. | ||||||||||||||
| -noExit | Ikke kall opp System.exit(n) ved avslutningen av kompileringen n=0 hvis det ikke er feil). | ||||||||||||||
| -repeat <n> | Gjenta kompileringsprosess <n> ganger (utfør analyse). | ||||||||||||||
| -inlineJSR | Bygg inn JSR-bytekode (implisitt hvis mål >= 1.5). | ||||||||||||||
| -enableJavadoc | Vurder referanser i javadoc | ||||||||||||||
| -missingNullDefault | Når en annotasjon som er basert på en null-analyse er aktivert (ved hjelp av nullAnnot, se ovenfor), sender dette alternativet en advarsel når det ikke finnes noen standardannotasjon i en pakke eller en type. | ||||||||||||||
| Hjelpealternativer | |||||||||||||||
| -? -help | Vis hjelpemeldingen. | ||||||||||||||
| -v -version | Vis byggenummeret til kompilatoren. Svært nyttig ved rapportering av feil. | ||||||||||||||
| -showversion | Vis byggenummeret til kompilatoren og fortsett. Svært nyttig ved rapportering av feil. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Kompilerer alle kildefiler i d:\temp og undermapper. Klassebanen er bare rt.jar. Den genererer alle feilsøkingsattributter, og alle genererte *.class-filer dumpes i d:\tmp. Kompilatorens hastighet blir vist så snart satsprosessen er fullført. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Kompilerer bare Test.java og eventuelle avhengige filer fra d:\temp. Klassebanen er d:\temp fulgt av rt.jar, hvilket betyr at alle nødvendige klasser søkes først i d:\temp og deretter i rt.jar. Den genererer ingen feilsøkingsattributter, og alle genererte .class-filer dumpes i d:\temp. |