Eräkääntäjäluokka sijaitsee JDT Core -lisäosassa. Luokan nimi on org.eclipse.jdt.compiler.batch.BatchCompiler. Se on paketissa plugins/org.eclipse.jdt.core_<versio>.jar. Versiosta 3.2 alkaen luokan on voinut myös noutaa erikseen. Tiedoston nimi on ecj.jar. Sitä vastaava lähde on myös käytettävissä. Jos haluat ladata kyseiset tiedostot, siirry lataussivulle ja hae sieltä osio JDT Core -eräkääntäjä. Tämä JAR-tiedosto sisältää eräkääntäjän ja Javac Ant -sovittimen.
Versiosta 3.3 lähtien tämä JAR-paketti sisältää myös jsr199-tuen (kääntäjän ohjelmointirajapinta) ja jsr269-tuen (huomautuskäsittely). Huomautusten käsittelyn tukea varten vaaditaan version 1.6 näennäiskone.
Sitä voi näin ollen käyttää erillisenä sovelluksena ja Eclipsen ulkopuolisessa Ant-koonnissa.
java -jar org.eclipse.jdt.core_<versio>.jar -classpath rt.jar A.java
tai
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress)-metodia.
org.eclipse.jdt.compiler.CompilationProgress progress = null; // luo aliluokka org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
Voit ohjata sitä, miten edistymisestä raportoidaan tai miten eräkääntäjä peruutetaan, luomalla aliluokan luokasta org.eclipse.jdt.compiler.CompilationProgress.
Suositellut vaihtoehdot on merkitty oranssilla taustavärillä.
Jos joitakin valintoja asetetaan useaan kertaan, eräkääntäjä käsittelee ne vasemmalta oikealle. Jos varoitusmääritystä (-warn:....) käytetään ilman plus- tai miinusmerkkiä, määritys korvaa aiemmin määritetyn varoitusjoukon. Käyttäjän on siis varmistettava, että asetus määritetään annetaan ennen -warn-valinnan käyttöä.
Sama koskee -err:-valintaa.
| Nimi | Käyttö | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Luokkapolun vaihtoehdot | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | Tämä on luettelo hakemistoista tai jar-tiedostoista, joita käytetään kääntäjän käyttämien luokkatiedostojen käynnistykseen. Ajossa olevan näennäiskoneen kirjastot ovat oletuksena käytössä. Merkinnät erotetaan ympäristön polkuerottimella. Jokainen hakemisto tai tiedosto voi määrittää tyyppien saantisäännöt merkkien [ ja ] väliin. Jos aloitusluokkapolkua ei ole määritetty, kääntäjä päättelee sen käyttämällä järjestelmän ominaisuuksia |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
Tämä on luettelo hakemistoista tai jar-tiedostoista, joita käytetään lähdetiedostojen käännökseen. Oletusarvo on ominaisuuden "java.class.path" arvo. Merkinnät erotetaan ympäristön polkuerottimella. Jokainen hakemisto tai tiedosto voi määrittää tyyppien saantisäännöt merkkien [ ja ] väliin (esim. [-X] kiellä tyypin X käyttö, [~X] älä suosittele tyypin X käyttöä, [+p/X:-p/*] kiellä paketin p kaikkien tyyppien käyttö, mutta salli p/X:n käyttö). Kääntäjä noudattaa JAR-tiedostojen manifest-tiedostojen Class-Path-lauseita rekursiivisesti ja liittää viitatut JAR-tiedostot luokkapolun loppuun, jos ne eivät vielä ole luokkapolulla. |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | Tämä on luettelo hakemistoista, joita käytetään zip- tai jar-tunnisteisten tiedostojen sijainnin määritykseen. Merkinnät erotetaan ympäristön polkuerottimella. | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | Tämä on luettelo hakemistoista, joita käytetään zip- tai jar-tunnisteisten tiedostojen sijainnin määritykseen. Merkinnät erotetaan ympäristön polkuerottimella. | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | Tämä on luettelo hakemistoista, joita käytetään lähdetiedostojen määritykseen. Merkinnät erotetaan ympäristön polkuerottimella. Jokainen hakemisto voi määrittää tyyppien saantisäännöt merkkien [ ja ] väliin. |
||||||||||||||
| -d <dir 1>|none | Tätä käytetään määrittämään, mihin hakemistoon muodostetut .class-tiedostot tulee vedostaa. Jos se jätetään pois, paketin hakemistorakennetta ei luoda. Jos et halua muodostaa .class-tiedostoja, käytä vaihtoehtoa -d none. |
||||||||||||||
| -encoding <koodauksen nimi> | Määritä kaikkien lähdetiedostojen oletusarvoinen koodausmuoto. Voit määrittää mukautetun koodausmuodon myös tiedostokohtaisestilisäämällä kunkin lähdetiedoston tai -kansion nimeen loppuliitteen [<encoding name>]. Esimerkiksi X.java[utf8] määrittää nykyisessä käyttäjähakemistossa olevan X.java-käännösyksikön koodausmuodoksi UTF-8.
Jos oletusarvoiseksi koodausmuodoksi valitaan useita muotoja, koodaukseen käytetään viimeksi valittua muotoa. Esimerkki:
|
||||||||||||||
| Yhteensopivuusvaihtoehdot | |||||||||||||||
| -target 1.1 - 1.7 tai (5, 5.0, jne.) | Tämä määrittää .class-tiedoston kohdeasetuksen. Mahdolliset arvot ovat seuraavat:
StackMap-määrite voidaan muodostaa luokan clcd1.1 avulla. |
||||||||||||||
| -1.3 | Aseta yhteensopivuustasoksi 1.3. Implisiittinen -source 1.3 -target 1.1. | ||||||||||||||
| -1.4 | Aseta yhteensopivuustasoksi 1.4. Implisiittinen -source 1.3 -target 1.2. | ||||||||||||||
| -1.5 | Aseta yhteensopivuustasoksi 1.5. Implisiittinen -source 1.5 -target 1.5. | ||||||||||||||
| -1.6 | Aseta yhteensopivuustasoksi 1.6. Implisiittinen -source 1.6 -target 1.6. | ||||||||||||||
| -1.7 | Aseta yhteensopivuustasoksi 1.7. Implisiittinen -source 1.7 -target 1.7. | ||||||||||||||
| -source 1.1 - 1.7 tai (5, 5.0 jne.) | Tämän valinnan avulla määritetään lähteen taso, jota kääntäjä odottaa. Mahdolliset arvot ovat seuraavat:
|
||||||||||||||
| Varoitusvaihtoehdot | |||||||||||||||
| -?:warn -help:warn | Näytä lisävaroitusvalinnat | ||||||||||||||
| -warn:... | Määritä käytössä oleva varoitusjoukko. esim. -warn:unusedLocal,deprecation
|
||||||||||||||
| Oletusarvo | Sanakenimi | Kuvaus | |||||||||||||
| +/- | allDeadCode | ajamaton koodi, mukaan lukien if(DEBUG)-tarkistus | |||||||||||||
| +/- | allDeprecation | vanhentuminen myös vanhentuneen koodin sisällä | |||||||||||||
| - | allJavadoc | virheellinen tai puuttuva javadoc | |||||||||||||
| - | allOver-ann | kaikki puuttuvat @Override-huomautukset (yliluokka ja ylirajapinnat) | |||||||||||||
| - | all-static-method | koko metodi voidaan määrittää staattisiksi varoituksiksi | |||||||||||||
| + | assertIdentifier | assert-lauseketta käytetään tunnuksena | |||||||||||||
| - | boxing | automaattisen lokeroinnin muunto | |||||||||||||
| + | charConcat | kun char-taulukkoa käytetään merkkijonon liitostuksessa muuntamatta eksplisiittisesti merkkijonoksi | |||||||||||||
| + | compareIdentical | samanlaisten lausekkeiden vertailu | |||||||||||||
| - | conditionAssign | mahdollinen tahaton looginen osoitus | |||||||||||||
| + | constructorName | metodilla on konstruktorin nimi | |||||||||||||
| + | deadCode | ajamaton koodi, ei if(DEBUG)-tarkistusta | |||||||||||||
| - | dep-ann | puuttuva @Deprecated-huomautus | |||||||||||||
| +/- | deprecation | vanhentuneen tyypin tai jäsenen käyttö vanhentuneen koodin ulkopuolella | |||||||||||||
| + | discouraged | ei-suositeltua saantisääntöä vastaavien tyyppien käyttö | |||||||||||||
| - | emptyBlock | dokumentoimaton tyhjä lohko | |||||||||||||
| + | enumIdentifier | enum-lauseketta käytetään tunnuksena | |||||||||||||
| + | enumSwitch | epätäydellinen enum-kytkin | |||||||||||||
| - | enumSwitchPedantic | ilmoitus puuttuvasta enum-tyypin switch-lauseen case-lauseesta, vaikka case-oletuslause on olemassa | |||||||||||||
| - | fallthrough | mahdollinen toteutumaton case-haara | |||||||||||||
| - | fieldHiding | kenttä piilottaa toisen muuttujan | |||||||||||||
| + | finalBound | tyypin parametri, jossa on lopullinen raja | |||||||||||||
| + | finally | finally-lohko, joka ei pääty normaalisti | |||||||||||||
| + | forbidden | kiellettyä saantisääntöä vastaavien tyyppien käyttö | |||||||||||||
| - | hashCode | hashCode()-metodi puuttuu equals()-metodin ohituksesta | |||||||||||||
| +/- | hiding | fieldHiding-, localHiding-, typeHiding- ja maskedCatchBlock-makro | |||||||||||||
| - | includeAssertNull | anna tyhjäarvoon liittyvä varoitus muuttujista, jotka pilaantuivat assert-lausekkeessa | |||||||||||||
| - | indirectStatic | epäsuora viite staattiseen jäseneen | |||||||||||||
| + | intfAnnotation | huomautustyyppiä käytetään super-rajapintana | |||||||||||||
| + | intfNonInherited | rajapinnan ei-perityn metodin yhteensopivuus | |||||||||||||
| - | intfRedundant | hae ylimääräiset super-rajapinnat | |||||||||||||
| - | javadoc | virheellinen javadoc | |||||||||||||
| - | localHiding | paikallismuuttuja piilottaa toisen muuttujan | |||||||||||||
| + | maskedCatchBlock | piilotettu catch-lohko | |||||||||||||
| - | nls | ei-nls-merkkijonoliteraalit (tunnisteet //$NON-NLS-<n> puuttuvat) | |||||||||||||
| + | noEffectAssign | osoitus, jolla ei ole vaikutusta | |||||||||||||
| +/- | null | mahdollinen puuttuva tai tarpeeton null-tarkistus | |||||||||||||
| - | nullAnnot | Ota huomautuspohjainen tyhjäarvoanalyysi käyttöön Kääntäjän tulkittavat huomautustyypit voidaan haluttaessa määrittää liittämällä (nullable|nonnull|nonnullbydefault), jossa jokainen huomautustyyppi määritetään käyttämällä sen tarkennettua nimeä. Katso myös jäljempänä oleva kohta -nonNullByDefault. |
|||||||||||||
| - | nullDereference | puuttuva null-tarkistus | |||||||||||||
| - | over-ann | puuttuva @Override-huomautus (vain yliluokka) | |||||||||||||
| - | paramAssign | osoitus parametriin | |||||||||||||
| + | pkgDefaultMethod | yritys ohittaa paketin oletusmetodi | |||||||||||||
| + | raw | muotoilemattoman tyypin käyttö (parametroidun tyypin sijaan) | |||||||||||||
| +/- | resurssi | tyypin Closeable resurssin (mahdollisesti) virheellinen käyttö | |||||||||||||
| - | semicolon | tarpeeton puolipiste tai tyhjä lause | |||||||||||||
| + | serial | puuttuva serialVersionUID | |||||||||||||
| - | specialParamHiding | konstruktori tai asetusparametri piilottaa toisen kentän | |||||||||||||
| +/- | static-access | indirectStatic- ja staticReceiver-makro | |||||||||||||
| - | static-method | ilmentymämetodi, joka voi olla staattinen metodi | |||||||||||||
| + | staticReceiver | käytetäänkö ei-staattista vastaanottajaa staattisen kentän hakuun tai staattisen metodin kutsuun | |||||||||||||
| - | super | metodi korvataan ilman super-kutsua | |||||||||||||
| + | suppress | ota @SuppressWarnings käyttöön | |||||||||||||
| - | switchDefault | switch-lause, josta puuttuu case-oletuslause | |||||||||||||
| - | syncOverride | synkronoitu metodi puuttuu synkronoidun metodin ohituksesta | |||||||||||||
| - | syntheticAccess | kun käytetään sisäluokkaa synteettisesti | |||||||||||||
| - | tasks | ota lähdekoodin tehtävätunnisteiden tuki käyttöön | |||||||||||||
| + | typeHiding | tyypin parametri piilottaa toisen tyypin | |||||||||||||
| + | unavoidableGenericProblems | ohita muokkaamattomista sovellusliittymistä johtuvat väistämättömät tyypin suojauksen ongelmat | |||||||||||||
| + | unchecked | tarkistamattoman tyypin käyttö | |||||||||||||
| - | unnecessaryElse | tarpeeton else-lause | |||||||||||||
| - | unqualifiedField | tarkentamaton viite kenttään | |||||||||||||
| +/- | unused | unusedAllocation-, unusedArgument-, unusedImport-, unusedLabel-, unusedLocal-, unusedPrivate-, unusedThrown- ja unusedTypeArgs-makro | |||||||||||||
| - | unusedAllocation | käyttämättömän objektin varaus | |||||||||||||
| - | unusedArgument | käyttämätön metodin argumentti | |||||||||||||
| + | unusedImport | käyttämätön tuontiviite | |||||||||||||
| + | unusedLabel | käyttämätön nimiö | |||||||||||||
| + | unusedLocal | käyttämätön paikallismuuttuja | |||||||||||||
| + | unusedPrivate | käyttämätön yksityisen jäsenen esittely | |||||||||||||
| - | unusedThrown | käyttämätön esitelty aiheutettu poikkeus | |||||||||||||
| + | unusedTypeArgs | metodissa ja konstruktorissa on käyttämättömiä tyyppiargumentteja | |||||||||||||
| - | uselessTypeCheck | tarpeeton cast/instanceof-toiminto | |||||||||||||
| + | varargsCast | varargs-argumentti edellyttää eksplisiittistä lajinvaihtoa | |||||||||||||
| +/- | warningToken | käsittelemätön tai käyttämätön varoitussanake @SuppressWarnings-huomautuksessa | |||||||||||||
| -nowarn | Ei varoitusta (vastaava kuin -warn:none) | ||||||||||||||
| -err:... | Määritä käytössä olevien varoitusten joukko, jonka sisältämät varoitukset muunnetaan virhesanomiksi. esim. -err:unusedLocal,deprecation unusedLocal- ja deprecation-varoitukset muunnetaan virhesanomiksi. Kaikki muut varoitukset ilmoitetaan edelleen varoituksina.
|
||||||||||||||
| -deprecation | Vastaava kuin -warn:+deprecation. | ||||||||||||||
| -properties <tiedosto> | Varoitus- ja virheasetuksen määritys ominaisuustiedoston sisällön perusteella. Asetusta voidaan käyttää yhdessä -nowarn, -err:.. ja -warn:.. -asetusten kanssa, mutta käytettävät asetukset määräytyvät komentorivillä viimeisenä olevan asetuksen perusteella. Ominaisuustiedoston sisältö voidaan luoda määrittämällä projektikohtaiset asetukset aiemmin luodulle Java-projektille ja käyttämällä sijainnissa ... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ... |
||||||||||||||
| Vianmäärityksen asetukset | |||||||||||||||
| -g[:none|:lines,vars,source] | Aseta vianmäärityksen määritteiden taso
|
||||||||||||||
| -preserveAllLocals | Pyydä kääntäjää nimenomaisesti säilyttämään kaikki paikallismuuttujat (vianmääritystä varten). Jos tämä jätetään pois, kääntäjä poistaa käyttämättömät paikallismuuttujat. | ||||||||||||||
| Huomautusten käsittelyvalinnat (edellyttävät vähintään version 1.6 näennäiskoneen, ja niitä käytetään vain, jos yhteensopivuus on 1.6) | |||||||||||||||
| -Akey[=value] | Huomautusten käsittelytoiminnoille välitettävät valinnat. key-arvo koostuu pisteillä erotetuista tunnisteista. |
||||||||||||||
| -proc:[only|none] | Jos käytetään määritystä -proc:only, huomautuskäsittelijät ajetaan mutta kääntämistä ei tehdä. Jos käytetään määritystä -proc:none, huomautuskäsittelijöitä ei havaita tai ajeta. Kääntäminen tehdään samoin kuin jos huomautuskäsittelijöitä ei löytyisi. Oletusarvon mukaan kääntäjä etsii huomautuskäsittelijöiden luokkapolkua, joten -proc:none-määritys voi nopeuttaa kääntämistä, jos huomautusten käsittely ei ole tarpeen. |
||||||||||||||
| -processor <class1[,class2,...]> | Ajettavien huomautuskäsittelijöiden tarkennetut luokkanimet. Jos tätä määritystä käytetään, tavallinen käsittelijöiden hakuprosessi ohitetaan. | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | Luettelo hakemistoista tai JAR-tiedostoista, joista huomautuskäsittelijöitä haetaan. Merkinnät erotetaan ympäristön polkuerottimella. Jos tätä määritystä ei käytetä, haku tehdään luokkapolun perusteella. | ||||||||||||||
| -s <dir> | Hakemisto, johon luodut lähdetiedostot tallennetaan. | ||||||||||||||
| -XprintProcessorInfo | Tulostaa tiedot, jotka kertovat, mitä huomautuksia ja elementtejä käsittelijää on pyydetty käsittelemään. | ||||||||||||||
| -XprintRounds | Tulostaa tietoja huomautusten käsittelykierroksista. | ||||||||||||||
| -classNames <class1[,class2,...]> | Käsiteltävien binaaristen tyyppien tarkennetut nimet. | ||||||||||||||
| Ohitetut asetukset (Javac-asetusten kanssa yhteensopivuutta varten) | |||||||||||||||
| -J<asetus> | Välitä asetus näennäiskoneelle. | ||||||||||||||
| -X<asetus> | Määritä standardista poikkeava asetus. -Xemacs-vaihtoehtoa ei ohiteta. | ||||||||||||||
| -X | Tulosta standardista poikkeavat asetukset ja lopeta. | ||||||||||||||
| -O | Optimoi suorituksen ajaksi. | ||||||||||||||
| Lisäasetukset | |||||||||||||||
| @<file> | Lue komentorivin argumentit tiedostosta | ||||||||||||||
| -maxProblems <n> | Häiriöiden enimmäismäärä käännösyksikköä kohti (oletuksena on 100) | ||||||||||||||
| -log <filename> | Määritä lokitiedosto, johon kaikki kääntäjän tuloste vedostetaan. Tämä on erittäin hyödyllistä, jos haluat tehdä vianmäärityksen eräkääntäjälle tai saada tiedoston, jossa on kaikki virheet ja varoitukset eräkoonnista. Jos tunniste on .xml, muodostettu loki on xml-tiedosto. | ||||||||||||||
| -Xemacs | Emacs-tyylin avulla voi esittää virheiden ja varoitusten sijainteja konsolissa ja normaaleissa tekstilokeissa. Tämä vaihtoehto ei vaikuta XML-lokeihin. Kun tämä vaihtoehto on käytössä, sanoma:2. VAROITUS kohteessa /workspace/X.javaesitetään seuraavassa muodossa: /workspace/X.java:8: varoitus: Metodi... |
||||||||||||||
| -proceedOnError[:Fatal] | Jatka kääntöä virheistä huolimatta, ongelmallisia metodeja tai tyyppejä sisältävät luokkatiedostot vedostetaan. Tämä vaihtoehto on suositeltava vain, jos haluat ajaa sovelluksen jäljellä olevista virheistä huolimatta. Jos ":Fatal" on määritetty, kaikki valinnaiset virheet käsitellään vakavina virheinä. Muodostetun koodin suoritus keskeytetään, jos ajon aikana tapahtuu virhe. Jos ":Fatal" ei ole määritettynä, valinnaiset virheet eivät estä varsinaisen koodin muodostusta ja kääntäjän tuottamat .class-tiedostot voidaan ajaa ongelmitta. |
||||||||||||||
| -verbose | Tulosta käytetyt/käsitellyt käännösyksiköt konsoliin tai lokitiedostoon, jos se on määritetty. | ||||||||||||||
| -referenceInfo | Laske viitetiedot. Tämä on hyödyllistä vain, jos luontitoimintoon on yhteys. Muuten viitetiedot ovat hyödyttömiä. | ||||||||||||||
| -progress | Näytä tilannetiedot (vain -log-tilassa). | ||||||||||||||
| -time | Näytä nopeustiedot. | ||||||||||||||
| -noExit | Älä kutsu kohdetta System.exit(n) käännöksen lopussa (n=0, jos virheitä ei ole). | ||||||||||||||
| -repeat <n> | Toista käännöskäsittely <n> kertaa (suoritustehon analyysi). | ||||||||||||||
| -inlineJSR | Muunna JSR-tavukoodi koodiksi (implisiittinen, jos kohde >= 1.5). | ||||||||||||||
| -enableJavadoc | Ota javadocin sisällä olevat viitteet huomioon. | ||||||||||||||
| -missingNullDefault | Kun huomautuksiin perustuva tyhjäarvoanalyysi on käytössä (otettu käyttöön edellä olevan asetuksen nullAnnot avulla), tämä asetus tuottaa varoituksen aina, kun paketissa tai tyypissä ei ole oletushuomautusta. | ||||||||||||||
| Ohjeen vaihtoehdot | |||||||||||||||
| -? -help | Näytä ohjesanoma. | ||||||||||||||
| -v -version | Näytä kääntäjän koontinumero. Tämä on erittäin hyödyllistä vian ilmoituksessa. | ||||||||||||||
| -showversion | Näytä kääntäjän koontinumero ja jatka. Tämä on erittäin hyödyllistä vian ilmoituksessa. | ||||||||||||||
d:\temp -classpath rt.jar -time -g -d d:/tmp |
Kääntää kaikki lähdetiedostot, jotka ovat hakemistossa d:\temp ja sen alikansioissa. Luokkapolku on yksinkertaisesti rt.jar. Se luo kaikki vianmääritysmääritteet, ja kaikki muodostetut .class-tiedostot vedostetaan hakemistoon d:\tmp. Kääntäjän nopeus tulee näyttöön, kun eräkäsittely on valmis. |
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none |
Kääntää ainoastaan Test.java-tiedoston ja sen mahdolliset alisteiset tiedostot, jotka noudetaan hakemistosta d:\temp. Luokkapolku on d:\temp, jota seuraa rt.jar, eli kaikkia tarpeellisia luokkia etsitään ensin hakemistosta d:\temp ja sitten tiedostosta rt.jar. Se ei muodosta vianmäärityksen määritteitä, ja kaikki muodostetut .class-tiedostot vedostetaan hakemistoon d:\temp. |