程序包 cn.taketoday.core

类 ReactiveAdapterRegistry

java.lang.Object

cn.taketoday.core.ReactiveAdapterRegistry

public class ReactiveAdapterRegistry
extends Object

A registry of adapters to adapt Reactive Streams Publisher to/from various async/reactive types such as CompletableFuture, RxJava Flowable, etc. This is designed to complement Infra Reactor Mono/Flux support while also being usable without Reactor, e.g. just for org.reactivestreams bridging.

By default, depending on classpath availability, adapters are registered for Reactor (including CompletableFuture and Flow.Publisher adapters), RxJava 3, Kotlin Coroutines' Deferred (bridged via Reactor) and SmallRye Mutiny 1.x/2.x. If Reactor is not present, a simple Flow.Publisher bridge will be registered.

从以下版本开始:

4.0

作者:

Rossen Stoyanchev, Sebastien Deleuze, Juergen Hoeller, Harry Yang

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	ReactiveAdapterRegistry.CoreBlockHoundIntegration	BlockHoundIntegration for core classes.
private static class	ReactiveAdapterRegistry.EmptyCompletableFuture<T>
private static class	ReactiveAdapterRegistry.FlowAdaptersRegistrar
private static class	ReactiveAdapterRegistry.MutinyRegistrar
private static class	ReactiveAdapterRegistry.ReactorAdapter	ReactiveAdapter variant that wraps adapted Publishers as Flux or Mono depending on ReactiveTypeDescriptor.isMultiValue().
private static class	ReactiveAdapterRegistry.ReactorRegistrar
private static class	ReactiveAdapterRegistry.RxJava3Registrar

字段概要

字段

修饰符和类型	字段	说明
private final ArrayList<ReactiveAdapter>	adapters
private static final boolean	mutinyPresent
private static final boolean	reactiveStreamsPresent
private static final boolean	reactorPresent
private static final boolean	rxjava3Present
private static ReactiveAdapterRegistry	sharedInstance

构造器概要

构造器

构造器	说明
ReactiveAdapterRegistry()	Create a registry and auto-register default adapters.

方法概要

修饰符和类型	方法	说明
private ReactiveAdapter	buildAdapter(ReactiveTypeDescriptor descriptor, Function<Object,org.reactivestreams.Publisher<?>> toAdapter, Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)
ReactiveAdapter	getAdapter(Class<?> reactiveType)	Get the adapter for the given reactive type.
ReactiveAdapter	getAdapter(Class<?> reactiveType, Object source)	Get the adapter for the given reactive type.
static ReactiveAdapterRegistry	getSharedInstance()	Return a shared default ReactiveAdapterRegistry instance, lazily building it once needed.
boolean	hasAdapters()	Whether the registry has any adapters.
private static boolean	isPresent(String className)
void	registerReactiveType(ReactiveTypeDescriptor descriptor, Function<Object,org.reactivestreams.Publisher<?>> toAdapter, Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)	Register a reactive type along with functions to adapt to and from a Reactive Streams Publisher.
void	registerReactiveTypeOverride(ReactiveTypeDescriptor descriptor, Function<Object,org.reactivestreams.Publisher<?>> toAdapter, Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)	Register a reactive type along with functions to adapt to and from a Reactive Streams Publisher.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

sharedInstance

@Nullable
private static volatile ReactiveAdapterRegistry sharedInstance

mutinyPresent

private static final boolean mutinyPresent

reactorPresent

private static final boolean reactorPresent

rxjava3Present

private static final boolean rxjava3Present

reactiveStreamsPresent

private static final boolean reactiveStreamsPresent

adapters

private final ArrayList<ReactiveAdapter> adapters

构造器详细资料

ReactiveAdapterRegistry

public ReactiveAdapterRegistry()

Create a registry and auto-register default adapters.

另请参阅:

• getSharedInstance()

方法详细资料

registerReactiveType

public void registerReactiveType(ReactiveTypeDescriptor descriptor,
 Function<Object,org.reactivestreams.Publisher<?>> toAdapter,
 Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)

Register a reactive type along with functions to adapt to and from a Reactive Streams Publisher. The function arguments assume that their input is neither null nor Optional.

This variant registers the new adapter after existing adapters. It will be matched for the exact reactive type if no earlier adapter was registered for the specific type, and it will be matched for assignability in a second pass if no earlier adapter had an assignable type before.

另请参阅:

• registerReactiveTypeOverride(cn.taketoday.core.ReactiveTypeDescriptor, java.util.function.Function<java.lang.Object, org.reactivestreams.Publisher<?>>, java.util.function.Function<org.reactivestreams.Publisher<?>, java.lang.Object>)
• getAdapter(java.lang.Class<?>)

registerReactiveTypeOverride

public void registerReactiveTypeOverride(ReactiveTypeDescriptor descriptor,
 Function<Object,org.reactivestreams.Publisher<?>> toAdapter,
 Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)

Register a reactive type along with functions to adapt to and from a Reactive Streams Publisher. The function arguments assume that their input is neither null nor Optional.

This variant registers the new adapter first, effectively overriding any previously registered adapters for the same reactive type. This allows for overriding existing adapters, in particular default adapters.

Note that existing adapters for specific types will still match before an assignability match with the new adapter. In order to override all existing matches, a new reactive type adapter needs to be registered for every specific type, not relying on subtype assignability matches.

另请参阅:

• registerReactiveType(cn.taketoday.core.ReactiveTypeDescriptor, java.util.function.Function<java.lang.Object, org.reactivestreams.Publisher<?>>, java.util.function.Function<org.reactivestreams.Publisher<?>, java.lang.Object>)
• getAdapter(java.lang.Class<?>)

buildAdapter

private ReactiveAdapter buildAdapter(ReactiveTypeDescriptor descriptor,
 Function<Object,org.reactivestreams.Publisher<?>> toAdapter,
 Function<org.reactivestreams.Publisher<?>,Object> fromAdapter)

hasAdapters

public boolean hasAdapters()

Whether the registry has any adapters.

getAdapter

@Nullable
public ReactiveAdapter getAdapter(Class<?> reactiveType)

Get the adapter for the given reactive type.

返回:

the corresponding adapter, or null if none available

getAdapter

@Nullable
public ReactiveAdapter getAdapter(@Nullable
 Class<?> reactiveType,
 @Nullable
 Object source)

Get the adapter for the given reactive type. Or if a "source" object is provided, its actual type is used instead.

参数:

reactiveType - the reactive type (may be null if a concrete source object is given)

source - an instance of the reactive type (i.e. to adapt from; may be null if the reactive type is specified)

返回:

the corresponding adapter, or null if none available

getSharedInstance

public static ReactiveAdapterRegistry getSharedInstance()

Return a shared default ReactiveAdapterRegistry instance, lazily building it once needed.

NOTE: We highly recommend passing a long-lived, pre-configured ReactiveAdapterRegistry instance for customization purposes. This accessor is only meant as a fallback for code paths that want to fall back on a default instance if one isn't provided.

返回:

the shared ReactiveAdapterRegistry instance

isPresent

private static boolean isPresent(String className)