Preferencje błędów/ostrzeżeń kompilacji Java

Strona preferencji Otwiera stronę preferencji Błędy/ostrzeżenia Java > Kompilator > Błędy/ostrzeżenia pozwala określić preferencje dotyczące ustawień błędów i ostrzeżeń.

Styl kodu

Opcja

Opis

Wartość domyślna

Niestatyczny dostęp do składowej static

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku dostępu do pola lub metody static za pomocą odbiornika wyrażenia. Odwołanie do składowej static powinno być kwalifikowane nazwą typu.

Ostrzeżenie

Pośredni dostęp do składowej static

Jeśli ta opcja jest włączona, kompilator zgłosi błąd lub ostrzeżenie w przypadku pośredniego dostępu do pola lub metody static. Pole static interfejsu powinno być kwalifikowane za pomocą nazwy typu deklarującego.

Ignorowanie

Niekwalifikowany dostęp do pola instancji

Gdy ta opcja jest włączona, kompilator zgłosi błąd lub ostrzeżenie w przypadku niekwalifikowanego dostępu do pola (np. brak operatora this).

Ignorowanie

Dostęp do niedostępnej składowej typu obejmującego

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku emulacji dostępu do niedostępnej składowej typu obejmującego. Taki dostęp może wpływać na wydajność.

Ignorowanie

Przypisanie parametru

Przypisywanie wartości parametrowi uznaje się ogólnie za niewłaściwy sposób programowania. Po włączeniu opcji kompilator zasygnalizuje taką sytuację jako błąd lub ostrzeżenie.

Ignorowanie

Łańcuchy nieeksternalizowane

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku nieeksternalizowanego literału łańcucha (pozbawionego znacznika //$NON-NLS-<n>$) lub nieeksternalizowanych znaczników łańcucha nienależących do łańcucha.

Ignorowanie

Nieudokumentowany pusty blok

Jeśli ta opcja jest włączona, kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania pustej instrukcji blokowej bez wyjaśniającego komentarza.

Ignorowanie

Zasób nie jest zarządzany za pomocą instrukcji try-with-resource (wersja 1.7 lub nowsza)

Po włączeniu tej opcji kompilator zgłasza błąd lub ostrzeżenie, gdy w zmiennej lokalnej jest przechowywana wartość o typie „java.lang.AutoCloseable” i gdy metoda „close()” jest jawnie wywoływana na tym zasobie, ale zasób nie jest zarządzany w obrębie bloku try-with-resources.

Ignorowanie

Metoda o nazwie konstruktora

Nadawanie metodzie nazwy konstruktora jest uznawane za zły styl programowania. Po włączeniu opcji kompilator zasygnalizuje taką sytuację jako błąd lub ostrzeżenie.

Ostrzeżenie

Metoda może być statyczna

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku metod prywatnych lub finalnych, które odwołują się tylko do składowych statycznych.

Ignorowanie

Metoda może potencjalnie być statyczna

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku metod innych niż metody prywatne lub metody finalne, które odwołują się tylko do składowych statycznych. Należy pamiętać, że metody mogą być przesłaniane w podklasie, więc przekształcenie metody potencjalnie statycznej w metodę statyczną może zakłócić działanie istniejących klientów.

Ignorowanie

Potencjalne problemy programistyczne

Porównywanie identycznych wartości ('x == x')

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku porównań uwzględniających identyczne operandy (na przykład x == x).

Ostrzeżenie

Bezskuteczne przypisanie (na przykład: x = x)

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku bezskutecznego przypisania (na przykład x = x).

Ostrzeżenie

Możliwe przypadkowe przypisanie boolowskie, na przykład: if (a = b))

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania potencjalnie przypadkowego przypisania boolowskiego (np. if (a = b)).

Ignorowanie

Konwersje pakowania i wypakowywania

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania konwersji pakowania lub wypakowywania. Automatyczne pakowanie może mieć negatywny wpływ na wydajność.

Ignorowanie

Użycie tablicy char w konkatenacji łańcucha

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku użycia wyrażenia char[] w konkatenacji łańcucha, np.

"Witaj" + new char[]{'s','w','i','e','c','i','e'}

Ostrzeżenie

Niedokładne dopasowanie typów dla argumentów vararg

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania niedokładnego dopasowania typów dla argumentów vararg.

Ostrzeżenie

Pusta instrukcja

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania pustej instrukcji (np. nadmiarowego średnika).

Ignorowanie

Przydział obiektu nieużywanego

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania przydzielonego obiektu, który nie jest używany, na przykład:

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

Ignorowanie

Niekompletne przypadki lub wyliczenia instrukcji „switch”

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania instrukcji switch, która nie zawiera instrukcji case dla każdej stałej wyliczeniowej przywoływanego typu wyliczeniowego ani przypadku default. Przypadek default ma pokrywać niezgodne instrukcje case dla dowolnej stałej wyliczeniowej, więc kompilator ignoruje obecność przypadków default, chyba że jest zaznaczona opcja „Sygnalizuj, nawet gdy przypadek 'default' istnieje” (patrz poniżej).

Ostrzeżenie

Sygnalizuj, nawet gdy przypadek „default” istnieje

Po włączeniu tej opcji kompilator dodatkowo zgłasza błąd lub ostrzeżenie, gdy stała wyliczeniowa nie jest pokryta przez instrukcję case, nawet gdy istnieje przypadek default. Ta opcja jest pomocna przy wykrywaniu brakujących instrukcji case po dodaniu nowej stałej wyliczeniowej.

Wyłączone

W instrukcji „switch” brakuje przypadku „default”

Po włączeniu kompilator zgłosi błąd lub ostrzeżenie w przypadku, gdy w instrukcji „switch” brakuje przypadku „default”. W rezultacie brakująca instrukcja „default” zostanie oznaczona nawet w przypadku, gdy wszystkie możliwe wartości są pokryte przez instrukcje „case”. Użycie tego ostrzeżenia jest zalecane w specyfikacji języka Java na potrzeby zgodności binarnej.

Ignorowanie

Nieosiągnięcie przypadku 'switch'

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli do przypadku można wejść przez niedojście do skutku poprzedniego, niepustego przypadku.

Ignorowanie

Ukryty blok catch

Niektóre bloki catch mogą ukrywać inne (lokalnie względem instrukcji try), np.

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

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku ukrytych bloków catch odpowiadających sprawdzonym wyjątkom.

Ostrzeżenie

Nieprawidłowe zakończenie bloku finally

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku nieprawidłowego zakończenia instrukcji finally (np. z instrukcją return).

Ostrzeżenie

Martwy kod (np. 'if (false)')

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania martwego kodu, na przykład if (false).

Ostrzeżenie

Wyciek zasobów

Po włączeniu tej opcji kompilator zgłasza błąd lub ostrzeżenie, gdy w zmiennej lokalnej jest przechowywana wartość o typie „java.lang.AutoCloseable” (zgodność z wersją >= 1.7) lub wartość o typie „java.io.Closeable” (zgodność z wersją <= 1.6) i gdy analiza przepływu wskazuje, że metoda „close()” nie jest lokalnie wywoływana na tej wartości.

Ostrzeżenie

Potencjalny wyciek zasobów

Po włączeniu tej opcji kompilator zgłasza błąd lub ostrzeżenie, gdy w zmiennej lokalnej jest przechowywana wartość o typie „java.lang.AutoCloseable” (zgodność z wersją >= 1.7) lub wartość o typie „java.io.Closeable” (zgodność z wersją <= 1.6) i gdy analiza przepływu wskazuje, że metoda „close()” nie jest lokalnie wywoływana na tej wartości we wszystkich ścieżkach wykonania.

Ignorowanie

Klasa możliwa do serializowania bez identyfikatora serialVersionUID

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, gdy typ implementujący interfejs java.io.Serializable nie zawiera pola serialVersionUID.

Ostrzeżenie

Brak modyfikatora synchronized w metodzie dziedziczonej

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania metody dziedziczonej, która jest pozbawiona zsynchronizowanego modyfikatora.

Ignorowanie

Klasa przesłania metodę equals(), ale nie przesłania metody hashCode()

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania klasy, która przesłania metodę equals(), ale nie przesłania metody hashCode().

Ignorowanie

Przesłanianie i konflikty nazw

Deklaracja pola ukrywa inne pole lub inną zmienną

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli deklaracja pola ukrywa inne odziedziczone pole.

Ignorowanie

Deklaracja zmiennej lokalnej ukrywa inne pole lub inną zmienną

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli deklaracja zmiennej lokalnej ukrywa inne pole lub inną zmienną.

Ignorowanie

Uwzględnij parametry konstruktora lub metody ustawiającej

Po włączeniu tej opcji kompilator dodatkowo zgłosi błąd lub ostrzeżenie, jeśli parametr konstruktora lub procedury ustawiającej ukrywa inne pole lub inną zmienną.

Wyłączone

Parametr typu ukrywa inny typ

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli na przykład parametr typu klasy wewnętrznej ukrywa typ zewnętrzny.

Ostrzeżenie

Metoda nie przesłania metody widocznej w pakiecie.

Domyślna metoda pakietu nie jest widoczna w innym pakiecie i dlatego nie można jej przesłonić. Po włączeniu opcji kompilator zasygnalizuje taką sytuację jako błąd lub ostrzeżenie.

Ostrzeżenie

Konflikt metody interfejsu z chronioną metodą Object

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku, gdy interfejs definiuje metodę niezgodną z niedziedziczoną metodą klasy Object. Do momentu rozwiązania tego konfliktu, takiego interfejsu nie można zaimplementować, na przykład:

interface I {
   int clone();
}

Ostrzeżenie

Nieaktualny i ograniczony interfejs API

Nieaktualny interfejs API

Po włączeniu tej opcji kompilator zasygnalizuje użycie nieaktualnego interfejsu API jako błąd lub ostrzeżenie.

Ostrzeżenie

Sygnalizuj użycie nieaktualnej funkcji API w nieaktualnym kodzie

Po włączeniu tej opcji kompilator zasygnalizuje użycie nieaktualnego interfejsu API w nieaktualnym kodzie. Istotność tego problemu kontroluje opcja Nieaktualny interfejs API.

Wyłączone

Sygnalizuj przesłanianie lub implementowanie nieaktualnej metody

Po włączeniu tej opcji kompilator zasygnalizuje przesłanianie lub implementowanie nieaktualnej metody. Istotność tego problemu kontroluje opcja Nieaktualny interfejs API.

Wyłączone

Zabronione odwołanie (reguły dostępu)

Po włączeniu tej opcji kompilator zasygnalizuje zabronione odwołanie określone w regułach dostępu.

Błąd

Niezalecane odwołanie (reguły dostępu)

Po włączeniu tej opcji kompilator zasygnalizuje niezalecane odwołanie określone w regułach dostępu.

Ostrzeżenie

Zbędny kod

Wartość zmiennej lokalnej nie jest używana

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli zmienna lokalna jest zadeklarowana, ale jej wartość nie jest używana w jej zasięgu.

Ostrzeżenie

Wartość parametru nie jest używana

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli parametr jest zadeklarowany, ale jego wartość nie jest używana w jego zasięgu.

Ignorowanie

Ignoruj w metodach przesłaniających i implementujących.

Po włączeniu tej opcji kompilator nie będzie zgłaszać błędu ani ostrzeżenia wtedy, gdy parametr został zadeklarowany, ale nigdy nie był używany w zasięgu w metodzie, która przesłania lub implementuje inną metodę.

Włączone

Ignoruj parametry oznaczone znacznikiem @param

Po włączeniu tej opcji kompilator nie będzie zgłaszać błędów ani lub ostrzeżeń w przypadku napotkania niewczytanego elementu, udokumentowanego znacznikiem @param.

Włączone

Nieużywane instrukcje importowania

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku nieużywanego odwołania do instrukcji importu.

Ostrzeżenie

Nieużywana składowa prywatna

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, jeśli składowa prywatna jest zadeklarowana, ale nie jest używana w obrębie tej samej jednostki.

Ostrzeżenie

Zbędna instrukcja 'else'

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zbędnej instrukcji else (np. "if (warunek) return; else zrobCos();").

Ignorowanie

Zbędne rzutowanie lub zbędna operacja instanceof

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zbędnego rzutowania lub zbędnej operacji instanceof (np. "if (object instanceof Object) return;").

Ignorowanie

Zbędna deklaracja zgłoszonego wyjątku

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zbędnej deklaracji zgłoszonego wyjątku.

Ignorowanie

Ignoruj w metodach przesłaniających i implementujących.

Po włączeniu tej opcji kompilator nie będzie zgłaszać błędu ani ostrzeżenia w przypadku napotkania zbędnej deklaracji zgłoszonego wyjątku w metodzie, która przesłania lub implementuje inną metodę.

Włączone

Ignoruj wyjątki udokumentowane za pomocą znaczników @throws lub @exception.

Po włączeniu tej opcji kompilator nie będzie zgłaszać błędu ani ostrzeżenia w każdym przypadku, gdy zbędna deklaracja zgłoszonego wyjątku jest udokumentowana za pomocą znacznika @throws lub @exception.

Włączone

Ignoruj obiekty Exception oraz Throwable

Po włączeniu tej opcji kompilator nie będzie zgłaszać błędu ani ostrzeżenia w przypadku napotkania zbędnej deklaracji wyjątku Exception i Throwable.

Włączone

Nieużywana etykieta „break” lub „continue”

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania nieobsługiwanej etykiety break lub continue.

Ostrzeżenie

Zbędny nadinterfejs

Po włączeniu tej opcji kompilator będzie zgłaszał błąd lub ostrzeżenie w przypadku napotkania typu jawnie implementującego interfejs, który już został zaimplementowany przez jego dowolny nadtyp.

Ignorowanie

Typy ogólne

Operacja na niekontrolowanym typie ogólnym

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania operacji na niekontrolowanym typie ogólnym.

Ostrzeżenie

Użycie typu surowego

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zastosowania typu surowego (np. typu List zamiast typu List<String>).

Ostrzeżenie

Zadeklarowano parametr typu ogólnego z powiązaniem typu final

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania powiązania typów z udziałem typu final.

Ostrzeżenie

Ignoruj nieuniknione problemy dotyczące typów ogólnych

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie nawet wtedy, gdy wykryje problem dotyczący typu ogólnego, którego programista nie mógł uniknąć. Typ może na przykład zostać zmuszony do użycia typów surowych w swoich sygnaturach metod i typach zwracanych, ponieważ przesłaniane przez niego metody typu nadtypu są zadeklarowane z typami surowymi.

Po uogólnieniu przywoływanych surowych interfejsów API albo nie będą zgłaszane żadne problemy (jeśli typy ogólne były poprawne), albo pojawią się błędy kompilacji (jeśli interfejs API został uogólniony w inny sposób).

Wyłączone

Adnotacje

Brak adnotacji @Override

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania metody przesłaniającej inną zaimplementowaną metodę bez adnotacji @Override.

Ignorowanie

Włącz implementacje metod interfejsu (wersja 1.6 lub nowsza)

Po włączeniu tej opcji kompilator także zgłosi błąd lub ostrzeżenie w przypadku napotkania metody przesłaniającej lub implementującej metodę zadeklarowaną w interfejsie, dla której nie określono adnotacji @Override.
Należy zauważyć, że adnotacja @Override jest dozwolona dla takich metod tylko wtedy, gdy poziom zgodności kompilatora to 1.6 lub wyższy. A zatem ten błąd lub ostrzeżenie nie będzie nigdy występowało dla kodu w wersji 1.5.

Włączone

Brak adnotacji @Deprecated

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania nieaktualnego typu bez dodatkowej adnotacji @Deprecated.

Ignorowanie

Adnotacja używana jako nadinterfejs

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania typu implementującego adnotację. Choć jest to możliwe, uważa się to za zły styl programowania.

Ostrzeżenie

Nieobsługiwany element w adnotacji @SuppressWarnings.

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania nieznanego elementu w adnotacji @SuppressWarnings.

Ostrzeżenie

Włącz adnotacje @SuppressWarnings

Po włączeniu tej opcji kompilator będzie przetwarzał adnotacje @SuppressWarnings. Wyłączenie tej opcji spowoduje, że kompilator będzie zachowywał się tak, jakby usunięto wszystkie adnotacje „@SuppressWarnings”.

Włączone

Nieużywany element @SuppressWarnings.

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania nieużywanego elementu w adnotacji @SuppressWarnings.

Ostrzeżenie

Pomiń błędy opcjonalne za pomocą adnotacji @SuppressWarnings

Po włączeniu tej opcji adnotacja „@SuppressWarnings” będzie również pomijać opcjonalne błędy kompilacji, tj. opcje ustawione tutaj jako „Błąd”. Nie można pomijać obowiązkowych błędów kompilacji.

Wyłączone

Analiza wartości NULL

Dostęp do wskaźnika pustego

Po włączeniu tej opcji, kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zmiennej lokalnej o wartości NULL, która została wyłuskana. Należy zauważyć, że analiza ta nie jest w stanie znaleźć wszystkich przypadków dostępu do wskaźnika pustego. Patrz Potencjalny dostęp do wskaźnika pustego.

Ostrzeżenie

Potencjalny dostęp do wskaźnika pustego

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie w przypadku napotkania zmiennej lokalnej o wartości NULL, do której zostało wycofane odwołanie. Analiza jest stosunkowo restrykcyjna, ponieważ uwzględniane są wyłącznie przypadki wykazujące nieprawidłowości.

Jakość tej analizy można poprawić, korzystając z adnotacji wartości NULL, które można włączyć za pomocą opcji Włącz analizę wartości NULL opartą na adnotacjach

Ignorowanie

Nadmiarowe sprawdzanie wartości NULL

Po włączeniu tej opcji, kompilator zgłosi błąd lub ostrzeżenie w razie wykrycia, że sprawdzana jest wartość NULL dla zmiennej lokalnej, która nie może mieć takiej wartości.

Ignorowanie

Uwzględnienie elementu assert podczas analizy wartości NULL

Po włączeniu tej opcji kompilator będzie uwzględniał instrukcje „assert” w czasie wykonywania analizy wartości NULL.

Wyłączone

Włącz analizę wartości NULL opartą na adnotacjach

Po włączeniu tej opcji kompilator będzie interpretował adnotacje @Nullable, @NonNull i @NonNullByDefault jako określające, czy w określonym typie może występować wartość NULL.

Wyniki tej analizy można w dalszym stopniu kontrolować za pomocą następujących opcji podrzędnych.

Patrz także Korzystanie z adnotacji wartości NULL.

Wyłączone

Naruszenie specyfikacji wartości NULL

W zależności od ustawienia tej opcji kompilator zgłosi błąd lub ostrzeżenie, gdy zostanie wykryta jedna z następujących sytuacji:

  1. Metoda zadeklarowana z adnotacją o braku wartości NULL zwraca wyrażenie z dopuszczalną wartością NULL.
  2. Wyrażenie z dopuszczalną wartością NULL jest przekazywane jako argument w wywołaniu metody, w przypadku której odpowiedni parametr jest zadeklarowany z adnotacją o braku wartości NULL.
  3. Wyrażenie z dopuszczalną wartością NULL jest przypisywane do zmiennej lokalnej, która jest zadeklarowana z adnotacją o braku wartości NULL.
  4. Metoda przesłaniająca dziedziczoną metodę zadeklarowaną z adnotacją o braku wartości NULL próbuje rozluźnić to ograniczenie przez określenie adnotacji o obecności wartości NULL (odmowa rozszerzania zakresu wartości zwracanej).
  5. Metoda przesłaniająca dziedziczoną metodę zadeklarowaną z adnotacją o obecności wartości NULL dla co najmniej jednego jej parametru próbuje zacieśnić tę deklarację przez określenie adnotacji o braku wartości NULL we własnym odpowiadającym parametrze (odmowa zawężania zakresu parametrów).

W powyższym opisie wyrażenie jest tratowane jako z obecną wartością NULL jeśli statystycznie możliwe jest wartościowanie do wartości NULL lub jeśli jest zadeklarowane z adnotacją o obecności wartości NULL.

Błąd

Konflikt między adnotacjami wartości NULL a ustalaniem wartości NULL

W zależności od ustawienia tej opcji kompilator zgłosi błąd lub ostrzeżenie, gdy zostanie wykryta jedna z następujących sytuacji:

  1. Metoda zadeklarowana z adnotacją o braku wartości NULL zwraca wyrażenie, które statystycznie może być wartościowane do wartości NULL w niektórych przepływach.
  2. Wyrażenie, które statystycznie może być wartościowane do wartości NULL w niektórych przepływach, jest przekazywane jako argument w wywołaniu metody, gdy odpowiadający parametr wywoływanej metody jest zadeklarowany z adnotacją o braku wartości NULL.
  3. Wyrażenie, które statystycznie może być wartościowane do wartości NULL w niektórych przepływach, jest przypisywane do zmiennej lokalnej zadeklarowanej z adnotacją o braku wartości NULL.

Błąd

Niesprawdzona konwersja z typu bez adnotacji do typu z adnotacją @NonNull

W zależności od ustawienia tej opcji kompilator zgłosi błąd lub ostrzeżenie, gdy zostanie wykryta jedna z następujących sytuacji:

  1. Metoda zadeklarowana z adnotacją o braku wartości NULL zwraca wyrażenie, w przypadku którego określono informacje o obecności wartości niewystarczające do statystycznego określenia, że żaden przepływ nie zwróci wartości NULL w czasie wykonywania.
  2. Wyrażenie, w przypadku którego określono informacje o obecności wartości NULL niewystarczające do statystycznego określenia, że nigdy nie będzie wartościowane do wartości NULL w czasie wykonywania, jest przekazywane jako argument w wywołaniu metody w przypadku, gdy odpowiadający parametr wywoływanej metody jest zadeklarowany z adnotacją o braku wartości NULL.
  3. Wyrażenie, w przypadku którego określono informacje o obecności wartości NULL niewystarczające do statystycznego określenia, że nigdy nie będzie wartościowane do wartości NULL w czasie wykonywania, jest przypisywane do zmiennej lokalnej zadeklarowanej z adnotacją o braku wartości NULL.

Niesprawdzone konwersje zwykle są skutkiem użycia innych zmiennych lub metod bez adnotacji.

Ostrzeżenie

Nadmiarowe adnotacje wartości NULL

Po włączeniu tej opcji kompilator zgłosi błąd lub ostrzeżenie, gdy adnotacja o braku wartości NULL jest stosowana, mimo że ten sam efekt jest już uzyskany przez wartość domyślną mającą zastosowanie w danym położeniu. Taka wartość domyślna może zostać zastosowana przez użycie opcji Używaj domyślnej wartości adnotacji braku wartości NULL na poziomie obszaru roboczego (lub projektu) lub przez użycie adnotacji @NonNullByDefault.

Ostrzeżenie

Brak adnotacji „@NonNullByDefault” w pakiecie

Po włączeniu kompilator zgłasza błąd lub ostrzeżenie w następujących przypadkach:

  1. Gdy pakiet nie zawiera domyślnej adnotacji o obecności wartości NULL w wyniku braku pliku package-info.java lub braku domyślnej adnotacji o obecności wartości NULL w pliku package-info.java.
  2. Gdy typ w pakiecie domyślnym nie zawiera domyślnej adnotacji o obecności wartości NULL.

Ignorowanie

Użyj domyślnych adnotacji w specyfikacjach wartości NULL

Po włączeniu tej opcji kompilator będzie używać domyślnego zestawu adnotacji specyfikacji wartości NULL. Te adnotacje znajdują się w pakiecie SDK środowiska Eclipse w pakunku org.eclipse.jdt.annotation.

W projekcie można ustawić korzystanie z innych nazw adnotacji, ale należy pamiętać, że kompilator środowiska Eclipse obsługuje tylko semantykę określoną w domyślnych adnotacjach:

  • org.eclipse.jdt.annotation.Nullable: Pełna nazwa typu adnotacji Java, który, po zastosowaniu do typu w sygnaturze metody lub deklaracji zmiennej, jest interpretowany jako specyfikacja, że wartość null jest poprawną wartością na tej pozycji.
    Aktualnie obsługiwane pozycje to: parametry metody, typ zwracany metody i zmienne lokalne.
  • org.eclipse.jdt.annotation.NonNull: Pełna nazwa typu adnotacji Java, który, po zastosowaniu do typu w sygnaturze metody lub deklaracji zmiennej, jest interpretowany jako specyfikacja, że wartość null nie jest poprawną wartością na tej pozycji.
    Aktualnie obsługiwane pozycje to: parametry metody, typ zwracany metody i zmienne lokalne.
  • org.eclipse.jdt.annotation.NonNullByDefault: Pełna nazwa typu adnotacji Java. Po zastosowaniu do elementu bez argumentu adnotacji wszystkie typy bez adnotacji w sygnaturach metody elementu z tą adnotacją będą traktowane tak, jakby były określone z adnotacją braku wartości NULL.
    Z drugiej strony, jeśli adnotacja jest stosowana ze stałą „false” jako argumentem, wszystkie odpowiednie wartości domyślne określone za pomocą tej adnotacji w zewnętrznych zasięgach zostaną anulowane dla elementu z adnotacją.

Włączone

Po włączeniu opcji Traktuj powyższe błędy jak krytyczne błędy kompilacji wszystkie wygenerowane błędy krytyczne lub konfigurowalne uniemożliwiają wykonywanie kodu. Po wyłączeniu tej opcji kod może być wykonywany, dopóki nie zawiera błędu krytycznego (błędu składniowego, błędu typu lub innego błędu związanego ze specyfikacją języka Java).

Pojęcia pokrewne

Widok Problemy
Szybka poprawka
Program budujący Java