AbstractQueuedLongSynchronizer

AbstractQueuedLongSynchronizer

AbstractQueuedLongSynchronizer ()

创建一个初始同步状态为零的新实例 AbstractQueuedLongSynchronizer 。

acquire

void acquire (long arg)

以独占模式获取，忽略中断。 通过调用至少一次tryAcquire(long) ，成功返回。 否则，线程排队，可能重复阻塞和解除阻塞，直到成功为止，调用tryAcquire(long) 。 此方法可用于实施方法lock() 。

acquireInterruptibly

void acquireInterruptibly (long arg)

以独占模式获取，如果中断则中止。 通过首先检查中断状态来实现，然后调用至少一次tryAcquire(long) ，成功返回。 否则，线程排队，可能重复阻塞和解除阻塞，调用tryAcquire(long)直到成功或线程中断。 该方法可用于实施方法lockInterruptibly() 。

acquireShared

void acquireShared (long arg)

采用共享模式，忽略中断。 通过首先调用至少一次tryAcquireShared(long) ，返回成功。 否则，线程排队，可能重复阻塞并解除阻塞，调用tryAcquireShared(long)直到成功。

acquireSharedInterruptibly

void acquireSharedInterruptibly (long arg)

在共享模式下获取，如果中断则中止。 首先检查中断状态，然后调用至少一次tryAcquireShared(long) ，成功返回。 否则，线程排队，可能重复阻塞和解除阻塞，调用tryAcquireShared(long)直到成功或线程中断。

getExclusiveQueuedThreads

Collection<Thread> getExclusiveQueuedThreads ()

返回包含可能正在等待以独占模式获取的线程的集合。 它具有与getQueuedThreads()相同的属性，只是它仅返回由于独占获取而等待的那些线程。

getFirstQueuedThread

Thread getFirstQueuedThread ()

返回队列中的第一个（等待时间最长的）线程，如果当前没有线程正在排队，则 null 。

在这个实现中，这个操作通常在不变的时间内返回，但是如果其他线程正在并发地修改队列，它可能会在争用时迭代。

getQueueLength

int getQueueLength ()

返回等待获取的线程数的估计值。 该值仅为估计值，因为在此方法遍历内部数据结构时，线程数可能会动态变化。 此方法设计用于监视系统状态，而不是用于同步控制。

getQueuedThreads

Collection<Thread> getQueuedThreads ()

返回包含可能正在等待获取的线程的集合。 因为实际的一组线程可能会在构造这个结果时动态地改变，所以返回的集合只是一个尽力而为的估计。 返回的集合的元素没有特定的顺序。 该方法旨在促进提供更广泛监测设施的子类的构建。

getSharedQueuedThreads

Collection<Thread> getSharedQueuedThreads ()

返回包含可能正在等待以共享模式获取的线程的集合。 它具有与getQueuedThreads()相同的属性，只是它只返回由于共享获取而等待的那些线程。

getWaitQueueLength

int getWaitQueueLength (AbstractQueuedLongSynchronizer.ConditionObject condition)

返回等待与此同步器关联的给定条件的线程数的估计值。 请注意，因为超时和中断可能随时发生，所以估计仅作为服务员实际数量的上限。 此方法设计用于监视系统状态，而不是用于同步控制。

getWaitingThreads

Collection<Thread> getWaitingThreads (AbstractQueuedLongSynchronizer.ConditionObject condition)

返回包含那些可能正在等待与此同步器关联的给定条件的线程的集合。 因为实际的一组线程可能会在构造这个结果时动态地改变，所以返回的集合只是一个尽力而为的估计。 返回的集合的元素没有特定的顺序。

hasContended

boolean hasContended ()

查询是否有线程曾争夺过这个同步器; 也就是说，如果一种获取方法被阻止。

在这个实现中，这个操作在一段时间内返回。

hasQueuedPredecessors

boolean hasQueuedPredecessors ()

查询是否有任何线程等待获取比当前线程更长的时间。

此方法的调用等效于（但可能更有效）：

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

请注意，因为中断和超时导致的取消可能随时发生，所以true返回不能保证其他线程将在当前线程之前获取。 同样，由于队列是空的，在此方法返回false之后，另一个线程有可能赢得比赛排队。

此方法旨在供公平同步器使用，以避免barging 。 这种同步的tryAcquire(long)方法应该返回false ，其tryAcquireShared(long)方法应该返回一个负值，如果这个方法返回true （除非这是一个折返获取）。 例如，用于公平，可重入，独占模式同步器的tryAcquire方法可能如下所示：

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

hasQueuedThreads

boolean hasQueuedThreads ()

查询是否有线程正在等待获取。 请注意，由于中断和超时导致的取消可能随时发生， true返回并不能保证任何其他线程都会获取。

在这个实现中，这个操作在一段时间内返回。

hasWaiters

boolean hasWaiters (AbstractQueuedLongSynchronizer.ConditionObject condition)

查询是否有线程正在等待与此同步器关联的给定条件。 请注意，因为超时和中断可能随时发生，所以true返回不能保证将来signal将唤醒任何线程。 此方法主要用于监视系统状态。

isQueued

boolean isQueued (Thread thread)

如果给定线程当前正在排队，则返回true。

该实现遍历队列以确定给定线程的存在。

owns

boolean owns (AbstractQueuedLongSynchronizer.ConditionObject condition)

查询给定的ConditionObject是否使用此同步器作为其锁。

release

boolean release (long arg)

以独占模式发布。 如果tryRelease(long)返回true，则通过解锁一个或多个线程tryRelease(long)实现。 此方法可用于实施方法unlock() 。

releaseShared

boolean releaseShared (long arg)

以共享模式发布。 如果tryReleaseShared(long)返回true，则通过解锁一个或多个线程tryReleaseShared(long)实现。

toString

String toString ()

返回标识此同步器的字符串及其状态。 括号中的状态包括字符串"State ="后跟当前值getState() ，以及"nonempty"或"empty"具体取决于队列是否为空。

tryAcquireNanos

boolean tryAcquireNanos (long arg, 
                long nanosTimeout)

尝试以独占模式获取，如果中断则中止，如果超时，则失败。 通过首先检查中断状态来实现，然后调用至少一次tryAcquire(long) ，成功返回。 否则，线程排队，可能重复阻塞和解除阻塞，调用tryAcquire(long)直到成功或线程中断或超时。 此方法可用于实施方法tryLock(long, TimeUnit) 。

tryAcquireSharedNanos

boolean tryAcquireSharedNanos (long arg, 
                long nanosTimeout)

尝试以共享模式获取，如果中断则中止，如果超时，则失败。 通过首先检查中断状态来实现，然后调用至少一次tryAcquireShared(long) ，成功返回。 否则，线程排队，可能重复阻塞和解除阻塞，调用tryAcquireShared(long)直到成功或线程中断或超时。

compareAndSetState

boolean compareAndSetState (long expect, 
                long update)

如果当前状态值等于期望值，则将同步状态按原子级设置为给定的更新值。 该操作具有volatile读写的内存语义。

getState

long getState ()

返回同步状态的当前值。 此操作具有volatile读取的内存语义。

isHeldExclusively

boolean isHeldExclusively ()

如果同步仅针对当前（调用）线程进行true则返回true 。 每次调用非等待方法时调用AbstractQueuedLongSynchronizer.ConditionObject方法。 （等待方法改为调用release(long) ）

默认实现抛出UnsupportedOperationException 。 该方法仅在AbstractQueuedLongSynchronizer.ConditionObject方法内部调用，因此如果不使用条件，则不需要定义该方法。

setState

void setState (long newState)

设置同步状态的值。 此操作具有volatile写入的存储器语义。

tryAcquire

boolean tryAcquire (long arg)

尝试以独占模式获取。 该方法应该查询对象的状态是否允许在独占模式下获取它，如果是，则获取它。

此方法总是由执行获取的线程调用。 如果此方法报告失败，则获取方法可以将该线程排队（如果该线程尚未排队），直到通过来自其他某个线程的发布发出信号。 这可以用来实现方法tryLock() 。

默认实现抛出 UnsupportedOperationException 。

tryAcquireShared

long tryAcquireShared (long arg)

尝试以共享模式获取。 此方法应查询对象的状态是否允许在共享模式下获取它，如果是，则获取它。

此方法总是由执行获取的线程调用。 如果此方法报告失败，则获取方法可以将该线程排队（如果该线程尚未排队），直到通过来自其他某个线程的发布发出信号。

默认实现抛出 UnsupportedOperationException 。

tryRelease

boolean tryRelease (long arg)

尝试设置状态以反映独占模式下的发行版。

此方法始终由执行发布的线程调用。

默认实现抛出 UnsupportedOperationException 。

tryReleaseShared

boolean tryReleaseShared (long arg)

尝试设置状态以反映共享模式下的发布。

此方法始终由执行发布的线程调用。

默认实现抛出 UnsupportedOperationException 。