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

CKTIS / Java

Boxing, unboxing e identidade da cache de wrappers

O boxing converte um valor primitivo num objeto wrapper, enquanto o unboxing recupera o seu valor. Aprende a diferença entre == e equals e por que razão null e instâncias wrapper partilhadas podem causar surpresas.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Integer boxed = 42;
int primitive = boxed;
boolean sameReference = boxed == anotherBoxed;
boolean sameValue = boxed.equals(anotherBoxed);

O boxing converte um valor primitivo no tipo wrapper correspondente, por exemplo, int → Integer; o unboxing faz o inverso. Integer boxed = 42; e int primitive = boxed; ilustram conversões automáticas. O unboxing de null lança uma NullPointerException.

Para duas referências Integer, == testa a identidade dos objetos, não o valor numérico. Para uma referência não nula x, x.equals(y) verifica se y é um Integer com o mesmo valor. Em contrapartida, x == 1000 efetua unboxing e compara números; se x == null, esse unboxing não ocorre.

A secção 5.1.7 da JLS garante que o boxing repetido do mesmo valor obtido a partir de uma expressão constante produz referências ao mesmo objeto nos seguintes casos: valores boolean true e false, valores do tipo char de 0 a 127, inclusive, e valores dos tipos short, int ou long de -128 a 127, inclusive. Esta regra não menciona byte. Fora desta garantia, não partas do princípio de que os objetos são partilhados ou distintos. Separadamente, o contrato de Integer.valueOf(int) garante a cache de -128–127 e permite um intervalo mais amplo.

O exemplo não apresenta deliberadamente x == y: para 1000, o resultado dependeria da partilha de objetos. Integer é uma classe baseada em valores; não uses as suas instâncias como bloqueios de sincronização.

Identificadores de referência abrangidos por esta entrada: Boxing, unboxing and wrapper cache identity.

Exemplos

public class BoxingDemo {
    public static void main(String[] args) {
        Integer a = 127;
        Integer b = 127;
        int value = a;
        Integer x = 1000;
        Integer y = 1000;

        System.out.println(a == b);
        System.out.println(value);
        System.out.println(x.equals(y));
        System.out.println(x == 1000);

        Integer missing = null;
        try {
            int number = missing;
            System.out.println(number);
        } catch (NullPointerException ex) {
            System.out.println("NullPointerException");
        }
    }
}

Resultado

true
127
true
true
NullPointerException

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes