org.apache.deltaspike.data.api

Interface EntityPersistenceRepository<E,PK extends Serializable>

All Superinterfaces:

Deactivatable

All Known Subinterfaces:

ArticleRepository, EntityRepository<E,PK>, FullEntityRepository<E,PK>

All Known Implementing Classes:

AbstractEntityRepository, AbstractFullEntityRepository

public interface EntityPersistenceRepository<E,PK extends Serializable>
extends Deactivatable

Method Summary

Methods

Modifier and Type	Method and Description
void	attachAndRemove(E entity) Convenience access to EntityManager.remove(Object) with an detached entity.
void	flush() Convenience access to EntityManager.flush().
PK	getPrimaryKey(E example) Return the id of the entity.
void	refresh(E entity) Convenience access to EntityManager.refresh(Object).
void	remove(E entity) Convenience access to EntityManager.remove(Object).
void	removeAndFlush(E entity) Convenience access to EntityManager.remove(Object) with a following flush.
E	save(E entity) Persist (new entity) or merge the given entity.
E	saveAndFlush(E entity) save(Object)s the given entity and flushes the persistence context afterwards.
E	saveAndFlushAndRefresh(E entity) save(Object)s the given entity and flushes the persistence context afterwards, followed by a refresh (e.g. to load DB trigger modifications).

Method Detail

save

E save(E entity)

Persist (new entity) or merge the given entity. The distinction on calling either method is done based on the primary key field being null or not. If this results in wrong behavior for a specific case, consider using the EntityManagerDelegate which offers both persist and merge.

Parameters:

entity - Entity to save.

Returns:

Returns the modified entity.

saveAndFlush

E saveAndFlush(E entity)

save(Object)s the given entity and flushes the persistence context afterwards.

Parameters:

entity - Entity to save.

Returns:

Returns the modified entity.

saveAndFlushAndRefresh

E saveAndFlushAndRefresh(E entity)

save(Object)s the given entity and flushes the persistence context afterwards, followed by a refresh (e.g. to load DB trigger modifications).

Parameters:

entity - Entity to save.

Returns:

Returns the modified entity.

remove

void remove(E entity)

Convenience access to EntityManager.remove(Object).

Parameters:

entity - Entity to remove.

removeAndFlush

void removeAndFlush(E entity)

Convenience access to EntityManager.remove(Object) with a following flush.

Parameters:

entity - Entity to remove.

attachAndRemove

void attachAndRemove(E entity)

Convenience access to EntityManager.remove(Object) with an detached entity.

Parameters:

entity - Entity to remove.

refresh

void refresh(E entity)

Convenience access to EntityManager.refresh(Object).

Parameters:

entity - Entity to refresh.

flush

void flush()

Convenience access to EntityManager.flush().

getPrimaryKey

PK getPrimaryKey(E example)

Return the id of the entity. Returns null if the entity does not yet have an id.

Parameters:

example - Sample entity.

Returns:

id of the entity