Clases genéricas

Parte de la sección Programación Orientada a Objetos del Journey de Dart de Coddy — lección 65 de 110.

Has visto cómo las colecciones integradas de Dart como List<String> usan parámetros de tipo. Ahora es el momento de crear tus propias clases genéricas que funcionen con cualquier tipo que especifiques.

Una clase genérica utiliza un parámetro de tipo (normalmente T) como un marcador de posición para el tipo real que se proporcionará al crear una instancia:

class Box<T> {
  T content;
  
  Box(this.content);
  
  T getContent() => content;
}

void main() {
  var stringBox = Box<String>('Hello');
  var intBox = Box<int>(42);
  
  print(stringBox.getContent());  // Hello
  print(intBox.getContent());     // 42
}

La T actúa como una variable de tipo; cuando creas Box<String>, cada T en la clase se convierte en String. Esto te proporciona seguridad de tipos sin tener que escribir clases separadas para cada tipo.

Puedes usar múltiples parámetros de tipo cuando tu clase necesite trabajar con más de un tipo:

class Pair<K, V> {
  K first;
  V second;
  
  Pair(this.first, this.second);
}

void main() {
  var pair = Pair<String, int>('age', 25);
  print('${pair.first}: ${pair.second}');  // age: 25
}

Las clases genéricas son la base del código reutilizable y con seguridad de tipos. En lugar de duplicar la lógica para diferentes tipos o perder información de tipos con dynamic, los genéricos te permiten escribir código flexible que el compilador aún puede verificar.

Desafío

Fácil

Vamos a construir un sistema de envoltura de regalos que utiliza clases genéricas para crear contenedores flexibles para diferentes tipos de artículos. Crearás una clase genérica Wrapper que puede envolver cualquier tipo de contenido, y una clase GiftBox con dos parámetros de tipo para emparejar un regalo con un mensaje de tarjeta.

Organizarás tu código en dos archivos:

wrapper.dart: Define tus clases genéricas aquí:
- Una clase genérica Wrapper<T> con una propiedad T content y un constructor. Incluye un método unwrap() que devuelva el contenido, y un método describe() que imprima 'Wrapped: $content'
- Una clase genérica GiftBox<G, C> con dos propiedades: G gift y C card. Incluye un constructor y un método open() que imprima 'Gift: $gift' en una línea y 'Card: $card' en la siguiente línea
main.dart: Importa tu archivo wrapper y demuestra las clases genéricas con diferentes tipos:
- Crea un Wrapper<String> que contenga 'Chocolate' y llama a describe()
- Crea un Wrapper<int> que contenga 42 y llama a describe()
- Crea un Wrapper<double> que contenga 3.14 y llama a describe()
- Imprime una línea vacía
- Crea un GiftBox<String, String> con el regalo 'Teddy Bear' y la tarjeta 'Happy Birthday!', luego llama a open()
- Imprime una línea vacía
- Crea un GiftBox<int, String> con el regalo 100 (que representa el monto de una tarjeta de regalo) y la tarjeta 'Congratulations!', luego llama a open()

Observa cómo la misma clase Wrapper funciona perfectamente con cadenas, enteros y dobles. La clase GiftBox demuestra el uso de dos parámetros de tipo para emparejar diferentes tipos: el regalo puede ser de cualquier tipo mientras que el mensaje de la tarjeta sigue siendo una cadena.

Salida esperada:

Wrapped: Chocolate
Wrapped: 42
Wrapped: 3.14

Gift: Teddy Bear
Card: Happy Birthday!

Gift: 100
Card: Congratulations!

Hoja de referencia

Las clases genéricas utilizan parámetros de tipo (como T) como marcadores de posición para los tipos reales especificados al crear instancias:

class Box<T> {
  T content;
  
  Box(this.content);
  
  T getContent() => content;
}

void main() {
  var stringBox = Box<String>('Hello');
  var intBox = Box<int>(42);
  
  print(stringBox.getContent());  // Hello
  print(intBox.getContent());     // 42
}

Al crear Box<String>, cada T en la clase se convierte en String, proporcionando seguridad de tipos sin necesidad de clases separadas para cada tipo.

Utilice múltiples parámetros de tipo cuando trabaje con más de un tipo:

class Pair<K, V> {
  K first;
  V second;
  
  Pair(this.first, this.second);
}

void main() {
  var pair = Pair<String, int>('age', 25);
  print('${pair.first}: ${pair.second}');  // age: 25
}

Pruébalo tú mismo

import 'wrapper.dart';

void main() {
  // TODO: Crea un Wrapper<String> que contenga 'Chocolate' y llama a describe()
  
  // TODO: Crea un Wrapper<int> que contenga 42 y llama a describe()
  
  // TODO: Crea un Wrapper<double> que contenga 3.14 y llama a describe()
  
  // TODO: Imprime una línea vacía
  
  // TODO: Crea un GiftBox<String, String> con el regalo 'Teddy Bear' 
  // y la tarjeta 'Happy Birthday!', luego llama a open()
  
  // TODO: Imprime una línea vacía
  
  // TODO: Crea un GiftBox<int, String> con el regalo 100 
  // y la tarjeta 'Congratulations!', luego llama a open()
}