com.db4o.io

Interface Bin

All Known Implementing Classes:

BinDecorator, BlockAwareBin, FileStorage.FileBin, MemoryBin, ReadOnlyBin, SynchronizedBin, ThreadedSyncBin

public interface Bin

Representation of a container for storage of db4o database data (to file, to memory).

Method Summary

Methods

Modifier and Type	Method and Description
void	close() closes the Bin.
long	length() returns the length of the Bin (on disc, in memory).
int	read(long position, byte[] bytes, int bytesToRead) reads a given number of bytes into an array of bytes at an offset position.
void	sync() flushes the buffer content to the physical storage media.
void	sync(java.lang.Runnable runnable) runs the Runnable between two calls to sync();
int	syncRead(long position, byte[] bytes, int bytesToRead) reads a given number of bytes into an array of bytes at an offset position.
void	write(long position, byte[] bytes, int bytesToWrite) writes a given number of bytes from an array of bytes at an offset position

Method Detail

length

long length()

returns the length of the Bin (on disc, in memory).

read

int read(long position,
       byte[] bytes,
       int bytesToRead)

reads a given number of bytes into an array of bytes at an offset position.

Parameters:

position - the offset position to read at

bytes - the byte array to read bytes into

bytesToRead - the number of bytes to be read

Returns:

write

void write(long position,
         byte[] bytes,
         int bytesToWrite)

writes a given number of bytes from an array of bytes at an offset position

Parameters:

position - the offset position to write at

bytes - the array of bytes to write

bytesToWrite - the number of bytes to write

sync

void sync()

flushes the buffer content to the physical storage media.

sync

void sync(java.lang.Runnable runnable)

runs the Runnable between two calls to sync();

syncRead

int syncRead(long position,
           byte[] bytes,
           int bytesToRead)

reads a given number of bytes into an array of bytes at an offset position. In contrast to the normal read(long, byte[], int) method, the Bin should ensure direct access to the raw storage medium. No caching should take place.

Parameters:

position - the offset position to read at

bytes - the byte array to read bytes into

bytesToRead - the number of bytes to be read

Returns:

close

void close()

closes the Bin.