CKTIS / Java
java.util.Objects — Validierung, Gleichheit und Hashing
Lerne Objects.requireNonNull, Objects.equals und Objects.hash kennen: Null-Prüfungen, Gleichheit von Referenzen, die null sein können, und die Berechnung eines Hashes aus Feldern.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);java.util.Objects stellt statische Hilfsmethoden bereit. Umfang dieses Eintrags: Java SE 21; die Laufzeitumgebung des Repositorys und die Produktionsumgebung wurden nicht bestätigt.
Objects.requireNonNull(value, "value") gibt dieselbe Referenz zurück oder wirft eine NullPointerException mit der angegebenen Meldung. Die Methode eignet sich zur Parameterprüfung, prüft aber beispielsweise nicht, ob ein Text leer ist.
Objects.equals(a, b) gibt true zurück, wenn beide Argumente null sind, und false, wenn nur a den Wert null hat. Ist a nicht null, bestimmt die Methode equals des ersten Arguments die Gleichheit. Wenn a == b gilt und beide Referenzen auf dasselbe Objekt verweisen, garantiert die Java-SE-21-API nicht, dass der Aufruf von a.equals(b) übersprungen wird. Die Methode vergleicht keine Array-Inhalte.
Objects.hash(field1, field2) hasht eine Folge ähnlich wie Arrays.hashCode(Object[]). Verwende bei der Implementierung von hashCode() Felder, die mit equals() übereinstimmen: Gleiche Objekte müssen gleiche Hashes haben, Kollisionen sind jedoch möglich. Objects.hash(x) ist für ein einzelnes Objekt kein Ersatz für Objects.hashCode(x).
Beispiele
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());
}
}
}Ergebnis
Ada true false 994 name
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.