org.redisson.core

Interface RRemoteService

All Known Implementing Classes:

RedissonRemoteService

public interface RRemoteService

Allows to execute object methods remotely between Redisson instances (Server side and Client side instances in terms of remote invocation).

1. Server side instance (worker instance). Register object with RRemoteService instance.

RRemoteService remoteService = redisson.getRemoteService();

// register remote service before any remote invocation
remoteService.register(SomeServiceInterface.class, someServiceImpl);

2. Client side instance. Invokes method remotely.

RRemoteService remoteService = redisson.getRemoteService();
SomeServiceInterface service = remoteService.get(SomeServiceInterface.class);

String result = service.doSomeStuff(1L, "secondParam", new AnyParam());

There are two timeouts during execution:

Acknowledge (Ack) timeout.Client side instance waits for acknowledge message from Server side instance.

If acknowledge has not been received by Client side instance then RemoteServiceAckTimeoutException will be thrown. And next invocation attempt can be made.

If acknowledge has not been received Client side instance but Server side instance has received invocation message already. In this case invocation will be skipped, due to ack timeout checking by Server side instance.

Execution timeout. Client side instance received acknowledge message. If it hasn't received any result or error from server side during execution timeout then RemoteServiceTimeoutException will be thrown.

Author:

Nikita Koksharov

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	get(Class<T> remoteInterface) Get remote service object for remote invocations.
<T> T	get(Class<T> remoteInterface, long executionTimeout, TimeUnit executionTimeUnit) Get remote service object for remote invocations with specified invocation timeout.
<T> T	get(Class<T> remoteInterface, long executionTimeout, TimeUnit executionTimeUnit, long ackTimeout, TimeUnit ackTimeUnit) Get remote service object for remote invocations with specified invocation and ack timeouts
<T> void	register(Class<T> remoteInterface, T object) Register remote service with single executor
<T> void	register(Class<T> remoteInterface, T object, int executorsAmount) Register remote service with custom executors amount

Method Detail

register

<T> void register(Class<T> remoteInterface,
                T object)

Register remote service with single executor

Parameters:

remoteInterface -

object -

register

<T> void register(Class<T> remoteInterface,
                T object,
                int executorsAmount)

Register remote service with custom executors amount

Parameters:

remoteInterface -

object -

executorsAmount -

get

<T> T get(Class<T> remoteInterface)

Get remote service object for remote invocations.

Ack timeout = 1000 ms by default

Execution timeout = 30 sec by default

Parameters:

remoteInterface -

Returns:

get

<T> T get(Class<T> remoteInterface,
        long executionTimeout,
        TimeUnit executionTimeUnit)

Get remote service object for remote invocations with specified invocation timeout.

Ack timeout = 1000 ms by default

Parameters:

remoteInterface -

executionTimeout - - invocation timeout

executionTimeUnit -

Returns:

get

<T> T get(Class<T> remoteInterface,
        long executionTimeout,
        TimeUnit executionTimeUnit,
        long ackTimeout,
        TimeUnit ackTimeUnit)

Get remote service object for remote invocations with specified invocation and ack timeouts

Parameters:

remoteInterface -

executionTimeout - - invocation timeout

executionTimeUnit -

ackTimeout - - ack timeout

ackTimeUnit -

Returns: