int primitivo vs Integer: Guía completa

Tabla de contenidos 1. Panorama general; 2. Diferencias clave; 3. Gestión de memoria; 4. Comportamiento de caché de Integer; 5. Ejemplos de comparación; 6. Flujo de compilación y ejecución; 7. Buenas prácticas; 8. Errores comunes; 9. Rendimiento; 10. Casos de uso; 11. Resumen

Panorama general En Java existen dos formas de representar valores enteros: int es un tipo primitivo y Integer es una clase envoltorio. Entender sus diferencias es clave para escribir código correcto, eficiente y mantenible.

Diferencias clave Tipo: int es primitivo; Integer es un objeto. Ubicación de memoria: int se almacena directamente en la pila de ejecución; Integer es una referencia en la pila que apunta a un objeto en el heap. Tamaño típico: int ocupa 4 bytes; Integer implica una referencia y un objeto con sobrecarga adicional. Valor por defecto: int usa 0; Integer usa null. Soporte de null: int no admite null; Integer sí. Uso en colecciones y genéricos: int no puede usarse directamente; Integer sí. Métodos disponibles: int no tiene métodos; Integer ofrece una API rica. Comparación: int se compara por valor con ==; Integer con == compara referencias y equals compara valores.

Gestión de memoria Con int el valor se guarda inline en el frame de pila, por ejemplo dos variables int con valor 10 ocupan cada una 4 bytes en la pila. Con Integer se almacena una referencia en la pila y el objeto en el heap; varias referencias pueden apuntar al mismo objeto si entra en el rango de caché. Nota práctica: tamaños exactos dependen de la arquitectura de la JVM, compresión de punteros y alineación de objetos.

Comportamiento de caché de Integer La JVM mantiene un caché de Integer para valores entre -128 y 127. Integer a = 10 y Integer b = Integer.valueOf(10) apuntan al mismo objeto en ese rango, por lo que a == b es true. En cambio new Integer(10) crea siempre un objeto nuevo y está deprecado. El límite superior del caché puede ampliarse con la propiedad del sistema java.lang.Integer.IntegerCache.high por ejemplo usando el parámetro de arranque -Djava.lang.Integer.IntegerCache.high=1000.

Ejemplos de comparación 1. Primitivos: int a = 10; int b = 10; System.out.println(a == b); produce true por comparación de valor. 2. Integer en caché: Integer a1 = 10; Integer b1 = 10; a1 == b1 produce true al compartir objeto. 3. Fuera de caché: Integer a2 = 250; Integer b2 = 250; a2 == b2 produce false por ser objetos distintos. 4. Comparación correcta: Integer x = 250; Integer y = 250; x.equals(y) es true; también x.intValue() == y.intValue() es true.

Flujo de compilación y autoboxing con Integer a1 = 10 Análisis léxico y sintáctico: se valida la declaración. Análisis semántico: se detecta compatibilidad de tipos y autoboxing. Reescritura: Integer a1 = Integer.valueOf(10). Búsqueda en caché: si 10 está en el rango, devuelve la instancia cacheada sin crear objeto. Bytecode típico: se empuja 10 a la pila de operandos, se invoca Integer.valueOf y se almacena la referencia resultante. En tiempo de ejecución la referencia apunta al objeto cacheado.

Buenas prácticas 1. Usa el método adecuado de comparación: para Integer emplea equals, Objects.equals si quieres seguridad ante null, o compara intValue cuando necesites primitivos. Evita == con Integer salvo que expresamente quieras comparar identidad de referencia. 2. Escoge el tipo correcto: usa int para aritmética simple, contadores de bucle, índices de arreglos, cuando no se requiera null y en código crítico de rendimiento; usa Integer para colecciones, cuando los valores puedan ser null, al trabajar con genéricos y cuando las APIs requieran objetos. 3. Trata null de forma segura: si una API devuelve Integer que puede ser null, evita desboxear directamente para no provocar NullPointerException; usa una comprobación previa, un valor por defecto o Optional.ofNullable(valor).orElse(0). 4. Autoboxing con cuidado: el autoboxing y unboxing continuos pueden degradar el rendimiento y generar basura; en bucles intensivos prioriza tipos primitivos y reduce conversiones innecesarias.

Errores comunes 1. Comparar referencias con == en Integer puede dar resultados inconsistentes por el caché solo entre -128 y 127. 2. NullPointerException por unboxing: Integer v = null; int r = v dispara NPE. 3. Coste por boxing excesivo en bucles masivos, creando muchos objetos temporales. 4. Comportamiento inconsistente en límites del caché: 127 puede ser igual por referencia, 128 no.

Rendimiento Memoria: un arreglo de int de longitud 1000 ronda 4 KB de datos; con Integer cada elemento añade la sobrecarga de referencia más objeto en el heap. Acceso: int se usa de forma directa y rápida; Integer requiere desboxing para operar aritméticamente. Recolección de basura: int no impacta al GC; Integer incrementa la presión del GC al crear objetos.

Casos de uso recomendados para int Aritmética simple como sumas y productos; contadores en for; índices de arrays; funciones de alto rendimiento que procesan grandes volúmenes numéricos. Ejemplo rápido: for (int i = 0; i < 100; i++) { /* cuerpo */ } y acumulaciones con int para minimizar boxing.

Casos de uso recomendados para Integer Trabajar con colecciones y genéricos donde se requieren objetos; valores opcionales y nulos en entidades y DTOs; interoperar con APIs que piden objetos. Ejemplo: almacenar edades en una lista de Integer cuando algunas pueden ser null.

Consejos adicionales Evita new Integer en favor de Integer.valueOf. Si necesitas comparar frecuentemente y no admites null, considera mantener datos como int internamente y convertir solo en los bordes de la aplicación. Documenta si una API puede devolver null en lugar de un int por claridad de contrato.

Resumen Usa int cuando busques simplicidad, velocidad y no necesites null. Usa Integer cuando necesites interoperar con colecciones, genéricos o representar ausencia de valor. Regla de oro: para Integer utiliza equals u Objects.equals para comparar por valor y evita == salvo que quieras comprobar identidad de objeto.

Sobre Q2BSTUDIO En Q2BSTUDIO desarrollamos software a medida y aplicaciones a medida de alto rendimiento, aplicando buenas prácticas como las descritas para int e Integer en proyectos críticos. Integramos inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y power bi, automatización de procesos, agentes IA e ia para empresas. Conoce nuestro enfoque de ingeniería y arquitectura visitando nuestro servicio de desarrollo de aplicaciones a medida y cómo aplicamos machine learning y modelos avanzados en soluciones de inteligencia artificial para empresas.