org.fryske_akademy.jsf

Class AbstractEntityController<T extends EntityInterface,S extends Auditing>

java.lang.Object

org.fryske_akademy.jsf.AbstractController<S>

org.fryske_akademy.jsf.AbstractEntityController<T,S>

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AbstractLazyController

public abstract class AbstractEntityController<T extends EntityInterface,S extends Auditing>
extends AbstractController<S>

Author:

eduard

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<T>	clazz
protected static String	CONDITION will be appended to action in filterAndRedirect(org.fryske_akademy.jsf.AbstractEntityController, java.lang.String, java.lang.String, java.lang.String)
static String	DEFAULT_BUNDLE_NAME
protected static String	FILTER will be appended to CONDITION in filterAndRedirect(org.fryske_akademy.jsf.AbstractEntityController, java.lang.String, java.lang.String, java.lang.String)

Fields inherited from class org.fryske_akademy.jsf.AbstractController

FACESREDIRECTTRUE

Constructor Summary

Constructors

Constructor and Description
AbstractEntityController(Class<T> clazz)

Method Summary

Modifier and Type	Method and Description
void	cancelRow(org.primefaces.event.RowEditEvent editEvent) Calls refreshRow(org.primefaces.event.RowEditEvent, org.fryske_akademy.jpa.EntityInterface, boolean) with the canceled entity from the event and false.
void	copy() copy an entity, call fillCopy(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jpa.EntityInterface)
T	create() calls AbstractController.persist(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jsf.util.JsfUtil.PersistAction, java.lang.String) and gotoPageContaining(org.fryske_akademy.jpa.EntityInterface)
void	destroy()
protected abstract void	fillCopy(T newEntity, T selected) implementors can fill the new object with values from selected
protected void	fillNew(T entity) empty method, called from prepareCreate()
protected String	filterAndRedirect(AbstractEntityController controller, String key, String value, String action) clears all filters, adds the key/value to it and returns your action with AbstractController.FACESREDIRECTTRUE and "condition=filter" appended.
protected String	getBundleName() override if you want to use different bundle name then DEFAULT_BUNDLE_NAME
abstract Filtering<T>	getFiltering()
List<RevInfo<T>>	getLastChanged(T entity, int max)
String	getLastChangedInfo(T entity) returns username, revision date and RevisionType for the last revision found
T	getNewEntity()
T	getSelected()
protected abstract String	gotoPageContaining(T entity) Navigate (i.e.
boolean	isRememberTableState() remember sorting, filtering, column order, selection, column widths, page number (@multiViewState).
void	onRowSelect(org.primefaces.event.SelectEvent event)
void	prepareCreate() creates a new entity and calls fillNew(org.fryske_akademy.jpa.EntityInterface)
protected void	refreshRow(org.primefaces.event.RowEditEvent editEvent, T t, boolean update) Attempts to show data in sync with the database after an update or cancel edit.
void	setNewEntity(T newEntity)
void	setRememberTableState(boolean rememberTableState)
void	setSelected(T selected)
T	update(org.primefaces.event.RowEditEvent editEvent) Calls AbstractController.persist(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jsf.util.JsfUtil.PersistAction, java.lang.String) and refreshRow(org.primefaces.event.RowEditEvent, org.fryske_akademy.jpa.EntityInterface, boolean) with the up to date entity and true.

Methods inherited from class org.fryske_akademy.jsf.AbstractController

diacriticsKeyBoard, getCrudWriteService, initCrudWriteService, persist, persist, setCrudWriteService

Methods inherited from class java.lang.Object

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

Field Detail

clazz

protected final Class<T extends EntityInterface> clazz

DEFAULT_BUNDLE_NAME

public static final String DEFAULT_BUNDLE_NAME

See Also:

Constant Field Values

CONDITION

protected static final String CONDITION

will be appended to action in filterAndRedirect(org.fryske_akademy.jsf.AbstractEntityController, java.lang.String, java.lang.String, java.lang.String)

See Also:

Constant Field Values

FILTER

protected static final String FILTER

will be appended to CONDITION in filterAndRedirect(org.fryske_akademy.jsf.AbstractEntityController, java.lang.String, java.lang.String, java.lang.String)

See Also:

Constant Field Values

Constructor Detail

AbstractEntityController

public AbstractEntityController(Class<T> clazz)

Method Detail

isRememberTableState

public boolean isRememberTableState()

remember sorting, filtering, column order, selection, column widths, page number (@multiViewState). NOTE this may overwrite filter value set from filterAndRedirect(org.fryske_akademy.jsf.AbstractEntityController, java.lang.String, java.lang.String, java.lang.String) subclasses may therefore choose to check if #getCondition() equals FILTER.

Returns:

setRememberTableState

public void setRememberTableState(boolean rememberTableState)

getSelected

public T getSelected()

setSelected

public void setSelected(T selected)

getNewEntity

public T getNewEntity()

setNewEntity

public void setNewEntity(T newEntity)

onRowSelect

public void onRowSelect(org.primefaces.event.SelectEvent event)

prepareCreate

public final void prepareCreate()
                         throws InstantiationException,
                                IllegalAccessException

creates a new entity and calls fillNew(org.fryske_akademy.jpa.EntityInterface)

Throws:

InstantiationException

IllegalAccessException

create

public T create()

calls AbstractController.persist(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jsf.util.JsfUtil.PersistAction, java.lang.String) and gotoPageContaining(org.fryske_akademy.jpa.EntityInterface)

getBundleName

protected String getBundleName()

override if you want to use different bundle name then DEFAULT_BUNDLE_NAME

Returns:

getFiltering

public abstract Filtering<T> getFiltering()

gotoPageContaining

protected abstract String gotoPageContaining(T entity)

Navigate (i.e. in a datatable) to the page containing the argument entity. Implementors can call Filtering.clear().add(java.lang.String, java.lang.Object) and then for example redirect and use viewParam

Parameters:

entity -

Returns:

the action to perform

fillCopy

protected abstract void fillCopy(T newEntity,
                                 T selected)

implementors can fill the new object with values from selected

Parameters:

newEntity -

selected -

fillNew

protected void fillNew(T entity)

empty method, called from prepareCreate()

Parameters:

entity -

copy

public final void copy()
                throws InstantiationException,
                       IllegalAccessException

copy an entity, call fillCopy(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jpa.EntityInterface)

Throws:

InstantiationException

IllegalAccessException

update

public T update(org.primefaces.event.RowEditEvent editEvent)

Calls AbstractController.persist(org.fryske_akademy.jpa.EntityInterface, org.fryske_akademy.jsf.util.JsfUtil.PersistAction, java.lang.String) and refreshRow(org.primefaces.event.RowEditEvent, org.fryske_akademy.jpa.EntityInterface, boolean) with the up to date entity and true.

Parameters:

editEvent -

Returns:

the updated entity

refreshRow

protected void refreshRow(org.primefaces.event.RowEditEvent editEvent,
                          T t,
                          boolean update)

Attempts to show data in sync with the database after an update or cancel edit. This implementation works for DataTables with a List or a DataModel wrapping a List as value.

Parameters:

editEvent -

t -

update - when

cancelRow

public void cancelRow(org.primefaces.event.RowEditEvent editEvent)

Calls refreshRow(org.primefaces.event.RowEditEvent, org.fryske_akademy.jpa.EntityInterface, boolean) with the canceled entity from the event and false.

Parameters:

editEvent -

destroy

public void destroy()

getLastChangedInfo

public String getLastChangedInfo(T entity)

returns username, revision date and RevisionType for the last revision found

Parameters:

entity -

Returns:

See Also:

Auditing.getRevisionInfo(java.io.Serializable, java.lang.Integer, java.lang.Class)

getLastChanged

public List<RevInfo<T>> getLastChanged(T entity,
                                       int max)

filterAndRedirect

protected String filterAndRedirect(AbstractEntityController controller,
                                   String key,
                                   String value,
                                   String action)

clears all filters, adds the key/value to it and returns your action with AbstractController.FACESREDIRECTTRUE and "condition=filter" appended.

Parameters:

controller -

key -

value -

action -

Returns: