2008-08-08 02:37:18 +02:00
|
|
|
/*
|
2009-08-28 09:15:49 +02:00
|
|
|
* Copyright 2009 Red Hat, Inc.
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
2009-08-28 09:15:49 +02:00
|
|
|
* Red Hat licenses this file to you under the Apache License, version 2.0
|
|
|
|
* (the "License"); you may not use this file except in compliance with the
|
|
|
|
* License. You may obtain a copy of the License at:
|
2008-08-08 02:37:18 +02:00
|
|
|
*
|
2009-08-28 09:15:49 +02:00
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
2008-08-08 03:27:24 +02:00
|
|
|
*
|
2009-08-28 09:15:49 +02:00
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
* License for the specific language governing permissions and limitations
|
|
|
|
* under the License.
|
2008-08-08 02:37:18 +02:00
|
|
|
*/
|
2008-08-08 03:40:10 +02:00
|
|
|
package org.jboss.netty.channel;
|
2008-08-08 02:37:18 +02:00
|
|
|
|
2008-11-07 04:00:19 +01:00
|
|
|
import static java.util.concurrent.TimeUnit.*;
|
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
import java.util.ArrayList;
|
|
|
|
import java.util.List;
|
|
|
|
import java.util.concurrent.TimeUnit;
|
|
|
|
|
2008-08-09 16:52:19 +02:00
|
|
|
import org.jboss.netty.logging.InternalLogger;
|
2008-08-09 17:05:53 +02:00
|
|
|
import org.jboss.netty.logging.InternalLoggerFactory;
|
2009-04-06 09:09:11 +02:00
|
|
|
import org.jboss.netty.util.internal.IoWorkerRunnable;
|
2008-08-08 02:37:18 +02:00
|
|
|
|
2008-08-11 09:33:19 +02:00
|
|
|
/**
|
2008-09-02 09:13:20 +02:00
|
|
|
* The default {@link ChannelFuture} implementation. It is recommended to
|
|
|
|
* use {@link Channels#future(Channel)} and {@link Channels#future(Channel, boolean)}
|
|
|
|
* to create a new {@link ChannelFuture} rather than calling the constructor
|
|
|
|
* explicitly.
|
2008-08-11 09:33:19 +02:00
|
|
|
*
|
2010-01-26 10:04:19 +01:00
|
|
|
* @author <a href="http://www.jboss.org/netty/">The Netty Project</a>
|
|
|
|
* @author <a href="http://gleamynode.net/">Trustin Lee</a>
|
2008-08-11 09:33:19 +02:00
|
|
|
*
|
|
|
|
* @version $Rev$, $Date$
|
|
|
|
*/
|
2008-08-08 02:37:18 +02:00
|
|
|
public class DefaultChannelFuture implements ChannelFuture {
|
|
|
|
|
2008-08-09 16:52:19 +02:00
|
|
|
private static final InternalLogger logger =
|
2008-08-09 17:05:53 +02:00
|
|
|
InternalLoggerFactory.getInstance(DefaultChannelFuture.class);
|
2008-08-11 09:33:19 +02:00
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
private static final Throwable CANCELLED = new Throwable();
|
|
|
|
|
2009-07-17 12:32:17 +02:00
|
|
|
private static volatile boolean useDeadLockChecker = true;
|
2009-07-24 03:30:48 +02:00
|
|
|
private static boolean disabledDeadLockCheckerOnce;
|
2009-07-17 12:32:17 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns {@code true} if and only if the dead lock checker is enabled.
|
|
|
|
*/
|
|
|
|
public static boolean isUseDeadLockChecker() {
|
|
|
|
return useDeadLockChecker;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enables or disables the dead lock checker. It is not recommended to
|
|
|
|
* disable the dead lock checker. Disable it at your own risk!
|
|
|
|
*/
|
|
|
|
public static void setUseDeadLockChecker(boolean useDeadLockChecker) {
|
2009-07-24 03:30:48 +02:00
|
|
|
if (!useDeadLockChecker && !disabledDeadLockCheckerOnce) {
|
|
|
|
disabledDeadLockCheckerOnce = true;
|
2009-07-17 12:32:17 +02:00
|
|
|
logger.debug(
|
|
|
|
"The dead lock checker in " +
|
|
|
|
DefaultChannelFuture.class.getSimpleName() +
|
|
|
|
" has been disabled as requested at your own risk.");
|
|
|
|
}
|
|
|
|
DefaultChannelFuture.useDeadLockChecker = useDeadLockChecker;
|
|
|
|
}
|
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
private final Channel channel;
|
|
|
|
private final boolean cancellable;
|
|
|
|
|
2010-02-19 09:23:48 +01:00
|
|
|
private ChannelFutureListener firstListener;
|
|
|
|
private List<ChannelFutureListener> otherListeners;
|
2008-08-08 02:37:18 +02:00
|
|
|
private boolean done;
|
|
|
|
private Throwable cause;
|
|
|
|
private int waiters;
|
|
|
|
|
2008-08-11 09:33:19 +02:00
|
|
|
/**
|
|
|
|
* Creates a new instance.
|
|
|
|
*
|
|
|
|
* @param channel
|
|
|
|
* the {@link Channel} associated with this future
|
|
|
|
* @param cancellable
|
|
|
|
* {@code true} if and only if this future can be canceled
|
|
|
|
*/
|
2008-08-08 02:37:18 +02:00
|
|
|
public DefaultChannelFuture(Channel channel, boolean cancellable) {
|
|
|
|
this.channel = channel;
|
|
|
|
this.cancellable = cancellable;
|
|
|
|
}
|
|
|
|
|
|
|
|
public Channel getChannel() {
|
|
|
|
return channel;
|
|
|
|
}
|
|
|
|
|
|
|
|
public synchronized boolean isDone() {
|
|
|
|
return done;
|
|
|
|
}
|
|
|
|
|
|
|
|
public synchronized boolean isSuccess() {
|
2009-02-26 10:28:37 +01:00
|
|
|
return done && cause == null;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public synchronized Throwable getCause() {
|
|
|
|
if (cause != CANCELLED) {
|
|
|
|
return cause;
|
|
|
|
} else {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public synchronized boolean isCancelled() {
|
|
|
|
return cause == CANCELLED;
|
|
|
|
}
|
|
|
|
|
|
|
|
public void addListener(ChannelFutureListener listener) {
|
|
|
|
if (listener == null) {
|
|
|
|
throw new NullPointerException("listener");
|
|
|
|
}
|
|
|
|
|
|
|
|
boolean notifyNow = false;
|
|
|
|
synchronized (this) {
|
|
|
|
if (done) {
|
|
|
|
notifyNow = true;
|
|
|
|
} else {
|
|
|
|
if (firstListener == null) {
|
|
|
|
firstListener = listener;
|
|
|
|
} else {
|
|
|
|
if (otherListeners == null) {
|
|
|
|
otherListeners = new ArrayList<ChannelFutureListener>(1);
|
|
|
|
}
|
|
|
|
otherListeners.add(listener);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (notifyNow) {
|
|
|
|
notifyListener(listener);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removeListener(ChannelFutureListener listener) {
|
|
|
|
if (listener == null) {
|
|
|
|
throw new NullPointerException("listener");
|
|
|
|
}
|
|
|
|
|
|
|
|
synchronized (this) {
|
|
|
|
if (!done) {
|
|
|
|
if (listener == firstListener) {
|
|
|
|
if (otherListeners != null && !otherListeners.isEmpty()) {
|
|
|
|
firstListener = otherListeners.remove(0);
|
|
|
|
} else {
|
|
|
|
firstListener = null;
|
|
|
|
}
|
|
|
|
} else if (otherListeners != null) {
|
|
|
|
otherListeners.remove(listener);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public ChannelFuture await() throws InterruptedException {
|
2009-09-04 06:21:56 +02:00
|
|
|
if (Thread.interrupted()) {
|
|
|
|
throw new InterruptedException();
|
|
|
|
}
|
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
synchronized (this) {
|
|
|
|
while (!done) {
|
2009-04-06 09:09:11 +02:00
|
|
|
checkDeadLock();
|
2008-08-08 02:37:18 +02:00
|
|
|
waiters++;
|
|
|
|
try {
|
2008-08-19 12:21:04 +02:00
|
|
|
this.wait();
|
2008-08-08 02:37:18 +02:00
|
|
|
} finally {
|
|
|
|
waiters--;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
public boolean await(long timeout, TimeUnit unit)
|
|
|
|
throws InterruptedException {
|
2008-11-07 04:00:19 +01:00
|
|
|
return await0(unit.toNanos(timeout), true);
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public boolean await(long timeoutMillis) throws InterruptedException {
|
2008-11-07 04:00:19 +01:00
|
|
|
return await0(MILLISECONDS.toNanos(timeoutMillis), true);
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public ChannelFuture awaitUninterruptibly() {
|
2009-09-04 06:21:56 +02:00
|
|
|
boolean interrupted = false;
|
2008-08-08 02:37:18 +02:00
|
|
|
synchronized (this) {
|
|
|
|
while (!done) {
|
2009-04-06 09:09:11 +02:00
|
|
|
checkDeadLock();
|
2008-08-08 02:37:18 +02:00
|
|
|
waiters++;
|
|
|
|
try {
|
2008-08-19 12:21:04 +02:00
|
|
|
this.wait();
|
2008-08-08 02:37:18 +02:00
|
|
|
} catch (InterruptedException e) {
|
2009-09-04 06:21:56 +02:00
|
|
|
interrupted = true;
|
2008-08-08 02:37:18 +02:00
|
|
|
} finally {
|
|
|
|
waiters--;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2009-09-04 06:21:56 +02:00
|
|
|
if (interrupted) {
|
|
|
|
Thread.currentThread().interrupt();
|
|
|
|
}
|
|
|
|
|
2008-08-08 02:37:18 +02:00
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
public boolean awaitUninterruptibly(long timeout, TimeUnit unit) {
|
2008-11-07 04:00:19 +01:00
|
|
|
try {
|
|
|
|
return await0(unit.toNanos(timeout), false);
|
|
|
|
} catch (InterruptedException e) {
|
|
|
|
throw new InternalError();
|
|
|
|
}
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public boolean awaitUninterruptibly(long timeoutMillis) {
|
|
|
|
try {
|
2008-11-07 04:00:19 +01:00
|
|
|
return await0(MILLISECONDS.toNanos(timeoutMillis), false);
|
2008-08-08 02:37:18 +02:00
|
|
|
} catch (InterruptedException e) {
|
|
|
|
throw new InternalError();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2008-11-07 04:00:19 +01:00
|
|
|
private boolean await0(long timeoutNanos, boolean interruptable) throws InterruptedException {
|
2009-09-04 06:21:56 +02:00
|
|
|
if (interruptable && Thread.interrupted()) {
|
|
|
|
throw new InterruptedException();
|
|
|
|
}
|
|
|
|
|
2008-11-07 04:00:19 +01:00
|
|
|
long startTime = timeoutNanos <= 0 ? 0 : System.nanoTime();
|
|
|
|
long waitTime = timeoutNanos;
|
2009-09-04 06:21:56 +02:00
|
|
|
boolean interrupted = false;
|
2008-08-08 02:37:18 +02:00
|
|
|
|
2009-09-04 06:21:56 +02:00
|
|
|
try {
|
|
|
|
synchronized (this) {
|
|
|
|
if (done) {
|
|
|
|
return done;
|
|
|
|
} else if (waitTime <= 0) {
|
|
|
|
return done;
|
|
|
|
}
|
2008-08-08 02:37:18 +02:00
|
|
|
|
2009-09-04 06:21:56 +02:00
|
|
|
checkDeadLock();
|
|
|
|
waiters++;
|
|
|
|
try {
|
|
|
|
for (;;) {
|
|
|
|
try {
|
|
|
|
this.wait(waitTime / 1000000, (int) (waitTime % 1000000));
|
|
|
|
} catch (InterruptedException e) {
|
|
|
|
if (interruptable) {
|
|
|
|
throw e;
|
|
|
|
} else {
|
|
|
|
interrupted = true;
|
|
|
|
}
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
2009-09-04 06:21:56 +02:00
|
|
|
if (done) {
|
|
|
|
return true;
|
|
|
|
} else {
|
|
|
|
waitTime = timeoutNanos - (System.nanoTime() - startTime);
|
|
|
|
if (waitTime <= 0) {
|
|
|
|
return done;
|
|
|
|
}
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
2009-09-04 06:21:56 +02:00
|
|
|
} finally {
|
|
|
|
waiters--;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
2009-09-04 06:21:56 +02:00
|
|
|
}
|
|
|
|
} finally {
|
|
|
|
if (interrupted) {
|
|
|
|
Thread.currentThread().interrupt();
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2009-04-06 09:09:11 +02:00
|
|
|
private void checkDeadLock() {
|
2009-07-17 12:32:17 +02:00
|
|
|
if (isUseDeadLockChecker() && IoWorkerRunnable.IN_IO_THREAD.get()) {
|
2009-04-06 09:09:11 +02:00
|
|
|
throw new IllegalStateException(
|
|
|
|
"await*() in I/O thread causes a dead lock or " +
|
2009-04-23 09:14:27 +02:00
|
|
|
"sudden performance drop. Use addListener() instead or " +
|
|
|
|
"call await*() from a different thread.");
|
2009-04-06 09:09:11 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2008-11-26 10:21:00 +01:00
|
|
|
public boolean setSuccess() {
|
2008-08-08 02:37:18 +02:00
|
|
|
synchronized (this) {
|
|
|
|
// Allow only once.
|
|
|
|
if (done) {
|
2008-11-26 10:21:00 +01:00
|
|
|
return false;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
done = true;
|
|
|
|
if (waiters > 0) {
|
2008-11-26 10:21:00 +01:00
|
|
|
notifyAll();
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
notifyListeners();
|
2008-11-26 10:21:00 +01:00
|
|
|
return true;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
2008-11-26 10:21:00 +01:00
|
|
|
public boolean setFailure(Throwable cause) {
|
2008-08-08 02:37:18 +02:00
|
|
|
synchronized (this) {
|
|
|
|
// Allow only once.
|
|
|
|
if (done) {
|
2008-11-26 10:21:00 +01:00
|
|
|
return false;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
this.cause = cause;
|
|
|
|
done = true;
|
|
|
|
if (waiters > 0) {
|
2008-11-26 10:21:00 +01:00
|
|
|
notifyAll();
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
notifyListeners();
|
2008-11-26 10:21:00 +01:00
|
|
|
return true;
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public boolean cancel() {
|
|
|
|
if (!cancellable) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
synchronized (this) {
|
|
|
|
// Allow only once.
|
|
|
|
if (done) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
cause = CANCELLED;
|
|
|
|
done = true;
|
|
|
|
if (waiters > 0) {
|
2008-11-26 10:21:00 +01:00
|
|
|
notifyAll();
|
2008-08-08 02:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
notifyListeners();
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
private void notifyListeners() {
|
2010-02-19 09:23:48 +01:00
|
|
|
// This method doesn't need synchronization because:
|
|
|
|
// 1) This method is always called after synchronized (this) block.
|
|
|
|
// Hence any listener list modification happens-before this method.
|
2010-02-19 10:18:10 +01:00
|
|
|
// 2) This method is called only when 'done' is true. Once 'done'
|
|
|
|
// becomes true, the listener list is never modified - see add/removeListener()
|
2008-08-08 02:37:18 +02:00
|
|
|
if (firstListener != null) {
|
|
|
|
notifyListener(firstListener);
|
|
|
|
firstListener = null;
|
|
|
|
|
|
|
|
if (otherListeners != null) {
|
|
|
|
for (ChannelFutureListener l: otherListeners) {
|
|
|
|
notifyListener(l);
|
|
|
|
}
|
|
|
|
otherListeners = null;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private void notifyListener(ChannelFutureListener l) {
|
|
|
|
try {
|
|
|
|
l.operationComplete(this);
|
|
|
|
} catch (Throwable t) {
|
|
|
|
logger.warn(
|
|
|
|
"An exception was thrown by " +
|
|
|
|
ChannelFutureListener.class.getSimpleName() + ".", t);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|