Respuesta.

Historia de la pregunta

En Kotlin se introdujo el concepto de clases inline/clases de valor (ahora llamadas clases de valor) para minimizar el overhead de tiempo de ejecución al trabajar con envoltorios sobre tipos primitivos y estructuras pequeñas. La idea se toma de otros lenguajes (por ejemplo, estructuras en C#), donde tal optimización es útil para mejorar el rendimiento sin perder la tipificación.

Problema

Crear clases envoltorio (por ejemplo, para tipos de entidad o identificadores) sin optimización conduce a la presencia de un objeto adicional en memoria, lo que afecta el rendimiento, la recolección de basura y puede llevar a un overhead de Boxing/Unboxing. A menudo surge el deseo de tener una tipificación estricta (por ejemplo, UserId en lugar de Int), pero sin la creación real de objetos.

Solución

La clase de valor se declara con el modificador value. En la mayoría de las situaciones, la JVM no crea un objeto adicional: la clase de valor se reemplaza directamente por su campo (inlining). Esto proporciona seguridad de tipo y un rendimiento cercano a "simplemente Int".

Ejemplo de código:

@JvmInline
value class UserId(val value: Int)

fun showId(id: UserId) = println(id.value)

val id = UserId(15)
showId(id) // Sin crear un objeto separado UserId

Características clave:

La clase debe contener exactamente una propiedad (val o var), pero este tipo no puede ser nullable
No hay soporte para la herencia (la clase de valor no puede heredar ni ser heredada)
Algunas limitaciones: no se puede tener un bloque init, almacenar propiedades lateinit o no inicializadas, no se puede usar reflexión en todos los casos

Preguntas capciosas.

¿Pueden las clases de valor tener múltiples propiedades?

No, la clase de valor solo puede contener una propiedad.

// Error:
// value class Money(val amount: Int, val currency: String)

¿Se puede crear una clase de valor con una propiedad nullable?

El campo value de la clase de valor no puede ser nullable: solo tipos no nulos.

// Error:
// value class Name(val value: String?)

¿Se puede usar herencia con clases de valor?

La clase de valor no admite herencia y no puede ser abstracta o sellada.

// Error:
// value class NewId(val value: Int): BaseId()

Errores típicos y anti-patterns

Intentar usar clase de valor para estructuras complejas (por ejemplo, con múltiples campos)
Almacenar valores nullable a través de clases de valor
Uso de métodos de referencia (por ejemplo, los métodos equals/hashCode pueden comportarse de manera inesperada en el backend compilado)

Ejemplo de la vida real

Caso negativo

Un desarrollador creó una clase de valor para una entidad con dos propiedades (por ejemplo, un par de Int y String) y obtuvo un error de compilación.

Pros:

Intenta lograr un tipo estrictamente tipado Contras:
No funciona, no se puede compilar

Caso positivo

Un desarrollador utiliza clase de valor para un tipo identificador con un solo campo (por ejemplo, UserId), lo que funciona rápida y seguramente.