Kotlin Academy · Lección

Copiar con copy() y sobrescrituras parciales

Use copy() para crear instancias modificadas sin mutar la original.

Lección 2 de 413 pasos

Copiar con copy() y sobrescrituras parciales es una lección gratuita de Kotlin Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Academy incluye 4 lecciones en total.

Actualizaciones inmutables con copy()

copy() crea una instancia nueva de una clase de datos con algunas propiedades modificadas. Todas las propiedades no especificadas conservan sus valores originales.

copy() básico

Pase argumentos con nombre para sobrescribir propiedades específicas.
data class Person(val name: String, val age: Int, val city: String)
val alice = Person("Alice", 30, "Berlin")
val olderAlice = alice.copy(age = 31)
println(olderAlice)  // Person(name=Alice, age=31, city=Berlin)

Copia de varios campos

Sobrescriba tantos campos como necesite.
data class Config(val host: String, val port: Int, val ssl: Boolean, val timeout: Int)
val prod = Config("prod.server", 443, true, 30)
val test = prod.copy(host = "test.server", port = 8080, ssl = false)
println(test)

copy no modifica el original

copy siempre crea un objeto nuevo. El original no cambia en absoluto.
data class Point(val x: Int, val y: Int)
val origin = Point(0, 0)
val moved = origin.copy(x = 5)
println(origin)  // Point(x=0, y=0) — unchanged
println(moved)   // Point(x=5, y=0)

Advertencia sobre la copia profunda

copy es superficial. Los objetos mutables dentro de una clase de datos se comparten entre el original y la copia.
data class Team(val name: String, val members: MutableList<String>)
val t1 = Team("A", mutableListOf("Alice"))
val t2 = t1.copy(name = "B")
t2.members.add("Bob")       // modifies SHARED list!
println(t1.members)  // [Alice, Bob] ← also changed!

Cómo evitar problemas de las copias superficiales

Utilice datos inmutables dentro de las clases de datos para evitar problemas de uso compartido.
data class Team(val name: String, val members: List<String>)  // immutable list
val t1 = Team("A", listOf("Alice"))
val t2 = t1.copy(name = "B", members = t1.members + "Bob")
println(t1.members)  // [Alice]
println(t2.members)  // [Alice, Bob]

copy en la gestión del estado

copy es la forma idiomática de actualizar el estado en arquitecturas de estilo Redux o MVI.
data class UiState(val loading: Boolean, val items: List<String>, val error: String?)
fun reduce(state: UiState, action: Action) = when (action) {
    is Loading -> state.copy(loading = true)
    is Success -> state.copy(loading = false, items = action.data)
    is Error -> state.copy(loading = false, error = action.msg)
}

copy con parámetros predeterminados

Las clases de datos con muchas propiedades siguen ofreciendo un copy ergonómico gracias a los parámetros con nombre.
data class Article(
    val id: Long, val title: String, val body: String,
    val published: Boolean = false, val views: Int = 0
)
val draft = Article(1L, "Hello", "Content...")
val published = draft.copy(published = true)
println(published.title)  // Hello

Uso de copy en las pruebas

copy facilita la creación de accesorios de prueba: cree un objeto base y varíe solo los campos que necesite.
val baseUser = User(id = 1, name = "Test", email = "test@test.com", active = true)
val inactiveUser = baseUser.copy(active = false)
val renamed = baseUser.copy(name = "Renamed")

copy frente al patrón Builder

El copy() de las clases de datos es la respuesta de Kotlin al patrón Builder. Para objetos complejos con muchos campos opcionales, combinar una clase de datos con copy resulta más conciso.
// Java Builder:
User.builder().name("A").age(30).role("admin").build()
// Kotlin:
val u = User("A", 30, "admin")  // or copy from base

Semántica de registro

Las clases de datos con propiedades val se comportan como los registros de Java (JDK 16+): son inmutables, se basan en valores y se imprimen automáticamente.
data class RGB(val r: Int, val g: Int, val b: Int)
val white = RGB(255, 255, 255)
println(white)  // RGB(r=255, g=255, b=255)

Comprobación rápida

¿Qué ocurre con la instancia original de la clase de datos cuando se llama a copy() sobre ella?

Resumen

copy() crea una instancia nueva con los campos sobrescritos; el original no cambia. Es ideal para la gestión del estado, las pruebas y la construcción al estilo de Builder. Tenga cuidado con las copias superficiales cuando haya propiedades mutables. A continuación: ¡desestructuración!
Gratis para empezar

Aprende Kotlin con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
51
Lecciones
203

Preguntas frecuentes

¿La lección «Copiar con copy() y sobrescrituras parciales» es gratis?

Sí — el texto completo de «Copiar con copy() y sobrescrituras parciales» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Academy, actualiza a CoddyKit PRO. El curso de Kotlin Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Copiar con copy() y sobrescrituras parciales»?

Use copy() para crear instancias modificadas sin mutar la original. Practicas Kotlin Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Kotlin Academy?

No se requiere experiencia previa. Kotlin Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Copiar con copy() y sobrescrituras parciales»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Kotlin Academy?

Sí. Cada lección de Kotlin Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Fundamentos de las clases de datos: métodos generados automáticamente
  2. Copiar con copy() y sobrescrituras parciales
  3. Declaraciones de desestructuración con componentN
  4. Clases de datos en colecciones y como claves de mapas
← Volver a Kotlin Academy