ml.shifu.guagua.util

Interface AppendList<T>

All Superinterfaces:

Iterable<T>

All Known Implementing Classes:

BytableDiskList, BytableMemoryDiskList, DiskList, MemoryDiskList, MemoryLimitedList

public interface AppendList<T>
extends Iterable<T>

Appendable list interface definition.

Two states are in this list. State AppendList.State.WRITE when instance created, then element can be appended to tail. After all elements are appended, switch state to AppendList.State.READ. When state is AppendList.State.READ, data cannot be appended, only can be iterative.

Only support appending element to tail and iterative reading.

Such code as an example:

 AppendList<Data> dataList = new MemoryDiskList<Data>(60L, "c.txt");
 dataList.append(new Data(1, 1));
 dataList.append(new Data(2, 2));
 dataList.append(new Data(3, 3));
 dataList.append(new Data(4, 4));
 
 dataList.switchState();
 
 for(Data d: dataList) {
     System.out.println(d);
 }
 

Author:

Zhang David (pengzhang@paypal.com)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AppendList.State Inner state definition.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	append(T t) Append object to this list
void	clear() Clear all elements.
int	size() Return size of this list.
void	switchState() After appending, switch state from WRITE to READ to allow iterating.

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

append

boolean append(T t)

Append object to this list

Parameters:

t - the object to append

Returns:

whether appending object successful

Throws:

IllegalStateException - if not in WRITE state.

switchState

void switchState()

After appending, switch state from WRITE to READ to allow iterating.

size

int size()

Return size of this list.

clear

void clear()

Clear all elements.