Top Description Inners Fields Constructors Methods
reactor.core.publisher

pack-priv final Class MonoCacheInvalidateWhen<T>

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

A caching operator that uses a companion Mono as a trigger to invalidate the cached value. Subscribers accumulated between the upstream subscription is triggered and the actual value is received and stored don't get impacted by the generated trigger and will immediately receive the cached value. If after that the trigger completes immediately, the next incoming subscriber will lead to a resubscription to the source and a new caching cycle.
Author
Simon Baslé

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
pack-priv static class
pack-priv static class

Field Summary

Modifier and TypeField and Description
pack-priv final Consumer<? super T>
pack-priv final Function<? super T, Mono<Void>>
private static final Logger
pack-priv volatile MonoCacheInvalidateIf.State<T>
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateWhen<T>, MonoCacheInvalidateIf.State<T>>
Inherited from reactor.core.publisher.InternalMonoOperator:
optimizableOperator

Constructor Summary

AccessConstructor and Description
pack-priv
MonoCacheInvalidateWhen(Mono<T> source, Function<? super T, Mono<Void>> invalidationTriggerGenerator, Consumer<? super T> invalidateHandler)

Method Summary

Modifier and TypeMethod and Description
pack-priv boolean
pack-priv void
pack-priv void
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

invalidateHandlerback to summary
pack-priv final Consumer<? super T> invalidateHandler
Annotations
@Nullable
invalidationTriggerGeneratorback to summary
pack-priv final Function<? super T, Mono<Void>> invalidationTriggerGenerator
LOGGERback to summary
private static final Logger LOGGER
stateback to summary
pack-priv volatile MonoCacheInvalidateIf.State<T> state
STATEback to summary
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateWhen<T>, MonoCacheInvalidateIf.State<T>> STATE
Annotations
@SuppressWarnings:rawtypes

Constructor Detail

MonoCacheInvalidateWhenback to summary
pack-priv MonoCacheInvalidateWhen(Mono<T> source, Function<? super T, Mono<Void>> invalidationTriggerGenerator, Consumer<? super T> invalidateHandler)

Method Detail

compareAndInvalidateback to summary
pack-priv boolean compareAndInvalidate(MonoCacheInvalidateIf.State<T> expected)
invalidateback to summary
pack-priv void invalidate()
safeInvalidateHandlerback to summary
pack-priv void safeInvalidateHandler(T value)
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 MonoCacheInvalidateWhen.CacheMonoSubscriber<T>

extends Operators.MonoSubscriber<T, T>
Class Inheritance

Field Summary

Modifier and TypeField and Description
pack-priv MonoCacheInvalidateWhen.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 MonoCacheInvalidateWhen.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 MonoCacheInvalidateWhen.CoordinatorSubscriber<T>

extends Object
implements InnerConsumer<T>, MonoCacheInvalidateIf.State<T>
Class Inheritance
  • java.lang.Object
  • reactor.core.publisher.MonoCacheInvalidateWhen.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 MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[]
private static final MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[]
pack-priv final MonoCacheInvalidateWhen<T>
pack-priv volatile MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[]
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateWhen.CoordinatorSubscriber<T>, MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[]>
pack-priv Subscription

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
pack-priv final boolean
pack-priv void
cacheLoad(T value)

pack-priv 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.
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 MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[] COORDINATOR_DONE
Annotations
@SuppressWarnings:rawtypes
COORDINATOR_INITback to summary
private static final MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[] COORDINATOR_INIT
Annotations
@SuppressWarnings:rawtypes
mainback to summary
pack-priv final MonoCacheInvalidateWhen<T> main
subscribersback to summary
pack-priv volatile MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[] subscribers
SUBSCRIBERSback to summary
pack-priv static final AtomicReferenceFieldUpdater<MonoCacheInvalidateWhen.CoordinatorSubscriber<T>, MonoCacheInvalidateWhen.CacheMonoSubscriber<T>[]> SUBSCRIBERS
Annotations
@SuppressWarnings:rawtypes
subscriptionback to summary
pack-priv Subscription subscription

Constructor Detail

CoordinatorSubscriberback to summary
pack-priv CoordinatorSubscriber(MonoCacheInvalidateWhen<T> main)
Annotations
@SuppressWarnings:unchecked

Method Detail

addback to summary
pack-priv final boolean add(MonoCacheInvalidateWhen.CacheMonoSubscriber<T> toAdd)
cacheLoadback to summary
pack-priv void cacheLoad(T value)
cacheLoadFailureback to summary
pack-priv boolean cacheLoadFailure(MonoCacheInvalidateIf.State<T> expected, Throwable failure)
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
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(MonoCacheInvalidateWhen.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 final Class MonoCacheInvalidateWhen.TriggerSubscriber

extends Object
implements InnerConsumer<Void>
Class Inheritance
  • java.lang.Object
  • reactor.core.publisher.MonoCacheInvalidateWhen.TriggerSubscriber
All Implemented Interfaces
reactor.core.publisher.InnerConsumer, reactor.core.Scannable, reactor.core.CoreSubscriber, org.reactivestreams.Subscriber

Field Summary

Modifier and TypeField and Description
pack-priv final MonoCacheInvalidateWhen<?>

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
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.
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(Void
the element signaled
unused
)

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).
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

mainback to summary
pack-priv final MonoCacheInvalidateWhen<?> main

Constructor Detail

TriggerSubscriberback to summary
pack-priv TriggerSubscriber(MonoCacheInvalidateWhen<?> main)

Method Detail

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
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(Void unused)

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
unused:Void

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
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