org.springframework.data.mapping.callback

Interface EntityCallbacks

public interface EntityCallbacks

Interface to be implemented by objects that can manage a number of EntityCallback objects and invoke these with a specific entity.

Since:

2.2

Author:

Christoph Strobl

See Also:

EntityCallback

Method Summary

Modifier and Type	Method and Description
void	addEntityCallback(EntityCallback<?> callback) Add the given callback using generic type argument detection for identification of supported types.
<T> T	callback(Class<? extends EntityCallback> callbackType, T entity, Object... args) Invoke matching entity callbacks with given arguments.
static EntityCallbacks	create() Obtain a new EntityCallbacks instance.
static EntityCallbacks	create(BeanFactory beanFactory) Obtain a new EntityCallbacks instance.
static EntityCallbacks	create(EntityCallback<?>... callbacks) Create a new EntityCallbacks instance with given callbacks.

Method Detail

addEntityCallback

void addEntityCallback(EntityCallback<?> callback)

Add the given callback using generic type argument detection for identification of supported types.

Parameters:

callback - must not be null.

Throws:

IllegalArgumentException - if the required argument is null.

callback

<T> T callback(Class<? extends EntityCallback> callbackType,
               T entity,
               Object... args)

Invoke matching entity callbacks with given arguments.

Type Parameters:

T - Entity type.

Parameters:

callbackType - must not be null.

entity - must not be null.

args - optional arguments.

Returns:

never null.

Throws:

IllegalArgumentException - if a required argument is null.

create

static EntityCallbacks create(EntityCallback<?>... callbacks)

Create a new EntityCallbacks instance with given callbacks.
The provided callbacks are immediately added.

create

static EntityCallbacks create()

Obtain a new EntityCallbacks instance.
Use addEntityCallback(EntityCallback) to register callbacks manually.

create

static EntityCallbacks create(BeanFactory beanFactory)

Obtain a new EntityCallbacks instance.

callbacks are pre loaded from the given BeanFactory.
Use addEntityCallback(EntityCallback) to register additional callbacks manually.

Parameters:

beanFactory - must not be null.

Throws:

IllegalArgumentException - if a required argument is null.