Null Safety en clases

Parte de la sección Programación Orientada a Objetos del Journey de Dart de Coddy. Lección 28 de 110.

Al diseñar clases, debes decidir qué campos son obligatorios y cuáles son opcionales. La seguridad contra nulos (null safety) afecta cómo declaras las variables de instancia y escribes los constructores.

Los campos no anulables deben inicializarse antes de que se ejecute el cuerpo del constructor. Puedes hacerlo mediante listas de inicializadores, parámetros del constructor o valores predeterminados:

class User {
  String name;           // Debe ser inicializado
  String? bio;           // Opcional - puede ser nulo
  int age = 0;           // Tiene un valor por defecto
  
  User(this.name);       // name se inicializa a través del parámetro
}

Para los campos que admiten valores nulos, puedes dejarlos sin inicializar ya que por defecto son null. Esto es útil para datos opcionales:

class Product {
  String title;
  String? description;   // Descripción opcional del producto
  double? discount;      // Sin descuento por defecto
  
  Product(this.title);
}

var item = Product('Laptop');
print(item.description);  // null
print(item.discount);     // null

Al acceder a campos que admiten valores nulos, utiliza los operadores null-aware que has aprendido:

class Order {
  String id;
  User? customer;
  
  Order(this.id);
  
  String getCustomerName() {
    return customer?.name ?? 'Guest';
  }
}

La palabra clave required en parámetros nombrados asegura que quienes realizan la llamada proporcionen valores esenciales:

class Account {
  String email;
  String? phone;
  
  Account({required this.email, this.phone});
}

var acc = Account(email: 'test@mail.com');  // phone es opcional

Al elegir cuidadosamente entre campos anulables y no anulables, creas clases que comunican claramente qué datos son esenciales y cuáles son opcionales.

Desafío

Fácil

Construyamos un sistema de reservas para un hotel que demuestre cómo diseñar clases con una combinación bien pensada de campos obligatorios y opcionales mediante la seguridad frente a valores nulos.

Organizarás tu código en dos archivos:

reservation.dart: Define una clase Reservation que represente una reserva de hotel. Cada reserva necesita cierta información esencial, pero algunos detalles son extras opcionales que los huéspedes pueden proporcionar o no. Tu clase debe tener:
- Un String guestName no anulable: toda reserva debe tener el nombre de un huésped
- Un int roomNumber no anulable: toda reserva debe tener una habitación asignada
- Un int nights no anulable con un valor predeterminado de 1: la estancia mínima es de una noche
- Un String? specialRequests anulable: los huéspedes pueden tener solicitudes especiales
- Un DateTime? checkInTime anulable: es posible que no se conozca la hora exacta de llegada
- Un constructor que use parámetros con nombre y required para guestName y roomNumber, mientras que nights debe ser opcional con su valor predeterminado
- Un método getRequestsSummary() que devuelva las solicitudes especiales si se proporcionaron, o 'No special requests' mediante el operador ??
- Un método getArrivalInfo() que devuelva la representación de cadena de la hora de llegada mediante ?., o null si no se estableció
- Un método printConfirmation() que muestre los detalles de la reserva
main.dart: Importa tu clase de reserva y crea reservas que muestren diferentes combinaciones de datos obligatorios y opcionales:
- Crea una reserva para el huésped 'Sarah Johnson' en la habitación 101 por 3 noches, con las solicitudes especiales 'Late checkout' y la hora de llegada establecida en DateTime(2024, 6, 15, 14, 30)
- Crea una reserva para el huésped 'Mike Chen' en la habitación 205 (usa las noches predeterminadas), estableciendo únicamente las solicitudes especiales en 'Extra pillows'
- Crea una reserva para el huésped 'Emma Davis' en la habitación 310 por 2 noches (deja ambos campos opcionales como null)
- Para cada reserva, en orden, llama a printConfirmation() y después imprime Arrival: [result] usando getArrivalInfo()

El método printConfirmation() debe imprimir con este formato:

=== Reservation Confirmed ===
Guest: [guestName]
Room: [roomNumber]
Nights: [nights]
Requests: [getRequestsSummary()]

Salida esperada:

=== Reservation Confirmed ===
Guest: Sarah Johnson
Room: 101
Nights: 3
Requests: Late checkout
Arrival: 2024-06-15 14:30:00.000
=== Reservation Confirmed ===
Guest: Mike Chen
Room: 205
Nights: 1
Requests: Extra pillows
Arrival: null
=== Reservation Confirmed ===
Guest: Emma Davis
Room: 310
Nights: 2
Requests: No special requests
Arrival: null

Pruébalo tú mismo

import 'reservation.dart';

void main() {
  // TODO: Crear reserva para 'Sarah Johnson'
  // Habitación 101, 3 noches, peticiones especiales: 'Late checkout'
  // Hora de check-in: DateTime(2024, 6, 15, 14, 30)
  
  // TODO: Crear reserva para 'Mike Chen'
  // Habitación 205, usar noches por defecto, peticiones especiales: 'Extra pillows'
  // No se especificó hora de check-in
  
  // TODO: Crear reserva para 'Emma Davis'
  // Habitación 310, 2 noches, sin peticiones especiales, sin hora de check-in
  
  // TODO: Para cada reserva en orden:
  // 1. Llamar a printConfirmation()
  // 2. Imprimir 'Arrival: [result]' usando getArrivalInfo()
}