Package com.db4o.io
Interface Bin
-
- All Known Implementing Classes:
BinDecorator
,BlockAwareBin
,FileStorage.FileBin
,MemoryBin
,PagingMemoryBin
,ReadOnlyBin
,SynchronizedBin
,ThreadedSyncBin
public interface Bin
Representation of a container for storage of db4o database data (to file, to memory).
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method 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 atbytes
- the byte array to read bytes intobytesToRead
- the number of bytes to be read- Returns:
- The number of bytes actually read (<= bytesToRead) or -1 if position already points to/exceeds the end of the bin
-
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 atbytes
- the array of bytes to writebytesToWrite
- 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 normalread(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 atbytes
- the byte array to read bytes intobytesToRead
- the number of bytes to be read- Returns:
-
close
void close()
closes the Bin.
-
-