Tape是一个队列集合类库，主要包含内存对象队列，文件对象队列和任务队列，特别是文件对象队列的设计，使用了RandomAccessFile，可以在新增，移除对象时就把数据保存在文件里，使用起来非常方便。
使用方法
Tape的使用方法非常简单，和List差不多，包含方法size()，add(T entry)，peek()，remove()，看字面意思就明白，我就不具体展开了，至于TaskQueue的使用，可以看下官方的介绍.
源码分析
QueueFile(队列文件)
内存对象队列和任务队列都比较简单，主要是看到了QueueFile(队列文件)的设计受到了一些启发，在这里和可以和大家聊聊。
数据结构设计
QueueFile数据结构.png
看到上图，我们可以清晰的看到，该数据结构包含头部信息（16 bytes）和元素列表（Length - 16 bytes）。头部信息包含文件长度（4 bytes），元素个数（4 bytes），第一个元素位置（4 bytes），最后一个元素位置（4 bytes）。元素列表里面的单个元素包含元素长度（4 bytes）和元素内容。
源码设计
里面主要用到的是RandomAccessFile（随机存储文件），用seek( )方法来访问记录，只需要记住位置和大小即可。
RandomAccessFile file = new RandomAccessFile("file", "rw");
// 以下向file文件中写数据
file.writeInt(20);
file.seek(0);// 把文件指针位置设置到文件起始处
// 以下从file文件中读数据，要注意文件指针的位置
file.readInt();
在QueueFile里面对RandomAccessFile使用主要就是用到上面这几个方法，我们接下来看看QueueFile源码。
QueueFile初始化
public QueueFile(File file) throws IOException {
if (!file.exists()) initialize(file);//如果文件不存在，则初始化
raf = open(file);//创建RandomAccessFile
readHeader();//读取头部信息
}
private static void initialize(File file) throws IOException {
// Use a temp file so we don't leave a partially-initialized file.
File tempFile = new File(file.getPath() + ".tmp");//创建文件*.tmp
RandomAccessFile raf = open(tempFile);//创建RandomAccessFile
try {
raf.setLength(INITIAL_LENGTH);//初始化RandomAccessFile文件长度是4096
raf.seek(0);// 把文件指针位置设置到文件起始处
byte[] headerBuffer = new byte[16];//初始化头部信息bytes
writeInts(headerBuffer, INITIAL_LENGTH, 0, 0, 0);//将文件长度为4096写入headerBuffer
raf.write(headerBuffer);//将headerBuffer写入RandomAccessFile文件
} finally {
raf.close();
}
// A rename is atomic.
if (!tempFile.renameTo(file)) throw new IOException("Rename failed!");//将tempFile重命名成file
}
private void readHeader() throws IOException {
raf.seek(0);
raf.readFully(buffer);
fileLength = readInt(buffer, 0);
if (fileLength > raf.length()) {
throw new IOException("File is truncated. Expected length: " + fileLength + ", Actual length: " + raf.length());
} else if (fileLength == 0) {
throw new IOException("File is corrupt; length stored in header is 0.");
}
elementCount = readInt(buffer, 4);//读取元素个数
int firstOffset = readInt(buffer, 8);//读取第一个元素的位置
int lastOffset = readInt(buffer, 12);//读取最后一个元素的位置
first = readElement(firstOffset);//读取第一个元素
last = readElement(lastOffset);//读取最后一个元素
}
至此，QueueFile初始化完成。
接下来看下add方法。
public void add(byte[] data) throws IOException {
add(data, 0, data.length);
}
public synchronized void add(byte[] data, int offset, int count) throws IOException {
nonNull(data, "buffer");
if ((offset | count) < 0 || count > data.length - offset) {
throw new IndexOutOfBoundsException();
}
expandIfNecessary(count);//判断新增内容之后文件长度是否够，如果不够则进行扩大
// Insert a new element after the current last element.
boolean wasEmpty = isEmpty();
int position = wasEmpty ? HEADER_LENGTH : wrapPosition(last.position + Element.HEADER_LENGTH + last.length);
Element newLast = new Element(position, count);
// Write length.
writeInt(buffer, 0, count);//向buffer写入新元素长度
ringWrite(newLast.position, buffer, 0, Element.HEADER_LENGTH);//向RandomAccessFile写入新元素长度
// Write data.
ringWrite(newLast.position + Element.HEADER_LENGTH, data, offset, count);//向RandomAccessFile写入新元素内容
// Commit the addition. If wasEmpty, first == last.
int firstPosition = wasEmpty ? newLast.position : first.position;
writeHeader(fileLength, elementCount + 1, firstPosition, newLast.position);//写入头部信息
last = newLast;
elementCount++;
if (wasEmpty) first = last; // first element
}
peek方法，返回第一个元素内容
public synchronized byte[] peek() throws IOException {
if (isEmpty()) return null;
int length = first.length;
byte[] data = new byte[length];
ringRead(first.position + Element.HEADER_LENGTH, data, 0, length);
return data;
}
remove方法
public synchronized void remove() throws IOException {
if (isEmpty()) throw new NoSuchElementException();
if (elementCount == 1) {//如果元素个数等于1，则清空全部内容
clear();
} else {
// assert elementCount > 1
int firstTotalLength = Element.HEADER_LENGTH + first.length;
ringErase(first.position, firstTotalLength);//清除第一个元素数据
int newFirstPosition = wrapPosition(first.position + firstTotalLength);
ringRead(newFirstPosition, buffer, 0, Element.HEADER_LENGTH);
int length = readInt(buffer, 0);//新元素内容长度
writeHeader(fileLength, elementCount - 1, newFirstPosition, last.position);//写入更新之后的头部信息
elementCount--;
first = new Element(newFirstPosition, length);
}
}
private void ringErase(int position, int length) throws IOException {
while (length > 0) {
int chunk = min(length, ZEROES.length);
ringWrite(position, ZEROES, 0, chunk);
length -= chunk;
position += chunk;
}
}
需要注意的是，在清除第一个元素数据时，只是将第一个元素的数据设置成0。
总结
测试发现，RandomAccessFile在处理大数据的时候读写性能很差，主要原因是RandomAccessFile每读/写一个字节就需对磁盘进行一次I/O操作，所以QueueFile不适合大数据的读写。不过可以对RandomAccessFile进行优化，增加缓冲读写机制，看该文。
参考资料
Tape
花1K内存实现高效I/O的RandomAccessFile类
可以随意转发，也欢迎关注我的简书，我会坚持给大家带来分享。
