Class SqlJetFile

  • All Implemented Interfaces:
    ISqlJetFile

    public class SqlJetFile
    extends java.lang.Object
    implements ISqlJetFile
    Author:
    TMate Software Ltd., Sergey Scherbina (sergey.scherbina@gmail.com)
    • Field Detail

      • SQLJET_DEFAULT_SECTOR_SIZE

        public static final int SQLJET_DEFAULT_SECTOR_SIZE
        See Also:
        Constant Field Values
    • Method Detail

      • sync

        public void sync​(java.util.Set<SqlJetSyncFlags> syncFlags)
                  throws SqlJetIOException
        Description copied from interface: ISqlJetFile
        Make sure all writes to a particular file are committed to disk. If dataOnly==false then both the file itself and its metadata (file size, access time, etc) are synced. If dataOnly==true then only the file data is synced. Also make sure that the directory entry for the file has been created by fsync-ing the directory that contains the file. If we do not do this and we encounter a power failure, the directory entry for the journal might not exist after we reboot. The next SqlJet to access the file will not know that the journal exists (because the directory entry for the journal was never created) and the transaction will not roll back - possibly leading to database corruption.
        Specified by:
        sync in interface ISqlJetFile
        Throws:
        SqlJetIOException
      • lock

        public boolean lock​(SqlJetLockType lockType)
                     throws SqlJetIOException
        Description copied from interface: ISqlJetFile
        Lock the file with the lock specified by parameter locktype - one of the following: (1) SHARED (2) RESERVED (3) PENDING (4) EXCLUSIVE Sometimes when requesting one lock state, additional lock states are inserted in between. The locking might fail on one of the later transitions leaving the lock state different from what it started but still short of its goal. The following chart shows the allowed transitions and the inserted intermediate states: UNLOCKED -> SHARED SHARED -> RESERVED SHARED -> (PENDING) -> EXCLUSIVE RESERVED -> (PENDING) -> EXCLUSIVE PENDING -> EXCLUSIVE This routine will only increase a lock.
        Specified by:
        lock in interface ISqlJetFile
        Returns:
        Throws:
        SqlJetIOException
      • unlock

        public boolean unlock​(SqlJetLockType lockType)
                       throws SqlJetIOException
        Description copied from interface: ISqlJetFile
        Lower the locking level on file descriptor pFile to locktype. locktype must be either NONE or SHARED. If the locking level of the file descriptor is already at or below the requested locking level, this routine is a no-op.
        Specified by:
        unlock in interface ISqlJetFile
        Returns:
        Throws:
        SqlJetIOException
      • checkReservedLock

        public boolean checkReservedLock()
        Description copied from interface: ISqlJetFile
        This routine checks if there is a RESERVED lock held on the specified file by this or any other process. The return value is set unless an I/O error occurs during lock checking.
        Specified by:
        checkReservedLock in interface ISqlJetFile
        Returns:
      • sectorSize

        public int sectorSize()
        Description copied from interface: ISqlJetFile
        Return the sector size in bytes of the underlying block device for the specified file. This is almost always 512 bytes, but may be larger for some devices. SqlJet code assumes this function cannot fail. It also assumes that if two files are created in the same file-system directory (i.e. a database and its journal file) that the sector size will be the same for both.
        Specified by:
        sectorSize in interface ISqlJetFile
        Returns:
      • isMemJournal

        public boolean isMemJournal()
        Description copied from interface: ISqlJetFile
        Return true if the file-handle passed as an argument is an in-memory journal
        Specified by:
        isMemJournal in interface ISqlJetFile