Java fordítási hibák/figyelmeztetések beállításai

A Hibák/figyelmeztetések beállításait a Hibák/figyelmeztetések oldal megnyitása Java > Fordító > Hibák/figyelmeztetések oldalon adhatja meg.

Kódstílus

Beállítás

Leírás

Alapértelmezés

Nem statikus hozzáférés egy statikus taghoz

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha egy statikus mezőhöz vagy metódushoz hozzáférése kifejezésfogadóval történik. Egy statikus tagra vonatkozó hivatkozást típusnévvel kell képezni.

Figyelmeztetés

Közvetett hozzáférés egy statikus taghoz

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor egy statikus mezőhöz vagy metódushoz közvetetten történik hozzáférés. Egy felület statikus mezőjét a deklaráló típusnévvel kell minősíteni.

Figyelmen kívül hagyás

Minősítetlen hozzáférés példánymezőhöz

Ha engedélyezett, akkor a fordító nem minősített mező elérése esetén (pl. kihagy egy 'this' kulcsszót) hibát jelez vagy figyelmeztetést ad.

Figyelmen kívül hagyás

Hozzáférés beágyazó típus nem hozzáférhető tagjához

Ha engedélyezett, akkor a fordító hibát vagy figyelmeztetést jelez, amikor egy beágyazó típus nem hozzáférhető tag hozzáférését emulálja. Az ilyen hozzáférések befolyásolhatják a teljesítményt.

Figyelmen kívül hagyás

Paraméterhozzárendelés

Paraméterhez értéket rendelni általában szegényes programozási stílusra utal. Ha a beállítás engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi az ilyen helyzeteket.

Figyelmen kívül hagyás

Külsőleg nem elérhetővé tett karaktersorozatok

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi a külsőleg elérhetővé nem tett karaktersorozat literálokat (azokat, amelyek nincsenek felcímkézve a //$NON-NLS-<n>$ jelölővel), vagy a karaktersorozathoz nem tartozó, külsőleg elérhetővé nem tett karaktersorozat címkéket.

Figyelmen kívül hagyás

Nem dokumentált üres blokk

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor magyarázó megjegyzések nélküli üres utasítással találkozik.

Figyelmen kívül hagyás

Nem try-with-resource utasítással kezelt erőforrások (1.7 vagy magasabb szint)

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad, ha egy helyi változó 'java.lang.AutoCloseable' típusú értéket tartalmaz és kifejezetten meghívja a 'close()' metódust az adott erőforrásra, de az erőforrás kezelését nem try-with-resources blokk végzi.

Figyelmen kívül hagyás

Konstruktornevet viselő metódusok

A metódusok elnevezése konstruktornévvel általában szegényes programozási stílusra utal. Ha a beállítás engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi az ilyen helyzeteket.

Figyelmeztetés

A metódus lehet statikus

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést ad az olyan metódusok esetén, amelyek private vagy final módosítóval rendelkeznek, és amelyek csak statikus tagokra hivatkoznak.

Figyelmen kívül hagyás

A metódus lehetne statikus

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést ad az olyan metódusok esetén, amelyek nem rendelkeznek private vagy final módosítóval, és amelyek csak statikus tagokra hivatkoznak. Megjegyzés: a metódusok a származtatott osztályokban újradefiniálhatók, így ha a "potenciálisan statikus" metódust statikussá teszi, ez hibát okozhat a meglévő ügyfelekben.

Figyelmen kívül hagyás

Lehetséges programozási problémák

Azonos értékek összehasonlítása ('x == x')

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést ad, ha egy összehasonlítás azonos operandusokat (például 'x == x') tartalmaz.

Figyelmeztetés

A hozzárendelésnek nincs hatása (pl.: 'x = x')

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, ha egy hozzárendelésnek nincs hatása (pl.'x = x').

Figyelmeztetés

Lehetséges véletlen logikai hozzárendelés (például 'if (a = b)')

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, valahányszor lehetséges véletlen logikai hozzárendelést talál (például 'if (a = b)').

Figyelmen kívül hagyás

Típusátalakítások és -visszaalakítások

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor típusátalakítással vagy -visszaalakítással találkozik. Az automatikus típusátalakítás negatív hatással lehet a teljesítményre.

Figyelmen kívül hagyás

Char tömb használata karaktersorozat összefűzésénél

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha karaktersorozat összefűzésénél egy char[] kifejezést használ:

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

Figyelmeztetés

Vararg argumentumok nem pontos típus egyezése

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor vararg argumentumok nem pontos típus egyezésével találkozik.

Figyelmeztetés

Üres utasítás

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, ha üres utasítással találkozik (pl. felesleges pontosvesszővel).

Figyelmen kívül hagyás

Nem használt objektumfoglalás

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, ha egy nem használt lefoglalt objektumot talál, például

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

Figyelmen kívül hagyás

Hiányos 'switch' esetek a felsorolásban

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, ha olyan switch utasítással találkozik, amely nem tartalmaz sem case utasításokat a hivatkozott enum minden enum konstansához, sem alapértelmezett esetet. Feltételezzük, hogy az alapértelmezett eset lefedi a hiányzó case utasításokat bármely enum konstans esetén, így a fordító néma, amennyiben jelen van alapértelmezett eset, kivéve, ha engedélyezett az "Akkor is jelez, ha létezik 'default' eset" (lásd alább) lehetőség.

Figyelmeztetés

Akkor is jelez, ha létezik 'default' eset

Amikor engedélyezett, akkor a fordító akkor is ad hibát vagy figyelmeztetést, ha egy enum konstans nincs lefedve esettel, ha létezik alapértelmezett eset. Ezzel a beállítással azonosíthatja a hiányzó case utasításokat, amikor új enum konstanst ad hozzá.

Ki

A 'switch' utasításból hiányzik a 'default' eset

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad, ha egy 'switch' utasításnál nincs alapértelmezett eset. Ennek következtében hiányzó 'default' esetet jelez még akkor is, ha a 'case' utasítások egyébként lefedik az összes lehetséges értéket. A Java nyelv specifikációja a bináris kompatibilitás miatt ajánlja ezt a figyelmeztetést.

Figyelmen kívül hagyás

'switch' eset átesés

Engedélyezésekor a fordító hibát vagy figyelmeztetést jelez, ha egy esetbe lépés egy azt megelőző, nem üres eseten keresztül történt.

Figyelmen kívül hagyás

Rejtett catch blokk

Egy try utasításban a catch blokkok magukban rejthetnek más catch blokkokat, pléldául:

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

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi az ellenőrzött kifejezéseknek megfelelő catch blokkok elrejtését.

Figyelmeztetés

A 'finally' blokk nem normálisan fejeződik be

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, ha egy 'finally' utasítás nem normálisan végződik (pl. return utasítást tartalmaz).

Figyelmeztetés

Halott kód (például 'if (false)')

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, ha halott kódot talál (például 'if (false)' ).

Figyelmeztetés

Erőforrásszivárgás

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad, ha egy helyi változó 'java.lang.AutoCloseable' (megfelelési szint >= 1.7) vagy 'java.io.Closeable' (megfelelési szint <= 1.6) típusú értéket tartalmaz és a folyamelemzés szerint nem kerül sor helyi 'close()' hívásra az adott értékre.

Figyelmeztetés

Lehetséges erőforrásszivárgás

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad, ha egy helyi változó 'java.lang.AutoCloseable' (megfelelési szint >= 1.7) vagy 'java.io.Closeable' (megfelelési szint <= 1.6) típusú értéket tartalmaz és a folyamelemzés szerint nem kerül sor helyi 'close()' hívásra az adott értékre az összes végrehajtási útvonalon.

Figyelmen kívül hagyás

Sorosítható osztály serialVersionUID nélkül

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, ha 'java.io.Serializable' csomagot megvalósító típus nem tartalmazza a serialVersionUID mezőt.

Figyelmeztetés

Hiányzó synchronized módosító az örökölt metódusban

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, ha egy olyan örökölt metódust talál, amelyből hiányzik a synchronized módosító.

Figyelmen kívül hagyás

Az osztály újradefiniálja az 'equals()' metódust, de a 'hashCode()' metódust nem

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, ha egy olyan osztályt talál, amely újradefiniálja az 'equals()' metódust, a 'hashCode()' metódust azonban nem.

Figyelmen kívül hagyás

Névárnyékolás és ütközések

A mező deklaráció más mezőt vagy változót rejt

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha egy mező deklaráció elrejt egy másik örökölt mezőt.

Figyelmen kívül hagyás

Helyi változó deklaráció más mezőt vagy változót rejt

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha egy lokális változó deklaráció elrejt egy másik mezőt vagy változót.

Figyelmen kívül hagyás

Konstruktor vagy beállító metódus paraméterek tartalmazása

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha egy konstruktor vagy beállító metódus paraméter elrejt egy másik mezőt vagy változót.

Ki

Típus paraméter másik típust rejt

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha például egy belső osztály típus paramétere külső típust rejt el.

Figyelmeztetés

A metódus nem definiál újra csomagban látható metódust

Egy csomag alapértelmezett metódusa nem látható egy másik csomagban, így nem lehet újradefiniálni. Ha a beállítás engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi az ilyen helyzeteket.

Figyelmeztetés

Védett 'Object' metódussal ütköző felület metódus

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi, ha egy felület egy nem örökölt objektum metódussal inkompatibilis metódust határoz meg. A konfliktus megoldásáig ilyen felület nem valósítható meg, például:

interface I {
   int clone();
}

Figyelmeztetés

Elavult és korlátozott API

Elavult API

Engedélyezése esetén a fordító hibaként vagy figyelmeztetésként jelzi az elavult API használatát.

Figyelmeztetés

Elavult API elavult kódban alkalmazásának jelzése

Ha engedélyezve van, akkor a fordító jelzi az elavult API elavult kódban történő használatát. A probléma fontosságát az "Elavult API" beállításnál adhatja meg.

Ki

Elavult metódus újradefiniálásának vagy megvalósításának jelzése

Engedélyezésekor a fordító jelzi az elavult metódus újradefiniálását vagy megvalósítását. A probléma fontosságát az "Elavult API" beállításnál adhatja meg.

Ki

Tiltott hivatkozások (hozzáférési szabályok)

Engedélyezésével a fordító jelzi a hozzáférési szabályokban megadott tiltott hivatkozást.

Hiba

Nem javasolt hivatkozás (hozzáférési szabályok)

Engedélyezésével a fordító jelzi a hozzáférési szabályokban megadott nem javasolt hivatkozást.

Figyelmeztetés

Szükségtelen kód

A lokális változó értéke nincs használatban

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést ad, amikor deklarálva van egy helyi változó, de annak értéke a hatókörön belül soha nem kerül felhasználásra.

Figyelmeztetés

A paraméter értéke nincs használatban

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést ad, amikor deklarálva van egy paraméter, de annak értéke a hatókörön belül soha nem kerül felhasználásra.

Figyelmen kívül hagyás

Figyelmen kívül hagyás újradefiniáló és megvalósító metódusokban

Ha engedélyezve van, akkor a fordító nem ad hibát vagy figyelmeztetést, amikor egy paraméter deklarálva van, de soha nincs használatban a saját hatókörén belül egy olyan metódusban, amely újradefiniál vagy megvalósít egy másik metódust.

Be

A '@param' címkével dokumentált paraméterek figyelmen kívül hagyása

Ha engedélyezett, akkor a fordító nem jelez hibát vagy figyelmeztetést, amikor olvasatlan paraméter '@param' címkével van dokumentálva.

Be

Nem használt importálás

Ha engedélyezve van, akkor a fordító hibaként vagy figyelmeztetésként jelzi a használaton kívüli importálási hivatkozásokat.

Figyelmeztetés

Nem használt privát tag

Ha engedélyezve van, a fordító hibát vagy figyelmeztetést ad, amikor egy privát tag deklarálva van, de soha nem kerül felhasználásra egyazon egységen belül.

Figyelmeztetés

Szükségtelen 'else' utasítás

Ha engedélyezett, akkor a fordító hibát vagy figyelmeztetést jelez, valahányszor engedélyezett else utasítást észlel (pl.: if (condition) return; else doSomething();).

Figyelmen kívül hagyás

Szükségtelen típusmódosítás vagy 'instanceof' művelet

Ha engedélyezett, akkor a fordító hibát vagy figyelmeztetést jelez, valahányszor szükségtelen típusátalakítás vagy 'instanceof' műveletet észlel (pl.: if (object instanceof Object) return;).

Figyelmen kívül hagyás

Kivétel dobás szükségtelen deklarációja

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor megtörtént kivétel szükségtelen deklarációjával találkozik.

Figyelmen kívül hagyás

Figyelmen kívül hagyás újradefiniáló és megvalósító metódusokban

Ha engedélyezve van, akkor a fordító nem ad hibát vagy figyelmeztetést, amikor kivétel dobás szükségtelen deklarálásával találkozik egy olyan metódusban, amely újradefiniál vagy megvalósít egy másik metódust.

Be

'@throws' vagy '@exception' címkékkel dokumentált kivételek figyelmen kívül hagyása

Ha engedélyezve van, akkor a fordító nem ad hibát vagy figyelmeztetést, amikor egy '@throws' vagy '@exception' címkével dokumentált kivétel dobás szükségtelen deklarálásával találkozik.

Be

'Exception' és 'Throwable' típus figyelmen kívül hagyása

Amikor engedélyezett, akkor a fordító nem ad ki hibát vagy figyelmeztetést, valahányszor szükségtelen 'Exception' és 'Throwable' kivétel deklarációt talál.

Be

Nem használt 'break' vagy 'continue' címke

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor használaton kívüli 'break' vagy 'continue' címkével találkozik.

Figyelmeztetés

Redundáns szülő felület

Ha engedélyezve van, akkor a fordító nem ad hibát vagy figyelmeztetést, amikor egy olyan típust talál, amely explicit módon megvalósít egy felületet, amelyet már megvalósít valamelyik őstípusa.

Figyelmen kívül hagyás

Általános típusok

Nem ellenőrzött általános típus művelet

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor nem ellenőrzött általános típus művelettel találkozik.

Figyelmeztetés

Nyers típusok használata

Engedélyezésekor a fordító hibát vagy figyelmeztetést jelez, valahányszor nyers típus használatát érzékeli (például List a List<String> helyett).

Figyelmeztetés

Általános típus paraméter végleges típus határral deklarálva

Engedélyezésével a fordító hibát jelez vagy figyelmeztetést ad, amikor végleges határt magába foglaló típus határral találkozik.

Figyelmeztetés

Elkerülhetetlen általános típusú problémák figyelmen kívül hagyása

Ha engedélyezve van, a fordító hibát vagy figyelmeztetést ad még akkor is, ha egy olyan általános típusú problémát észlel, amelyet a programozó nem tudott volna elkerülni. Például egy típus esetén kényszeríthető a nyers típusok használata a metódus aláírásokban és visszatérési típusokban, mivel a metódusok, amelyeket az őstípusból felülbírál, úgy vannak deklarálva, hogy első helyen nyers típusokat használjanak.

A hivatkozott nyers API-k általánosítása után vagy egyáltalán nem lát hibát (ha az általános típusok helyesek voltak), vagy fordítási hibákat lát (ha az API máshogy lett általánosítva).

Ki

Annotációk

Hiányzó '@Override' annotáció

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor olyat talál, hogy egy metódus újradefiniál egy másik megvalósított metódust és hiányzik az '@Override' annotáció.

Figyelmen kívül hagyás

Felület metódusok megvalósításainak tartalmazása (1.6 vagy magasabb szint)

Ha engedélyezve van, akkor a fordító hibát vagy figyelmeztetést jelezi, amikor egy felületben deklarált metódus újradefiniálásával vagy megvalósításával találkozik, és hiányzik az '@Override' annotáció.
Megjegyzés: az '@Override' annotáció az ilyen metódusokhoz csak akkor engedélyezett, ha a fordító megfelelési szintje 1.6 vagy ennél magasabb, így ez a hiba vagy figyelmeztetés az 1.5 szintű kódban soha nem jelenik meg.

Be

Hiányzó '@Deprecated' annotáció

Ha engedélyezett, akkor a fordítóprogram hibát vagy figyelmeztetést ad ki, valahányszor olyan elavult típust talál, amelynél nincs '@Deprecated' annotáció.

Figyelmen kívül hagyás

Felső szintű felületként használt annotáció

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor olyan típust talál, ami annotációt valósít meg. Bár lehetséges, ez nem javasolt gyakorlatnak minősül.

Figyelmeztetés

Kezeletlen jelsor a '@SuppressWarnings' annotációban

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor ismeretlen tokent talál egy '@SuppressWarnings' annotációban.

Figyelmeztetés

'@SuppressWarnings' annotációk engedélyezése

Engedélyezése után a fordító feldolgozza a '@SuppressWarnings' annotációkat. Amikor tiltott, úgy viselkedik, mintha minden '@SuppressWarnings' annotáció el lenne távolítva.

Be

Nem használt '@SuppressWarnings' jelsor

Ha engedélyezve van, akkor a fordító hibát jelez vagy figyelmeztetést ad, amikor nem használt jelsorral találkozik egy '@SuppressWarnings' annotációban.

Figyelmeztetés

Elhagyható hibák kikapcsolása a '@SuppressWarnings' annotációval

Amikor engedélyezett, akkor a '@SuppressWarnings' annotáció a nem kötelező fordítási hibákat is kikapcsolja, vagyis azokat a beállításokat, amelyekhez itt "Hiba" van megadva. A kötelező fordítási hibák nem kapcsolhatók ki.

Ki

Nullelemzés

Null mutató hozzáférés

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor olyat talál, hogy egy biztosan nullértékű helyi változó kerül feloldásra. Megjegyzés: az elemzés nem minden null mutató hozzáférést képes megtalálni, lásd: Lehetséges null mutató hozzáférés.

Figyelmeztetés

Lehetséges null mutató hozzáférés

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor olyat talál, hogy egy esetlegesen nullértékű helyi változó kerül feloldásra. Az elemzés meglehetősen konzervatív, csak a gyanús eseteket vizsgálja.

Az elemzés minősége javítható null annotációk használatával, melyeket az Annotáció alapú nullelemzés engedélyezése lehetőséggel lehet engedélyezni.

Figyelmen kívül hagyás

Redundáns null ellenőrzés

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, valahányszor olyat talál, hogy olyan helyi változó értéke kerül tesztelésre, hogy null-e, ami nem lehet null.

Figyelmen kívül hagyás

'assert' utasítás belefoglalása a null elemzésekbe

Amikor engedélyezett, akkor a fordító figyelembe veszi az 'assert' utasítást a nullelemzés végrehajtásakor.

Ki

Annotáció alapú nullelemzés engedélyezése

Amikor engedélyezett, akkor a fordító értelmezi a @Nullable, @NonNull, és @NonNullByDefault annotációkat, melyek megadják, hogy egy adott típus tartalmazza-e a 'null' értéket.

Az elemzések hatását tovább vezérlik az alábbi részbeállítások.

Lásd még: Null annotációk használata.

Ki

Null specifikáció megsértése

A beállítástól függően a fordító hibát vagy figyelmeztetést ad ki, valahányszor észleli az alábbi helyzetek egyikét:

  1. Egy nem-null annotációval deklarált metódus nullképes kifejezést ad vissza.
  2. Nullképes kifejezés kerül átadásra argumentumként egy olyan metódusban, ahol a hívott metódus vonatkozó paramétere nem-null annotációval van deklarálva.
  3. Olyan helyi változóhoz kerül hozzárendelésre nullképes kifejezés, ami nem-null annotációval van deklarálva.
  4. Egy metódus, ami újradefiniál egy nem-null annotációval deklarált örökölt metódust, lazítani akarja a szerződést azzal, hogy nullképes annotációt ad meg (kontravariáns visszatérés tiltása).
  5. Egy metódus, ami újradefiniál egy olyan örökölt metódust, mely nullképes deklarációval rendelkezik legalább egy paraméteréhez, szorosabbra akarja fűzni azt a null szerződést azzal, hogy nem-null annotációt ad meg a vonatkozó paraméterhez (kovariáns paraméterek tiltása).

A fentiekben akkor tekintünk nullképesnek egy kifejezést, ha vagy statikusan ismert, hogy kiértékelése null, vagy pedig nullképes annotációval van deklarálva.

Hiba

Null annotációk és null következtetés közötti ütközés

A beállítástól függően a fordító hibát vagy figyelmeztetést ad ki, valahányszor észleli az alábbi helyzetek egyikét:

  1. Egy nem-null annotációval deklarált metódus olyan kifejezést ad vissza, amelyről statikusan ismert, hogy valamely folyamon null a kiértékelése.
  2. Olyan kifejezés kerül átadásra argumentumként egy olyan metódushívásban, ahol a hívott metódus vonatkozó paramétere nem-null annotációval van deklarálva, amelyről statikusan ismert, hogy valamely folyamban null a kiértékelése.
  3. Olyan kifejezés kerül átadásra argumentumként egy nem-null annotációval deklarált helyi változónak, amelyről statikusan ismert, hogy valamely folyamban null a kiértékelése.

Hiba

Ellenőrizetlen átalakítás annotáció nélküli típusról @NonNull típusra

A beállítástól függően a fordító hibát vagy figyelmeztetést ad ki, valahányszor észleli az alábbi helyzetek egyikét:

  1. Egy nem-null annotációval deklarált metódus olyan kifejezést ad vissza, melynél nem áll rendelkezésre elegendő információ annak megállapításához, hogy null-e, így nem lehet statikusan bizonyítani, hogy egyetlen folyam sem fog nullértéket átadni a futás során.
  2. Olyan kifejezés kerül átadásra argumentumként egy olyan metódushívásban, ahol a hívott metódus vonatkozó paramétere nem-null annotációval van deklarálva, amelyhez nem áll rendelkezésre elegendő információ annak statikus bizonyításához, hogy sohasem lesz null a kiértékelése a futás során.
  3. Olyan kifejezés kerül hozzárendelésre egy nem-null annotációval deklarált helyi helyi változóhoz, amelyhez nem áll rendelkezésre elegendő információ annak statikus bizonyításához, hogy sohasem lesz null a kiértékelése a futás során.

Az ellenőrizetlen átalakítás általában más, annotációval nem rendelkező változók vagy metódusok használatának következménye.

Figyelmeztetés

Redundáns null annotáció

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad ki, amikor olyan helyzetben van alkalmazva nem-null annotáció, ahol ugyanezt a hatást már eléri az adott helyen alkalmazható alapértelmezés. Ilyen alapértelmezést a Nem-null használata a munkaterületre (vagy a projektre) alapértelmezésként beállítás engedélyezésével vagy a @NonNullByDefault annotáció használatával állítható be.

Figyelmeztetés

Hiányzó '@NonNullByDefault' annotáció a csomaghoz

Amikor engedélyezett, akkor a fordító hibát vagy figyelmeztetést ad az alábbi helyzetekben:

  1. Amikor egy csomag nem tartalmaz alapértelmezett null annotációt, mert hiányzik a package-info.java fájl vagy nincs benne alapértelmezett null annotáció.
  2. Amikor egy alapértelmezett csomagon belüli típus nem tartalmaz alapértelmezett null annotációt:

Figyelmen kívül hagyás

Alapértelmezett annotációk használata null specifikációknak

Amikor engedélyezett, akkor a fordító az alapértelmezett annotációkészletet használja null specifikációknak. Ezeket az annotációkat az Eclipse SDK org.eclipse.jdt.annotation kötege tartalmazza.

Megadhat más annotációneveket, hogy azokat használja a projektekben, de fontos, hogy az Eclipse fordító csak az alapértelmezett annotációkban megadott szemantikát támogatja:

  • org.eclipse.jdt.annotation.Nullable: Egy Java annotációtípus teljes képzésű neve, amelyet ha alkalmaz egy metódusaláírásban vagy változódeklarációban található típusra, akkor a rendszer annak megadásaként értelmezi, hogy a null legális érték az adott pozícióban.
    A jelenleg támogatott pozíciók: metódusparaméterek, metódusok visszatérési típusa, helyi változók.
  • org.eclipse.jdt.annotation.NonNull: Egy Java annotációtípus teljes képzésű neve, amelyet ha alkalmaz egy metódusaláírásban vagy változódeklarációban található típusra, akkor a rendszer annak megadásaként értelmezi, hogy a null nem legális érték az adott pozícióban.
    A jelenleg támogatott pozíciók: metódusparaméterek, metódusok visszatérési típusa, helyi változók.
  • org.eclipse.jdt.annotation.NonNullByDefault: Egy Java annotációtípus teljes képzésű neve. Ha alkalmazza egy annotáció paraméterrel nem rendelkező elemre, akkor az annotált elemen belüli metódusaláírásokban található összes olyan típust, amely nem rendelkezik annotációval, úgy tekinti a rendszer, mintha a nem-null annotációval lenne megadva.
    Ezzel szemben ha úgy alkalmazza az annotációt, hogy argumentumként megadja a 'false' konstanst, akkor a külsőbb hatókörökben megadott összes vonatkozó alapértelmezés meg lesz szüntetve az annotált elemnél.

Be

Amikor a Fenti hibák kezelése végzetes fordítási hibákként beállítás engedélyezett, akkor az összes előállított hiba, akár végzetes, akár konfigurálható, nem végrehajtható kódhoz vezet. Ha tiltott, akkor a kód végrehajtható mindaddig, amíg nincs benne végzetes hiba (szintaktikai hiba, típushiba, vagy a Java nyelv specifikációja szerinti egyéb hiba).

Kapcsolódó fogalmak

Problémák nézet
Gyorsjavítás
Java összeépítő