co.codewizards.cloudstore.core.io

Class LockFileFactory

java.lang.Object

co.codewizards.cloudstore.core.io.LockFileFactory

public class LockFileFactory
extends Object

Factory creating LockFile instances.

All methods of this class are thread-safe.

Author:

Marco หงุ่ยตระกูล-Schulze - marco at codewizards dot co

Field Summary

Fields

Modifier and Type	Field and Description
protected Object	mutex

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LockFileFactory()

Method Summary

Methods

Modifier and Type	Method and Description
LockFile	acquire(File file, long timeoutMillis) Acquire an exclusive lock on the specified file.
static LockFileFactory	getInstance()
protected void	postRelease(co.codewizards.cloudstore.core.io.LockFileImpl lockFileImpl)

Methods inherited from class java.lang.Object

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

Field Detail

mutex

protected final Object mutex

Constructor Detail

LockFileFactory

protected LockFileFactory()

Method Detail

getInstance

public static LockFileFactory getInstance()

acquire

public LockFile acquire(File file,
               long timeoutMillis)
                 throws TimeoutException

Acquire an exclusive lock on the specified file.

Important: You must invoke LockFile.release() on the returned object! Use a try-finally-block to ensure it:

  LockFile lockFile = LockFileFactory.acquire(theFile, theTimeout);
  try {
    // do something
  } finally {
    lockFile.release();
  }

If the JVM is interrupted or shut down before release(), the file-lock is released by the operating system, but a missing release() causes the file to be locked for the entire remaining runtime of the JVM!

Important: This is not usable for the synchronization of multiple threads within the same Java virtual machine! Multiple LockFiles on the same File are possible within the same JVM! This locking mechanism only locks against separate processes! Since this implementation is based on FileLock, please consult its Javadoc for further information.

Multiple invocations of this method on the same given file return multiple different LockFile instances. The actual lock is held until the last LockFile instance was released.

This method is thread-safe.

Parameters:

file - the file to be locked. Must not be null. If this file does not exist in the file system, it is created by this method.

timeoutMillis - the timeout to wait for the lock to be acquired in milliseconds. The value 0 means to wait forever.

Returns:

the LockFile. Never null. This must be released (use a try-finally-block)!

Throws:

TimeoutException - if the LockFile could not be acquired within the timeout specified by timeoutMillis.

See Also:

LockFile.release()

postRelease

protected void postRelease(co.codewizards.cloudstore.core.io.LockFileImpl lockFileImpl)