Privacidade no Nível da Biblioteca

Parte da seção Programação Orientada a Objetos do Journey de Dart da Coddy. Lição 32 de 110.

No Dart, a privacidade é aplicada no nível da biblioteca, não no nível da classe. Esta é uma distinção fundamental em relação a linguagens como Java ou C++. Uma biblioteca no Dart é tipicamente um único arquivo, ou múltiplos arquivos conectados com diretivas part.

Membros privados (aqueles que começam com _) são acessíveis em qualquer lugar dentro da mesma biblioteca, mesmo a partir de outras classes:

// Ambas as classes no mesmo arquivo (mesma biblioteca)
class Engine {
  int _horsepower = 200;  // Privado para esta biblioteca
}

class Car {
  void showPower(Engine engine) {
    print(engine._horsepower);  // Acessível! Mesma biblioteca
  }
}

No entanto, quando você importa uma classe de um arquivo diferente, seus membros privados tornam-se verdadeiramente ocultos:

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

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

void main() {
  var engine = Engine();
  // print(engine._horsepower);  // Error! Not accessible
  print(engine.power);           // Works - using public getter
}

Essa privacidade em nível de biblioteca significa que classes no mesmo arquivo podem colaborar estreitamente, enquanto ainda ocultam detalhes de implementação do código externo. É uma escolha de design deliberada que incentiva a organização de classes relacionadas juntas na mesma biblioteca.

Desafio

Fácil

Vamos criar um sistema de colaboração em equipe que demonstra como funciona a privacidade no nível da biblioteca em Dart. Você verá como as classes no mesmo arquivo podem acessar os membros privados umas das outras, enquanto o código em arquivos separados não pode.

Você organizará seu código em dois arquivos:

team.dart: Este arquivo conterá duas classes que trabalham em estreita colaboração na mesma biblioteca:
- Uma classe Member com um String name público e um int _performanceScore privado inicializado com 50. Inclua um construtor que receba o nome e um getter público performanceScore que retorne a pontuação privada.
- Uma classe TeamLead no mesmo arquivo que possa acessar diretamente o campo privado de Member (porque elas estão na mesma biblioteca). Essa classe deve ter um String name público, um construtor que receba o nome e um método evaluateMember(Member member) que acesse diretamente member._performanceScore, adicione 10 a ele e imprima [leadName] boosted [memberName]'s score to [newScore].
main.dart: Importe seu arquivo da equipe e demonstre a diferença no acesso:
- Crie um Member chamado 'Alice'
- Crie um TeamLead chamado 'Bob'
- Imprima Initial score: [score] usando o getter público de Alice
- Faça Bob avaliar Alice usando evaluateMember
- Imprima Updated score: [score] usando o getter público
- Imprima Direct access from main: Not allowed (isso nos lembra que main.dart não pode acessar _performanceScore diretamente, pois está em uma biblioteca diferente)

A principal conclusão aqui é que TeamLead pode ler e modificar diretamente o Member privado de _performanceScore porque ambas as classes estão no mesmo arquivo (mesma biblioteca). No entanto, o código em main.dart deve usar o getter público porque está em uma biblioteca diferente.

Saída esperada:

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

Experimente você mesmo

import 'team.dart';

void main() {
  // TODO: Criar um Member chamado 'Alice'

  // TODO: Criar um TeamLead chamado 'Bob'

  // TODO: Imprimir "Initial score: [score]" usando o getter público em Alice

  // TODO: Fazer Bob avaliar Alice usando evaluateMember

  // TODO: Imprimir "Updated score: [score]" usando o getter público

  // TODO: Imprimir "Direct access from main: Not allowed"
  // Nota: Não podemos acessar alice._performanceScore aqui porque
  // main.dart está em uma biblioteca diferente de team.dart
}