Класс AbstractQueuedLongSynchronizer

AbstractQueuedLongSynchronizer

public AbstractQueuedLongSynchronizer()

getState

protected final long getState()

Возвращает:

текущее значение состояния

setState

protected final void setState(long newState)

Параметры:

newState - новое значение состояния

compareAndSetState

protected final boolean compareAndSetState(long expect, long update)

Параметры:

expect - ожидаемое значение

update - новое значение

Возвращает:

true в случае успеха. Возвращение False указывает, что фактическое значение не было равно ожидаемому значению.

tryAcquire

protected boolean tryAcquire(long arg)

Параметры:

arg - аргумент получения. Это значение всегда то, которое передается методу получения или сохраняется при входе в ожидание условия. В противном случае значение не интерпретируется и может представлять собой что угодно.

Возвращает:

true в случае успеха. При успехе этот объект был получен.

Исключения:

IllegalMonitorStateException - если получение поместит этот синхронизатор в незаконное состояние. Это исключение должно быть вызвано последовательным образом, чтобы синхронизация работала правильно.

UnsupportedOperationException - если эксклюзивный режим не поддерживается

tryRelease

protected boolean tryRelease(long arg)

Параметры:

arg - аргумент освобождения. Это значение всегда то, которое передается методу освобождения или текущее значение состояния при входе в ожидание условия. В противном случае значение не интерпретируется и может представлять собой что угодно.

Возвращает:

true если этот объект теперь находится в полностью освобожденном состоянии, так что любые ожидающие потоки могут попытаться получить; и false в противном случае.

Исключения:

IllegalMonitorStateException - если освобождение поместит этот синхронизатор в незаконное состояние. Это исключение должно быть вызвано последовательным образом, чтобы синхронизация работала правильно.

UnsupportedOperationException - если эксклюзивный режим не поддерживается

tryAcquireShared

protected long tryAcquireShared(long arg)

Параметры:

arg - аргумент получения. Это значение всегда то, которое передается методу получения или сохраняется при входе в ожидание условия. В противном случае значение не интерпретируется и может представлять собой что угодно.

Возвращает:

отрицательное значение при ошибке; ноль, если получение в совместном режиме удалось, но последующее получение в совместном режиме не может произойти; и положительное значение, если получение в совместном режиме удалось, и последующие получения в совместном режиме также могут произойти, в этом случае последующий ожидающий поток должен проверить доступность. (Поддержка трех различных значений возврата позволяет этому методу использоваться в контекстах, где получения иногда действуют исключительно.) При успехе этот объект был получен.

Исключения:

IllegalMonitorStateException - если получение поместит этот синхронизатор в незаконное состояние. Это исключение должно быть вызвано последовательным образом, чтобы синхронизация работала правильно.

UnsupportedOperationException - если совместный режим не поддерживается

tryReleaseShared

protected boolean tryReleaseShared(long arg)

Параметры:

arg - аргумент освобождения. Это значение всегда то, которое передается методу освобождения или текущее значение состояния при входе в ожидание условия. В противном случае значение не интерпретируется и может представлять собой что угодно.

Возвращает:

true если это освобождение совместного режима может позволить ожидающему получению (совместному или эксклюзивному) преуспеть; и false в противном случае

Исключения:

IllegalMonitorStateException - если освобождение поместит этот синхронизатор в незаконное состояние. Это исключение должно быть вызвано последовательным образом, чтобы синхронизация работала правильно.

UnsupportedOperationException - если совместный режим не поддерживается

isHeldExclusively

protected boolean isHeldExclusively()

Возвращает:

true если синхронизация удерживается исключительно; false в противном случае

Исключения:

UnsupportedOperationException - если условия не поддерживаются

acquire

public final void acquire(long arg)

Параметры:

arg - аргумент получения. Это значение передается в tryAcquire(long), но в противном случае не интерпретируется и может представлять собой что угодно.

acquireInterruptibly

public final void acquireInterruptibly(long arg) throws InterruptedException

Параметры:

arg - аргумент получения. Это значение передается в tryAcquire(long), но в противном случае не интерпретируется и может представлять собой что угодно.

Исключения:

InterruptedException - если текущий поток прерван

tryAcquireNanos

public final boolean tryAcquireNanos(long arg, long nanosTimeout) throws InterruptedException

Параметры:

arg - аргумент получения. Это значение передается в tryAcquire(long), но в противном случае не интерпретируется и может представлять собой что угодно.

nanosTimeout - максимальное количество наносекунд ожидания

Возвращает:

true если получено; false если таймаут истек

Исключения:

InterruptedException - если текущий поток прерван

освободить

public final boolean release(long arg)

Параметры:

arg - аргумент освобождения. Это значение передаётся в tryRelease(long), но в противном случае не интерпретируется и может представлять что угодно.

Возвращает:

значение, возвращённое из tryRelease(long)

acquireShared

public final void acquireShared(long arg)

Параметры:

arg - аргумент приобретения. Это значение передаётся в tryAcquireShared(long), но в противном случае не интерпретируется и может представлять что угодно.

acquireSharedInterruptibly

public final void acquireSharedInterruptibly(long arg) throws InterruptedException

Параметры:

arg - аргумент приобретения. Это значение передаётся в tryAcquireShared(long), но в противном случае не интерпретируется и может представлять что угодно.

Исключения:

InterruptedException - если текущая нить прервана

tryAcquireSharedNanos

public final boolean tryAcquireSharedNanos(long arg, long nanosTimeout) throws InterruptedException

Параметры:

arg - аргумент приобретения. Это значение передаётся в tryAcquireShared(long), но в противном случае не интерпретируется и может представлять что угодно.

nanosTimeout - максимальное количество наносекунд ожидания

Возвращает:

true при приобретении; false при истечении таймаута

Исключения:

InterruptedException - если текущая нить прервана

releaseShared

public final boolean releaseShared(long arg)

Параметры:

arg - аргумент освобождения. Это значение передаётся в tryReleaseShared(long), но в противном случае не интерпретируется и может представлять что угодно.

Возвращает:

значение, возвращённое из tryReleaseShared(long)

hasQueuedThreads

public final boolean hasQueuedThreads()

Возвращает:

true если могут быть другие нити, ожидающие приобретения

hasContended

public final boolean hasContended()

Возвращает:

true если когда-либо была конкуренция

getFirstQueuedThread

public final Thread getFirstQueuedThread()

Возвращает:

первую (самую долго ожидающую) нить в очереди или null если нити в очереди нет

isQueued

public final boolean isQueued(Thread thread)

Параметры:

thread - нить

Возвращает:

true если данная нить находится в очереди

Исключения:

NullPointerException - если нить равна null

hasQueuedPredecessors

public final boolean hasQueuedPredecessors()

 
 getFirstQueuedThread() != Thread.currentThread()
   && hasQueuedThreads()

 
 protected boolean tryAcquire(long arg) {
   if (isHeldExclusively()) {
     // A reentrant acquire; increment hold count
     return true;
   } else if (hasQueuedPredecessors()) {
     return false;
   } else {
     // try to acquire normally
   }
 }

Возвращает:

true если в очереди есть нить, которая ожидает дольше, чем текущая нить, и false если текущая нить находится в голове очереди или очередь пуста

С:

1.7

getQueueLength

public final int getQueueLength()

Возвращает:

оцененное количество нитей, ожидающих приобретения

getQueuedThreads

public final Collection<Thread> getQueuedThreads()

Возвращает:

коллекцию нитей

getExclusiveQueuedThreads

public final Collection<Thread> getExclusiveQueuedThreads()

Возвращает:

коллекцию нитей

getSharedQueuedThreads

public final Collection<Thread> getSharedQueuedThreads()

Возвращает:

коллекцию нитей

toString

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строку, идентифицирующую этот синхронизатор, а также его состояние

owns

public final boolean owns(AbstractQueuedLongSynchronizer.ConditionObject condition)

Параметры:

condition - условие

Возвращает:

true если принадлежит

Исключения:

NullPointerException - если условие равно null

hasWaiters

public final boolean hasWaiters(AbstractQueuedLongSynchronizer.ConditionObject condition)

Parameters:

condition - условие

Returns:

true если есть ожидающие потоки

Throws:

IllegalMonitorStateException - если эксклюзивная синхронизация не удерживается

IllegalArgumentException - если заданное условие не связано с этим синхронизатором

NullPointerException - если условие равно null

getWaitQueueLength

public final int getWaitQueueLength(AbstractQueuedLongSynchronizer.ConditionObject condition)

Parameters:

condition - условие

Returns:

оцененное количество ожидающих потоков

Throws:

IllegalMonitorStateException - если эксклюзивная синхронизация не удерживается

IllegalArgumentException - если заданное условие не связано с этим синхронизатором

NullPointerException - если условие равно null

getWaitingThreads

public final Collection<Thread> getWaitingThreads(AbstractQueuedLongSynchronizer.ConditionObject condition)

Parameters:

condition - условие

Returns:

коллекция потоков

Throws:

IllegalMonitorStateException - если эксклюзивная синхронизация не удерживается

IllegalArgumentException - если заданное условие не связано с этим синхронизатором

NullPointerException - если условие равно null