org.josef.web.jsf.bean.crud

Class AbstractCrudSingleEntityUsingEntityManagerBean<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.AbstractCrudSingleEntityBean<T>

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

Type Parameters:

T - The type of the Entities to maintain.

All Implemented Interfaces:

Serializable, Observer

Direct Known Subclasses:

CarBean, ElementBean, HtmlTagBean, NobelPrizeBean, NobelPrizeCategoryBean, PlanetBean, ScientistBean

public abstract class AbstractCrudSingleEntityUsingEntityManagerBean<T extends Persistable>
extends AbstractCrudSingleEntityBean<T>

Super class for JSF Beans that perform CRUD actions (including searching and sorting) on a single JPA Entity, 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
AbstractCrudSingleEntityUsingEntityManagerBean() Public constructor to make this a bean.

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.
T	selectItem(Object objectId) Selects the Entity identified by the supplied objectId.

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, newItemListener, removeItemListener, resetSearchCriteriaListener, searchItemsListener, selectItemListener, submitItemListener, update

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCrudSingleEntityUsingEntityManagerBean

public AbstractCrudSingleEntityUsingEntityManagerBean()

Public constructor to make this a bean.

Method Detail

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.
The returned Entity will be detached.

Throws:

NullPointerException - When the supplied objectId is null.

AssertionError - When the supplied objectId is 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.