Package org.eclipse.aether.named.support

Class AdaptedSemaphoreNamedLock

java.lang.Object

org.eclipse.aether.named.support.NamedLockSupport

org.eclipse.aether.named.support.AdaptedSemaphoreNamedLock

All Implemented Interfaces:

java.lang.AutoCloseable, NamedLock

public class AdaptedSemaphoreNamedLock
extends NamedLockSupport

Named lock support implementation that is using "adapted" semaphore (to be able to use semaphores not sharing common API).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AdaptedSemaphoreNamedLock.AdaptedSemaphore	Wrapper for semaphore-like stuff, that do not share common ancestor.

Field Summary

Fields

Modifier and Type	Field	Description
private static int	EXCLUSIVE	Count of permissions involved with exclusive locking
private static int	NONE	Count of permissions involved with "nop" locking.
private AdaptedSemaphoreNamedLock.AdaptedSemaphore	semaphore
private static int	SHARED	Count of permissions involved with shared locking
private java.lang.ThreadLocal<java.util.Deque<java.lang.Integer>>	threadPerms

Fields inherited from class org.eclipse.aether.named.support.NamedLockSupport

logger

Constructor Summary

Constructors

Constructor	Description
AdaptedSemaphoreNamedLock(java.lang.String name, NamedLockFactorySupport factory, AdaptedSemaphoreNamedLock.AdaptedSemaphore semaphore)

Method Summary

Modifier and Type	Method	Description
boolean	lockExclusively(long time, java.util.concurrent.TimeUnit unit)	Tries to lock exclusively, may block for given time.
boolean	lockShared(long time, java.util.concurrent.TimeUnit unit)	Tries to lock shared, may block for given time.
void	unlock()	Unlocks the lock, must be invoked by caller after one of the NamedLock.lockShared(long, TimeUnit) or NamedLock.lockExclusively(long, TimeUnit).

Methods inherited from class org.eclipse.aether.named.support.NamedLockSupport

close, name

Methods inherited from class java.lang.Object

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

Field Detail

NONE

private static final int NONE

Count of permissions involved with "nop" locking. When required lock step is preceded with a step that already fulfills currently requested locking, no locking is needed. In other words, caller already possesses the access to lock protected resource. The "nop" locking is used to track proper "boxing" of lock/unlock calls.

See Also:

Constant Field Values

SHARED

private static final int SHARED

Count of permissions involved with shared locking

See Also:

Constant Field Values

EXCLUSIVE

private static final int EXCLUSIVE

Count of permissions involved with exclusive locking

See Also:

Constant Field Values

threadPerms

private final java.lang.ThreadLocal<java.util.Deque<java.lang.Integer>> threadPerms

semaphore

private final AdaptedSemaphoreNamedLock.AdaptedSemaphore semaphore

Constructor Detail

AdaptedSemaphoreNamedLock

public AdaptedSemaphoreNamedLock(java.lang.String name,
                                 NamedLockFactorySupport factory,
                                 AdaptedSemaphoreNamedLock.AdaptedSemaphore semaphore)

Method Detail

lockShared

public boolean lockShared(long time,
                          java.util.concurrent.TimeUnit unit)
                   throws java.lang.InterruptedException

Description copied from interface: NamedLock

Tries to lock shared, may block for given time. If successful, returns true.

Throws:

java.lang.InterruptedException

lockExclusively

public boolean lockExclusively(long time,
                               java.util.concurrent.TimeUnit unit)
                        throws java.lang.InterruptedException

Description copied from interface: NamedLock

Tries to lock exclusively, may block for given time. If successful, returns true.

Throws:

java.lang.InterruptedException

unlock

public void unlock()

Description copied from interface: NamedLock

Unlocks the lock, must be invoked by caller after one of the NamedLock.lockShared(long, TimeUnit) or NamedLock.lockExclusively(long, TimeUnit).