org.josef.web.jsf.bean.crud

Class AbstractCrudManyToOneEntityUsingEntityManagerBean<T extends Persistable>

java.lang.Object

org.josef.web.jsf.bean.crud.AbstractCrudItemBean<T>

org.josef.web.jsf.bean.crud.AbstractCrudEntityBean<T>

org.josef.web.jsf.bean.crud.AbstractCrudManyToOneEntityBean<T>

org.josef.web.jsf.bean.crud.AbstractCrudManyToOneEntityUsingEntityManagerBean<T>

Type Parameters:

T - The type of the Entities to maintain.

All Implemented Interfaces:

Serializable, Observer

Direct Known Subclasses:

MoonBean

public abstract class AbstractCrudManyToOneEntityUsingEntityManagerBean<T extends Persistable>
extends AbstractCrudManyToOneEntityBean<T>

Super class for JSF Beans that perform CRUD actions (including searching and sorting) on a single JPA Entity, that is part of a many-to-one relation, by directly using an Entity Manager.

Version:

1.1 $Revision: 5773 $

Author:

Kees Schotanus

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.josef.web.jsf.bean.crud.AbstractCrudItemBean

AbstractCrudItemBean.DetailItemDelegate, AbstractCrudItemBean.SearchItemsDelegate

Constructor Summary

Constructors

Constructor and Description
AbstractCrudManyToOneEntityUsingEntityManagerBean()

Method Summary

Modifier and Type	Method and Description
void	merge() Merges the Entity.
void	persist() Persists the Entity.
void	preMerge() Automatically called from within a transaction, before an entity is merged.
void	prePersist() Automatically called from within a transaction, before an entity is persisted.
void	preRemove() Automatically called from within a transaction, before an entity is removed.
boolean	remove() Removes the Item.
List<T>	searchItems() Default implementation for searching Entities.
void	searchItemsListener(javax.faces.event.ActionEvent actionEvent) Called when a search needs to be executed.
T	selectItem(Object objectId) Selects the Entity identified by the supplied objectId.

Methods inherited from class org.josef.web.jsf.bean.crud.AbstractCrudManyToOneEntityBean

getParentId, newItemListener, setParentId

Methods inherited from class org.josef.web.jsf.bean.crud.AbstractCrudEntityBean

sort

Methods inherited from class org.josef.web.jsf.bean.crud.AbstractCrudItemBean

backToSearchItemsListener, getDetailDelegate, getItemObservable, getItemType, getSearchCriteria, getSearchDelegate, getSearchModePhaseListener, removeItemListener, resetSearchCriteriaListener, selectItemListener, submitItemListener, update

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCrudManyToOneEntityUsingEntityManagerBean

public AbstractCrudManyToOneEntityUsingEntityManagerBean()

Method Detail

searchItemsListener

public void searchItemsListener(javax.faces.event.ActionEvent actionEvent)

Called when a search needs to be executed.
Note: Failing to clear the cache, results in different search results upon subsequent search requests.

Overrides:

searchItemsListener in class AbstractCrudItemBean<T extends Persistable>

Parameters:

actionEvent - The ActionEvent.

searchItems

public List<T> searchItems()

Default implementation for searching Entities.
Builds a JP/QL query including where-clause and order-by-clause and executes the generated query. As an abbreviation, this method uses the first letter of the name of the entity, converted to lower case.

Specified by:

searchItems in class AbstractCrudItemBean<T extends Persistable>

Returns:

The found Entities.

See Also:

EntityDataAccess.findByCriteria(Class, org.josef.jpa.Searchable)

selectItem

public T selectItem(Object objectId)

Selects the Entity identified by the supplied objectId.

Specified by:

selectItem in class AbstractCrudItemBean<T extends Persistable>

Parameters:

objectId - The object ID of the Entity.
The supplied objectId must be non null and of type Long.

Returns:

The Entity with the supplied objectId or null when no such Entity exists.

Throws:

NullPointerException - When the supplied objectId is null.

AssertionError - When the supplied objectId is null or not of type Long.

persist

public void persist()

Persists the Entity.
Postcondition: When the persist fails, a JSF Message is added and the transaction is rolled back. Postcondition: When the persist is successful the mode is set to JsfBeanMode.UPDATE.

Specified by:

persist in class AbstractCrudItemBean<T extends Persistable>

prePersist

public void prePersist()

Automatically called from within a transaction, before an entity is persisted.
Override this method for example to update parent/child relations.

merge

public void merge()

Merges the Entity.
Postcondition: When the merge fails, a JSF Message is added and the transaction is rolled back.

Specified by:

merge in class AbstractCrudItemBean<T extends Persistable>

preMerge

public void preMerge()

Automatically called from within a transaction, before an entity is merged.

remove

public boolean remove()

Removes the Item.
Postcondition: When the remove fails, a JSF Message is added and the transaction is rolled back.

Specified by:

remove in class AbstractCrudItemBean<T extends Persistable>

Returns:

True when the removal was successful, otherwise false is returned.

preRemove

public void preRemove()

Automatically called from within a transaction, before an entity is removed.