ai.eloquent.util

Class ConcurrencyUtils

java.lang.Object

ai.eloquent.util.ConcurrencyUtils

public class ConcurrencyUtils
extends java.lang.Object

Static utilities for dealing with concurrency -- primarily, with ensuring correctness.

Method Summary

Modifier and Type	Method and Description
static boolean	ensureLockOrder(java.util.List<java.lang.Object> lockOrder, java.lang.Object lockBeingTaken) A helper for determining if we can take the given lock according to the lock order.
static boolean	ensureLocksHeld(java.util.Collection<java.lang.Object> lockOrder) Ensure that all of the given locks are being held by the current thread.
static boolean	ensureNoLocksHeld() Ensure that the current thread does not hold any synchronized block locks.
static boolean	ensureNoLocksHeld(java.util.Collection<java.lang.Object> lockOrder) Ensure that none of the given locks are being held by the current thread.

Methods inherited from class java.lang.Object

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

Method Detail

ensureLockOrder

public static boolean ensureLockOrder(java.util.List<java.lang.Object> lockOrder,
                                      java.lang.Object lockBeingTaken)

A helper for determining if we can take the given lock according to the lock order.

Parameters:

lockOrder - The lock order we are checking against.

lockBeingTaken - The lock we are trying to take. This can either be a ReentrantLock or an object we're synchronizing on.

Returns:

Throws an assert error if something goes wrong, but also returns false just in case.

ensureNoLocksHeld

public static boolean ensureNoLocksHeld(java.util.Collection<java.lang.Object> lockOrder)

Ensure that none of the given locks are being held by the current thread. This is useful for, e.g., checking that we are not holding any locks on network calls.

Parameters:

lockOrder - The lock order. The order here doesn't matter, but is meant to mirror ensureLockOrder(List, Object).

Returns:

Throws an assert error if something goes wrong, but also returns false just in case.

ensureNoLocksHeld

public static boolean ensureNoLocksHeld()

Ensure that the current thread does not hold any synchronized block locks. Note that this method cannot check explicit locks.

Returns:

Throws an assert error if something goes wrong, but also returns false just in case.

ensureLocksHeld

public static boolean ensureLocksHeld(java.util.Collection<java.lang.Object> lockOrder)

Ensure that all of the given locks are being held by the current thread. This is useful for, e.g., checking that we hold a lock on a future

Parameters:

lockOrder - The lock order. The order here doesn't matter, but is meant to mirror ensureLockOrder(List, Object).

Returns:

Throws an assert error if something goes wrong, but also returns false just in case.