liste/List.java

231 lines
8.0 KiB
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 ) {
ListNode<ContentType> newNode = new ListNode<>(pContent);
if (hasAccess()) {
if (current == first) {
newNode.setNextNode(first);
first = newNode;
current = newNode;
} else {
ListNode prev = getPrevious(current);
current.setNextNode(prev.getNextNode());
}
} else {
append(pContent);
}
}
/**
* 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;
}
}
}