Top Description Inners Fields Constructors Methods
reactor.core.publisher

pack-priv final Class MonoCacheInvalidateIf<T>

extends InternalMonoOperator<T, T>
Class Inheritance
Imports
java.util.NoSuchElementException, .Objects, java.util.concurrent.atomic.AtomicReferenceFieldUpdater, java.util.function.Predicate, org.reactivestreams.Subscription, reactor.core.CoreSubscriber, reactor.util.Logger, .Loggers, reactor.util.annotation.Nullable, reactor.util.context.Context

A caching operator that uses a Predicate to potentially invalidate the cached value whenever a late subscriber arrives. Subscribers accumulated between the upstream susbscription is triggered and the actual value is received and stored don't trigger the predicate, as the operator assumes that values are not invalid at reception.
Author
Simon Baslé

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
pack-priv static class
pack-priv static interface
MonoCacheInvalidateIf.State<
the type of data cached by the parent operator
T
>

A state-holding interface for MonoCacheInvalidateIf and MonoCacheInvalidateWhen, leaner than a Signal to represent valued state, and allowing specific subclasses for pending state and disconnected state.

pack-priv static class
MonoCacheInvalidateIf.ValueState<
the type of data cached by the parent operator
T
>

Common implementation of State for storing the cached value.

Field Summary

Modifier and TypeField and Description
pack-priv static final MonoCacheInvalidateIf.State<?>
EMPTY_STATE

Singleton implementation of an empty State, to represent initial state pre-subscription, when no caching has been requested.

pack-priv final Predicate<? super T>
pack-priv volatile MonoCacheInvalidateIf.State<T>
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf<T>, MonoCacheInvalidateIf.State<T>>
Inherited from reactor.core.publisher.InternalMonoOperator:
optimizableOperator

Constructor Summary

AccessConstructor and Description
pack-priv
MonoCacheInvalidateIf(Mono<T> source, Predicate<? super T> invalidationPredicate)

Method Summary

Modifier and TypeMethod and Description
public Object
scanUnsafe(Scannable.Attr<T>
a Attr to resolve for the component.
key
)

Overrides reactor.core.publisher.InternalMonoOperator.scanUnsafe.

Implements reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place.
public CoreSubscriber<? super T>
subscribeOrReturn(CoreSubscriber<? super T> actual)

Implements abstract reactor.core.publisher.InternalMonoOperator.subscribeOrReturn.

Implements reactor.core.publisher.OptimizableOperator.subscribeOrReturn.

Allow delegation of the subscription by returning a CoreSubscriber, or force subscription encapsulation by returning null.
Inherited from reactor.core.publisher.InternalMonoOperator:
nextOptimizableSourcesourcesubscribe

Field Detail

EMPTY_STATEback to summary
pack-priv static final MonoCacheInvalidateIf.State<?> EMPTY_STATE

Singleton implementation of an empty State, to represent initial state pre-subscription, when no caching has been requested.

shouldInvalidatePredicateback to summary
pack-priv final Predicate<? super T> shouldInvalidatePredicate
stateback to summary
pack-priv volatile MonoCacheInvalidateIf.State<T> state
STATEback to summary
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf<T>, MonoCacheInvalidateIf.State<T>> STATE
Annotations
@SuppressWarnings:rawtypes

Constructor Detail

MonoCacheInvalidateIfback to summary
pack-priv MonoCacheInvalidateIf(Mono<T> source, Predicate<? super T> invalidationPredicate)

Method Detail

scanUnsafeback to summary
public Object scanUnsafe(Scannable.Attr<T> key)

Overrides reactor.core.publisher.InternalMonoOperator.scanUnsafe.

Implements reactor.core.Scannable.scanUnsafe.

Doc from reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place. Although it is ignoring the generic type of the Attr key, implementors should take care to return values of the correct type, and return null if no specific value is available.

For public consumption of attributes, prefer using scan(Attr), which will return a typed value and fall back to the key's default if the component didn't define any mapping.

Parameters
key:Scannable.Attr<T>

a Attr to resolve for the component.

Returns:Object

the value associated to the key for that specific component, or null if none.

Annotations
@Override
subscribeOrReturnback to summary
public CoreSubscriber<? super T> subscribeOrReturn(CoreSubscriber<? super T> actual)

Implements abstract reactor.core.publisher.InternalMonoOperator.subscribeOrReturn.

Implements reactor.core.publisher.OptimizableOperator.subscribeOrReturn.

Doc from reactor.core.publisher.OptimizableOperator.subscribeOrReturn.

Allow delegation of the subscription by returning a CoreSubscriber, or force subscription encapsulation by returning null. This can be used in conjunction with nextOptimizableSource() to perform subscription in a loop instead of by recursion.

Returns:CoreSubscriber<? super T>

next CoreSubscriber or "null" if the subscription was already done inside the method

Annotations
@Override
reactor.core.publisher back to summary

pack-priv final Class MonoCacheInvalidateIf.CacheMonoSubscriber<T>

extends Operators.MonoSubscriber<T, T>
Class Inheritance

Field Summary

Modifier and TypeField and Description
pack-priv MonoCacheInvalidateIf.CoordinatorSubscriber<T>
Inherited from reactor.core.publisher.Operators.MonoSubscriber:
actualCANCELLEDHAS_REQUEST_HAS_VALUEHAS_REQUEST_NO_VALUENO_REQUEST_HAS_VALUENO_REQUEST_NO_VALUEstateSTATEvalue

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
public void
cancel()

Overrides reactor.core.publisher.Operators.MonoSubscriber.cancel.

Implements org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.
public Object
scanUnsafe(Scannable.Attr<T>
a Attr to resolve for the component.
key
)

Overrides reactor.core.publisher.Operators.MonoSubscriber.scanUnsafe.

Overrides default reactor.core.publisher.InnerProducer.scanUnsafe.

Implements reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place.
Inherited from reactor.core.publisher.Operators.MonoSubscriber:
actualclearcompletediscardisCancelledisEmptyonCompleteonErroronNextonSubscribepollrequestrequestFusionsetValuesize

Field Detail

coordinatorback to summary
pack-priv MonoCacheInvalidateIf.CoordinatorSubscriber<T> coordinator

Constructor Detail

CacheMonoSubscriberback to summary
pack-priv CacheMonoSubscriber(CoreSubscriber<? super T> actual)

Method Detail

cancelback to summary
public void cancel()

Overrides reactor.core.publisher.Operators.MonoSubscriber.cancel.

Implements org.reactivestreams.Subscription.cancel.

Doc from org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.

Data may still be sent to meet previously signalled demand after calling cancel.

Annotations
@Override
scanUnsafeback to summary
public Object scanUnsafe(Scannable.Attr<T> key)

Overrides reactor.core.publisher.Operators.MonoSubscriber.scanUnsafe.

Overrides default reactor.core.publisher.InnerProducer.scanUnsafe.

Implements reactor.core.Scannable.scanUnsafe.

Doc from reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place. Although it is ignoring the generic type of the Attr key, implementors should take care to return values of the correct type, and return null if no specific value is available.

For public consumption of attributes, prefer using scan(Attr), which will return a typed value and fall back to the key's default if the component didn't define any mapping.

Parameters
key:Scannable.Attr<T>

a Attr to resolve for the component.

Returns:Object

the value associated to the key for that specific component, or null if none.

Annotations
@Override
reactor.core.publisher back to summary

pack-priv final Class MonoCacheInvalidateIf.CoordinatorSubscriber<T>

extends Object
implements InnerConsumer<T>, MonoCacheInvalidateIf.State<T>
Class Inheritance
  • java.lang.Object
  • reactor.core.publisher.MonoCacheInvalidateIf.CoordinatorSubscriber
All Implemented Interfaces
reactor.core.publisher.MonoCacheInvalidateIf.State, reactor.core.publisher.InnerConsumer, reactor.core.Scannable, reactor.core.CoreSubscriber, org.reactivestreams.Subscriber

Field Summary

Modifier and TypeField and Description
private static final MonoCacheInvalidateIf.CacheMonoSubscriber<T>[]
private static final MonoCacheInvalidateIf.CacheMonoSubscriber<T>[]
pack-priv boolean
pack-priv final MonoCacheInvalidateIf<T>
pack-priv final Mono<? extends T>
pack-priv volatile MonoCacheInvalidateIf.CacheMonoSubscriber<T>[]
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf.CoordinatorSubscriber<T>, MonoCacheInvalidateIf.CacheMonoSubscriber<T>[]>
pack-priv volatile Subscription
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf.CoordinatorSubscriber<T>, Subscription>

Constructor Summary

AccessConstructor and Description
pack-priv
CoordinatorSubscriber(MonoCacheInvalidateIf<T> main, Mono<? extends T> source)

Method Summary

Modifier and TypeMethod and Description
pack-priv final boolean
public void
clear()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.clear.

unused in this context as the State interface is only implemented for use in the main's STATE compareAndSet.
public Context
currentContext()

Overrides default reactor.core.CoreSubscriber.currentContext.

Request a Context from dependent components which can include downstream operators during subscribing or a terminal org.reactivestreams.Subscriber.
pack-priv void
public T
get()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.get.

unused in this context as the State interface is only implemented for use in the main's STATE compareAndSet.
public void
onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Successful terminal state.
public void
onError(Throwable
the throwable signaled
t
)

Implements org.reactivestreams.Subscriber.onError.

Failed terminal state.
public void
onNext(T
the element signaled
t
)

Implements org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).
public void
onSubscribe(Subscription
the Subscription that allows requesting data via Subscription#request(long)
s
)

Implements reactor.core.CoreSubscriber.onSubscribe.

Implementors should initialize any state used by onNext(Object) before calling Subscription#request(long).
pack-priv final void
public Object
scanUnsafe(Scannable.Attr<T>
a Attr to resolve for the component.
key
)

Implements reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

COORDINATOR_DONEback to summary
private static final MonoCacheInvalidateIf.CacheMonoSubscriber<T>[] COORDINATOR_DONE
Annotations
@SuppressWarnings:rawtypes
COORDINATOR_INITback to summary
private static final MonoCacheInvalidateIf.CacheMonoSubscriber<T>[] COORDINATOR_INIT
Annotations
@SuppressWarnings:rawtypes
doneback to summary
pack-priv boolean done
mainback to summary
pack-priv final MonoCacheInvalidateIf<T> main
sourceback to summary
pack-priv final Mono<? extends T> source
subscribersback to summary
pack-priv volatile MonoCacheInvalidateIf.CacheMonoSubscriber<T>[] subscribers
SUBSCRIBERSback to summary
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf.CoordinatorSubscriber<T>, MonoCacheInvalidateIf.CacheMonoSubscriber<T>[]> SUBSCRIBERS
Annotations
@SuppressWarnings:rawtypes
upstreamback to summary
pack-priv volatile Subscription upstream
UPSTREAMback to summary
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateIf.CoordinatorSubscriber<T>, Subscription> UPSTREAM
Annotations
@SuppressWarnings:rawtypes

Constructor Detail

CoordinatorSubscriberback to summary
pack-priv CoordinatorSubscriber(MonoCacheInvalidateIf<T> main, Mono<? extends T> source)
Annotations
@SuppressWarnings:unchecked

Method Detail

addback to summary
pack-priv final boolean add(MonoCacheInvalidateIf.CacheMonoSubscriber<T> toAdd)
clearback to summary
public void clear()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.clear.

unused in this context as the State interface is only implemented for use in the main's STATE compareAndSet.

Annotations
@Override
currentContextback to summary
public Context currentContext()

Overrides default reactor.core.CoreSubscriber.currentContext.

Doc from reactor.core.CoreSubscriber.currentContext.

Request a Context from dependent components which can include downstream operators during subscribing or a terminal org.reactivestreams.Subscriber.

Returns:Context

a resolved context or Context#empty()

Annotations
@Override
delayedSubscribeback to summary
pack-priv void delayedSubscribe()
getback to summary
public T get()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.get.

unused in this context as the State interface is only implemented for use in the main's STATE compareAndSet.

Annotations
@Nullable
@Override
onCompleteback to summary
public void onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Doc from org.reactivestreams.Subscriber.onComplete.

Successful terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Annotations
@Override
onErrorback to summary
public void onError(Throwable t)

Implements org.reactivestreams.Subscriber.onError.

Doc from org.reactivestreams.Subscriber.onError.

Failed terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Parameters
t:Throwable

the throwable signaled

Annotations
@Override
onNextback to summary
public void onNext(T t)

Implements org.reactivestreams.Subscriber.onNext.

Doc from org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).

Parameters
t:T

the element signaled

Annotations
@Override
onSubscribeback to summary
public void onSubscribe(Subscription s)

Implements reactor.core.CoreSubscriber.onSubscribe.

Doc from reactor.core.CoreSubscriber.onSubscribe.

Implementors should initialize any state used by onNext(Object) before calling Subscription#request(long). Should further onNext related state modification occur, thread-safety will be required.

Note that an invalid request <= 0 will not produce an onError and will simply be ignored or reported through a debug-enabled reactor.util.Logger. Invoked after calling Publisher#subscribe(Subscriber).

No data will start flowing until Subscription#request(long) is invoked.

It is the responsibility of this Subscriber instance to call Subscription#request(long) whenever more data is wanted.

The Publisher will send notifications only in response to Subscription#request(long).

Parameters
s:Subscription

Doc from org.reactivestreams.Subscriber.onSubscribe.

the Subscription that allows requesting data via Subscription#request(long)

Annotations
@Override
removeback to summary
pack-priv final void remove(MonoCacheInvalidateIf.CacheMonoSubscriber<T> toRemove)
scanUnsafeback to summary
public Object scanUnsafe(Scannable.Attr<T> key)

Implements reactor.core.Scannable.scanUnsafe.

Doc from reactor.core.Scannable.scanUnsafe.

This method is used internally by components to define their key-value mappings in a single place. Although it is ignoring the generic type of the Attr key, implementors should take care to return values of the correct type, and return null if no specific value is available.

For public consumption of attributes, prefer using scan(Attr), which will return a typed value and fall back to the key's default if the component didn't define any mapping.

Parameters
key:Scannable.Attr<T>

a Attr to resolve for the component.

Returns:Object

the value associated to the key for that specific component, or null if none.

Annotations
@Nullable
@Override
reactor.core.publisher back to summary

pack-priv Interface MonoCacheInvalidateIf.State<T>

Known Direct Implementers
reactor.core.publisher.MonoCacheInvalidateIf.ValueState, reactor.core.publisher.MonoCacheInvalidateIf.CoordinatorSubscriber, reactor.core.publisher.MonoCacheInvalidateWhen.CoordinatorSubscriber
Type Parameters
<T>
the type of data cached by the parent operator

A state-holding interface for MonoCacheInvalidateIf and MonoCacheInvalidateWhen, leaner than a Signal to represent valued state, and allowing specific subclasses for pending state and disconnected state.

Method Summary

Modifier and TypeMethod and Description
public void
public T
get()

Method Detail

clearback to summary
public void clear()
getback to summary
public T get()
Annotations
@Nullable
reactor.core.publisher back to summary

pack-priv final Class MonoCacheInvalidateIf.ValueState<T>

extends Object
implements MonoCacheInvalidateIf.State<T>
Class Inheritance
All Implemented Interfaces
reactor.core.publisher.MonoCacheInvalidateIf.State
Type Parameters
<T>
the type of data cached by the parent operator

Common implementation of State for storing the cached value.

Field Summary

Modifier and TypeField and Description
pack-priv T

Constructor Summary

AccessConstructor and Description
pack-priv
ValueState(T value)

Method Summary

Modifier and TypeMethod and Description
public void
public T
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

valueback to summary
pack-priv T value
Annotations
@Nullable

Constructor Detail

ValueStateback to summary
pack-priv ValueState(T value)

Method Detail

clearback to summary
public void clear()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.clear.

Annotations
@Override
getback to summary
public T get()

Implements reactor.core.publisher.MonoCacheInvalidateIf.State.get.

Annotations
@Nullable
@Override