Package com.db4o.io

Interface Bin

    • 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 at
        bytes - the byte array to read bytes into
        bytesToRead - 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 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.