The interface used for setting up an area initially in a store. This method
is intended to optimize the area creation process. Typically an area is
created at a specified size and filled with data. This area should be
used as follows;
AreaWriter writer = store.createArea(16);
writer.putInt(3);
writer.putLong(100030);
writer.putByte(1);
writer.putShort(0);
writer.putByte(2);
writer.finish();
When the 'finish' method is called, the AreaWriter object is invalidated and
the area can then be accessed in the store by the 'getArea' method.
Note that an area may only be written sequentially using this object. This
is by design and allows for the area initialization process to be optimized.
author: Tobias Downer |