Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Construtor obsoleto Integer(int)

Cada chamada bem-sucedida a `Integer(int)` cria um objeto distinto. Em código novo, usa `Integer.valueOf(int)` ou autoboxing quando precisares de um objeto, mas não de uma nova identidade.

Versão: Java SE 21

Sintaxe

@Deprecated(since="9", forRemoval=true)
public Integer(int value)

Com um argumento do tipo int, new Integer(n) chama o construtor java.lang.Integer(int). Cada chamada bem-sucedida cria um novo objeto que representa n, mesmo que outro objeto já represente o mesmo número. Em Java SE 21, o construtor continua disponível, mas tem a anotação @Deprecated(since="9", forRemoval=true): está obsoleto desde Java 9 e marcado para remoção. Ao contrário da sobrecarga Integer(String), não interpreta texto. Essa sobrecarga lança NumberFormatException se o texto não puder ser interpretado como um int.

Se só precisares do número, usa int. Se precisares de um objeto que encapsule o valor, usa Integer.valueOf(n) ou autoboxing, como em Integer x = n; para uma variável n do tipo int. valueOf(int) mantém sempre em cache os valores de -128 a 127, inclusive, e pode guardar outros. O autoboxing garante a mesma referência quando o mesmo valor nesse intervalo é convertido repetidamente a partir de uma expressão constante do tipo int. Não uses nenhuma destas alternativas para obter uma nova identidade.

Com dois operandos do tipo Integer, == verifica a identidade das referências, enquanto equals compara os valores encapsulados em dois objetos Integer. Na comparação entre um Integer e um int, == converte o Integer em int por unboxing e compara os números; o unboxing de null lança NullPointerException. Integer é uma classe baseada no valor: não faças depender a lógica do programa da identidade das suas instâncias nem as uses para sincronização.

Exemplos

public class IntegerConstructorDemo {
    public static void main(String[] args) {
        Integer a = new Integer(42);
        Integer b = new Integer(42);
        Integer c = Integer.valueOf(42);
        Integer d = Integer.valueOf(42);

        System.out.println(a == b);
        System.out.println(a.equals(b));
        System.out.println(c == d);
    }
}

Resultado

false
true
true

As duas chamadas ao construtor para `42` criam objetos distintos (`false`) com valores iguais (`true`). As duas chamadas a `Integer.valueOf(42)` devolvem o mesmo objeto da cache (`true`). O construtor é usado de propósito como exemplo histórico; os avisos do compilador sobre a remoção prevista não fazem parte da saída do programa.

Lições relacionadas

  • Java · Lição 4 · Avançado · Versão: 2

Fontes