Privacidad a nivel de librería

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

En Dart, la privacidad se aplica a nivel de biblioteca, no a nivel de clase. Esta es una distinción clave respecto a lenguajes como Java o C++. Una biblioteca en Dart es normalmente un solo archivo, o múltiples archivos conectados con directivas part.

Los miembros privados (aquellos que comienzan con _) son accesibles en cualquier lugar dentro de la misma librería, incluso desde otras clases:

// Both classes in the same file (same library)
class Engine {
  int _horsepower = 200;  // Private to this library
}

class Car {
  void showPower(Engine engine) {
    print(engine._horsepower);  // Accessible! Same library
  }
}

Sin embargo, cuando importas una clase desde un archivo diferente, sus miembros privados se vuelven verdaderamente ocultos:

// archivo: engine.dart
class Engine {
  int _horsepower = 200;
  int get power => _horsepower;
}

// archivo: main.dart
import 'engine.dart';

void main() {
  var engine = Engine();
  // print(engine._horsepower);  // ¡Error! No es accesible
  print(engine.power);           // Funciona - usando el getter público
}

Esta privacidad a nivel de librería significa que las clases en el mismo archivo pueden colaborar estrechamente mientras siguen ocultando los detalles de implementación del código externo. Es una elección de diseño deliberada que fomenta la organización de clases relacionadas juntas en la misma librería.

Desafío

Fácil

Construyamos un sistema de colaboración en equipo que demuestre cómo funciona la privacidad a nivel de biblioteca en Dart. Verás cómo las clases del mismo archivo pueden acceder a los miembros privados de las demás, mientras que el código de archivos separados no puede hacerlo.

Organizarás tu código en dos archivos:

team.dart: Este archivo contendrá dos clases que trabajan estrechamente juntas en la misma biblioteca:
- Una clase Member con un String name público y un int _performanceScore privado inicializado en 50. Incluye un constructor que reciba el nombre y un getter público performanceScore que devuelva la puntuación privada.
- Una clase TeamLead en el mismo archivo que pueda acceder directamente al campo privado de Member (porque están en la misma biblioteca). Esta clase debe tener un String name público, un constructor que reciba el nombre y un método evaluateMember(Member member) que acceda directamente a member._performanceScore, le sume 10 e imprima [leadName] boosted [memberName]'s score to [newScore].
main.dart: Importa tu archivo del equipo y demuestra la diferencia en el acceso:
- Crea un Member llamado 'Alice'
- Crea un TeamLead llamado 'Bob'
- Imprime Initial score: [score] usando el getter público de Alice
- Haz que Bob evalúe a Alice usando evaluateMember
- Imprime Updated score: [score] usando el getter público
- Imprime Direct access from main: Not allowed (esto nos recuerda que main.dart no puede acceder directamente a _performanceScore porque está en una biblioteca diferente)

La idea clave aquí es que TeamLead puede leer y modificar directamente el Member privado de _performanceScore porque ambas clases se encuentran en el mismo archivo (la misma biblioteca). Sin embargo, el código de main.dart debe usar el getter público porque está en una biblioteca diferente.

Salida esperada:

Initial score: 50
Bob boosted Alice's score to 60
Updated score: 60
Direct access from main: Not allowed

Pruébalo tú mismo

import 'team.dart';

void main() {
  // TODO: Crea un Member llamado 'Alice'

  // TODO: Crea un TeamLead llamado 'Bob'

  // TODO: Imprime "Initial score: [score]" usando el getter público en Alice

  // TODO: Haz que Bob evalúe a Alice usando evaluateMember

  // TODO: Imprime "Updated score: [score]" usando el getter público

  // TODO: Imprime "Direct access from main: Not allowed"
  // Note: No podemos acceder a alice._performanceScore aquí porque
  // main.dart está en una biblioteca diferente a team.dart
}