de.team33.patterns.pooling.e1

Class RProvider<I>

java.lang.Object

de.team33.patterns.pooling.e1.RProvider<I>

Type Parameters:

I - The type of provided instances (items).

Deprecated.

Further development is discontinued and this package/module may be removed in a future release. Successor is the module pooling-ariel.

@Deprecated
public class RProvider<I>
extends Object

A tool that makes instances of a certain type available for the course of operations that require such an instance. The instances provided are referred to as item in the following.

The tool maintains a number of such items and only creates as many as are actually required at most at the same time in its application context. The items are retained and reused for subsequent operations.

In this respect, this tool is suitable for providing item types whose instantiation is relatively "expensive", which are rather unsuitable for concurrent access, but are designed for multiple or permanent use. Database or other client-server connections may be an example.

Note: this implementation cannot detect when an internal operation is taking place in the course of an operation to which the same item could be made available.

This implementation supports expiry and reinitialisation of provided items.

This implementation does not support checked exceptions to occur while creating new item instances.

See Also:

Provider, XProvider

Constructor Summary

Constructors

Constructor and Description
RProvider(Supplier<I> newItem, long maxIdle, long maxLiving) Deprecated. Initializes a new instance giving a Supplier that defines the intended initialization of a new item.

Method Summary

Modifier and Type	Method and Description
<R> R	get(Function<? super I,R> function) Deprecated. Calls a given Function with a parameter provided for it and returns its result.
<R,X extends Exception> R	getEx(XFunction<? super I,R,X> xFunction) Deprecated. Calls a given XFunction with a parameter provided for it and returns its result.
void	run(Consumer<? super I> consumer) Deprecated. Runs a given Consumer with a parameter provided for it.
<X extends Exception> void	runEx(XConsumer<? super I,X> xConsumer) Deprecated. Runs a given XConsumer with a parameter provided for it.
int	size() Deprecated. Returns the number of currently unused subjects in stock.

Methods inherited from class java.lang.Object

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

Constructor Detail

RProvider

public RProvider(Supplier<I> newItem,
                 long maxIdle,
                 long maxLiving)

Deprecated.

Initializes a new instance giving a Supplier that defines the intended initialization of a new item.

Once an instance item is initialized it will expire and be renewed after a maximum idle time or at least after a maximum lifetime.

Method Detail

run

public final void run(Consumer<? super I> consumer)

Deprecated.

Runs a given Consumer with a parameter provided for it. The parameter is kept for future use.

While the Consumer is being executed, the parameter is exclusively available to it, but must not be "hijacked" from the context of the execution or the executing thread!

runEx

public final <X extends Exception> void runEx(XConsumer<? super I,X> xConsumer)
                                       throws X extends Exception

Deprecated.

Runs a given XConsumer with a parameter provided for it. The parameter is kept for future use.

While the XConsumer is being executed, the parameter is exclusively available to it, but must not be "hijacked" from the context of the execution or the executing thread!

Type Parameters:

X - A type of exception that may be caused by the given XConsumer.

Throws:

X - if the execution of the given XConsumer causes one.

X extends Exception

get

public final <R> R get(Function<? super I,R> function)

Deprecated.

Calls a given Function with a parameter provided for it and returns its result. The parameter is kept for future use.

While the Function is being called, the parameter is exclusively available to it, but must not be "hijacked" from the context of the call or the executing thread!

Type Parameters:

R - The result type of the given Function

getEx

public final <R,X extends Exception> R getEx(XFunction<? super I,R,X> xFunction)
                                      throws X extends Exception

Deprecated.

Calls a given XFunction with a parameter provided for it and returns its result. The parameter is kept for future use.

While the XFunction is being called, the parameter is exclusively available to it, but must not be "hijacked" from the context of the call or the executing thread!

Type Parameters:

R - The result type of the given XFunction

X - A type of exception that may be caused by the given XFunction.

Throws:

X - if the execution of the given XFunction causes one.

X extends Exception

size

public final int size()

Deprecated.

Returns the number of currently unused subjects in stock.