CKTIS / Java
java.util.Objects — convalida, uguaglianza e hash
Scopri Objects.requireNonNull, Objects.equals e Objects.hash: controlli di null, uguaglianza tra riferimenti che possono essere null e calcolo di un hash dai campi.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);java.util.Objects fornisce metodi di utilità statici. Ambito di questa voce: Java SE 21; l’ambiente di esecuzione del repository e quello di produzione non sono stati attestati.
Objects.requireNonNull(value, "value") restituisce lo stesso riferimento oppure lancia una NullPointerException con il messaggio fornito. È utile per convalidare i parametri, ma non controlla, per esempio, se una stringa è vuota.
Objects.equals(a, b) restituisce true se entrambi gli argomenti sono null e false se solo a è null. Quando a non è null, l’uguaglianza è determinata dal metodo equals del primo argomento. Se a == b ed entrambi i riferimenti puntano allo stesso oggetto, l’API di Java SE 21 non garantisce che la chiamata a a.equals(b) venga omessa. Il metodo non confronta il contenuto degli array.
Objects.hash(field1, field2) calcola l’hash di una sequenza come Arrays.hashCode(Object[]). Quando implementi hashCode(), usa campi coerenti con equals(): oggetti uguali devono avere hash uguali, ma sono possibili collisioni. Per un singolo oggetto, Objects.hash(x) non sostituisce Objects.hashCode(x).
Esempi
import java.util.Objects;
public class Main {
public static void main(String[] args) {
String name = Objects.requireNonNull("Ada", "name");
System.out.println(name);
System.out.println(Objects.equals(null, null));
System.out.println(Objects.equals(name, null));
System.out.println(Objects.hash(1, 2));
try {
Objects.requireNonNull(null, "name");
} catch (NullPointerException e) {
System.out.println(e.getMessage());
}
}
}Risultato
Ada true false 994 name
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.