org.fryske_akademy.ejb

Interface CrudWriteService

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractCrudService, AbstractCrudServiceEnvers

public interface CrudWriteService
extends Serializable

Generic interface for write operations on entities

Author:

eduard

Method Summary

Modifier and Type	Method and Description
int	batchDelete(Collection<? extends EntityInterface> entities, Integer flushCount) save multiple entities, NOTE that normally only after commit or flush entitymanagers will reflect changes caused by saving all entities, this may cause entitylisteners to fail.
<T extends EntityInterface> Stream<T>	batchSave(Collection<T> entities, Integer flushCount) save multiple entities, NOTE that normally only after commit or flush entitymanagers will reflect changes caused by saving all entities, this may cause entitylisteners to fail.
<T extends Serializable> T	create(T t)
void	delete(EntityInterface t)
<T extends EntityInterface> T	save(T t) create or update depending on EntityInterface.isTransient().
<T extends Serializable> T	update(T t)

Method Detail

create

<T extends Serializable> T create(T t)

update

<T extends Serializable> T update(T t)

save

<T extends EntityInterface> T save(T t)

create or update depending on EntityInterface.isTransient().

Type Parameters:

T -

Parameters:

t -

Returns:

delete

void delete(EntityInterface t)

batchSave

<T extends EntityInterface> Stream<T> batchSave(Collection<T> entities,
                                                Integer flushCount)

save multiple entities, NOTE that normally only after commit or flush entitymanagers will reflect changes caused by saving all entities, this may cause entitylisteners to fail. You may need to perform checks on the collection before calling this method. Also note that entitylisteners will execute within the batch transaction, you may need to specify Transactional.TxType on the bean that you use in your listeners, use isolation level 0 (not recommended) or use XA when you need to access resources from your listeners. When flushCount != null flushes and clears the entitymanager every flushCount entities. NOTE that this method executes in one (possibly big) sql transaction! You can use EntityException in for example your listeners to find out in case of failure which enitity caused it.

Parameters:

entities -

flushCount - when not null try to optimize (flush/clear) every so many entities

Returns:

the saved entities

See Also:

Util#getBean(java.lang.Class, javax.enterprise.inject.spi.BeanManager, java.lang.annotation.Annotation...)

batchDelete

int batchDelete(Collection<? extends EntityInterface> entities,
                Integer flushCount)

save multiple entities, NOTE that normally only after commit or flush entitymanagers will reflect changes caused by saving all entities, this may cause entitylisteners to fail. You may need to perform checks on the collection before calling this method. Also note that entitylisteners will execute within the batch transaction, you may need to specify Transactional.TxType on the bean that you use in your listeners, use isolation level 0 (not recommended) or use XA when you need to access resources from your listeners. When flushCount != null flushes and clears the entitymanager every flushCount entities. NOTE that this method executes in one (possibly big) sql transaction! You can use EntityException in for example your listeners to find out in case of failure which enitity caused it.

Parameters:

entities -

flushCount - when not null try to optimize (flush/clear) every so many entities

Returns:

number of entities deleted

See Also:

Util#getBean(java.lang.Class, javax.enterprise.inject.spi.BeanManager, java.lang.annotation.Annotation...)