CKTIS / Java
Comparar objetos Integer: valores, referências e null
Distingue a identidade dos objetos da igualdade dos valores. Vê quando `==` converte um `Integer` em `int` e como comparar referências que podem ser `null`.
Versão: Java SE 21
Sintaxe
Instance methods on java.lang.Integer: boolean equals(Object obj); int intValue(). Static method on java.util.Objects: static boolean equals(Object a, Object b). With Integer a and b and int n: a == b compares references; a == n unboxes a and compares values.Quando ambos os operandos são do tipo Integer, == compara as referências. Devolve true se estas apontarem para o mesmo objeto ou se ambas forem null. Dois objetos distintos podem conter o mesmo int. Integer.valueOf(int) guarda em cache os valores de −128 a 127, inclusive, e pode também guardar outros valores. Não uses == para comparar os valores de dois objetos Integer.
O método de instância Integer.equals(Object) só devolve true se o argumento for um Integer que contém o mesmo int. Devolve false se o argumento for null ou se for um Long com o mesmo valor numérico. Invocar o método através de uma referência null lança NullPointerException.
Integer.intValue() devolve o valor primitivo int. Quando == compara um Integer com um int, o Java faz automaticamente o unboxing do Integer e compara os valores numéricos. Tanto a chamada de intValue() através de uma referência null como o unboxing automático de null lançam NullPointerException.
O método estático java.util.Objects.equals(Object, Object) devolve true para dois argumentos null. Para dois argumentos do tipo Integer, devolve false se apenas um for null; se nenhum for null, aplica a regra de igualdade de valores de Integer. Usa este método se qualquer uma das referências puder ser null.
Exemplos
import java.util.Objects;
public class IntegerComparison {
@SuppressWarnings("removal") // Fresh objects for this demonstration only.
public static void main(String[] args) {
Integer a = new Integer(42);
Integer b = new Integer(42);
Integer missing = null;
System.out.println("same reference: " + (a == b));
System.out.println("Integer.equals: " + a.equals(b));
System.out.println("Integer vs Long: " + a.equals(Long.valueOf(42L)));
System.out.println("intValue comparison: " + (a.intValue() == b.intValue()));
System.out.println("Integer vs int: " + (a == 42));
System.out.println("Objects.equals, same value: " + Objects.equals(a, b));
System.out.println("Objects.equals, one null: " + Objects.equals(a, missing));
System.out.println("Objects.equals, both null: " + Objects.equals(missing, null));
try {
System.out.println(missing == 42);
} catch (NullPointerException e) {
System.out.println("null unboxing: NullPointerException");
}
}
}Resultado
same reference: false Integer.equals: true Integer vs Long: false intValue comparison: true Integer vs int: true Objects.equals, same value: true Objects.equals, one null: false Objects.equals, both null: true null unboxing: NullPointerException
As duas chamadas a `new Integer(42)` criam deliberadamente objetos distintos com o mesmo valor, independentemente da cache. O construtor está obsoleto e marcado para remoção; só é usado para esta demonstração. No código habitual, usa autoboxing ou `Integer.valueOf(int)`. O bloco `catch` final mostra o que acontece ao fazer unboxing de `null`.
Lições relacionadas
- Java · Lição 48 · Avançado · Versão: 2