Turm.java

/**
 * Repräsentiert einen einzelnen Turm im Turm-von-Hanoi-Spiel.
 * Ein `Turm` enthält einen Stapel von `Scheibe`-Objekten sowie
 * eine Zählvariable für die aktuelle Höhe.
 */
public class Turm {
    /** Internes LIFO-Stapel für die Scheiben dieses Turms. */
    private Stack<Scheibe> stapel;
    /** Anzahl der Scheiben auf dem Turm. */
    private int anzahl;

    /**
     * Erzeugt einen leeren Turm.
     */
    public Turm() {
        stapel = new Stack<Scheibe>();
        anzahl = 0;
    }

    /**
     * Legt eine Scheibe oben auf den Turm. Erhöht die Anzahl der Scheiben um 1.
     *
     * @param pScheibe die aufzulegende `Scheibe`
     */
    public void scheibeAufnehmen(Scheibe pScheibe) {
        // Füge hier deinen Code ein.
    }

    /**
     * Gibt die oberste Scheibe zurück, ohne sie zu entfernen.
     *
     * @return die oberste `Scheibe` oder `null`, falls der Turm leer ist
     */
    public Scheibe gibScheibe() {
        // Füge hier deinen Code ein.
    }

    /**
     * Entfernt die oberste Scheibe vom Turm. Verringert die Anzahl der Scheiben um
     * 1.
     * Ist der Turm leer, passiert nichts.
     */
    public void scheibeLoeschen() {
        // Füge hier deinen Code ein.
    }

    /**
     * Prüft, ob der Turm keine Scheiben enthält.
     *
     * @return `true`, wenn der Turm leer ist, sonst `false`
     */
    public boolean istLeer() {
        // Füge hier deinen Code ein.
    }

    /**
     * Liefert die Anzahl der Scheiben auf dem Turm.
     *
     * @return die Höhe des Turms als Ganzzahl
     */
    public int gibHoehe() {
        // Füge hier deinen Code ein.
    }

    /**
     * Gibt direkten Zugriff auf den internen Stapel zurück.
     * Wird von Views oder Tests genutzt, um den Turminhalt zu
     * inspizieren.
     *
     * @return das `Stack<Scheibe>`-Objekt dieses Turms
     */
    public Stack<Scheibe> gibStapel() {
        return stapel;
    }
}