CKTIS / Java
NullPointerException — usar null em vez de um objeto
NullPointerException (NPE) indica a utilização de null quando é necessário um objeto. É uma subclasse de RuntimeException, pelo que não precisa de ser declarada em throws.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new NullPointerException()
new NullPointerException("message")java.lang.NullPointerException indica uma tentativa de utilizar null quando é necessário um objeto. Entre as causas comuns estão a invocação de um método de instância, o acesso a um campo ou elemento de um array, a leitura do comprimento de um array através de uma referência null e throw null.
Enquanto subclasse de RuntimeException, é uma exceção não verificada: não é necessária uma declaração throws. Recomenda-se descobrir a origem do valor em falta e validar ou corrigir os dados antes de os utilizar, em vez de ocultar o problema com um catch demasiado abrangente.
Os construtores NullPointerException() e NullPointerException(String message) criam uma exceção sem uma mensagem explícita ou com uma mensagem. Não parta do princípio de que as mensagens geradas pela JVM têm um texto fixo: getMessage() pode devolver texto específico da implementação ou null.
No exemplo, text.length() lança a exceção antes de ser apresentado qualquer comprimento. O catch serve apenas para demonstração e apresenta texto fixo, independente dos diagnósticos da JVM.
Exemplos
public class Main {
public static void main(String[] args) {
String text = null;
try {
System.out.println(text.length());
} catch (NullPointerException exception) {
System.out.println("NullPointerException");
}
}
}Resultado
NullPointerException
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.