reactor.ipc.netty.tcp

Class TcpResources

java.lang.Object

reactor.ipc.netty.tcp.TcpResources

All Implemented Interfaces:

Cancellation, Disposable, LoopResources, PoolResources

Direct Known Subclasses:

HttpResources

public class TcpResources
extends Object
implements PoolResources, LoopResources

Hold the default Tcp resources

Since:

0.6

Author:

Stephane Maldini

Field Summary

Fields inherited from interface reactor.ipc.netty.resources.PoolResources

DEFAULT_POOL_ACQUIRE_TIMEOUT, DEFAULT_POOL_MAX_CONNECTION

Fields inherited from interface reactor.ipc.netty.resources.LoopResources

DEFAULT_IO_SELECT_COUNT, DEFAULT_IO_WORKER_COUNT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TcpResources(LoopResources defaultLoops, PoolResources defaultPools)

Method Summary

Modifier and Type	Method and Description
protected void	_dispose() Dispose underlying resources
boolean	daemon() return true if EventLoopGroup should not be shutdown
void	dispose()
static TcpResources	get() Return the global HTTP resources for event loops and pooling
protected static <T extends TcpResources> T	getOrCreate(AtomicReference<T> ref, LoopResources loops, PoolResources pools, java.util.function.BiFunction<LoopResources,PoolResources,T> onNew, String name) Safely check if existing resource exist and proceed to update/cleanup if new resources references are passed.
Class<? extends Channel>	onChannel(EventLoopGroup group) Callback for client or generic channel factory selection.
EventLoopGroup	onClient(boolean useNative) Callback for client EventLoopGroup creation.
Class<? extends DatagramChannel>	onDatagramChannel(EventLoopGroup group) Callback for UDP channel factory selection.
EventLoopGroup	onServer(boolean useNative) Callback for server EventLoopGroup creation.
Class<? extends ServerChannel>	onServerChannel(EventLoopGroup group) Callback for server channel factory selection.
EventLoopGroup	onServerSelect(boolean useNative) Create a server select EventLoopGroup for servers to be used
boolean	preferNative() Rreturn true if should default to native EventLoopGroup and Channel
static TcpResources	reset() Reset http resources to default and return its instance
ChannelPool	selectOrCreate(SocketAddress address, java.util.function.Supplier<? extends Bootstrap> bootstrap, java.util.function.Consumer<? super Channel> onChannelCreate, EventLoopGroup group) Return an existing or new ChannelPool.
static TcpResources	set(LoopResources loops) Update pooling resources and return the global HTTP resources
static TcpResources	set(PoolResources pools) Update event loops resources and return the global HTTP resources

Methods inherited from class java.lang.Object

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

Methods inherited from interface reactor.ipc.netty.resources.PoolResources

elastic, fixed, fixed, fixed

Methods inherited from interface reactor.ipc.netty.resources.LoopResources

colocate, create, create, create

Methods inherited from interface reactor.core.Disposable

isDisposed

Constructor Detail

TcpResources

protected TcpResources(LoopResources defaultLoops,
                       PoolResources defaultPools)

Method Detail

get

public static TcpResources get()

Return the global HTTP resources for event loops and pooling

Returns:

the global HTTP resources for event loops and pooling

set

public static TcpResources set(PoolResources pools)

Update event loops resources and return the global HTTP resources

Returns:

the global HTTP resources

set

public static TcpResources set(LoopResources loops)

Update pooling resources and return the global HTTP resources

Returns:

the global HTTP resources

reset

public static TcpResources reset()

Reset http resources to default and return its instance

Returns:

the global HTTP resources

dispose

public void dispose()

Specified by:

dispose in interface Cancellation

Specified by:

dispose in interface Disposable

Specified by:

dispose in interface LoopResources

Specified by:

dispose in interface PoolResources

_dispose

protected void _dispose()

Dispose underlying resources

selectOrCreate

public ChannelPool selectOrCreate(SocketAddress address,
                                  java.util.function.Supplier<? extends Bootstrap> bootstrap,
                                  java.util.function.Consumer<? super Channel> onChannelCreate,
                                  EventLoopGroup group)

Description copied from interface: PoolResources

Return an existing or new ChannelPool. The implementation will take care of pulling Bootstrap lazily when a ChannelPool creation is actually needed.

Specified by:

selectOrCreate in interface PoolResources

Parameters:

address - the remote address to resolve for existing or new ChannelPool

bootstrap - the Bootstrap supplier if a ChannelPool must be created

onChannelCreate - callback only when new connection is made

Returns:

an existing or new ChannelPool

onChannel

public Class<? extends Channel> onChannel(EventLoopGroup group)

Description copied from interface: LoopResources

Callback for client or generic channel factory selection.

Specified by:

onChannel in interface LoopResources

Parameters:

group - the source EventLoopGroup to assign a loop from

Returns:

a Class target for the underlying Channel factory

onClient

public EventLoopGroup onClient(boolean useNative)

Description copied from interface: LoopResources

Callback for client EventLoopGroup creation.

Specified by:

onClient in interface LoopResources

Parameters:

useNative - should use native group if current LoopResources.preferNative() is also true

Returns:

a new EventLoopGroup

onDatagramChannel

public Class<? extends DatagramChannel> onDatagramChannel(EventLoopGroup group)

Description copied from interface: LoopResources

Callback for UDP channel factory selection.

Specified by:

onDatagramChannel in interface LoopResources

Parameters:

group - the source EventLoopGroup to assign a loop from

Returns:

a Class target for the underlying Channel factory

onServer

public EventLoopGroup onServer(boolean useNative)

Description copied from interface: LoopResources

Callback for server EventLoopGroup creation.

Specified by:

onServer in interface LoopResources

Parameters:

useNative - should use native group if current LoopResources.preferNative() is also true

Returns:

a new EventLoopGroup

onServerChannel

public Class<? extends ServerChannel> onServerChannel(EventLoopGroup group)

Description copied from interface: LoopResources

Callback for server channel factory selection.

Specified by:

onServerChannel in interface LoopResources

Parameters:

group - the source EventLoopGroup to assign a loop from

Returns:

a Class target for the underlying ServerChannel factory

onServerSelect

public EventLoopGroup onServerSelect(boolean useNative)

Description copied from interface: LoopResources

Create a server select EventLoopGroup for servers to be used

Specified by:

onServerSelect in interface LoopResources

Parameters:

useNative - should use native group if current LoopResources.preferNative() is also true

Returns:

a new EventLoopGroup

preferNative

public boolean preferNative()

Description copied from interface: LoopResources

Rreturn true if should default to native EventLoopGroup and Channel

Specified by:

preferNative in interface LoopResources

Returns:

true if should default to native EventLoopGroup and Channel

daemon

public boolean daemon()

Description copied from interface: LoopResources

return true if EventLoopGroup should not be shutdown

Specified by:

daemon in interface LoopResources

Returns:

true if EventLoopGroup should not be shutdown

getOrCreate

protected static <T extends TcpResources> T getOrCreate(AtomicReference<T> ref,
                                                        LoopResources loops,
                                                        PoolResources pools,
                                                        java.util.function.BiFunction<LoopResources,PoolResources,T> onNew,
                                                        String name)

Safely check if existing resource exist and proceed to update/cleanup if new resources references are passed.

Type Parameters:

T - the reified type of TcpResources

Parameters:

ref - the resources atomic reference

loops - the eventual new LoopResources

pools - the eventual new PoolResources

onNew - a TcpResources factory

name - a name for resources

Returns:

an existing or new TcpResources