org.jgroups.util.Promise Maven / Gradle / Ivy
Go to download
This artifact provides a single jar that contains all classes required to use remote EJB and JMS, including
all dependencies. It is intended for use by those not using maven, maven users should just import the EJB and
JMS BOM's instead (shaded JAR's cause lots of problems with maven, as it is very easy to inadvertently end up
with different versions on classes on the class path).
package org.jgroups.util;
import org.jgroups.TimeoutException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.Lock;
import java.util.concurrent.locks.ReentrantLock;
/**
* Allows a thread to submit an asynchronous request and to wait for the result. The caller may choose to check
* for the result at a later time, or immediately and it may block or not. Both the caller and responder have to
* know the promise.
* When the result is available, {@link #hasResult()} will always return true and {@link #getResult()} will return the
* result. In order to block for a different result, {@link #reset()} has to be called first.
* @author Bela Ban
*/
public class Promise implements org.jgroups.util.Condition {
protected final Lock lock=new ReentrantLock();
protected final CondVar cond=new CondVar(lock);
protected T result;
protected volatile boolean hasResult=false; // condition
public boolean isMet() {
return hasResult();
}
/**
* Blocks until a result is available, or timeout milliseconds have elapsed
* @param timeout in ms
* @return An object
* @throws TimeoutException If a timeout occurred (implies that timeout > 0)
*/
public T getResultWithTimeout(long timeout) throws TimeoutException {
return _getResultWithTimeout(timeout);
}
public T getResultWithTimeout(long timeout, boolean reset) throws TimeoutException {
if(!reset)
return _getResultWithTimeout(timeout);
// the lock is acquired because we want to get the result and reset the promise in the same lock scope; if we had
// to re-acquire the lock for reset(), some other thread could possibly set a new result before reset() is called !
lock.lock();
try {
return _getResultWithTimeout(timeout);
}
finally {
reset();
lock.unlock();
}
}
public T getResult() {
try {
return getResultWithTimeout(0);
}
catch(TimeoutException e) {
return null;
}
}
/**
* Returns the result, but never throws a TimeoutException; returns null instead.
* @param timeout in ms
* @return T
*/
public T getResult(long timeout) {
return getResult(timeout, false);
}
public T getResult(long timeout, boolean reset) {
try {
return getResultWithTimeout(timeout, reset);
}
catch(TimeoutException e) {
return null;
}
}
/**
* Checks whether result is available. Does not block.
*/
public boolean hasResult() {
lock.lock();
try {
return hasResult;
}
finally {
lock.unlock();
}
}
/**
* Sets the result and notifies any threads waiting for it
*/
public void setResult(T obj) {
lock.lock();
try {
result=obj;
hasResult=true;
cond.signal(true);
}
finally {
lock.unlock();
}
}
/**
* Causes all waiting threads to return
*/
public void reset() {
lock.lock();
try {
result=null;
hasResult=false;
cond.signal(true);
}
finally {
lock.unlock();
}
}
public String toString() {
return "hasResult=" + hasResult + ", result=" + result;
}
/**
* Blocks until a result is available, or timeout milliseconds have elapsed. Needs to be called with lock held
* @param timeout in ms
* @return An object
* @throws TimeoutException If a timeout occurred (implies that timeout > 0)
*/
protected T _getResultWithTimeout(final long timeout) throws TimeoutException {
if(timeout <= 0)
cond.waitFor(this);
else if(!cond.waitFor(this, timeout, TimeUnit.MILLISECONDS))
throw new TimeoutException();
return result;
}
}