Package org.infinispan.interceptors.distribution

Class RemoteGetSingleKeyCollector

java.lang.Object

org.infinispan.interceptors.distribution.RemoteGetSingleKeyCollector

All Implemented Interfaces:

ResponseCollector<SuccessfulResponse>

public class RemoteGetSingleKeyCollector
extends Object
implements ResponseCollector<SuccessfulResponse>

Return the first successful response for a staggered remote get, used in dist mode. Throw an OutdatedTopologyException if all responses are either UnsureResponse or CacheNotFoundResponse. Throw an exception immediately if a response is exceptional or unexpected.

Since:

9.4

Author:

Dan Berindei

Constructor Summary

Constructors

Constructor	Description
RemoteGetSingleKeyCollector()

Method Summary

Modifier and Type	Method	Description
SuccessfulResponse	addResponse(Address sender, Response response)	Called when a response is received, or when a target node becomes unavailable.
SuccessfulResponse	finish()	Called after ResponseCollector.addResponse(Address, Response) returns null for the last response.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteGetSingleKeyCollector

public RemoteGetSingleKeyCollector()

Method Detail

addResponse

public SuccessfulResponse addResponse(Address sender,
                                      Response response)

Description copied from interface: ResponseCollector

Called when a response is received, or when a target node becomes unavailable.

When a target node leaves the cluster, this method is called with a CacheNotFoundResponse.

Should return a non-null result if the request should complete, or null if it should wait for more responses. If the method throws an exception, the request will be completed with that exception. If the last response is received and addResponse() still returns null, ResponseCollector.finish() will also be called to obtain a result.

Thread safety: addResponse() will *not* be called concurrently from multiple threads, and the request will not be completed while addResponse() is running.

Specified by:

addResponse in interface ResponseCollector<SuccessfulResponse>

finish

public SuccessfulResponse finish()

Description copied from interface: ResponseCollector

Called after ResponseCollector.addResponse(Address, Response) returns null for the last response.

If finish() finishes normally, the request will complete with its return value (even if null). If finish() throws an exception, the request will complete exceptionally with that exception, wrapped in a CompletionException (unless the exception is already a CompletionException).

Specified by:

finish in interface ResponseCollector<SuccessfulResponse>