`dispose` es una operación del ciclo de vida

1159. Identidad de la lección

Módulo

3.8 — Memoria y ciclo de vida

Lección

dispose es una operación del ciclo de vida

Tipo académico

Sistemas

Orden

Lección 1 del módulo

Tiempo estimado

35–45 minutos, incluida la práctica evaluada

1160. Objetivo de aprendizaje

Al terminar esta lección, podrás modelar el ciclo de vida de un recurso del juego, identificar a su responsable o a quien lo usa en préstamo, corregir transiciones de limpieza ausentes, distinguir la reutilización de la recuperación y explicar cómo se evita una doble liberación.

1161. Por qué importa

Un recurso puede crearse correctamente y aun así provocar fallos si permanece activo después de que termine su uso válido o si se libera mientras otro sistema todavía depende de él. Las texturas, los identificadores de audio, las suscripciones, los objetos similares a archivos, las entidades de un pool y los recursos vinculados a la GPU necesitan contratos explícitos de ciclo de vida.

Los cambios de escena, las cancelaciones, los reintentos y las inicializaciones parciales pueden dejar referencias obsoletas, callbacks duplicados, recursos sin devolver o liberaciones prematuras. La IA puede sugerir código de limpieza, pero no puede deducir de forma segura un contrato de responsabilidad que no esté documentado. Tú debes determinar quién controla cada recurso o derecho de uso, cuándo termina ese uso y qué ocurre en cada salida posible.

1162. Conocimientos previos

Debes poder distinguir una observación de rendimiento medida de una hipótesis, como se practicó en 3.7 L2 — Measure before changing. También debes poder seguir un flujo pequeño de código e identificar el objeto o sistema que solicita un recurso. No se requiere ningún lenguaje ni API de motor en particular.

1163. Concepto central

El ciclo de vida de un recurso es una secuencia de responsabilidades, no solo un constructor seguido de un destructor.

Un modelo útil distingue estas operaciones:

1. Crear o adquirir: asignar un recurso, abrirlo, suscribirse u obtener un derecho de uso de otro responsable.
2. Usar: realizar trabajo mientras el recurso o el derecho de uso siga siendo válido.
3. Ejecutar dispose: indicar que un componente ha terminado y ejecutar su contrato de limpieza.
4. Liberar: cerrar, cancelar una suscripción, reducir un contador, devolver un elemento a un pool o renunciar de otra forma a lo adquirido. En algunas APIs, dispose realiza la liberación; en otras, coordina varias operaciones.
5. Reutilizar: iniciar un nuevo periodo de uso válido para un recurso existente o para un elemento equivalente de un pool.
6. Recuperar: responder a una creación fallida, un uso fallido, una inicialización parcial o una limpieza incompleta mediante un reintento, una alternativa o el registro y la notificación del fallo.

Toda adquisición necesita un contrato explícito de responsabilidad, pero eso no significa que cada usuario deba liberar el recurso compartido subyacente. El responsable libera los recursos o derechos que posee. Quien usa un recurso en préstamo debe terminar su uso y devolver o abandonar ese derecho según el contrato; no debe destruir ni liberar un recurso subyacente que pertenece a un pool, un gestor o un servicio compartido.

1164. Modelo responsable–vida útil–salida

Representa el ciclo de vida mediante flechas, una lista numerada de transiciones o una tabla de estados. Etiqueta cada transición con el evento que la activa. Si no se conoce al responsable, al usuario, el evento o el estado siguiente, marca ese punto como defecto en lugar de suponer cómo funciona la API.

1165. Ejemplo concreto

Imagina una DialogueAudioSession que solicita un stream a un pool de audio y después se suscribe al callback que indica el final del diálogo.

Comienza el diálogo
    -> Solicitar un stream al pool
    -> Si la solicitud tiene éxito, suscribirse al callback de finalización
    -> Reproducir el diálogo
    -> El diálogo termina, se omite o se descarga la escena
    -> Ejecutar dispose en la sesión una sola vez
    -> Cancelar la suscripción y devolver al pool el derecho de uso del stream
    -> El pool podrá entregar más adelante el stream mediante un nuevo derecho de uso

El pool puede ser el responsable del stream subyacente, mientras que la sesión solo controla temporalmente el derecho obtenido al retirarlo. Según ese contrato, la sesión debe devolver su derecho de uso, pero no debe destruir el recurso que pertenece al pool.

Examina al menos estos recorridos:

• Finalización normal: termina la última línea, la sesión se cierra una sola vez, se elimina el callback y el derecho de uso del stream vuelve al pool.
• Cancelación o descarga: se aplican las mismas obligaciones de limpieza aunque nunca se ejecute la última línea.
• Adquisición fallida: no existe ningún derecho sobre el stream, por lo que la limpieza no debe intentar devolverlo ni liberarlo. La sesión sigue una ruta definida de recuperación o notificación.
• Adquisición parcial: la retirada del stream tiene éxito, pero falla la suscripción al callback. La limpieza debe devolver el stream adquirido sin intentar cancelar una suscripción que nunca llegó a establecerse.

1166. Reutilización no es recuperación

La reutilización y la recuperación pueden conducir a un estado utilizable, pero responden a preguntas distintas:

• Reutilización: ¿cómo recibe un recurso válido un nuevo responsable o usuario temporal después de terminar el derecho anterior?
• Recuperación: ¿qué respuesta se aplica después de un fallo o de un estado parcial?

Devolver un stream al pool y retirarlo de nuevo más tarde es reutilización. Registrar un fallo de adquisición, revertir una sesión creada solo en parte, reintentar según una política definida o seleccionar una alternativa son acciones de recuperación.

1167. Cómo evitar una doble liberación

Más de un evento puede solicitar la limpieza. Por ejemplo, una cancelación y una descarga de escena podrían ocurrir casi al mismo tiempo. Un ciclo de vida seguro debe hacer que la limpieza sea idempotente o protegerla para que cada derecho adquirido se abandone como máximo una vez.

Una protección conceptual puede expresarse así:

si el estado es Activo o AdquiridoParcialmente:
    cambiar el estado a EnLimpieza
    liberar solo los derechos registrados como adquiridos
    borrar esos registros
    cambiar el estado a Cerrado
si no:
    no realizar una segunda liberación

La sintaxis exacta depende de la API. La evidencia importante es el cambio de estado o la protección que impide que dos eventos terminales liberen dos veces el mismo derecho.

1168. Lista de comprobación de responsabilidades

1169. Práctica evaluada

Completa Corrección de un ciclo de vida de recursos. Inspeccionarás un ciclo de vida deliberadamente incompleto para un stream de audio procedente de un pool y una suscripción a un callback.

El ciclo proporcionado incluye recorridos de finalización normal, cancelación y adquisición parcial, pero omite varias decisiones de responsabilidad y limpieza. Identifica al responsable del recurso subyacente y los derechos temporales, marca o etiqueta las transiciones ausentes, distingue la reutilización de la recuperación y explica la protección contra la doble liberación.

Puedes entregar cualquiera de estos formatos equivalentes:

• un diagrama con anotaciones;
• una lista estructurada de transiciones; o
• una tabla de estados con columnas para estado, responsable o usuario temporal, evento activador, acción, estado siguiente y ruta de fallo.

No es necesario rodear elementos visualmente. Puedes marcar los defectos con etiquetas como RESPONSABLE AUSENTE, TRANSICIÓN AUSENTE, RIESGO DE DOBLE LIBERACIÓN o LIBERACIÓN NO VÁLIDA.

1170. Validación y evidencia

1171. Ideas clave

• La vida útil de un recurso se define mediante la responsabilidad, el uso en préstamo, los estados válidos y los eventos de salida.
• dispose coordina el contrato de limpieza de un componente; no siempre equivale a liberar un recurso compartido subyacente.
• Cada responsable libera los derechos que posee. Quien usa un recurso en préstamo termina su uso sin destruir recursos que pertenecen a otro sistema.
• La finalización normal, la cancelación, la adquisición fallida y la adquisición parcial necesitan recorridos explícitos.
• La reutilización crea un nuevo derecho válido; la recuperación responde a un fallo.
• El ciclo de vida necesita una protección o transición observable que evite la doble liberación.

1172. Próxima lección

Continúa con 3.8 L2 — Reproducir un fallo del ciclo de vida. Utiliza el ciclo corregido y la nota de responsabilidades como punto de partida para reproducir un fallo acotado.

1173. Comprobación