Java-käännösvirheiden tai -varoitusten oletusasetukset

Voit määrittää virheiden ja varoitusten oletusasetukset oletusasetussivulla Virheiden ja varoitusten oletusasetussivun avaus Java > Kääntäjä > Virheet/varoitukset.

Koodityyli

Asetus

Kuvaus

Oletusarvo

Staattisen jäsenen ei-staattinen käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun staattista kenttää tai metodia on käytetty lausekkeen vastaanottajalla. Viittaus staattiseen jäseneen on tarkennettava tyypin nimellä.

Varoitus

Epäsuora staattisen jäsenen käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun staattista kenttää tai metodia käytetään epäsuorasti. Rajapinnan staattinen kenttä on tarkennettava esittelevän tyypin nimellä.

Ohita

Tarkentamaton ilmentymäkentän käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun se havaitsee kentän käytön, jota ei ole tarkennettu (esimerkiksi "this" puuttuu).

Ohita

Sisällytystyypin sellaisen jäsenen käyttö, joka ei ole käytettävissä

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen emuloidessaan sisältävän tyypin sellaisen jäsenen käyttöä, joka ei ole käytettävissä. Tällaisilla käytöillä voi olla vaikutuksia suoritustehoon.

Ohita

Parametrin arvon osoitus

Parametrin arvon osoitusta pidetään yleisesti huonona ohjelmointitapana. Kun tämä asetus on käytössä, kääntäjä ilmoittaa tällaisista tapauksista joko virheenä tai varoituksena.

Ohita

Ulkoistamattomat merkkijonot

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen ulkoistamattomista merkkijonon literaaleista (joita ei ole merkitty tunnisteella //$NON-NLS-<n>$) ja ulkoistamattomista merkkijonotunnisteista, jotka eivät kuulu merkkijonoon.

Ohita

Dokumentoimaton tyhjä lohko

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tyhjän lohkon lauseen ilman selittävää kommenttia.

Ohita

Resurssit, joiden hallinnassa ei ole käytössä try-with-resource-lauseita (versio 1.7 tai uudempi)

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos paikallismuuttujalla on tyypin java.lang.AutoCloseable arvo ja jos metodi close() kutsutaan eksplisiittisesti kyseisessä resurssissa, mutta resurssia ei ohjata try-with-resources-lohkon avulla.

Ohita

Metodi, jolla on konstruktorin nimi

Metodin nimeämistä konstruktorin nimellä pidetään yleisesti huonona ohjelmointitapana. Kun tämä asetus on käytössä, kääntäjä ilmoittaa tällaisista tapauksista joko virheenä tai varoituksena.

Varoitus

Metodi saattaa olla staattinen

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen yksityisille tai lopullisille metodeille, jotka viittaavat vain staattisiin jäseniin.

Ohita

Metodi saattaa olla staattinen

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen metodeille, jotka eivät ole yksityisiä tai lopullisia ja jotka viittaavat vain staattisiin jäseniin. Huomaa, että aliluokan metodit voidaan ohittaa, joten jos teet "mahdollisesti staattisesta" metodista staattisen, tämä saattaa estää olemassa olevien asiakkaiden toiminnan.

Ohita

Mahdolliset ohjelmointihäiriöt

Vertaillaan samanlaisia arvoja ('x == x')

Kun asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos vertailu sisältää samanlaiset operandit (esim 'x == x').

Varoitus

Osoituksella ei ole vaikutusta (esim. "x = x")

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun osoituksella ei ole vaikutusta (esim. "x = x").

Varoitus

Mahdollinen tahaton Boolen arvon osoitus (esim. "if (a = b)")

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan mahdollisen tahattoman Boolen arvon osoituksen (esimerkiksi "if (a = b)").

Ohita

Lokeroinnin ja lokeroinnin purun muunnokset

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan lokeroinnin tai lokeroinnin purun muunnoksen. Automaattinen lokerointi saattaa huonontaa suoritustehoa.

Ohita

Käytetään char-taulukkoa merkkijonon liitostuksessa

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina, kun merkkijonon liitostuksissa käytetään char[]-lauseketta,

"hello" + new char[]{'w','o','r','l','d'}

Varoitus

Epätarkka tyypin vastine vararg-argumenteille

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan epätarkan tyypin vastineen vararg-argumenteille.

Varoitus

Tyhjä lause

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tyhjän lauseen (esimerkiksi tarpeettoman puolipisteen).

Ohita

Käyttämätön objektivaraus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan käyttämättömän objektivarauksen, esim.

if (name == null)
   new IllegalArgumentException();

Ohita

Epätäydelliset switch-lajinvaihdot enum-lajissa

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina kohdatessaan switch-lauseen, joka ei sisällä case-lauseita jokaiselle viitatun enum-tyypin enum-vakiolle eikä case-oletuslausetta. Case-oletuslauseen oletetaan kattavan kaikkien enum-vakioiden puuttuvat case-lauseet. Kääntäjä ei tällöin ilmoita mistään case-oletuslauseiden ollessa läsnä, ellei Ilmoitus, vaikka default-lajinvaihto on määritetty -asetus (ks. alla) ole käytössä.

Varoitus

Ilmoitus, vaikka default-lajinvaihto on määritetty

Kun tämä asetus on käytössä, kääntäjä tuottaa lisäksi virheen tai varoituksen, jos case-lause ei kata enum-vakiota, vaikka case-oletuslause on olemassa. Tämä asetus on hyödyllinen, kun puuttuvat case-lauseet halutaan saada kiinni lisättäessä uutta enum-vakiota.

Ei käytössä

Switch-lauseesta puuttuu case-oletuslause

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos switch-lauseesta puuttuu case-oletuslause. Tämän seurauksena puuttuva case-oletuslause liputetaan, vaikka case-lauseet muuten kattaisivat kaikki mahdolliset arvot. Javan kielimääritys (Java Language Specification) suosittelee tätä varoitusta binaarisen yhteensopivuuden vuoksi.

Ohita

Toteutumaton switch-lauseen case-haara

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan switch-lauseen case-haaran, johon siirrytään edeltävän toteutumattoman case-haaran kautta.

Ohita

Piilotettu catch-lohko

Jotkin catch-lohkot voivat piilottaa toisia try-lauseen sisällä, esim.

try { throw new java.io.CharConversionException();
} catch (java.io.CharConversionException e) {
} catch (java.io.IOException e) {}

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen valittuja poikkeuksia vastaavia piilotettuja catch-lohkoja varten.

Varoitus

"Finally" ei pääty normaalisti

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina, kun "finally"-lause ei pääty normaalisti (sisältää esimerkiksi paluulauseen).

Varoitus

Tarpeeton koodi (esim. if (false))

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan ajamattoman koodin (esim. 'if (false)' ).

Varoitus

Resurssivuoto

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos paikallismuuttujalla on tyypin java.lang.AutoCloseable arvo (yhteensopivuus >= 1.7) tai tyypin java.io.Closeable arvo (yhteensopivuus <= 1.6) ja jos virta-analyysi osoittaa, ettei metodia close() ole kutsuttu paikallisesti kyseisessä arvossa.

Varoitus

Mahdollinen resurssivuoto

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos paikallismuuttujalla on tyypin java.lang.AutoCloseable arvo (yhteensopivuus >= 1.7) tai tyypin java.io.Closeable arvo (yhteensopivuus <= 1.6) ja jos virta-analyysi osoittaa, ettei metodia close() ole kutsuttu paikallisesti kaikkien suorituspolkujen kyseisessä arvossa.

Ohita

Peräkkäistettävä luokka ilman serialVersionUID-kenttää

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun luokan "java.io.Serializable" toteuttava tyyppi ei sisällä serialVersionUID-kenttää.

Varoitus

Puuttuva synchronized-määre perityssä metodissa

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan perityn metodin, jolta puuttuu synchronized-määre.

Ohita

Luokka ohittaa 'equals()'-metodin, mutta ei 'hashCode()'-metodia

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan luokan, joka ohittaa 'equals()'-metodin, mutta ei 'hashCode()'-metodia.

Ohita

Nimen varjostus ja ristiriidat

Kentän esittely piilottaa toisen kentän tai muuttujan

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos kentän esittely piilottaa toisen perityn kentän.

Ohita

Paikallismuuttujan esittely piilottaa toisen kentän tai muuttujan

Kun tämä asetus on käytössä, kääntäjä tuottaa virhe- tai tai varoitusilmoituksen, jos paikallismuuttujan esittely piilottaa toisen kentän tai muuttujan.

Ohita

Sisällytä konstruktorin tai asetusmetodin parametrit

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos konstruktori tai asetusmetodi piilottaa toisen kentän tai muuttujan.

Ei käytössä

Tyypin parametri piilottaa toisen tyypin

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, jos esimerkiksi sisäisen luokan tyyppiparametri piilottaa ulkoisen tyypin.

Varoitus

Metodi ei ohita pakkauksen näkyvää metodia

Paketin oletusmetodi ei ole näkyvissä eri paketeissa, joten sitä ei voi ohittaa. Kun tämä asetus on käytössä, kääntäjä ilmoittaa tällaisista tapauksista joko virheenä tai varoituksena.

Varoitus

Rajapintametodi on ristiriidassa suojatun Object-metodin kanssa

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina, kun rajapinta määrittää metodin yhteensopimattomaksi ei-perityn Object-metodin kanssa. Tällaista rajapintaa ei voi toteuttaa, ennen kuin ristiriita on ratkaistu. Esimerkki:

interface I {
   int clone();
}

Varoitus

Vanhentunut ja rajoitettu API-ohjelmointirajapinta

Vanhentunut API-ohjelmointirajapinta

Kun tämä asetus on käytössä, kääntäjä ilmoittaa vanhentuneen ohjelmointirajapinnan käytöstä joko virheen tai varoituksen muodossa.

Varoitus

Ilmoitus vanhentuneen API-ohjelmointirajapinnan käytöstä vanhentuneen koodin sisällä

Kun tämä asetus on käytössä, kääntäjä ilmoittaa vanhentuneen API-ohjelmointirajapinnan käytöstä vanhentuneen koodin sisällä. Häiriön vakavuutta ohjataan asetuksella "Vanhentunut API-ohjelmointirajapinta".

Ei käytössä

Ilmoitus korvaavan tai toteuttavan vanhentuneen koodin käytöstä

Kun tämä asetus on käytössä, kääntäjä ilmoittaa vanhentuneen metodin korvauksesta tai toteutuksesta. Häiriön vakavuutta ohjataan asetuksella "Vanhentunut API-ohjelmointirajapinta".

Ei käytössä

Kielletty viite (saantisäännöt)

Kun tämä asetus on käytössä, kääntäjä ilmoittaa saantisäännöissä määritetystä kielletystä viitteestä.

Virhe

Ei-suositeltu viite (saantisäännöt)

Kun tämä asetus on käytössä, kääntäjä ilmoittaa saantisäännöissä määritetystä ei-suositellusta viitteestä.

Varoitus

Tarpeeton koodi

Paikallismuuttujan arvoa ei käytetä

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina, kun esitellyn paikallismuuttujan arvoa ei käytetä omassa alueessaan.

Varoitus

Parametrin arvoa ei käytetä

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun esitellyn parametrin arvoa ei käytetä omassa alueessaan.

Ohita

Ohita korvaavissa ja toteuttavissa metodeissa

Kun tämä asetus on käytössä, kääntäjä ei tuota virhe- tai varoitusilmoitusta, kun esiteltyä paikallismuuttujaa ei käytetä oman alueensa korvaavissa tai toteuttavissa metodeissa.

Käytössä

Ohita parametrit, jotka on dokumentoitu "@param"-tunnisteella

Kun tämä asetus on käytössä, kääntäjä ei tuota virheilmoitusta tai varoitusta, kun lukematon parametri on dokumentoitu "@param"-tunnisteella.

Käytössä

Käyttämätön tuonti

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen käyttämättömistä tuontiviittauksista.

Varoitus

Käyttämätön yksityinen jäsen

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen aina, kun yksityinen jäsen esitellään, mutta sitä ei koskaan käytetä samassa yksikössä.

Varoitus

Tarpeeton else-lause

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tarpeettoman else-lauseen (esimerkiksi if (condition) return; else doSomething();)).

Ohita

Tarpeeton lajinvaihto- tai instanceof-toiminto

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tarpeettoman lajinvaihto- tai "instanceof"-toiminnon (esimerkiksi if (object instanceof Object) return;).

Ohita

Tarpeeton thrown-poikkeuksen esittely

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tarpeettoman tuotetun poikkeuksen esittelyn.

Ohita

Ohita korvaavissa ja toteuttavissa metodeissa

Kun tämä asetus on käytössä, kääntäjä ei tuota virhe- tai varoitusilmoitusta havaitessaan tarpeettoman tuotetun poikkeuksen esittelyn toisen metodin korvaavassa tai toteuttavassa metodissa.

Käytössä

Ohita poikkeukset, jotka on dokumentoitu @throws- tai @exception-tunnisteella

Kun tämä asetus on käytössä, kääntäjä ei tuota virheilmoitusta tai varoitusta, kun tarpeettomasti tuotettu poikkeus on dokumentoitu @throws- tai @exception-tunnisteella.

Käytössä

Ohita Exception- ja Throwable-luokat

Kun tämä asetus on käytössä, kääntäjä ei tuota virhe- tai varoitusilmoitusta havaitessaan tarpeettoman tuotetun Exception- ja Throwable-poikkeuksen esittelyn.

Käytössä

Käyttämätön break- tai continue-nimiö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan käyttämättömän break- tai continue-nimiön.

Varoitus

Ylimääräinen super-rajapinta

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tyypin, joka toteuttaa erikseen jonkin sen ylityypin aiemmin toteuttaman rajapinnan.

Ohita

Yleistyypit

Unchecked-yleistyypin toiminto

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan unchecked-yleistyypin toiminnon.

Varoitus

Muotoilemattoman tyypin käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan muotoilemattoman tyypin käytön (esimerkiksi List-määritys määrityksen List<String> sijasta).

Varoitus

Yleistyypin parametri, joka on esitelty lopullisen tyypin rajalla

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan lopullisen tyypin käsittävän tyypin rajan.

Varoitus

Ohita yleistyypin väistämättömät ongelmat

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen myös silloin, kun se havaitsee yleistyypin ongelman, jota ohjelmoija ei ole pystynyt välttämään. Tyyppi on esimerkiksi voitu pakottaa käyttämään muotoilemattomia tyyppejä metodien allekirjoituksissa ja palauttamaan tyyppejä, koska ylityypin korvaamat metodit on määritelty käyttämään muotoilemattomia tyyppejä.

Kun viitatut muotoilemattomat ohjelmointirajapinnat yleistetään, näkyviin joko ei tule ollenkaan ongelmia (jos yleistyypit olivat oikein) tai näkyviin tulee käännösvirheitä (jos ohjelmointirajapinta yleistettiin eri tavalla).

Ei käytössä

Huomautukset

Puuttuva @Override-huomautus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan metodin, joka korvaa toisen toteutetun metodin, ja "@Override"-huomautus puuttuu.

Ohita

Sisällytä rajapintametodien toteutukset (1.6 tai uudempi)

Kun tämä asetus on käytössä ja jos @Override-huomautus puuttuu, kääntäjä tuottaa virheen tai varoituksen myös havaitessaan metodin, joka korvaa tai toteuttaa rajapinnassa määritellyn metodin.
Huomaa, että @Override-huomautuksen käyttö sallitaan kyseisen kaltaisissa metodeissa vain, jos kääntäjän yhteensopivuustaso on 1.6 tai suurempi. Virhe- tai varoitusilmoitus ei esiinny käytettäessä yhteensopivuustason 1.5 mukaista koodia.

Käytössä

Puuttuva @Deprecated-huomautus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan vanhentuneen tyypin ilman "@Deprecated"-lisähuomautusta.

Ohita

Huomautusta käytetään super-rajapintana

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tyypin, joka toteuttaa huomautuksen. Tätä ei pidetä hyvänä käytäntönä, vaikka tämä on mahdollista.

Varoitus

@SuppressWarnings-huomautuksessa on käsittelemätön sanake

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan tuntemattoman sanakkeen @SuppressWarnings-huomautuksessa.

Varoitus

Ota käyttöön @SuppressWarnings-huomautukset

Kun tämä asetus on käytössä, kääntäjä käsittelee "@SuppressWarnings"-huomautukset.Kun tämä asetus on poistettu käytöstä, se käyttäytyy ikään kuin kaikki @SuppressWarnings-huomautukset olisi poistettu.

Käytössä

Käyttämätön @SuppressWarnings-sanake

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan käyttämättömän sanakkeen "@SuppressWarnings"-huomautuksessa.

Varoitus

Piilota valinnaiset virheet '@SuppressWarnings'-huomautuksella

Kun tämä asetus on käytössä, @SuppressWarnings-huomautus piilottaa myös valinnaiset käännösvirheet eli vaihtoehdot, jotka määritetään tässä virheiksi. Pakollisia käännösvirheitä ei voi piilottaa.

Ei käytössä

Tyhjäarvoanalyysi

Paikanvarausosoittimen käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan, että varmuudella tyhjäarvoisen (null) paikallismuuttujan arvo haetaan. Huomaa, että analyysi ei pysty löytämään kaikkia tyhjän osoittimen käyttöjä. Katso kohta Mahdollisen paikanvarausosoittimen käyttö.

Varoitus

Mahdollisen paikanvarausosoittimen käyttö

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen havaitessaan, että mahdollisesti tyhjäarvoisen (null) paikallismuuttujan arvo haetaan. Huomaa, että analyysi on melko varovainen ja siinä huomioidaan vain epäilyttävät tapaukset.

Analyysin laatua voidaan parantaa käyttämällä tyhjäarvojen huomautuksia. Ne voidaan ottaa käyttöön käyttämällä asetusta Ota huomautuspohjainen tyhjäarvoanalyysi käyttöön

Ohita

Ylimääräinen tyhjäarvon tarkistus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen, kun paikallinen muuttuja, jonka arvo ei voi olla tyhjä, tarkistetaan tyhjäarvon varalta.

Ohita

Sisällytä assert-lauseke tyhjään analyysiin

Kun tämä asetus on käytössä, kääntäjä käyttää assert-lausetta toteuttaessaan tyhjäarvoanalyysia.

Ei käytössä

Ota huomautuspohjainen tyhjäarvoanalyysi käyttöön

Kun tämä asetus on käytössä, kääntäjä määrittää, sisältääkö tietty tyyppi tyhjäarvon, tulkitsemalla huomautukset @Nullable, @NonNull ja @NonNullByDefault.

Tyhjäarvoanalyysien tehoa ohjataan lisäksi seuraavien aliasetusten avulla.

Lisätietoja on ohjeaiheessa Tyhjäarvojen huomautuksien käyttö.

Ei käytössä

Tyhjäarvomäärityksen rikkomus

Tämän asetuksen mukaan kääntäjä tuottaa joko virheen tai varoituksen havaitessaan jonkin seuraavista tilanteista:

  1. Muiden kuin tyhjäarvojen huomautuksen avulla määritetty metodi palauttaa tyhjäarvot sallivan lausekkeen.
  2. Tyhjäarvot salliva lauseke välitetään argumenttina metodikutsussa, jossa kutsutun metodin vastaava parametri määritetään muiden kuin tyhjäarvojen huomautuksen avulla.
  3. Muiden kuin tyhjäarvojen huomautuksen avulla määritetylle paikallismuuttujalle määritetään tyhjäarvot salliva lauseke.
  4. Muiden kuin tyhjäarvojen huomautuksen avulla määritetyn periytyneen metodin ohittava metodi yrittää lieventää kyseistä sopimusta määrittämällä tyhjäarvot sallivan huomautuksen (kontravariantin palautuksen kielto).
  5. Metodi ohittaa periytyneen metodin, jolla on tyhjäarvot salliva määritys vähintään yhdelle sen parametreista. Metodi yrittää tiukentaa kyseistä tyhjäarvosopimusta määrittämällä muiden kuin tyhjäarvojen huomautuksen sen vastaavalle parametrille (kovarianttien parametrien kielto).

Edellä olevaa lauseketta pidetään tyhjäarvot sallivana, jos sen staattisesti tiedetään palauttavan arvon null tai jos se määritetään tyhjäarvot sallivan huomautuksen avulla.

Virhe

Tyhjäarvoisten huomautusten ja liittymien välinen ristiriita

Tämän asetuksen mukaan kääntäjä tuottaa joko virheen tai varoituksen havaitessaan jonkin seuraavista tilanteista:

  1. Muiden kuin tyhjäarvojen huomautuksen avulla määritetty metodi palauttaa lausekkeen, jonka staattisesti tiedetään palauttavan tyhjäarvon jossakin virrassa.
  2. Lauseke, jonka staattisesti tiedetään palauttavan tyhjäarvon jossakin virrassa, välitetään argumenttina metodikutsussa, jossa kutsutun metodin vastaava parametri määritetään muiden kuin tyhjäarvojen huomautuksen avulla.
  3. Muiden kuin tyhjäarvojen huomautuksen avulla määritetylle paikallismuuttujalle määritetään lauseke, jonka staattisesti tiedetään palauttavan tyhjäarvon jossakin virrassa.

Virhe

Tarkistamaton muunto huomautuksettomasta tyypistä @NonNull-tyyppiin

Tämän asetuksen mukaan kääntäjä tuottaa joko virheen tai varoituksen havaitessaan jonkin seuraavista tilanteista:

  1. Muiden kuin tyhjäarvojen huomautuksen avulla määritetty metodi palauttaa lausekkeen, jolle ei ole käytettävissä riittävästi tyhjyystietoja, jotta voitaisiin osoittaa staattisesti, ettei mikään virta siirrä tyhjäarvoa ajon aikana.
  2. Lauseke, jolle ei ole käytettävissä riittävästi tyhjyystietoja, jotta voitaisiin osoittaa staattisesti, ettei se palauta koskaan tyhjäarvoa ajon aikana, välitetään argumenttina metodikutsussa, jossa kutsutun metodin vastaava parametri määritetään muiden kuin tyhjäarvojen huomautuksen avulla.
  3. Muiden kuin tyhjäarvojen huomautuksen avulla määritetylle paikallismuuttujalle määritetään lauseke, jolle ei ole käytettävissä riittävästi tyhjyystietoja, jotta voitaisiin osoittaa staattisesti, ettei se palauta koskaan tyhjäarvoa ajon aikana.

Tarkistamaton muunto johtuu tavallisesti muiden huomautuksettomien muuttujien tai metodien käytöstä.

Varoitus

Ylimääräinen tyhjäarvon tarkistus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen käytettäessä muiden kuin tyhjäarvojen huomautusta, vaikka sama vaikutus on jo saavutettu sovelletun oletuksen avulla nykyisessä sijainnissa. Tällainen oletus voidaan asettaa ottamalla käyttöön asetus Käytä muuta kuin tyhjäarvoa työtilakohtaisena (tai projektikohtaisena) oletuksena tai käyttämällä @NonNullByDefault-huomautusta.

Varoitus

Paketista puuttuu @NonNullByDefault-huomautus

Kun tämä asetus on käytössä, kääntäjä tuottaa virheen tai varoituksen seuraavissa tapauksissa:

  1. Kun paketti ei sisällä oletustyhjyyden huomautusta puuttuvan package-info.java-tiedoston tai package-info.java-tiedoston puuttuvan oletustyhjyyden huomautuksen vuoksi.
  2. Kun tyyppi oletuspaketin sisällä ei sisällä oletustyhjyyden huomautusta.

Ohita

Käytä oletushuomautuksia tyhjäarvomäärityksissä

Kun tämä asetus on käytössä, kääntäjä käyttää tyhjäarvomääritysten oletushuomautuksia. Nämä huomautukset sisältyvät org.eclipse.jdt.annotation-resurssijoukon Eclipse SDK -työkaluihin.

Voit määrittää erilaisia projekteissa käytettäviä huomautusten nimiä. Muista kuitenkin, että Eclipse-kääntäjä tukee vain oletushuomautuksissa määritettyä semantiikkaa:

  • org.eclipse.jdt.annotation.Nullable: Java-huomautustyypin tarkennettu nimi, joka käytettynä metodin allekirjoituksen tai muuttujan esittelyn tyypissä tulkitaan määrityksenä, jonka mukaan tyhjäarvo sallitaan kyseisessä sijainnissa.
    Tällä hetkellä tuetaan seuraavia sijainteja: metodin parametrit, metodin paluulaji ja paikallismuuttujat.
  • org.eclipse.jdt.annotation.NonNull: Java-huomautustyypin tarkennettu nimi, joka käytettynä metodin allekirjoituksen tai muuttujan esittelyn tyypissä tulkitaan määrityksenä, jonka mukaan tyhjäarvoa ei sallita kyseisessä sijainnissa.
    Tällä hetkellä tuetaan seuraavia sijainteja: metodin parametrit, metodin paluulaji ja paikallismuuttujat.
  • org.eclipse.jdt.annotation.NonNullByDefault: Java-huomautustyypin tarkennettu nimi. Kun sitä käytetään elementissä ilman huomautuksen argumenttia, kaikkia huomautuksia sisältävän elementin metodin allekirjoitusten huomautuksettomia tyyppejä käsitellään ikään kuin ne olisi määritetty muiden kuin tyhjäarvojen huomautuksen avulla.
    Jos huomautusta käytetään sitä vastoin argumentin kanssa, jonka vakioarvo on epätosi, huomautuksia sisältävän elementin kaikki vastaavat ulomman alueen oletusarvot peruutetaan.

Käytössä

Kun Käsittele edellä mainitut virheet vakavina kääntövirheinä -asetus on käytössä, kaikki tuotetut virheet (sekä vakavat että määritettävät) tuottavat koodin, jota ei voi toteuttaa. Jos asetus ei ole käytössä, koodi voidaan suorittaa, kunhan se ei sisällä vakavia virheitä (syntaksivirheitä, kirjoitusvirheitä tai mitään Javan kielimäärityksen mukaisia virheitä).

Aiheeseen liittyviä käsitteitä

Ongelmat-näkymä
Pikakorjaus
Java-koontitoiminto