io.picodata.driver.api

Interface TarantoolCallOperations

All Known Subinterfaces:

TarantoolClient<T,R>

All Known Implementing Classes:

AbstractTarantoolClient, ClusterTarantoolClient, ClusterTarantoolTupleClient, ProxyTarantoolClient, ProxyTarantoolTupleClient, RetryingTarantoolClient, RetryingTarantoolTupleClient

public interface TarantoolCallOperations

Aggregates all call operation variants

Method Summary

Modifier and Type	Method and Description
CompletableFuture<List<?>>	call(String functionName) Execute a function defined on Tarantool instance.
CompletableFuture<List<?>>	call(String functionName, Collection<?> arguments) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	call(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	call(String functionName, Collection<?> arguments, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
CompletableFuture<List<?>>	call(String functionName, Object... arguments) Execute a function defined on Tarantool instance, The value mapper specified in the client configuration will be used for converting the result values from MessagePack entities to objects.
<T> CompletableFuture<T>	call(String functionName, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Supplier<R> resultContainerSupplier, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Supplier<R> resultContainerSupplier, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<R> resultContainerSupplier, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Collection<?> arguments, Supplier<R> resultContainerSupplier, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Supplier<R> resultContainerSupplier, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T,R extends List<T>> CompletableFuture<R>	callForMultiResult(String functionName, Supplier<R> resultContainerSupplier, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Class<T> resultClass) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Collection<?> arguments, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier) Execute a function defined on Tarantool instance.
<T> CompletableFuture<T>	callForSingleResult(String functionName, ValueConverter<org.msgpack.value.Value,T> valueConverter) Execute a function defined on Tarantool instance.
<T> CompletableFuture<TarantoolResult<T>>	callForTupleResult(String functionName, Class<T> entityClass) Execute a function defined on Tarantool instance.
<T> CompletableFuture<TarantoolResult<T>>	callForTupleResult(String functionName, Collection<?> arguments, Class<T> entityClass) Execute a function defined on Tarantool instance.
<T> CompletableFuture<TarantoolResult<T>>	callForTupleResult(String functionName, Collection<?> arguments, Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier, Class<T> entityClass) Execute a function defined on Tarantool instance.
ResultMapperFactoryFactory	getResultMapperFactoryFactory() Get the default factory for result mapper factory instances

Method Detail

call

CompletableFuture<List<?>> call(String functionName)
                         throws TarantoolClientException

Execute a function defined on Tarantool instance. The value mapper specified in the client configuration will be used for converting the result values from MessagePack entities to objects. TODO example function call

Parameters:

functionName - function name, must not be null or empty

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

call

CompletableFuture<List<?>> call(String functionName,
                                Object... arguments)
                         throws TarantoolClientException

Execute a function defined on Tarantool instance, The value mapper specified in the client configuration will be used for converting the result values from MessagePack entities to objects.

Parameters:

functionName - function name, must not be null or empty

arguments - vararg array of function arguments. The object mapper specified in the client configuration will be used for arguments conversion to MessagePack entities

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

call

CompletableFuture<List<?>> call(String functionName,
                                Collection<?> arguments)
                         throws TarantoolClientException

Execute a function defined on Tarantool instance. The value mapper specified in the client configuration will be used for converting the result values from MessagePack entities to objects.

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments. The object mapper specified in the client configuration will be used for arguments conversion to MessagePack entities

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForTupleResult

<T> CompletableFuture<TarantoolResult<T>> callForTupleResult(String functionName,
                                                             Class<T> entityClass)
                                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples. The value mapper specified in the client configuration will be used for converting the result values from MessagePack arrays to the specified entity type.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

entityClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

call

<T> CompletableFuture<T> call(String functionName,
                              Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                       throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForTupleResult

<T> CompletableFuture<TarantoolResult<T>> callForTupleResult(String functionName,
                                                             Collection<?> arguments,
                                                             Class<T> entityClass)
                                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples. The value mapper specified in the client configuration will be used for converting the result values from MessagePack arrays to the specified entity type.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments. The object mapper specified in the client configuration will be used for arguments conversion to MessagePack entities

entityClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

call

<T> CompletableFuture<T> call(String functionName,
                              Collection<?> arguments,
                              Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                       throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments. The object mapper specified in the client configuration will be used for arguments conversion to MessagePack entities

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForTupleResult

<T> CompletableFuture<TarantoolResult<T>> callForTupleResult(String functionName,
                                                             Collection<?> arguments,
                                                             Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                                             Class<T> entityClass)
                                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples. The value mapper specified in the client configuration will be used for converting the result values from MessagePack arrays to the specified entity type.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

entityClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

call

<T> CompletableFuture<T> call(String functionName,
                              Collection<?> arguments,
                              Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                              Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                       throws TarantoolClientException

Execute a function defined on Tarantool instance. The call result is interpreted as an array of tuples.

Type Parameters:

T - desired function call result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                             Class<T> resultClass)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                             ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                             Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             Class<T> resultClass)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Collection<?> arguments,
                                             Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Class<T> resultClass)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForSingleResult

<T> CompletableFuture<T> callForSingleResult(String functionName,
                                             Supplier<CallResultMapper<T,SingleValueCallResult<T>>> resultMapperSupplier)
                                      throws TarantoolClientException

Execute a function defined on Tarantool instance. The first item of the call result will be interpreted as a value, and the second -- as an error

Type Parameters:

T - target result content type

Parameters:

functionName - function name, must not be null or empty

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                                              Supplier<R> resultContainerSupplier,
                                                              Class<T> resultClass)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultContainerSupplier - supplier function for new empty result collection

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                                              Supplier<R> resultContainerSupplier,
                                                              ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultContainerSupplier - supplier function for new empty result collection

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<? extends MessagePackObjectMapper> argumentsMapperSupplier,
                                                              Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

argumentsMapperSupplier - mapper supplier for arguments object-to-MessagePack entity conversion

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<R> resultContainerSupplier,
                                                              Class<T> resultClass)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

resultContainerSupplier - supplier function for new empty result collection

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<R> resultContainerSupplier,
                                                              ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

resultContainerSupplier - supplier function for new empty result collection

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Collection<?> arguments,
                                                              Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

arguments - list of function arguments

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Supplier<R> resultContainerSupplier,
                                                              Class<T> resultClass)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

resultContainerSupplier - supplier function for new empty result collection

resultClass - target result entity class

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Supplier<R> resultContainerSupplier,
                                                              ValueConverter<org.msgpack.value.Value,T> valueConverter)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

resultContainerSupplier - supplier function for new empty result collection

valueConverter - MessagePack value to entity converter for each result item

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

callForMultiResult

<T,R extends List<T>> CompletableFuture<R> callForMultiResult(String functionName,
                                                              Supplier<CallResultMapper<R,MultiValueCallResult<T,R>>> resultMapperSupplier)
                                                       throws TarantoolClientException

Execute a function defined on Tarantool instance. All multi-return result items will be put into a list

Type Parameters:

T - target result content type

R - target result type

Parameters:

functionName - function name, must not be null or empty

resultMapperSupplier - mapper supplier for result value MessagePack entity-to-object conversion

Returns:

some result

Throws:

TarantoolClientException - if the client is not connected or some other error occurred

getResultMapperFactoryFactory

ResultMapperFactoryFactory getResultMapperFactoryFactory()

Get the default factory for result mapper factory instances

Returns:

result mapper factory instances factory instance