CKTIS / Java
java.util.Objects — validatie, gelijkheid en hashing
Leer Objects.requireNonNull, Objects.equals en Objects.hash kennen: null-controles, gelijkheid van referenties die null kunnen zijn en het berekenen van een hash uit velden.
Versie: 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 biedt statische hulpprogramma-methoden. Reikwijdte van dit artikel: Java SE 21; de runtime van de repository en de productie-runtime zijn niet bevestigd.
Objects.requireNonNull(value, "value") retourneert dezelfde referentie of gooit een NullPointerException met de opgegeven melding. De methode is handig voor parametervalidatie, maar controleert bijvoorbeeld niet of een tekenreeks leeg is.
Objects.equals(a, b) retourneert true als beide argumenten null zijn en false als alleen a null is. Als a niet null is, bepaalt de methode equals van het eerste argument of de argumenten gelijk zijn. Als a == b en beide referenties naar hetzelfde object verwijzen, garandeert de Java SE 21-API niet dat de aanroep van a.equals(b) wordt overgeslagen. De methode vergelijkt de inhoud van arrays niet.
Objects.hash(field1, field2) berekent een hash van een reeks zoals Arrays.hashCode(Object[]). Gebruik bij het implementeren van hashCode() velden die overeenkomen met equals(): gelijke objecten moeten gelijke hashes hebben, maar botsingen zijn mogelijk. Voor één object is Objects.hash(x) geen vervanging voor Objects.hashCode(x).
Voorbeelden
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());
}
}
}Resultaat
Ada true false 994 name
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.