/*
* Copyright (c) 2011-2017 Pivotal Software Inc, All Rights Reserved.
*
* Licensed 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
*
* https://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.
*/
/*
* Copyright (c) 2011-2017 Pivotal Software Inc, All Rights Reserved.
*
* Licensed 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
*
* https://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 reactor.core.publisher;
import java.util.Optional;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import org.reactivestreams.Subscription;
import reactor.core.Disposable;
import reactor.core.Exceptions;
import reactor.core.scheduler.Schedulers;
import reactor.util.annotation.Nullable;
import reactor.util.context.Context;
Blocks assuming the upstream is a Mono, until it signals its value or completes. Similar to BlockingSingleSubscriber
, except blockGet methods return an Optional
and thus aren't nullable. Type parameters: - <T> – the value type
See Also:
/**
* Blocks assuming the upstream is a Mono, until it signals its value or completes.
* Similar to {@link BlockingSingleSubscriber}, except blockGet methods return an {@link Optional}
* and thus aren't nullable.
*
* @param <T> the value type
* @see <a href="https://github.com/reactor/reactive-streams-commons">https://github.com/reactor/reactive-streams-commons</a>
*/
final class BlockingOptionalMonoSubscriber<T> extends CountDownLatch
implements InnerConsumer<T>, Disposable {
T value;
Throwable error;
Subscription s;
volatile boolean cancelled;
BlockingOptionalMonoSubscriber() {
super(1);
}
@Override
public void onNext(T t) {
if (value == null) {
value = t;
countDown();
}
}
@Override
public void onError(Throwable t) {
if (value == null) {
error = t;
}
countDown();
}
@Override
public final void onSubscribe(Subscription s) {
this.s = s;
if (!cancelled) {
s.request(Long.MAX_VALUE);
}
}
@Override
public final void onComplete() {
countDown();
}
@Override
public Context currentContext() {
return Context.empty();
}
@Override
public final void dispose() {
cancelled = true;
Subscription s = this.s;
if (s != null) {
this.s = null;
s.cancel();
}
}
Block until the first value arrives or the source completes empty, and return it as an Optional
. Rethrow any exception. Returns: an Optional representing the first value (or empty Optional if the source is empty)
/**
* Block until the first value arrives or the source completes empty, and return it
* as an {@link Optional}. Rethrow any exception.
*
* @return an Optional representing the first value (or empty Optional if the source is empty)
*/
final Optional<T> blockingGet() {
if (Schedulers.isInNonBlockingThread()) {
throw new IllegalStateException("blockOptional() is blocking, which is not supported in thread " + Thread.currentThread().getName());
}
if (getCount() != 0) {
try {
await();
}
catch (InterruptedException ex) {
dispose();
RuntimeException re = Exceptions.propagate(ex);
//this is ok, as re is always a new non-singleton instance
re.addSuppressed(new Exception("#blockOptional() has been interrupted"));
throw re;
}
}
Throwable e = error;
if (e != null) {
RuntimeException re = Exceptions.propagate(e);
//this is ok, as re is always a new non-singleton instance
re.addSuppressed(new Exception("#block terminated with an error"));
throw re;
}
return Optional.ofNullable(value);
}
Block until the first value arrives or the source completes empty, and return it as an Optional
. Rethrow any exception. Params: - timeout – the timeout to wait
- unit – the time unit
Returns: an Optional representing the first value (or empty Optional if the source is empty)
/**
* Block until the first value arrives or the source completes empty, and return it
* as an {@link Optional}. Rethrow any exception.
*
* @param timeout the timeout to wait
* @param unit the time unit
*
* @return an Optional representing the first value (or empty Optional if the source is empty)
*/
final Optional<T> blockingGet(long timeout, TimeUnit unit) {
if (Schedulers.isInNonBlockingThread()) {
throw new IllegalStateException("blockOptional() is blocking, which is not supported in thread " + Thread.currentThread().getName());
}
if (getCount() != 0) {
try {
if (!await(timeout, unit)) {
dispose();
throw new IllegalStateException("Timeout on blocking read for " + timeout + " " + unit);
}
}
catch (InterruptedException ex) {
dispose();
RuntimeException re = Exceptions.propagate(ex);
//this is ok, as re is always a new non-singleton instance
re.addSuppressed(new Exception("#blockOptional(timeout) has been interrupted"));
throw re;
}
}
Throwable e = error;
if (e != null) {
RuntimeException re = Exceptions.propagate(e);
//this is ok, as re is always a new non-singleton instance
re.addSuppressed(new Exception("#block terminated with an error"));
throw re;
}
return Optional.ofNullable(value);
}
@Override
@Nullable
public Object scanUnsafe(Attr key) {
if (key == Attr.TERMINATED) return getCount() == 0;
if (key == Attr.PARENT) return s;
if (key == Attr.CANCELLED) return cancelled;
if (key == Attr.ERROR) return error;
if (key == Attr.PREFETCH) return Integer.MAX_VALUE;
if (key == Attr.RUN_STYLE) return Attr.RunStyle.SYNC;
return null;
}
@Override
public boolean isDisposed() {
return cancelled || getCount() == 0;
}
}