org.springframework.geode.cache

Class RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction<T,ID>

java.lang.Object

org.springframework.geode.cache.RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction<T,ID>

Type Parameters:

T - type of the entity tied to the event.

ID - type of the identifier of the entity.

All Implemented Interfaces:

java.util.function.Function<org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T>,java.lang.Boolean>, RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction<T,ID>

Direct Known Subclasses:

RepositoryAsyncEventListener.CreateUpdateAsyncEventRepositoryFunction, RepositoryAsyncEventListener.RemoveAsyncEventRepositoryFunction

Enclosing class:

RepositoryAsyncEventListener<T,ID>

public abstract static class RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction<T,ID>
extends java.lang.Object
implements RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction<T,ID>

RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction is an abstract base class implementing the RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction interface to provided a default template implementation of the Function.apply(Object) method.

See Also:

RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction

Constructor Summary

Constructors

Constructor and Description
AbstractAsyncEventOperationRepositoryFunction(RepositoryAsyncEventListener<T,ID> listener) Constructs an new instance of RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction initialized with the given, required RepositoryAsyncEventListener to which this function is associated.

Method Summary

Modifier and Type	Method and Description
java.lang.Boolean	apply(org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T> event) Processes the given AsyncEvent by first determining whether the event can be processed by this Function, and then proceeds to extract the entity associated with the event to invoke the appropriate Spring Data CrudRepository data access operation determined by the AsyncEvent Operation.
protected abstract <R> R	doRepositoryOp(T entity) Invokes the appropriate Spring Data CrudRepository data access operation based on the AsyncEvent Operation as determined by GatewayQueueEvent.getOperation().
protected RepositoryAsyncEventListener.AsyncEventErrorHandler	getErrorHandler() Alias to the configured RepositoryAsyncEventListener RepositoryAsyncEventListener.AsyncEventErrorHandler.
protected RepositoryAsyncEventListener<T,ID>	getListener() Returns a reference to the associated RepositoryAsyncEventListener.
protected org.springframework.data.repository.CrudRepository<T,ID>	getRepository() Alias to the configured RepositoryAsyncEventListener CrudRepository.
protected T	resolveEntity(org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T> event) Resolves the entity associated with the AsyncEvent.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.geode.cache.RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction

canProcess

Methods inherited from interface java.util.function.Function

andThen, compose, identity

Constructor Detail

AbstractAsyncEventOperationRepositoryFunction

public AbstractAsyncEventOperationRepositoryFunction(@NonNull
                                                     RepositoryAsyncEventListener<T,ID> listener)

Constructs an new instance of RepositoryAsyncEventListener.AbstractAsyncEventOperationRepositoryFunction initialized with the given, required RepositoryAsyncEventListener to which this function is associated.

Parameters:

listener - RepositoryAsyncEventListener processing AsyncEvents by invoking this Function to handle them.

Throws:

java.lang.IllegalArgumentException - if RepositoryAsyncEventListener is null.

See Also:

RepositoryAsyncEventListener

Method Detail

getErrorHandler

protected RepositoryAsyncEventListener.AsyncEventErrorHandler getErrorHandler()

Alias to the configured RepositoryAsyncEventListener RepositoryAsyncEventListener.AsyncEventErrorHandler.

Returns:

the configured RepositoryAsyncEventListener.AsyncEventErrorHandler; never null.

See Also:

RepositoryAsyncEventListener.getAsyncEventErrorHandler(), RepositoryAsyncEventListener.AsyncEventErrorHandler, getListener()

getListener

@NonNull
protected RepositoryAsyncEventListener<T,ID> getListener()

Returns a reference to the associated RepositoryAsyncEventListener.

Returns:

a reference to the associated RepositoryAsyncEventListener; never null.

See Also:

RepositoryAsyncEventListener

getRepository

@NonNull
protected org.springframework.data.repository.CrudRepository<T,ID> getRepository()

Alias to the configured RepositoryAsyncEventListener CrudRepository.

Returns:

the configured CrudRepository; never null.

See Also:

CrudRepository, RepositoryAsyncEventListener.getRepository(), getListener()

apply

public java.lang.Boolean apply(@Nullable
                               org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T> event)

Processes the given AsyncEvent by first determining whether the event can be processed by this Function, and then proceeds to extract the entity associated with the event to invoke the appropriate Spring Data CrudRepository data access operation determined by the AsyncEvent Operation. If an error is thrown while processing the AsyncEvent, then the RepositoryAsyncEventListener.AsyncEventErrorHandler is called to handle the error and perform any necessary/required post-processing actions. RepositoryAsyncEventListener.AsyncEventErrorHandler can be implemented to retry the operation with incremental backoff, based on count or time, record the failure, perform resource cleanup actions, whatever is necessary and appropriate to the application use case.

Specified by:

apply in interface java.util.function.Function<org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T>,java.lang.Boolean>

Parameters:

event - AsyncEvent to process.

Returns:

a boolean value indicating whether the event was successfully processed.

Throws:

java.lang.IllegalStateException - if the resolve entity is null.

See Also:

AsyncEvent, RepositoryAsyncEventListener.AsyncEventErrorHandler, RepositoryAsyncEventListener.AsyncEventOperationRepositoryFunction.canProcess(AsyncEvent), doRepositoryOp(Object), resolveEntity(AsyncEvent), getErrorHandler()

doRepositoryOp

protected abstract <R> R doRepositoryOp(@NonNull
                                        T entity)

Invokes the appropriate Spring Data CrudRepository data access operation based on the AsyncEvent Operation as determined by GatewayQueueEvent.getOperation().

Type Parameters:

R - type of the Spring Data CrudRepository data access operation return value.

Parameters:

entity - entity to process.

Returns:

the result of invoking the Spring Data CrudRepository data access operation.

See Also:

CrudRepository

resolveEntity

protected T resolveEntity(@NonNull
                          org.apache.geode.cache.asyncqueue.AsyncEvent<ID,T> event)

Resolves the entity associated with the AsyncEvent.

Parameters:

event - AsyncEvent from which to resolve the entity.

Returns:

the resolve entity from the AsyncEvent.

Throws:

java.lang.IllegalArgumentException - if AsyncEvent is null.

java.lang.IllegalStateException - if the resolved entity is null.

See Also:

GatewayQueueEvent.getDeserializedValue(), AsyncEvent