com.vladium.util

接口 IFileLock

public interface IFileLock

A simple abstraction for implementing mutual exclusivity across multiple OS processes on the same physical host.

Lifecycle: create() -> (acquire() -> release() ->)* discard

MT-safety: a mutex instance is safe for use by multiple concurrent threads.

作者:

Vlad Roubtsov, (C) 2005

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	IFileLock.Factory
static class	IFileLock.FileLockException

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	LOCK_ACQUIRED_ALREADY [none]
static java.lang.String	LOCK_ACQUISITION_FAILURE [none]
static java.lang.String	LOCK_ACQUISITION_SECURITY_FAILURE [none]
static java.lang.String	LOCK_ACQUISITION_TIMEOUT [none]

方法概要

限定符和类型	方法和说明
void	acquire() Attempts to acquire this lock until either the lock is successfully acquired or the maximum time has elapsed or the maximum number of attempts has been exceeded.
void	release() Releases this lock.

字段详细资料

LOCK_ACQUIRED_ALREADY

static final java.lang.String LOCK_ACQUIRED_ALREADY

[none]

另请参阅:

常量字段值

LOCK_ACQUISITION_FAILURE

static final java.lang.String LOCK_ACQUISITION_FAILURE

[none]

另请参阅:

常量字段值

LOCK_ACQUISITION_SECURITY_FAILURE

static final java.lang.String LOCK_ACQUISITION_SECURITY_FAILURE

[none]

另请参阅:

常量字段值

LOCK_ACQUISITION_TIMEOUT

static final java.lang.String LOCK_ACQUISITION_TIMEOUT

[none]

另请参阅:

常量字段值

方法详细资料

acquire

void acquire()
      throws IFileLock.FileLockException,
             java.lang.InterruptedException

Attempts to acquire this lock until either the lock is successfully acquired or the maximum time has elapsed or the maximum number of attempts has been exceeded.

This method blocks until it either succeeds or errors out or the calling thread is interrupted.

抛出:

IFileLock.FileLockException - if this lock has already been acquired.

IFileLock.FileLockException - if the lock could not be acquired.

java.lang.InterruptedException - if the calling thread is interrupted.

release

void release()

Releases this lock. This method may be called multiple times (it has no effect on an unacquired/released lock).