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.
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).
org.eclipse.jdt.compiler.CompilationProgress progress = null; // Opret forekomst af underklassen org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Du kan styre, hvordan status rapporteres, eller hvordan batchcompileren annulleres ved at underinddele klassen org.eclipse.jdt.compiler.CompilationProgress.
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: |
||||||||||||||
| -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:
|
||||||||||||||
| 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:
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:
|
||||||||||||||
| Tilpasning af advarsler | |||||||||||||||
| -?:warn -help:warn | Vis udvidede advarselsindstillinger | ||||||||||||||
| -warn:... | Angiv sættet af aktiverede advarsler. Eksempel: -warn:unusedLocal,deprecation
|
||||||||||||||
| 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.
|
||||||||||||||
| -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 ... 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.
|
||||||||||||||
| -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.javablive 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. | ||||||||||||||
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. |