Class LockableFile

java.lang.Object

net.adoptopenjdk.icedteaweb.lockingfile.LockableFile

public class LockableFile
extends Object

Process invalid input: '&' thread lockable access to a file. Creates file if it does not already exist.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static interface	LockableFile.InterProcessLock	Interface for abstracting away the details of how a file is locked system wide.
private class	LockableFile.LockFile	This is an alternative approach to locking a file system-wide.
private class	LockableFile.NioFileLock	This is the recommended way to lock a file system wide (across multiple processes).

Field Summary

Fields

Modifier and Type	Field	Description
private final File	file
private static final Map<File, LockableFile>	instanceCache
private static final Logger	logger
private final LockableFile.InterProcessLock	processLock
private final boolean	readOnly
private final ReentrantLock	threadLock

Constructor Summary

Constructors

Modifier	Constructor	Description
private	LockableFile(File file)

Method Summary

Modifier and Type	Method	Description
private boolean	canWriteFile(File file)
private boolean	canWriteParent(File file)
private void	createFileIfMissing()
private void	createLockableFile()
private void	createParentDirIfMissing(File f)
File	getFile()	Get the file being locked.
static LockableFile	getInstance(File file)	Get a LockableFile for a given File.
boolean	isHeldByCurrentThread()
boolean	isReadOnly()
private boolean	isReadOnly(File file)
void	lock()	Lock access to the file.Lock is reentrant.
boolean	tryLock()
void	unlock()	Unlock access to the file.Lock is reentrant.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

private static final Logger logger

instanceCache

private static final Map<File, LockableFile> instanceCache

file

private final File file

readOnly

private final boolean readOnly

threadLock

private final ReentrantLock threadLock

processLock

private final LockableFile.InterProcessLock processLock

Constructor Details

LockableFile

private LockableFile(File file)

Method Details

getInstance

public static LockableFile getInstance(File file)

Get a LockableFile for a given File. Ensures that we share the same instance for all threads.

Parameters:

file - the file to lock

Returns:

a LockableFile instance

isReadOnly

private boolean isReadOnly(File file)

canWriteFile

private boolean canWriteFile(File file)

canWriteParent

private boolean canWriteParent(File file)

createParentDirIfMissing

private void createParentDirIfMissing(File f)

createLockableFile

private void createLockableFile()

getFile

public File getFile()

Get the file being locked.

Returns:

the file

isReadOnly

public boolean isReadOnly()

Returns:

if the file is read only.

lock

public void lock()
          throws IOException

Lock access to the file.Lock is reentrant.

Throws:

IOException - if an I/O error occurs.

tryLock

public boolean tryLock()

createFileIfMissing

private void createFileIfMissing()
                          throws IOException

Throws:

IOException

unlock

public void unlock()
            throws IOException

Unlock access to the file.Lock is reentrant. Does not do anything if not holding the lock.

Throws:

IOException - if an I/O error occurs.

isHeldByCurrentThread

public boolean isHeldByCurrentThread()