CKTIS / Java
Integer.equals: mismo tipo envoltorio y mismo valor, no identidad
`Integer.equals` comprueba el tipo envoltorio del argumento y el valor `int` que contiene. Con dos referencias `Integer`, `==` comprueba la identidad del objeto.
Versión: Java SE 21
Sintaxis
public boolean equals(Object obj)
// Instance call: a.equals(obj), where a is a non-null IntegerInteger.equals(Object obj) es un método de instancia de java.lang.Integer que sobrescribe Object.equals(Object). Devuelve true solo si el argumento es un Integer con el mismo valor int; no es necesario que ambas referencias apunten al mismo objeto. Si a contiene 42, a.equals(42) devuelve true porque 42 se convierte en Integer mediante boxing. En cambio, a.equals(42L) devuelve false: 42L se convierte en Long y el método no realiza comparaciones numéricas entre tipos envoltorio distintos.
Si a y b son de tipo Integer, a == b comprueba si apuntan al mismo objeto o si ambas referencias son null. Integer.valueOf(int) guarda en caché los valores entre -128 y 127, ambos incluidos, y puede guardar otros; no uses == para comparar los valores de dos objetos Integer. En cambio, en a == 42L, 42L es un long primitivo, por lo que a se convierte a un valor primitivo mediante unboxing y la comparación es numérica. El unboxing de null lanza NullPointerException.
Si a no es null, a.equals(null) devuelve false. Si a es null, la llamada a.equals(b) lanza NullPointerException. Si cualquiera de las dos referencias Integer puede ser null, usa Objects.equals(a, b): devuelve true si ambas son null, false si solo una es null y aplica Integer.equals si ninguna es null.
Ejemplos
import java.util.Objects;
public class Main {
public static void main(String[] args) {
Integer a = Integer.valueOf(42);
Integer b = Integer.valueOf(42);
System.out.println(a.equals(b));
System.out.println(a == b);
System.out.println(a.equals(42));
System.out.println(a.equals(42L));
System.out.println(a == 42L);
System.out.println(a.equals(null));
System.out.println(Objects.equals(null, null));
}
}Resultado
true true true false true false true
Los dos primeros resultados son `true` por motivos distintos: los valores coinciden e `Integer.valueOf(42)` reutiliza el objeto de la caché. Compara `a.equals(42L)` con `a == 42L`: la primera expresión comprueba el tipo envoltorio; la segunda compara números.
Lecciones relacionadas
- Java · Lección 4 · Avanzado · Versión: 2
Fuentes
- Java SE 21 API — Integer.equals(Object)
- Java SE 21 API — Integer.valueOf(int)
- Java SE 21 API — Objects.equals(Object, Object)
- Java Language Specification, Java SE 21 — §15.21 Equality Operators
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §5.1.8 Unboxing Conversion
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke