Bruke satsvis kompilator

Finne satsvis kompilator

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.

Kjøre satsvis kompilator

Hvilke alternativer er tilgjengelige?

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 sun.boot.class.path, vm.boot.class.path eller org.apache.harmony.boot.class.path i denne rekkefølgen.

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

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Alle kildefiler blir lest med UTF-8-koding (dette inkluderer Z.java). X.java blir lest med Cp1252-koding, og Y.java blir lest med UTF-16-koding.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Alle kildefiler blir lest med UTF-16-koding. Alternativet -encoding for UTF-8 blir ignorert.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Alle kildefiler blir lest med Cp1252-koding. X.java er den eneste filen i katalogen /foo/bar som blir lest med UTF-16-koding. Alle andre filer i den katalogen blir lest med UTF-8-koding.
Samsvarsalternativer
-target 1.1 til 1.7 eller (5, 5.0 etc) Spesifiserer *.class-filmålets innstilling. Mulige alternativene er:
  • 1.1 (hovedversjon: 45 underversjon: 3)
  • 1.2 (hovedversjon: 46 underversjon: 0)
  • 1.3 (hovedversjon: 47 underversjon: 0)
  • 1.4 (hovedversjon: 48 underversjon: 0)
  • 1.5, 5 eller 5.0 (hovedversjon: 49 underversjon: 0)
  • 1.6, 6 eller 6.0 (hovedversjon: 50 underversjon: 0)
  • 1.7, 7 eller 7.0 (hovedversjon: 51 underversjon: 0)
Standardverdier er:
  • 1.1 i -1.3-modus
  • 1.2 i -1.4-modus
  • 1.5 i -1.5-modus
  • 1.6 i -1.6-modus
  • 1.7 i -1.7-modus

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:
  • 1.3
  • 1.4
  • 1.5, 5 eller 5.0
  • 1.6, 6 eller 6.0
  • 1.7, 7 eller 7.0
Standardverdier er:
  • 1.3 i -1.3-modus
  • 1.3 i -1.4-modus
  • 1.5 i -1.5 mode
  • 1.6 i -1.6 mode
  • 1.7 i -1.7 mode
I 1.4 behandles assert som et nøkkelord. I 1.5 og 1.6 behandles enum og assert som nøkkelord.
Advarselsalternativer
-?:warn -help:warn Vis avanserte advarselsalternativer
-warn:... Oppgi settet med aktiverte alternativer.
f.eks. -warn:unusedLocal,deprecation
-warn:none deaktiver alle advarsler
-warn:<advarselstokener skilt med ,> aktiver nøyaktig de opplistede advarslene
-warn:+<advarselstokener skilt med ,> aktiver tilleggsadvarsler
-warn:-<advarselstokener skilt med ,> deaktiver bestemte advarsler
I kolonnen Standardverdi nedenfor, betyr et merke (+/-) at et alternativ dekker flere finkornede advarselsvarianter der noen aktiveres som standard og andre deaktiveres. Det betyr at å oppgi det gitte alternativer med +, aktiverer flere advarsler enn standard, og å oppgi - deaktiverer noen som ikke aktiveres som standard.
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.
-err:<advarselstokener skilt med ,> konverter nøyaktig de opplistede advarslene til feil
-err:+<advarselstokener skilt med ,> konverter tilleggsadvarsler til feil
-err:-<advarselstokener skilt med ,> opphev at bestemte advarsler skal konverteres til feil
-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 .settings/org.eclipse.jdt.core.prefs som egenskapsfil, eller bruker en enkel tekstfil som definerer par av oppføring/verdi ved hjelp av konstanter som er definert 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
...
Feilsøkingsalternativer
-g[:none|:lines,vars,source] Definer feilsøkingsattributtnivå
-g All feilsøkingsinfo (tilsvarer -g:lines,vars,source)
-g:none Ingen feilsøkingsinfo
-g:[lines,vars,source] Selektiv feilsøkingsinfo
-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.java
(på linje 8)...

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

Eksempler

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.