|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sleepycat.je.log.FileManager
public class FileManager
The FileManager presents the abstraction of one contiguous file. It doles out LSNs.
Nested Class Summary | |
---|---|
static class |
FileManager.FileMode
|
(package private) class |
FileManager.LogEndFileDescriptor
The LogEndFileDescriptor is used to write and fsync the end of the log. |
Constructor Summary | |
---|---|
FileManager(EnvironmentImpl envImpl,
File dbEnvHome,
boolean readOnly)
Set up the file cache and initialize the file manager to point to the beginning of the log. |
Method Summary | |
---|---|
(package private) boolean |
bumpLsn(long size)
Increase the current log position by "size" bytes. |
boolean |
checkEnvHomePermissions(boolean rdOnly)
Ensure that if the environment home dir is on readonly media or in a readonly directory that the environment has been opened for readonly access. |
void |
clear()
Close all file handles and empty the cache. |
void |
close()
Clear the file lock. |
static boolean |
continueAfterWriteException()
Returns whether we are in a test mode where we attempt to continue after a write IOException. |
boolean |
deleteFile(long fileNum)
Delete log file NNNNNNNN. |
boolean |
filesExist()
|
static int |
firstLogEntryOffset()
|
void |
force(Set<Long> fileNums)
Fsync this set of log files. |
(package private) void |
forceNewLogFile()
Set the flag that causes a new file to be written before the next write. |
Long[] |
getAllFileNumbers()
Get all JE file numbers. |
(package private) Set<Long> |
getCacheKeys()
|
long |
getCurrentFileNum()
Returns the highest (current) file number. |
FileHandle |
getFileHandle(long fileNum)
Return a read only file handle that corresponds to this file number. |
(package private) long |
getFileHeaderPrevOffset(long fileNum)
|
int |
getFileLogVersion(long fileNum)
Returns the log version for the given file. |
static String |
getFileName(long fileNum,
String suffix)
|
Long |
getFirstFileNum()
public for cleaner. |
Long |
getFollowingFileNum(long currentFileNum,
boolean forward)
Get the next file number before/after currentFileNum. |
String |
getFullFileName(long fileNum,
String suffix)
|
(package private) String[] |
getFullFileNames(long fileNum)
|
Long |
getLastFileNum()
|
long |
getLastUsedLsn()
Return the last allocated LSN in the log. |
long |
getNextLsn()
Return the next available LSN in the log. |
long |
getNFSyncRequests()
|
long |
getNFSyncs()
|
long |
getNFSyncTimeouts()
|
Long |
getNumFromName(String fileName)
Get the file number from a file name. |
(package private) long |
getPrevEntryOffset()
|
boolean |
getReadOnly()
|
(package private) boolean |
getUseWriteQueue()
For unit tests. |
(package private) void |
groupSync()
Flush a file using the group sync mechanism, trying to amortize off other syncs. |
boolean |
isFileValid(long fileNum)
For assertions that check whether a file is valid or has been deleted via log cleaning. |
static String[] |
listFiles(File envDirFile,
String[] suffixes)
Find JE files, flavor for unit test support. |
String[] |
listFiles(long minFileNumber,
long maxFileNumber)
Find .jdb files which are >= the minimimum file number and <= the maximum file number. |
String[] |
listFiles(String[] suffixes)
Find JE files. |
(package private) StatGroup |
loadStats(StatsConfig config)
|
boolean |
lockEnvironment(boolean rdOnly,
boolean exclusive)
Lock the environment. |
void |
makeInvisible(long fileNum,
List<Long> lsns)
Mark the specified log entries as invisible and obsolete. |
(package private) void |
readFromFile(RandomAccessFile file,
ByteBuffer readBuffer,
long offset,
long fileNo)
Read a buffer from a file at a given offset. |
void |
releaseExclusiveLock()
|
static void |
removeFiles(File envFile)
Remove files from the environment home directory. |
boolean |
renameFile(long fileNum,
String newSuffix)
Rename this file to NNNNNNNN.suffix. |
(package private) void |
restoreLastPosition()
|
(package private) void |
saveLastPosition()
|
void |
setIncludeDeletedFiles(boolean includeDeletedFiles)
|
void |
setLastPosition(long nextAvailableLsn,
long lastUsedLsn,
long prevOffset)
Set the file manager's "end of log". |
void |
setSyncAtFileEnd(boolean sync)
May be used to disable sync at file end to speed unit tests. |
(package private) void |
syncLogEnd()
FSync the end of the log. |
(package private) void |
syncLogEndAndFinishFile()
Sync the end of the log, close off this log file. |
void |
truncateLog(long fileNum,
long offset)
Truncate a log at this position. |
(package private) void |
writeLogBuffer(LogBuffer fullBuffer,
boolean flushRequired)
Write out a log buffer to the file. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
static boolean IO_EXCEPTION_TESTING_ON_WRITE
static boolean IO_EXCEPTION_TESTING_ON_READ
static boolean THROW_RRE_FOR_UNIT_TESTS
public static long WRITE_COUNT
public static long STOP_ON_WRITE_COUNT
public static long N_BAD_WRITES
public static boolean THROW_ON_WRITE
public static final String JE_SUFFIX
public static final String DEL_SUFFIX
public static final String BAD_SUFFIX
static final String[] DEL_SUFFIXES
static final String[] JE_SUFFIXES
public static final String TMP_SUFFIX
public static final String BUP_SUFFIX
public boolean VERIFY_CHECKSUMS
long lastFileNumberTouched
long lastFileTouchedOffset
final StatGroup stats
final LongStat nRandomReads
final LongStat nRandomWrites
final LongStat nSequentialReads
final LongStat nSequentialWrites
final LongStat nRandomReadBytes
final LongStat nRandomWriteBytes
final LongStat nSequentialReadBytes
final LongStat nSequentialWriteBytes
final IntStat nFileOpens
final IntStat nOpenFiles
final LongStat nBytesReadFromWriteQueue
final LongStat nBytesWrittenFromWriteQueue
final LongStat nReadsFromWriteQueue
final LongStat nWritesFromWriteQueue
final LongStat nWriteQueueOverflow
final LongStat nWriteQueueOverflowFailures
final LongStat nLogFSyncs
public static final boolean LOGWRITE_EXCEPTION_TESTING
Constructor Detail |
---|
public FileManager(EnvironmentImpl envImpl, File dbEnvHome, boolean readOnly) throws EnvironmentLockedException
configManager
- dbEnvHome
- environment home directory
IllegalArgumentException
- via Environment ctor
EnvironmentLockedException
- via Environment ctorMethod Detail |
---|
public static boolean continueAfterWriteException()
public void setLastPosition(long nextAvailableLsn, long lastUsedLsn, long prevOffset)
nextAvailableLsn
- LSN to be used for the next log entrylastUsedLsn
- last LSN to have a valid entry, may be nullprevOffset
- value to use for the prevOffset of the next entry.
If the beginning of the file, this is 0.void saveLastPosition()
void restoreLastPosition()
public void setSyncAtFileEnd(boolean sync)
public Long getFirstFileNum()
public boolean getReadOnly()
public Long getLastFileNum()
public long getCurrentFileNum()
boolean getUseWriteQueue()
public boolean isFileValid(long fileNum)
public void setIncludeDeletedFiles(boolean includeDeletedFiles)
public Long[] getAllFileNumbers()
public Long getFollowingFileNum(long currentFileNum, boolean forward)
currentFileNum
- the file we're at right now. Note that
it may not exist, if it's been cleaned and renamed.forward
- if true, we want the next larger file, if false
we want the previous file
public boolean filesExist()
public Long getNumFromName(String fileName)
the
- file name
public String[] listFiles(String[] suffixes)
suffix
- which type of file we're looking for
public String[] listFiles(long minFileNumber, long maxFileNumber)
public static String[] listFiles(File envDirFile, String[] suffixes)
suffix
- which type of file we're looking for
String[] getFullFileNames(long fileNum)
public static void removeFiles(File envFile)
envFile
- environment directorypublic String getFullFileName(long fileNum, String suffix)
public static String getFileName(long fileNum, String suffix)
public boolean renameFile(long fileNum, String newSuffix) throws IOException, DatabaseException
fileNum
- the file we want to movenewSuffix
- the new file suffix
IOException
DatabaseException
public boolean deleteFile(long fileNum) throws IOException, DatabaseException
fileNum
- the file we want to move
IOException
DatabaseException
public int getFileLogVersion(long fileNum) throws DatabaseException
DatabaseException
public FileHandle getFileHandle(long fileNum) throws FileNotFoundException, ChecksumException, DatabaseException
fileNum
- which file
FileNotFoundException
ChecksumException
DatabaseException
long getFileHeaderPrevOffset(long fileNum) throws ChecksumException, DatabaseException
ChecksumException
DatabaseException
long getPrevEntryOffset()
boolean bumpLsn(long size)
size
- is an unsigned int
void writeLogBuffer(LogBuffer fullBuffer, boolean flushRequired) throws DatabaseException
fullBuffer
- buffer to writeflushRequired
- true if this write can not be queued on the
Write Queue.
DatabaseException
void readFromFile(RandomAccessFile file, ByteBuffer readBuffer, long offset, long fileNo) throws DatabaseException
DatabaseException
void syncLogEnd() throws DatabaseException
DatabaseException
void syncLogEndAndFinishFile() throws DatabaseException, IOException
DatabaseException
IOException
void groupSync() throws DatabaseException
DatabaseException
public void clear() throws IOException, DatabaseException
IOException
DatabaseException
public void close() throws IOException
IOException
public boolean lockEnvironment(boolean rdOnly, boolean exclusive)
public void releaseExclusiveLock() throws DatabaseException
DatabaseException
public boolean checkEnvHomePermissions(boolean rdOnly) throws DatabaseException
IllegalArgumentException
- via Environment ctor
DatabaseException
public void truncateLog(long fileNum, long offset) throws IOException, DatabaseException
This method forces a new log file to be written next, if the last file (the file truncated to) has an old version in its header. This ensures that when the log is opened by an old version of JE, a version incompatibility will be detected. [#11243]
IOException
DatabaseException
public void makeInvisible(long fileNum, List<Long> lsns)
fileNum
- target file.lsns
- The list of LSNs to make invisible, must be sorted in
ascending order.public void force(Set<Long> fileNums)
void forceNewLogFile()
public static int firstLogEntryOffset()
public long getNextLsn()
public long getLastUsedLsn()
public long getNFSyncs()
public long getNFSyncRequests()
public long getNFSyncTimeouts()
StatGroup loadStats(StatsConfig config)
Set<Long> getCacheKeys()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |