2013-04-15 08:26:20 +02:00
|
|
|
/*
|
|
|
|
* Copyright 2013 The Netty Project
|
|
|
|
*
|
|
|
|
* The Netty Project 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:
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* 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.
|
|
|
|
*/
|
|
|
|
|
|
|
|
package io.netty.util.concurrent;
|
|
|
|
|
|
|
|
public class DefaultProgressivePromise<V> extends DefaultPromise<V> implements ProgressivePromise<V> {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates a new instance.
|
|
|
|
*
|
2013-04-15 13:11:02 +02:00
|
|
|
* It is preferable to use {@link EventExecutor#newProgressivePromise()} to create a new progressive promise
|
2013-04-15 08:26:20 +02:00
|
|
|
*
|
|
|
|
* @param executor
|
|
|
|
* the {@link EventExecutor} which is used to notify the promise when it progresses or it is complete
|
|
|
|
*/
|
2013-04-15 13:11:02 +02:00
|
|
|
public DefaultProgressivePromise(EventExecutor executor) {
|
2013-04-15 08:26:20 +02:00
|
|
|
super(executor);
|
|
|
|
}
|
|
|
|
|
2013-04-15 13:11:02 +02:00
|
|
|
protected DefaultProgressivePromise() { /* only for subclasses */ }
|
2013-04-15 08:26:20 +02:00
|
|
|
|
|
|
|
@Override
|
2013-04-15 13:11:02 +02:00
|
|
|
public ProgressivePromise<V> setProgress(long progress, long total) {
|
2013-07-19 05:53:23 +02:00
|
|
|
if (total < 0) {
|
|
|
|
// total unknown
|
|
|
|
total = -1; // normalize
|
|
|
|
if (progress < 0) {
|
|
|
|
throw new IllegalArgumentException("progress: " + progress + " (expected: >= 0)");
|
|
|
|
}
|
|
|
|
} else if (progress < 0 || progress > total) {
|
2013-04-15 08:26:20 +02:00
|
|
|
throw new IllegalArgumentException(
|
2013-04-15 13:11:02 +02:00
|
|
|
"progress: " + progress + " (expected: 0 <= progress <= total (" + total + "))");
|
2013-04-15 08:26:20 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
if (isDone()) {
|
|
|
|
throw new IllegalStateException("complete already");
|
|
|
|
}
|
|
|
|
|
2013-04-15 13:11:02 +02:00
|
|
|
notifyProgressiveListeners(progress, total);
|
2013-04-15 08:26:20 +02:00
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
2013-04-15 13:11:02 +02:00
|
|
|
public boolean tryProgress(long progress, long total) {
|
2013-07-19 06:21:32 +02:00
|
|
|
if (total < 0) {
|
|
|
|
total = -1;
|
|
|
|
if (progress < 0 || isDone()) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
} else if (progress < 0 || progress > total || isDone()) {
|
2013-04-15 08:26:20 +02:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2013-04-15 13:11:02 +02:00
|
|
|
notifyProgressiveListeners(progress, total);
|
2013-04-15 08:26:20 +02:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
2013-06-12 01:00:54 +02:00
|
|
|
public ProgressivePromise<V> addListener(GenericFutureListener<? extends Future<? super V>> listener) {
|
2013-04-15 08:26:20 +02:00
|
|
|
super.addListener(listener);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
2013-06-12 01:00:54 +02:00
|
|
|
public ProgressivePromise<V> addListeners(GenericFutureListener<? extends Future<? super V>>... listeners) {
|
2013-04-15 08:26:20 +02:00
|
|
|
super.addListeners(listeners);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
2013-06-12 01:00:54 +02:00
|
|
|
public ProgressivePromise<V> removeListener(GenericFutureListener<? extends Future<? super V>> listener) {
|
2013-04-15 08:26:20 +02:00
|
|
|
super.removeListener(listener);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
2013-06-12 01:00:54 +02:00
|
|
|
public ProgressivePromise<V> removeListeners(GenericFutureListener<? extends Future<? super V>>... listeners) {
|
2013-04-15 08:26:20 +02:00
|
|
|
super.removeListeners(listeners);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> sync() throws InterruptedException {
|
|
|
|
super.sync();
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> syncUninterruptibly() {
|
|
|
|
super.syncUninterruptibly();
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> await() throws InterruptedException {
|
|
|
|
super.await();
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> awaitUninterruptibly() {
|
|
|
|
super.awaitUninterruptibly();
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> setSuccess(V result) {
|
|
|
|
super.setSuccess(result);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
@Override
|
|
|
|
public ProgressivePromise<V> setFailure(Throwable cause) {
|
|
|
|
super.setFailure(cause);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
}
|