Brug batchcompileren

Søg efter batchcompileren

Batchcompilerklassen er placeret i JDT-kerneplugin. Navnet på klassen er org.eclipse.jdt.compiler.batch.BatchCompiler. Den er pakket ind i plugins/org.eclipse.jdt.core_<version>.jar. Siden 3.2 kan den også fås som en separat overførsel. Filens navn er ecj.jar. Dens tilhørende kilde er også tilgængelig. Du kan hente filerne ved at gå til overførselssiden og søge efter afsnittet JDT Core Batch Compiler. Denne JAR-fil indeholder batchcompileren og Javac Ant-adapteren.

Efter 3.3 indeholder denne JAR-fil også understøttelse til jsr199 (compiler-API) og understøttelse til jsr269 (annotationsbehandling). Der kræves 1.6 VM før understøttelse af annotationsbehandling kan anvendes.

Den kan således både bruges som et enkeltstående program og i et Ant-byg uden for Eclipse.

Udfør batchcompileren

Tilgængelige indstillinger

De anbefalede indstillinger har orange baggrund.

Når nogle indstillinger angives flere gange, forbruger batchcompileren dem fra venstre til højre. Når advarselsindstillingen (-warn:....) bruges uden '+' eller '-', tilsidesættes det tidligere angivne advarselssæt. Så brugeren skal sikre, at en sådan indstilling angives, før indstillingen -warn bruges til andet.

Det samme gælder for indstillingen -err:.

Navn Brug
Tilpasning af Classpath
-bootclasspath <dir 1>;<dir 2>;...;<dir P> Dette er en liste over biblioteker eller JAR-filer, som bruges til Bootstrap-funktionen for de klassefiler, der benyttes af compileren. Som standard anvendes bibliotekerne på den igangværende VM. Indgange adskilles af platformens stiseparator.
Hvert bibliotek eller fil kan angive adgangsregler for typer mellem '[' og ']'.

Hvis der ikke er angivet nogen bootclasspath, udledes den af compiler vha. følgende systemegenskaber: sun.boot.class.path, vm.boot.class.path eller org.apache.harmony.boot.class.path i nævnte rækkefølge.

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
Dette er en liste over biblioteker eller JAR-filer, der bruges til at kompilere kildefilerne. Standardværdien er værdien af egenskaben "java.class.path". Indgange adskilles af platformens stiseparator.
Hvert bibliotek eller fil kan angive adgangsregler for typer mellem '[' og ']' (f.eks. [-X] for at forbyde adgang til type X, [~X] for at fraråde adgang til type X, [+p/X:-p/*] for at forbyde adgang til alle typer i pakken, men tillade adgang til p/X).
Compileren følger Class-Path-udtrykkene rekursivt i JAR-filmanifesterne og tilføjer hver JAR-fil, der refereres til, i slutningen af classpath, forudsat at den ikke findes i classpath i forvejen.
-extdirs <dir 1>;<dir 2>;...;<dir P> Dette er en liste over biblioteker, der bruges til at angive placeringen af filer med filtypen .zip eller .JAR. Indgange adskilles af platformens stiseparator.
-endorseddirs <dir 1>;<dir 2>;...;<dir P> Dette er en liste over biblioteker, der bruges til at angive placeringen af godkendte ZIP/JAR-filer. Indgange adskilles af platformens stiseparator.
-sourcepath <dir 1>;<dir 2>;...;<dir P> Dette er en liste over biblioteker, der bruges til at angive kildefilerne. Indgange adskilles af platformens stiseparator.
Hvert bibliotek kan angive adgangsregler for typer mellem '[' og ']'.
-d <dir 1>|none Med dette angives, i hvilket bibliotek de genererede klassefiler skal dumpes. Hvis det udelades, oprettes der ikke nogen biblioteksstruktur.
Brug -d none, hvis du slet ikke vil generere nogen .class-fil.
-encoding <kodningsnavn> Angiv standardkodning for alle kildefiler. En tilpasset kodning kan også angives ved for hver enkelt fil at tilføje dette suffiks til navnet på hver inputkildefil/folder: [<kodningsnavn>]. Eksempelvis angiver X.java[utf8] UTF-8-kodning for kompileringsenheden X.java, der er placeret i det aktuelle brugerbibliotek.

Hvis der angives flere standardkodninger for kildefiler, bliver den sidste brugt.

Eksempel:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Alle kildefiler læses vha. UTF-8-kodning (herunder Z.java). X.java læses vha. Cp1252-kodning, og Y.java læses vha. UTF-16-kodning.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Alle kildefiler læses vha. UTF-16-kodning. Indstillingen -encoding for UTF-8 ignoreres.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Alle kildefiler læses vha. Cp1252-kodning. X.java er den eneste fil i biblioteket /foo/bar, som skal læses vha. kodningen UTF-16. Alle andre filer i biblioteket bruger UTF-8-kodning.
Tilpasning af kompatibilitet
-target 1.1 til 1.7 eller (5, 5.0 osv.) Med dette angives målindstillingen for .class-file. De mulige værdier er:
  • 1.1 (større version: 45 mindre: 3)
  • 1.2 (større version: 46 mindre: 0)
  • 1.3 (større version: 47 mindre: 0)
  • 1.4 (større version: 48 mindre: 0)
  • 1.5, 5 eller 5.0 (større version: 49 mindre: 0)
  • 1.6, 6 eller 6.0 (større version: 50 mindre: 0)
  • 1.7, 7 eller 7.0 (større version: 51 mindre: 0)
Standardværdier er:
  • 1.1 i -1.3-tilstand
  • 1.2 i -1.4-tilstand
  • 1.5 i -1.5-tilstand
  • 1.6 i -1.6-tilstand
  • 1.7 i -1.7-tilstand

clcd1.1 kan bruges til at generere StackMap-attributten.

-1.3 Angiv overholdelsesniveau til 1.3. Implicit -source 1.3 -target 1.1.
-1.4 Angiv overholdelsesniveau til 1.4 (standard). Implicit -source 1.3 -target 1.2.
-1.5 Angiv overholdelsesniveau til 1.5. Implicit -source 1.5 -target 1.5.
-1.6 Angiv overholdelsesniveau til 1.6. Implicit -source 1.6 -target 1.6.
-1.7 Angiv overholdelsesniveau til 1.7. Implicit -source 1.7 -target 1.7.
-source 1.1 til 1.7 eller (5, 5.0 osv.) Bruges til at angive det kildeniveau, som forventes af compileren.
De mulige værdier er:
  • 1.3
  • 1.4
  • 1.5, 5 eller 5.0
  • 1.6, 6 eller 6.0
  • 1.7, 7 eller 7.0
Standardværdier er:
  • 1.3 i -1.3-tilstand
  • 1.3 i -1.4-tilstand
  • 1.5 i -1.5-tilstand
  • 1.6 i -1.6-tilstand
  • 1.7 i -1.7-tilstand
I 1.4 behandles assert som et nøgleord. I 1.5 og 1.6 behandles enum og assert som nøgleord.
Tilpasning af advarsler
-?:warn -help:warn Vis udvidede advarselsindstillinger
-warn:... Angiv sættet af aktiverede advarsler.
Eksempel: -warn:unusedLocal,deprecation
-warn:none deaktivér alle advarsler
-warn:<advarselstokens adskilt af ,> aktivér præcist de angivne advarsler
-warn:+<advarselstokens adskilt af ,> aktivér yderligere advarsler
-warn:-<advarselstokens adskilt af ,> deaktivér specifikke advarsler
I kolonnen Standard herunder angiver "+/-", at en indstilling dækker over flere finkornede advarselsvarianter, hvoraf nogle er aktiveret som standard, og andre er deaktiveret. Det betyder, at hvis en given indstilling angives med "+", aktiveres flere advarsler end standardadvarslerne, og angivelse af "-" deaktiverer nogle, der er aktiveret som standard.
Standard Tokennavn Beskrivelse
+/- allDeadCode død kode, herunder trivial if(DEBUG)-kontrol
+/- allDeprecation afvisning endog inde i forældet kode
- allJavadoc ugyldig eller manglende javadoc
- allOver-ann alle manglende @Override-annotationer (superklasse og supergrænseflader)
- all-static-method alle metoder kan erklæres som statiske advarsler
+ assertIdentifier forekomst af assert anvendt som id
- boxing autoboxing-konvertering
+ charConcat når et char-array bruges i en sammenkædning af strenge uden at blive konverteret eksplicit til en streng
+ compareIdentical sammenligner identiske udtryk
- conditionAssign mulig tilfældig Boolesk tildeling
+ constructorName metode med konstruktørnavn
+ deadCode død kode uden trivial if(DEBUG)-kontrol
- dep-ann annotationen @Deprecated mangler
+/- deprecation brug af forældet type eller medlem uden for forældet kode
+ discouraged brug af typer, der matcher en frarådet adgangsregel
- emptyBlock ikke-dokumenteret tom blok
+ enumIdentifier forekomst af enum anvendt som id
+ enumSwitch ufuldstændig enum-parameter
- enumSwitchPedantic rapportér manglende switch-cases med enums, selvom default-case findes
- fallthrough mulig udbrydnings-case
- fieldHiding felt skjuler en anden variabel
+ finalBound parameter med binding af afsluttende type
+ finally afsluttende blok afslutter ikke normalt
+ forbidden brug af typer, der matcher en forbudt adgangsregel
- hashCode manglende hashCode()-metode ved tilsidesættelse af equals()
+/- hiding makro til fieldHiding, localHiding, typeHiding og maskedCatchBlock
- includeAssertNull vis null-advarsler for variabler, der er blevet ødelagt i et assert-udtryk
- indirectStatic indirekte reference til statisk medlem
+ intfAnnotation annotationstype brugt som supergrænseflade
+ intfNonInherited grænseflade med ikke-overtaget metodekompatibilitet
- intfRedundant find overflødige supergrænseflader
- javadoc ugyldigt Javadoc
- localHiding lokal variabel, der skjuler en anden variabel
+ maskedCatchBlock skjult catch-blok
- nls ikke-nls strengkonstanter (mangel på koder //$NON-NLS-<n>)
+ noEffectAssign tildeling uden virkning
+/- null eventuelt manglende eller overflødig NULL-kontrol
- nullAnnot aktivér annotationsbaseret NULL-analyse.
Hvis det ønskes, kan de annotationstyper, der skal fortolkes af compileren, angives ved at tilføje (nullable|nonnull|nonnullbydefault), hvor hver annotationstype angives med dens fuldstændige navn.
Se også -nonNullByDefault nedenfor.
- nullDereference manglende NULL-kontrol
- over-ann manglende @Override-annotation (kun superklasse)
- paramAssign tildeling til en parameter
+ pkgDefaultMethod forsøg på at overskrive pakke-standardmetoden
+ raw brug af en ubehandlet type (i stedet for en type med parametre)
+/- ressource (mulig) usikker brug af ressource med typen Closeable
- semicolon unødvendigt semikolon eller tom sætning
+ serial manglede serialVersionUID
- specialParamHiding konstruktør- eller setter-parameter skjuler andet felt
+/- static-access makro til indirectStatic og staticReceiver
- static-method en forekomstmetode, der kunne være som en statisk metode
+ staticReceiver hvis en ikke-statisk modtager bruges til at hente et statisk felt eller kalde en statisk metode
- super tilsidesætter en metode uden foretage et superkald
+ suppress aktiverer @SuppressWarnings
- switchDefault switch-sætning mangler en default-case
- syncOverride manglende synkroniseret i synkroniseret metodetilsidesættelse
- syntheticAccess ved udførelse af syntetisk adgang for innerclass
- tasks aktiverer understøttelse til opgavekoder i kildekode
+ typeHiding parametertype, der skjuler en anden type
+ unavoidableGenericProblems ignorér sikkerhedsproblemer, der er uundgåelige på grund af ubehandlede API'er
+ unchecked ikke-kontrolleret funktion
- unnecessaryElse unødvendigt else-udtryk
- unqualifiedField ikke-kvalificeret reference til felt
+/- unused makro til unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown og unusedTypeArgs
- unusedAllocation allokerer et objekt, der ikke bruges
- unusedArgument ubrugt metodeargument
+ unusedImport ubrugt importreference
+ unusedLabel ubrugt etiket
+ unusedLocal ubrugt lokal variabel
+ unusedPrivate ubrugt privat medlemserklæring
- unusedThrown ubrugt, erklæret returneret undtagelse
+ unusedTypeArgs ubrugte typeargumenter for metode og konstruktør
- uselessTypeCheck unødvendig cast/instanceof-funktion
+ varargsCast varargs-argument kræver eksplicit cast
+/- warningToken ikke-håndteret eller ikke-anvendt advarsels-token i @SuppressWarnings
-nowarn Ingen advarsel (svarer til -warn:none)
-err:... Angiv sættet af aktiverede advarsler, der konverteres til fejl.
f.eks. -err:unusedLocal,deprecation
unusedLocal og advarsler om forældelse konverteres til fejl. Alle andre advarsler rapporteres som advarsler.
-err:<advarselstokens adskilt af ,> konvertér præcist de viste advarsler til fejl
-err:+<advarselstokens adskilt af ,> konvertér yderligere advarsler til fejl
-err:-<advarselstokens adskilt af ,> fjern specifikke advarsler, så de ikke konverteres til fejl
-deprecation Svarer til -warn:+deprecation.
-egenskabs-<fil> Angiv parameter for advarsler/fejl baseret på indholdet i egenskabsfilen. Denne parameter kan bruges med parametrene -nowarn, -err:.. eller -warn:.. , men den sidste parameter på kommandolinjen bestemmer de parametre, der skal bruges.

Indholdet i egenskabsfilen kan genereres ved at definere projektspecifikke indstillinger i et eksisterende java-projekt og bruge filen i .settings/org.eclipse.jdt.core.prefs-filen som en egenskabsfil eller en simpel tekstfil, der er definerede indgangs/værdipar, der anvender de konstanter, der er defineret i org.eclipse.jdt.core.JavaCore-klassen.

...
org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning
org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
...
Tilpasning af fejlfinding
-g[:none|:lines,vars,source] Angiv niveauet for fejlfindingsattributter.
-g Alle fejlfindingsoplysninger (svarer til -g:lines,vars,source).
-g:none Ingen fejlfindingsoplysninger.
-g:[lines,vars,source] Udvalgte fejlfindingsoplysninger.
-preserveAllLocals Anmod eksplicit compileren om at bevare alle lokale variabler (med henblik på fejlfinding). Hvis den udelades, fjerner compileren ubrugte lokale variabler.
Indstillinger for annotationsbehandling (kræver 1.6 VM eller derover og bruges kun, hvis der er 1.6-kompatibilitet)
-Akey[=value] Indstillinger for annotationsprocessorer, som sendes til annotationsprocessorer. key består af id'er, der adskilles af punktummer
-proc:[only|none] Hvis -proc:only er angivet, udføres annotationsprocessorerne, men der udføres ikke nogen kompilering. Hvis -proc:none angives, registreres eller udføres der ikke nogen annotationsprocessorer. Kompileringen fortsætter, som om der ikke blev fundet nogen annotationsprocessorer. Som standard skal compileren søge i classpath efter annotationsprocessorer. Derfor kan angivelsen af -proc:none øge kompileringshastigheden, hvis annotationsbehandling ikke er påkrævet.
-processor <class1[,class2,...]> Fuldstændigt klassenavn på de annotationsprocessorer, der skal udføres. Hvis det angives, bliver den almindelige processoropsporingsproces sprunget over.
-processorpath <dir 1>;<dir 2>;...;<dir P> En liste over biblioteker eller JAR-filer, der bliver søgt i efter annotationsprocessorer. Indgange adskilles af platformens stiseparator. Hvis listen ikke angives, søges i stedet for i classpath.
-s <dir> Det bibliotek, hvor genererede kildefiler oprettes.
-XprintProcessorInfo Udskriv oplysninger om, hvilke annotationer og hvilke elementer en processor anmodes om at behandle
-XprintRounds Udskriv oplysninger om trinnene i annotationsbehandlingen
-classNames <class1[,class2,...]> Fuldstændige navne på binære typer, der skal behandles
Ignorerede parametre (af hensyn til kompatibilitet med Javac-parametre)
-J<parameter> Send indstilling til den virtuelle maskine
-X<parameter> Angiv en indstilling, der ikke er standard. -Xemacs ignoreres ikke.
-X Udskriv indstillinger, der ikke er standard, og afslut
-O Optimér til udførelsestid
Udvidede indstillinger
@<file> Læs kommandolinjeargumenter fra fil.
-maxProblems <n> Det maksimale antal problemer pr. kompileringsenhed (standardværdi er 100).
-log <filnavn> Angiv en logfil, hvor alt output fra compileren bliver dumpet. Det er meget nyttigt, hvis du vil foretage fejlfinding af baggrundscompileren eller hente en fil, som indeholder alle fejl og advarsler fra et baggrundsbyg. Hvis filtypen er .xml, vil den genererede logfil være en xml-fil.
-Xemacs Brug emacs-syntaks til at få vist fejl- og advarselsplaceringer i konsollen og almindelige tekstlogfiler. XML-logfiler berøres ikke af parameteren. Når parameteren er aktiv, vil meddelelsen:
2. Advarsel i /workspace/X.java
(i linje 8)...

blive vist som:
/workspace/X.java:8: advarsel: Metoden...
-proceedOnError[:Fatal] Fortsæt kompilering på trods af fejl, og dump klassefiler med fejlbehæftede metoder eller typer. Det kan kun anbefales, hvis du vil kunne udføre programmet, selv om der stadig er fejl.
Med ":Fatal" behandles alle valgfrie fejl som uoprettelige, og dette fører til kode, som afbrydes, hvis der opstår en fejl ved runtime. Uden ":Fatal" forhindrer valgfrie fejl ikke den korrekte kodegenerering, og de producerede .class-filer kan udføres uden problemer.
-verbose Udskriv de åbnede/behandlede kompileringsenheder i konsollen eller logfilen, hvis det er angivet.
-referenceInfo Beregn referenceoplysninger. Dette er kun nyttig i forbindelse med byggeprogrammet. I andre sammenhænge er referenceoplysningerne uden betydning.
-progress Vis status (kun i tilstanden -log).
-time Vis hastighedsoplysninger.
-noExit Undlad at kalde System.exit(n) i slutningen af kompileringen (n=0, hvis der ikke er nogen fejl).
-repeat <n> Gentag kompileringsprocessen <n> gange (udfør analyse).
-inlineJSR Inline JSR-bytekode (implicit, hvis målet >= 1.5).
-enableJavadoc Tag referencer i Javadoc i betragtning.
-missingNullDefault Når annotationsbaseeret NULL-analyse er aktiveret (ved brug af "nullAnnot" ovenfor), vil denne indstilling afsende en advarsel, hver gang en pakke eller en type ikke har en standardannotation.
Tilpasning af Hjælp
-? -help Vis hjælpemeddelelse.
-v -version Vis compilerens bygnummer. Nummeret får du brug for ved rapportering af fejl.
-showversion Vis compilerens bygnummer, og fortsæt. Nummeret får du brug for ved rapportering af fejl.

Eksempler

d:\temp -classpath rt.jar -time -g -d d:/tmp Alle kildefiler kompileres i d:\temp og tilhørende underfoldere. Classpath er simpelthen rt.jar. Alle fejlfindingsattributter genereres, og alle genererede .class-filer dumpes i d:\tmp. Compilerens hastighed bliver vist, når baggrundskørslen er færdig.
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none Kun Test.java og dens eventuelle afhængige filer kompileres, og afhængige filer hentes fra d:\temp. Classpath er d:\temp efterfulgt af rt.jar, hvilket betyder, at der først søges efter alle nødvendige klasser i d:\temp og derefter i rt.jar. Der genereres ingen fejlfindingsattributter, og alle genererede .class-filer dumpes i d:\temp.