Package org.infinispan.util.concurrent

Class NonBlockingOrderer

java.lang.Object

org.infinispan.util.concurrent.NonBlockingOrderer

public class NonBlockingOrderer
extends java.lang.Object

Ordering construct allowing concurrent operations that wish to do operations upon the same key to wait until the most recently registered operation is complete in a non blocking way.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	NonBlockingOrderer.OPERATION

Constructor Summary

Constructors

Constructor	Description
NonBlockingOrderer()

Method Summary

Modifier and Type	Method	Description
void	completeOperation(java.lang.Object key, java.util.concurrent.CompletableFuture<NonBlockingOrderer.OPERATION> registeredFuture, NonBlockingOrderer.OPERATION operation)	Completes a given operation by freeing any memory for the future and completing it
java.util.concurrent.CompletionStage<NonBlockingOrderer.OPERATION>	orderOn(java.lang.Object key, java.util.concurrent.CompletionStage<NonBlockingOrderer.OPERATION> register)	Registers the provided Stage to be next in line to do an operation on behalf of the provided key.

Methods inherited from class java.lang.Object

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

Constructor Detail

NonBlockingOrderer

public NonBlockingOrderer()

Method Detail

orderOn

public java.util.concurrent.CompletionStage<NonBlockingOrderer.OPERATION> orderOn(java.lang.Object key,
                                                                                  java.util.concurrent.CompletionStage<NonBlockingOrderer.OPERATION> register)

Registers the provided Stage to be next in line to do an operation on behalf of the provided key. Returns a different Stage that when complete signals that this operation should continue or null if there is no wait required.

Parameters:

key - delineating identifier for an operation

register - stage to register for others to wait upon for future registrations

Returns:

stage that signals when the operation that is registering its own future may continue or null if nothing to wait on

completeOperation

public void completeOperation(java.lang.Object key,
                              java.util.concurrent.CompletableFuture<NonBlockingOrderer.OPERATION> registeredFuture,
                              NonBlockingOrderer.OPERATION operation)

Completes a given operation by freeing any memory for the future and completing it

Parameters:

key - delineating identifier for an operation

registeredFuture - previously registered future that is removed from memory as needed

operation - the type of operation