liste/List.java

public class List<ContentType> {

    // erstes Element der Liste
    ListNode<ContentType> first;

    // letztes Element der Liste
    ListNode<ContentType> last;

    // aktuelles Element der Liste
    ListNode<ContentType> current;

    /**
     * Eine leere Liste wird erzeugt.
     */
    public List() {
        first = null;
        last = null;
        current = null;
    }

    /**
     * Die Anfrage liefert den Wert true, wenn die Liste keine Objekte enthaelt,
     * sonst liefert sie den Wert false.
     *
     * @return true, wenn die Liste leer ist, sonst false
     */
    public boolean isEmpty() {
        // Die Liste ist leer, wenn es kein erstes Element gibt.
        return first == null;
    }

    /**
     * Die Anfrage liefert den Wert true, wenn es ein aktuelles Objekt gibt,
     * sonst liefert sie den Wert false.
     *
     * @return true, falls Zugriff moeglich, sonst false
     */
    public boolean hasAccess() {
        // Es gibt keinen Zugriff, wenn current auf kein Element verweist.
        return current != null;
    }

    /**
     * Falls die Liste nicht leer ist, es ein aktuelles Objekt gibt und dieses
     * nicht das letzte Objekt der Liste ist, wird das dem aktuellen Objekt in
     * der Liste folgende Objekt zum aktuellen Objekt, andernfalls gibt es nach
     * Ausfuehrung des Auftrags kein aktuelles Objekt, d.h. hasAccess() liefert
     * den Wert false.
     */
    public void next() {
        if( this.hasAccess() ) {
            current = current.getNextNode();
        }
    }

    /**
     * Falls die Liste nicht leer ist, wird das erste Objekt der Liste aktuelles
     * Objekt. Ist die Liste leer, geschieht nichts.
     */
    public void toFirst() {
        if( !isEmpty() ) {
            current = first;
        }
    }

    /**
     * Falls die Liste nicht leer ist, wird das letzte Objekt der Liste
     * aktuelles Objekt. Ist die Liste leer, geschieht nichts.
     */
    public void toLast() {
        if( !isEmpty() ) {
            current = last;
        }
    }

    /**
     * Falls es ein aktuelles Objekt gibt (hasAccess() == true), wird das
     * aktuelle Objekt zurueckgegeben, andernfalls (hasAccess() == false) gibt
     * die Anfrage den Wert null zurueck.
     *
     * @return das aktuelle Objekt (vom Typ ContentType) oder null, wenn es
     * kein aktuelles Objekt gibt
     */
    public ContentType getContent() {
        if( this.hasAccess() ) {
            return current.getContentObject();
        } else {
            return null;
        }
    }

    /**
     * Falls es ein aktuelles Objekt gibt (hasAccess() == true) und pContent
     * ungleich null ist, wird das aktuelle Objekt durch pContent ersetzt. Sonst
     * geschieht nichts.
     *
     * @param pContent das zu schreibende Objekt vom Typ ContentType
     */
    public void setContent( ContentType pContent ) {
        // Nichts tun, wenn es keinen Inhalt oder kein aktuelles Element gibt.
        if( pContent != null && this.hasAccess() ) {
            current.setContentObject(pContent);
        }
    }

    /**
     * Falls es ein aktuelles Objekt gibt (hasAccess() == true), wird ein neues
     * Objekt vor dem aktuellen Objekt in die Liste eingefuegt. Das aktuelle
     * Objekt bleibt unveraendert. <br />
     * Wenn die Liste leer ist, wird pContent in die Liste eingefuegt und es
     * gibt weiterhin kein aktuelles Objekt (hasAccess() == false). <br />
     * Falls es kein aktuelles Objekt gibt (hasAccess() == false) und die Liste
     * nicht leer ist oder pContent gleich null ist, geschieht nichts.
     *
     * @param pContent das einzufuegende Objekt vom Typ ContentType
     */
    public void insert( ContentType pContent ) {
        // TODO: Implementiere insert() anhand der Beschreibung oben.
        //       Achte auf die korrekte Einhaltung des Verkettungsprinzips und
        //       das neue Element _vor_ dem Aktuellen eingefügt werden soll.
        //       Nutze bei der Implementierung die Hilfsmethode
        //          ListNode<ContentType> getPrevious()
    }

    /**
     * Falls pContent gleich null ist, geschieht nichts.<br />
     * Ansonsten wird ein neues Objekt pContent am Ende der Liste eingefuegt.
     * Das aktuelle Objekt bleibt unveraendert. <br />
     * Wenn die Liste leer ist, wird das Objekt pContent in die Liste eingefuegt
     * und es gibt weiterhin kein aktuelles Objekt (hasAccess() == false).
     *
     * @param pContent das anzuhaengende Objekt vom Typ ContentType
     */
    public void append( ContentType pContent ) {
        if( pContent != null ) { // Nichts tun, wenn es keine Inhalt gibt.

            if( this.isEmpty() ) { // Fall: An leere Liste anfuegen.
                // Neuen Knoten erstellen.
                ListNode<ContentType> newNode = new ListNode<>(pContent);

                first = newNode;
                last = newNode;
                // current wird nicht gesetzt!
            } else { // Fall: An nicht-leere Liste anfuegen.
                // Neuen Knoten erstellen.
                ListNode<ContentType> newNode = new ListNode<>(pContent);

                last.setNextNode(newNode);
                last = newNode; // Letzten Knoten aktualisieren.
            }

        }
    }

    /**
     * Falls es sich bei der Liste und pList um dasselbe Objekt handelt,
     * pList null oder eine leere Liste ist, geschieht nichts.<br />
     * Ansonsten wird die Liste pList an die aktuelle Liste angehaengt.
     * Anschliessend wird pList eine leere Liste. Das aktuelle Objekt bleibt
     * unveraendert. Insbesondere bleibt hasAccess identisch.
     *
     * @param pList die am Ende anzuhaengende Liste vom Typ List<ContentType>
     */
    public void concat( List<ContentType> pList ) {
        if( pList != this && pList != null && !pList.isEmpty() ) { // Nichts tun,
            // wenn pList und this identisch, pList leer oder nicht existent.

            if( this.isEmpty() ) { // Fall: An leere Liste anfuegen.
                this.first = pList.first;
                this.last = pList.last;
            } else { // Fall: An nicht-leere Liste anfuegen.
                this.last.setNextNode(pList.first);
                this.last = pList.last;
            }

            // Liste pList loeschen.
            pList.first = null;
            pList.last = null;
            pList.current = null;
        }
    }

    /**
     * Wenn die Liste leer ist oder es kein aktuelles Objekt gibt (hasAccess()
     * == false), geschieht nichts.<br />
     * Falls es ein aktuelles Objekt gibt (hasAccess() == true), wird das
     * aktuelle Objekt geloescht und das Objekt hinter dem geloeschten Objekt
     * wird zum aktuellen Objekt. <br />
     * Wird das Objekt, das am Ende der Liste steht, geloescht, gibt es kein
     * aktuelles Objekt mehr.
     */
    public void remove() {
        // TODO: Implementiere remove() anhand der Beschreibung oben.
        //       Achte auf die korrekte Einhaltung des Verkettungsprinzips.
        //       Du kannst bei der Implementierung die Hilfsmethode
        //          ListNode<ContentType> getPrevious()
        //       nutzen.
    }

    /**
     * Liefert den Vorgaengerknoten des Knotens pNode. Ist die Liste leer, pNode
     * == null, pNode nicht in der Liste oder pNode der erste Knoten der Liste,
     * wird null zurueckgegeben.
     *
     * @param pNode der Knoten, dessen Vorgaenger zurueckgegeben werden soll
     * @return der Vorgaenger des Knotens pNode oder null, falls die Liste leer ist,
     * pNode == null ist, pNode nicht in der Liste ist oder pNode der erste Knoten
     * der Liste ist
     */
    private ListNode<ContentType> getPrevious( ListNode<ContentType> pNode ) {
        if( pNode != null && pNode != first && !this.isEmpty() ) {
            ListNode<ContentType> temp = first;
            while( temp != null && temp.getNextNode() != pNode ) {
                temp = temp.getNextNode();
            }
            return temp;
        } else {
            return null;
        }
    }

}