CKTIS / Java
Objects.equals: comparar títulos que pueden ser null
Compara títulos aunque falte alguno y comprueba por separado que hay un título cuando sea necesario generar una etiqueta.
Versión: Java SE 21
Sintaxis
import java.util.Objects;
// Declaration in java.util.Objects (Java SE 21):
public static boolean equals(Object a, Object b)
// Use in an expression or statement:
boolean equal = Objects.equals(a, b);Objects.equals(a, b) es un método estático de java.util.Objects que recibe dos argumentos de tipo Object y devuelve un boolean. Si ambos argumentos son null, devuelve true. Si solo uno es null, el resultado es false, siempre que equals respete su contrato. Si ambas referencias apuntan al mismo objeto, el resultado es true; la implementación de JDK 21 lo devuelve sin llamar a a.equals(b). Para dos referencias distintas que no son null, el resultado lo determina a.equals(b).
En objetos String, la igualdad significa tener la misma secuencia de caracteres. En cambio, == aplicado a referencias comprueba si apuntan al mismo objeto o si ambas son null. Objects.equals no compara los elementos de los arrays; para una comparación en profundidad, usa Objects.deepEquals. El método no corrige una implementación defectuosa de equals ni captura las excepciones que esta lance.
Dos títulos ausentes pueden resultar iguales, pero true no demuestra que haya un título. Si la etiqueta requiere un título, usa Objects.requireNonNull(title, "title is required") antes de llamar a strip(). Si falta el título, la comprobación lanza una NullPointerException con ese mensaje. No rechaza cadenas vacías ni formadas únicamente por caracteres de espacio en blanco.
Ejemplos
import java.util.Objects;
public class Main {
private static String label(String title) {
return "Title: " + Objects.requireNonNull(title, "title is required").strip();
}
public static void main(String[] args) {
String title = "Atlas";
String sameText = new String(title); // Deliberately distinct reference.
String missing = null;
System.out.println(Objects.equals(missing, null));
System.out.println(Objects.equals(title, missing));
System.out.println(Objects.equals(title, sameText));
System.out.println(title == sameText);
System.out.println(label(title));
try {
System.out.println(label(missing));
} catch (NullPointerException e) {
System.out.println(e.getMessage());
}
}
}Resultado
true false true false Title: Atlas title is required
Dos objetos `String` distintos que contienen `Atlas` son iguales con `Objects.equals`, pero no con `==`. Dos títulos ausentes se consideran iguales, pero `label` rechaza la ausencia de un título; el ejemplo captura la excepción e imprime su mensaje.
Lecciones relacionadas
- Java · Lección 18 · Avanzado · Versión: 2
Fuentes
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Object.equals(Object)
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=
- Java SE 21 API — Objects.deepEquals(Object, Object)
- Java SE 21 API — Objects.requireNonNull(T, String)