Die _-Präfix-Konvention

Teil des Abschnitts Objektorientierte Programmierung der Dart-Journey von Coddy. Lektion 31 von 110.

Der Unterstrich-Präfix _ ist Darts Methode, um Member als privat zu kennzeichnen. Im Gegensatz zu Sprachen, die Schlüsselwörter wie private verwenden, verlässt sich Dart auf diese Namenskonvention, um die Sichtbarkeit zu steuern.

Sie können den Unterstrich sowohl auf Felder als auch auf Methoden anwenden:

class Counter {
  int _count = 0;        // Privates Feld
  
  void _increment() {    // Private Methode
    _count++;
  }
  
  void increase() {      // Öffentliche Methode
    _increment();
    print('Count: $_count');
  }
}

Der Unterstrich funktioniert für jeden Bezeichner – Variablen, Methoden, Getter, Setter und sogar Klassennamen. Eine Klasse namens _Helper wäre privat für ihre Bibliothek.

class Person {
  String _name;          // Privat
  int _age;              // Privat
  
  Person(this._name, this._age);
  
  String get name => _name;           // Öffentlicher Getter
  void _validateAge(int age) { }      // Private Methode
}

Innerhalb derselben Klasse greifst du ganz normal auf private Member zu. Die Einschränkung gilt nur für Code außerhalb der Bibliothek. Diese Konvention macht beim Lesen des Codes sofort deutlich, welche Member nur für den internen Gebrauch bestimmt sind – alles, was mit _ beginnt, ist ein Implementierungsdetail.

Aufgabe

Einfach

Erstellen wir einen Punktestand-Tracker für ein Spiel, der zeigt, wie das Präfix mit Unterstrich interne Implementierungsdetails verbirgt und gleichzeitig eine übersichtliche öffentliche Schnittstelle bereitstellt.

Du organisierst deinen Code in zwei Dateien:

score_tracker.dart: Erstelle eine ScoreTracker-Klasse, die den Punktestand eines Spielers mit geeigneter Kapselung verwaltet. Die Klasse sollte Folgendes enthalten:
- Ein öffentliches String playerName – jeder kann sehen, wer spielt
- Ein privates int _score, initialisiert mit 0 – der Rohpunktestand sollte geschützt sein
- Einen privaten int _bonusMultiplier, initialisiert mit 1 – dies ist eine interne Spielmechanik
- Einen Konstruktor, der den Spielernamen entgegennimmt
- Einen öffentlichen Getter score, der den privaten _score zurückgibt
- Eine private Methode _applyBonus(int points), die points * _bonusMultiplier zurückgibt
- Eine öffentliche Methode addPoints(int points), die intern _applyBonus verwendet, um die tatsächlich hinzugefügten Punkte zu berechnen, _score aktualisiert und Added [calculated] points! ausgibt
- Eine öffentliche Methode activateDoubleBonus(), die _bonusMultiplier auf 2 setzt und Double bonus activated! ausgibt
- Eine öffentliche Methode displayStats(), die den aktuellen Status des Spielers anzeigt
main.dart: Importiere deinen Punktestand-Tracker und simuliere eine Spielsitzung:
- Erstelle einen ScoreTracker für den Spieler 'Alex'
- Rufe displayStats() auf
- Füge 10 Punkte hinzu
- Füge 25 Punkte hinzu
- Aktiviere den doppelten Bonus
- Füge 15 Punkte hinzu (diese sollten verdoppelt werden)
- Rufe displayStats() auf
- Gib Final score: [score] mithilfe des öffentlichen Getters aus

Die Methode displayStats() sollte in diesem Format ausgeben:

=== Player Stats ===
Player: [playerName]
Current Score: [_score]

Beachte, wie die private Methode _applyBonus und das Feld _bonusMultiplier die Bonusberechnung intern übernehmen. Externer Code sieht nur die öffentlichen Methoden und weiß nichts über das Multiplikatorsystem – es handelt sich um ein Implementierungsdetail, das hinter der Konvention mit dem Unterstrich verborgen ist.

Erwartete Ausgabe:

=== Player Stats ===
Player: Alex
Current Score: 0
Added 10 points!
Added 25 points!
Double bonus activated!
Added 30 points!
=== Player Stats ===
Player: Alex
Current Score: 65
Final score: 65

Probier es selbst

import 'score_tracker.dart';

void main() {
  // TODO: Erstelle einen ScoreTracker für Spieler 'Alex'
  
  // TODO: Rufe displayStats() auf
  
  // TODO: Füge 10 Punkte hinzu
  
  // TODO: Füge 25 Punkte hinzu
  
  // TODO: Aktiviere den doppelten Bonus
  
  // TODO: Füge 15 Punkte hinzu (dies sollte verdoppelt werden)
  
  // TODO: Rufe displayStats() auf
  
  // TODO: Gib 'Final score: [score]' unter Verwendung des öffentlichen Getters aus
}