db4o 8.0

com.db4o.io
Interface Bin

All Known Implementing Classes:
BinDecorator, FileStorage.FileBin, MemoryBin, ThreadedSyncBin

public interface Bin

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


Method Summary
 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.


db4o 8.0

Copyright 2009 Versant Corporation. All rights reserved.