Wykluczanie ostrzeżeń przy użyciu adnotacji @SuppressWarnings
Począwszy od wersji 5.0 środowisko Java oferuje opcję wyłączenia przez użytkownika ostrzeżeń kompilacji dotyczących podzbioru jednostki kompilacji przy użyciu adnotacji java.lang.SuppressWarning.
@SuppressWarning("unused") public void foo() {
String s;
}
Bez tej adnotacji kompilator skarżyłby się, że zmienna lokalna s nie jest nigdy używana. Z tą adnotacją kompilator ignoruje to ostrzeżenie lokalnie w metodzie foo, nie wyświetlając żadnego komunikatu. Umożliwia to zachowanie ostrzeżeń w innych położeniach tej samej jednostki kompilacji lub tego samego projektu.
Lista elementów, które mogą być używane w adnotacji SuppressWarnings, jest następująca:
- all - blokowanie wszystkich ostrzeżeń
- boxing - blokowanie ostrzeżeń dotyczących operacji pakowania i wypakowywania
- cast - blokowanie ostrzeżeń dotyczących operacji rzutowania
- dep-ann - blokowanie ostrzeżeń dotyczących adnotacji deprecated
- deprecation - blokowanie ostrzeżeń dotyczących nieaktualności
- fallthrough - blokowanie ostrzeżeń dotyczących brakujących podziałów w instrukcjach przełącznika
- finally - blokowanie ostrzeżeń dotyczących bloków finally bez powrotu
- hiding - blokowanie ostrzeżeń dotyczących lokalnych, które ukrywają zmienną
- incomplete-switch - blokowanie ostrzeżeń dotyczących brakujących wpisów w instrukcji przełącznika (enum case)
- javadoc - blokowanie ostrzeżeń dotyczących dokumentacji Javadoc
- nls - blokowanie ostrzeżeń dotyczących literałów łańcuchowych non-nls
- null - blokowanie ostrzeżeń dotyczących analizy null
- rawtypes - blokowanie ostrzeżeń dotyczących użycia typów surowych
- resource - blokowanie ostrzeżeń dotyczących używania typów Closeable
- restriction - blokowanie ostrzeżeń dotyczących użycia niewskazanych lub niedozwolonych odwołań
- serial - blokowanie ostrzeżeń dotyczących braku pola serialVersionUID dla klasy możliwej do serializacji
- static-access - blokowanie ostrzeżeń dotyczących niepoprawnego dostępu statycznego
- static-method - blokowanie ostrzeżeń dotyczących metod, które mogą być zadeklarowane jako statyczne
- super - blokowanie ostrzeżeń dotyczących przesłaniania metody bez wywołań super
- synthetic-access - blokowanie ostrzeżeń dotyczących niezoptymalizowanego dostępu z klas wewnętrznych
- sync-override - blokowanie ostrzeżeń braku synchronizacji w przypadku przesłaniania synchronizowanej metody
- unchecked - blokowanie ostrzeżeń dotyczących niesprawdzonych operacji
- unqualified-field-access - blokowanie ostrzeżeń dotyczących niekwalifikowanego dostępu do pola
- unused - blokowanie ostrzeżeń dotyczących nieużywanego i martwego kodu