CKTIS / Java
Objects.requireNonNull — validar referências e indicar mensagens de erro
Verifica um parâmetro obrigatório: `Objects.requireNonNull` devolve a mesma referência se não for `null`. Se for `null`, normalmente lança uma `NullPointerException`. Podes fornecer uma mensagem personalizada.
Versão: Java SE 21
Sintaxe
import java.util.Objects;
import java.util.function.Supplier;
// Java SE 21: static method signatures in java.util.Objects
public static <T> T requireNonNull(T obj)
public static <T> T requireNonNull(T obj, String message)
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier)Em Java SE 21, Objects.requireNonNull é um método genérico estático da classe java.util.Objects. Importa java.util.Objects para usares o nome curto Objects. Se obj não for null, o método devolve exatamente a mesma referência, do tipo T, sem copiar o objeto. Se obj for null, lança uma NullPointerException em vez de devolver um valor, a menos que o fornecedor da mensagem lance uma exceção ou um erro.
Usa este método no início de um método ou construtor para rejeitar de imediato null num parâmetro obrigatório. Objects.requireNonNull(obj) não aceita uma mensagem personalizada. Em Objects.requireNonNull(obj, "name must not be null"), o segundo argumento é uma String usada como mensagem da exceção, não como valor alternativo. A expressão do argumento String é avaliada antes da chamada, mesmo quando obj não é null.
Se gerar a mensagem for dispendioso, podes passar um Supplier<String> de java.util.function, como em Objects.requireNonNull(obj, () -> buildMessage()). O corpo da lambda só é executado se obj for null. Se o fornecedor lançar uma exceção não verificada ou um Error, a exceção ou o erro propaga-se sem alterações e requireNonNull não lança a sua própria NullPointerException. Objects.requireNonNull(obj, null) não compila porque null é compatível tanto com String como com Supplier<String>. Usa a sobrecarga de um só argumento se não precisares de uma mensagem personalizada.
O método apenas verifica se a referência é null: uma cadeia vazia passa na verificação. Para substituir null em vez de o rejeitar, usa Objects.requireNonNullElse com um valor alternativo que não seja null.
Exemplos
import java.util.Objects;
public class Main {
private final String name;
public Main(String name) {
this.name = Objects.requireNonNull(name, "name must not be null");
}
public static void main(String[] args) {
String name = "Ada";
Main entry = new Main(name);
System.out.println(entry.name == name);
try {
new Main(null);
} catch (NullPointerException e) {
System.out.println(e.getMessage());
}
}
}Resultado
true name must not be null
A primeira linha é `true` porque `==` compara referências e o campo contém a mesma referência que foi passada ao construtor. Na segunda chamada, o construtor lança uma exceção; o bloco `catch` escreve apenas a mensagem obtida com `getMessage()`.
Lições relacionadas
- Java · Lição 28 · Intermédio · Versão: 2