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

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

Organizarás tu código en dos archivos:

team.dart: Este archivo contendrá dos clases que trabajan estrechamente en la misma librería:
- 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 librería). 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 de 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 en 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 a _performanceScore directamente ya que está en una librería diferente)

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

Salida esperada:

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

Hoja de referencia

En Dart, la privacidad se aplica a nivel de librería, no a nivel de clase. Una librería es normalmente un solo archivo, o múltiples archivos conectados con directivas part.

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

// Ambas clases en el mismo archivo (misma librería)
class Engine {
  int _horsepower = 200;  // Privado para esta librería
}

class Car {
  void showPower(Engine engine) {
    print(engine._horsepower);  // ¡Accesible! Misma librería
  }
}

Cuando importas una clase desde un archivo diferente, sus miembros privados se vuelven 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 accesible
  print(engine.power);           // Funciona - usando un getter público
}

Este diseño fomenta la organización de clases relacionadas juntas en la misma librería, permitiéndoles colaborar estrechamente mientras se ocultan los detalles de implementación al código externo.

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
}