/* 高手之作,本人谨以收藏者身份共享源码,供大家参考之! */
/*
* 列表ADT接口
*/
package dsa;
public interface List {
//查询列表当前的规模
public int getSize();
//判断列表是否为空
public boolean isEmpty();
//返回第一个元素(的位置)
public Position first();
//返回最后一个元素(的位置)
public Position last();
//返回紧接给定位置之后的元素(的位置)
public Position getNext(Position p)
throws ExceptionPositionInvalid, ExceptionBoundaryViolation;
//返回紧靠给定位置之前的元素(的位置)
public Position getPrev(Position p)
throws ExceptionPositionInvalid, ExceptionBoundaryViolation;
//将e作为第一个元素插入列表
public Position insertFirst(Object e);
//将e作为最后一个元素插入列表
public Position insertLast(Object e);
//将e插入至紧接给定位置之后的位置
public Position insertAfter(Position p, Object e)
throws ExceptionPositionInvalid;
//将e插入至紧靠给定位置之前的位置
public Position insertBefore(Position p, Object e)
throws ExceptionPositionInvalid;
//删除给定位置处的元素,并返回之
public Object remove(Position p)
throws ExceptionPositionInvalid;
//删除首元素,并返回之
public Object removeFirst();
//删除末元素,并返回之
public Object removeLast();
//将处于给定位置的元素替换为新元素,并返回被替换的元素
public Object replace(Position p, Object e)
throws ExceptionPositionInvalid;
//位置迭代器
public Iterator positions();
//元素迭代器
public Iterator elements();
}
/*
* 基于双向链表实现列表结构
*/
package dsa;
public class List_DLNode implements List {
protected int numElem;//列表的实际规模
protected DLNode header, trailer;//哨兵:首节点+末节点
//构造函数
public List_DLNode() {
numElem = 0;//空表
header = new DLNode(null, null, null);//头节点
trailer = new DLNode(null, header, null);//尾节点
header.setNext(trailer);//头、尾节点相互链接
}
/**************************** 辅助方法 ****************************/
//检查给定位置在列表中是否合法,若是,则将其转换为*DLNode
protected DLNode checkPosition(Position p) throws ExceptionPositionInvalid {
if (null == p)
throw new ExceptionPositionInvalid("意外:传递给List_DLNode的位置是null");
if (header == p)
throw new ExceptionPositionInvalid("意外:头节点哨兵位置非法");
if (trailer == p)
throw new ExceptionPositionInvalid("意外:尾结点哨兵位置非法");
DLNode temp = (DLNode)p;
return temp;
}
/**************************** ADT方法 ****************************/
//查询列表当前的规模
public int getSize() { return numElem; }
//判断列表是否为空
public boolean isEmpty() { return (numElem == 0); }
//返回第一个元素(的位置)
public Position first() throws ExceptionListEmpty {
if (isEmpty())
throw new ExceptionListEmpty("意外:列表空");
return header.getNext();
}
//返回最后一个元素(的位置)
public Position last() throws ExceptionListEmpty {
if (isEmpty())
throw new ExceptionListEmpty("意外:列表空");
return trailer.getPrev();
}
//返回紧靠给定位置之前的元素(的位置)
public Position getPrev(Position p)
throws ExceptionPositionInvalid, ExceptionBoundaryViolation {
DLNode v = checkPosition(p);
DLNode prev = v.getPrev();
if (prev == header)
throw new ExceptionBoundaryViolation("意外:企图越过列表前端");
return prev;
}
//返回紧接给定位置之后的元素(的位置)
public Position getNext(Position p)
throws ExceptionPositionInvalid, ExceptionBoundaryViolation {
DLNode v = checkPosition(p);
DLNode next = v.getNext();
if (next == trailer)
throw new ExceptionBoundaryViolation("意外:企图越过列表后端");
return next;
}
//将e插入至紧靠给定位置之前的位置
public Position insertBefore(Position p, Object element)
throws ExceptionPositionInvalid {
DLNode v = checkPosition(p);
numElem++;
DLNode newNode = new DLNode(element, v.getPrev(), v);
v.getPrev().setNext(newNode);
v.setPrev(newNode);
return newNode;
}
//将e插入至紧接给定位置之后的位置
public Position insertAfter(Position p, Object element)
throws ExceptionPositionInvalid {
DLNode v = checkPosition(p);
numElem++;
DLNode newNode = new DLNode(element, v, v.getNext());
v.getNext().setPrev(newNode);
v.setNext(newNode);
return newNode;
}
//将e作为第一个元素插入列表
public Position insertFirst(Object e) {
numElem++;
DLNode newNode = new DLNode(e, header, header.getNext());
header.getNext().setPrev(newNode);
header.setNext(newNode);
return newNode;
}
//将e作为最后一个元素插入列表
public Position insertLast(Object e) {
numElem++;
DLNode newNode = new DLNode(e, trailer.getPrev(), trailer);
if (null == trailer.getPrev()) System.out.println("!!!Prev of trailer is NULL!!!");
trailer.getPrev().setNext(newNode);
trailer.setPrev(newNode);
return newNode;
}
//删除给定位置处的元素,并返回之
public Object remove(Position p)
throws ExceptionPositionInvalid {
DLNode v = checkPosition(p);
numElem--;
DLNode vPrev = v.getPrev();
DLNode vNext = v.getNext();
vPrev.setNext(vNext);
vNext.setPrev(vPrev);
Object vElem = v.getElem();
//将该位置(节点)从列表中摘出,以便系统回收其占用的空间
v.setNext(null);
v.setPrev(null);
return vElem;
}
//删除首元素,并返回之
public Object removeFirst()
{ return remove(header.getNext()); }
//删除末元素,并返回之
public Object removeLast()
{ return remove(trailer.getPrev()); }
//将处于给定位置的元素替换为新元素,并返回被替换的元素
public Object replace(Position p, Object obj)
throws ExceptionPositionInvalid {
DLNode v = checkPosition(p);
Object oldElem = v.getElem();
v.setElem(obj);
return oldElem;
}
//位置迭代器
public Iterator positions()
{ return new IteratorPosition(this); }
//元素迭代器
public Iterator elements()
{ return new IteratorElement(this); }
}