Eräkääntäjän käyttö

Eräkääntäjän haku

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.

Eräkääntäjän ajo

Mitkä vaihtoehdot ovat käytettävissä?

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 sun.boot.class.path, vm.boot.class.path ja org.apache.harmony.boot.class.path, tässä järjestyksessä.

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

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    Kaikki lähdetiedostot luetaan käyttäen UTF-8-koodausta (tähän sisältyy Z.java). X.java luetaan käyttäen Cp1252-koodausta ja Y.java luetaan käyttäen UTF-16-koodausta.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    Kaikki lähdetiedostot luetaan käyttäen UTF-16-koodausta. UTF-8-koodauksen -encoding-vaihtoehto ohitetaan.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    Kaikki lähdetiedostot luetaan käyttäen Cp1252-koodausta. X.java on ainoa tiedosto /foo/bar-hakemiston sisällä, joka luetaan käyttäen UTF-16-koodausta. Kaikki muut tiedostot tässä hakemistossa käyttävät UTF-8-koodausta
Yhteensopivuusvaihtoehdot
-target 1.1 - 1.7 tai (5, 5.0, jne.) Tämä määrittää .class-tiedoston kohdeasetuksen. Mahdolliset arvot ovat seuraavat:
  • 1.1 (pääversio: 45 alaversio: 3)
  • 1.2 (pääversio: 46 alaversio: 0)
  • 1.3 (pääversio: 47 alaversio: 0)
  • 1.4 (pääversio: 48 alaversio: 0)
  • 1.5, 5 tai 5.0 (pääversio: 49 alaversio: 0)
  • 1.6, 6 tai 6.0 (pääversio: 50 alaversio: 0)
  • 1.7, 7 tai 7.0 (pääversio: 51 alaversio: 0)
Oletusarvot ovat seuraavat:
  • 1.1 tilassa -1.3
  • 1.2 tilassa -1.4
  • 1.5 tilassa -1.5
  • 1.6 tilassa -1.6
  • 1.7 tilassa -1.7

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:
  • 1.3
  • 1.4
  • 1.5, 5 tai 5.0
  • 1.6, 6 tai 6.0
  • 1.7, 7 tai 7.0
Oletusarvot ovat seuraavat:
  • 1.3 tilassa -1.3
  • 1.3 tilassa -1.4
  • 1.5 tilassa -1.5
  • 1.6 tilassa -1.6
  • 1.7 tilassa -1.7
1.4-tilassa assert käsitellään avainsanana. 1.5-tilassa ja 1.6-tilassa, enum ja assert käsitellään avainsanoina.
Varoitusvaihtoehdot
-?:warn -help:warn Näytä lisävaroitusvalinnat
-warn:... Määritä käytössä oleva varoitusjoukko.
esim. -warn:unusedLocal,deprecation
-warn:none kaikkien varoitusten poisto käytöstä
-warn:<pilkuin erotetut varoitussanakkeet> lueteltujen varoitusten ottaminen käyttöön
-warn:+<pilkuin erotetut varoitussanakkeet> lisävaroitusten ottaminen käyttöön
-warn:-<pilkuin erotetut varoitussanakkeet> määritettyjen varoitusten poisto käytöstä
Seuraavan Default-sarakkeen merkki +/- osoittaa, että asetus kattaa useita tarkkoja varoitusmuunnoksia, joista osa on käytössä oletusarvon mukaan ja osa poistettu käytöstä. Tämä tarkoittaa sitä, että jos tietylle asetukselle määritetään merkki +, käyttöön otetaan oletusarvoa enemmän varoituksia. Jos tietylle asetukselle taas määritetään merkki -, käytöstä poistetaan oletusarvon mukaan käytössä olevia asetuksia.
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.
-err:<pilkuin erotetut varoitussanakkeet> muunna luetellut varoitukset virheiksi
-err:+<pilkuin erotetut varoitussanakkeet> muunna lisävaroitukset virheiksi
-err:-<pilkuin erotetut varoitussanakkeet> poista määritettyjen varoitusten muuntaminen virheiksi käytöstä
-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 .settings/org.eclipse.jdt.core.prefs olevaa tiedostoa ominaisuustiedostona tai vaihtoehtoisesti käyttämällä yksinkertaista tekstitiedostoa, joka sisältää luokassa org.eclipse.jdt.core.JavaCore kuvatulla tavalla määritettyjä merkintä-arvopareja.

...
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
-g Kaikki vianmääritystiedot (vastaava kuin -g:lines,vars,source)
-g:none Ei vianmääritystietoja
-g:[lines,vars,source] Valitut vianmääritystiedot
-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.java
(rivillä 8)...

esitetää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.

Esimerkkejä

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.