org.nuxeo.ecm.platform.ui.web.component.list

Class UIEditableList

java.lang.Object

javax.faces.component.UIComponent

javax.faces.component.UIComponentBase

javax.faces.component.UIOutput

javax.faces.component.UIInput

org.nuxeo.ecm.platform.ui.web.component.list.UIEditableList

All Implemented Interfaces:

EventListener, javax.faces.component.EditableValueHolder, javax.faces.component.NamingContainer, javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.component.TransientStateHolder, javax.faces.component.ValueHolder, javax.faces.event.ComponentSystemEventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListenerHolder, ResettableComponent

Direct Known Subclasses:

UIJavascriptList

public class UIEditableList
extends javax.faces.component.UIInput
implements javax.faces.component.NamingContainer, ResettableComponent

Editable table component.

Allows to add/remove elements from an UIEditableList, inspired from Trinidad UIXCollection component.

Author:

Anahide Tchertchian

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_FAMILY
static String	COMPONENT_TYPE

Fields inherited from class javax.faces.component.UIInput

CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME

Fields inherited from class javax.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Fields inherited from interface javax.faces.component.NamingContainer

SEPARATOR_CHAR

Constructor Summary

Constructors

Constructor and Description
UIEditableList()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addValue(Object value) Adds a value to the end of the editable model.
void	broadcast(javax.faces.event.FacesEvent event) Delivers a wrapped event to the appropriate component.
void	encodeBegin(javax.faces.context.FacesContext context)
void	encodeChildren(javax.faces.context.FacesContext context) Repeatedly render the children as many times as needed.
void	encodeEnd(javax.faces.context.FacesContext context)
String	getContainerClientId(javax.faces.context.FacesContext context) Override container client id resolution to handle recursion.
Boolean	getDiff() Gets boolean stating if diff must be used when saving the value submitted.
EditableModel	getEditableModel() Gets the EditableModel to use with this component.
String	getFamily()
String	getModel() Gets model name exposed in request map.
Integer	getNumber()
ProtectedEditableModel	getProtectedModel(EditableModel model)
Boolean	getRemoveEmpty()
String	getRendererType()
boolean	getRendersChildren()
int	getRowCount() Gets the total number of rows in this table.
Object	getRowData() Gets the data for the current row.
int	getRowIndex() Gets the index of the current row.
Integer	getRowKey() Gets the rowKey of the current row.
Object	getTemplate() Gets template to be used when adding new values to the model.
Object	getValue()
void	insertValue(int index, Object value) Inserts value at given index on the editable model.
boolean	invokeOnComponent(javax.faces.context.FacesContext context, String clientId, javax.faces.component.ContextCallback callback)
boolean	isRowAvailable() Checks to see if the current row is available.
boolean	isRowModified() Checks to see if the current row is modified.
Object	moveValue(int fromIndex, int toIndex) Modifies value at given index on the editable model.
void	processDecodes(javax.faces.context.FacesContext context)
void	processUpdates(javax.faces.context.FacesContext context)
void	processValidators(javax.faces.context.FacesContext context)
void	queueEvent(javax.faces.event.FacesEvent event) Queues an event.
void	recordValueModified(int index, Object newValue) Records a value modification.
Object	removeValue(int index) Removes value at given index on the editable model.
void	resetCachedModel() Resets the cache model
void	restoreState(javax.faces.context.FacesContext context, Object state)
Object	saveState(javax.faces.context.FacesContext context)
void	setDiff(Boolean diff) Sets boolean stating if diff must be used when saving the value submitted.
void	setModel(String model) Sets model name exposed in request map.
void	setNumber(Integer number)
void	setRemoveEmpty(Boolean removeEmpty)
void	setRendererType(String rendererType)
void	setRowIndex(int rowIndex) Makes a row current.
void	setRowKey(Integer rowKey) Makes a row current.
void	setTemplate(Object template) Sets template to be used when adding new values to the model.
boolean	visitTree(javax.faces.component.visit.VisitContext context, javax.faces.component.visit.VisitCallback callback) Rough adapt of the UI data behaviour.

Methods inherited from class javax.faces.component.UIInput

addValidator, addValueChangeListener, clearInitialState, decode, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, removeValidator, removeValueChangeListener, resetValue, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel, validate

Methods inherited from class javax.faces.component.UIOutput

getConverter, getLocalValue, setConverter

Methods inherited from class javax.faces.component.UIComponentBase

addClientBehavior, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getValueBinding, isRendered, isTransient, processRestoreState, processSaveState, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getClientId, getCompositeComponentParent, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.faces.component.ValueHolder

getConverter, getLocalValue, setConverter

Field Detail

COMPONENT_TYPE

public static final String COMPONENT_TYPE

COMPONENT_FAMILY

public static final String COMPONENT_FAMILY

Constructor Detail

UIEditableList

public UIEditableList()

Method Detail

getFamily

public String getFamily()

Overrides:

getFamily in class javax.faces.component.UIInput

saveState

public Object saveState(javax.faces.context.FacesContext context)

Specified by:

saveState in interface javax.faces.component.StateHolder

Overrides:

saveState in class javax.faces.component.UIInput

getValue

public Object getValue()

Specified by:

getValue in interface javax.faces.component.ValueHolder

Overrides:

getValue in class javax.faces.component.UIInput

restoreState

public void restoreState(javax.faces.context.FacesContext context,
                Object state)

Specified by:

restoreState in interface javax.faces.component.StateHolder

Overrides:

restoreState in class javax.faces.component.UIInput

resetCachedModel

public void resetCachedModel()

Resets the cache model

Can be useful when re-rendering a list with ajax and not wanting to keep cached values already submitted.

Specified by:

resetCachedModel in interface ResettableComponent

Since:

5.3.1

getProtectedModel

public ProtectedEditableModel getProtectedModel(EditableModel model)

getEditableModel

public final EditableModel getEditableModel()

Gets the EditableModel to use with this component.

isRowAvailable

public final boolean isRowAvailable()

Checks to see if the current row is available. This is useful when the total number of rows is not known.

Returns:

true if the current row is available.

See Also:

EditableModel.isRowAvailable()

isRowModified

public final boolean isRowModified()

Checks to see if the current row is modified.

Returns:

true if the current row is modified.

See Also:

EditableModel.isRowModified()

getRowCount

public final int getRowCount()

Gets the total number of rows in this table.

Returns:

-1 if the total number is not known.

See Also:

EditableModel.getRowCount()

getRowIndex

public final int getRowIndex()

Gets the index of the current row.

Returns:

-1 if the current row is unavailable.

See Also:

EditableModel.getRowIndex()

getRowKey

public final Integer getRowKey()

Gets the rowKey of the current row.

Returns:

null if the current row is unavailable.

See Also:

EditableModel.getRowKey()

getRowData

public final Object getRowData()

Gets the data for the current row.

Returns:

null if the current row is unavailable

See Also:

EditableModel.getRowData()

setRowIndex

public void setRowIndex(int rowIndex)

Makes a row current.

This method calls preRowDataChange() and postRowDataChange(java.lang.Object) as appropriate.

Parameters:

rowIndex - The rowIndex of the row that should be made current. Use -1 to clear the current row.

See Also:

EditableModel.setRowIndex(int)

setRowKey

public void setRowKey(Integer rowKey)

Makes a row current.

This method calls preRowDataChange() and postRowDataChange(java.lang.Object) as appropriate.

Parameters:

rowKey - The rowKey of the row that should be made current. Use null to clear the current row.

See Also:

EditableModel.setRowKey(java.lang.Integer)

recordValueModified

public final void recordValueModified(int index,
                       Object newValue)

Records a value modification.

See Also:

EditableModel.recordValueModified(int, java.lang.Object)

addValue

public boolean addValue(Object value)

Adds a value to the end of the editable model.

Parameters:

value - the value to add

Returns:

true if value was added.

insertValue

public void insertValue(int index,
               Object value)

Inserts value at given index on the editable model.

Throws:

IllegalArgumentException - if model does not handle this index.

moveValue

public Object moveValue(int fromIndex,
               int toIndex)

Modifies value at given index on the editable model.

Returns:

the old value at that index.

Throws:

IllegalArgumentException - if model does not handle one of given indexes.

removeValue

public Object removeValue(int index)

Removes value at given index on the editable model.

Returns:

the old value at that index.

Throws:

IllegalArgumentException - if model does not handle this index.

getModel

public String getModel()

Gets model name exposed in request map.

setModel

public void setModel(String model)

Sets model name exposed in request map.

getTemplate

public Object getTemplate()

Gets template to be used when adding new values to the model.

setTemplate

public final void setTemplate(Object template)

Sets template to be used when adding new values to the model.

getDiff

public Boolean getDiff()

Gets boolean stating if diff must be used when saving the value submitted.

setDiff

public void setDiff(Boolean diff)

Sets boolean stating if diff must be used when saving the value submitted.

getNumber

public Integer getNumber()

setNumber

public void setNumber(Integer number)

getRemoveEmpty

public Boolean getRemoveEmpty()

setRemoveEmpty

public void setRemoveEmpty(Boolean removeEmpty)

getContainerClientId

public String getContainerClientId(javax.faces.context.FacesContext context)

Override container client id resolution to handle recursion.

Overrides:

getContainerClientId in class javax.faces.component.UIComponent

getRendererType

public String getRendererType()

Overrides:

getRendererType in class javax.faces.component.UIComponentBase

setRendererType

public void setRendererType(String rendererType)

Overrides:

setRendererType in class javax.faces.component.UIComponentBase

encodeBegin

public final void encodeBegin(javax.faces.context.FacesContext context)
                       throws IOException

Overrides:

encodeBegin in class javax.faces.component.UIComponentBase

Throws:

IOException

encodeEnd

public void encodeEnd(javax.faces.context.FacesContext context)
               throws IOException

Overrides:

encodeEnd in class javax.faces.component.UIComponentBase

Throws:

IOException

getRendersChildren

public boolean getRendersChildren()

Overrides:

getRendersChildren in class javax.faces.component.UIComponentBase

encodeChildren

public void encodeChildren(javax.faces.context.FacesContext context)
                    throws IOException

Repeatedly render the children as many times as needed.

Overrides:

encodeChildren in class javax.faces.component.UIComponentBase

Throws:

IOException

broadcast

public void broadcast(javax.faces.event.FacesEvent event)

Delivers a wrapped event to the appropriate component. If the event is a special wrapped event, it is unwrapped.

Overrides:

broadcast in class javax.faces.component.UIComponentBase

Parameters:

event - a FacesEvent

Throws:

javax.faces.event.AbortProcessingException

queueEvent

public void queueEvent(javax.faces.event.FacesEvent event)

Queues an event. If there is a currency set on this table, then the event will be wrapped so that when it is finally delivered, the correct currency will be restored.

Overrides:

queueEvent in class javax.faces.component.UIComponentBase

Parameters:

event - a FacesEvent

visitTree

public boolean visitTree(javax.faces.component.visit.VisitContext context,
                javax.faces.component.visit.VisitCallback callback)

Rough adapt of the UI data behaviour.

Overrides:

visitTree in class javax.faces.component.UIComponent

processDecodes

public void processDecodes(javax.faces.context.FacesContext context)

Overrides:

processDecodes in class javax.faces.component.UIInput

processValidators

public void processValidators(javax.faces.context.FacesContext context)

Overrides:

processValidators in class javax.faces.component.UIInput

processUpdates

public void processUpdates(javax.faces.context.FacesContext context)

Overrides:

processUpdates in class javax.faces.component.UIInput

invokeOnComponent

public boolean invokeOnComponent(javax.faces.context.FacesContext context,
                        String clientId,
                        javax.faces.component.ContextCallback callback)
                          throws javax.faces.FacesException

Overrides:

invokeOnComponent in class javax.faces.component.UIComponentBase

Throws:

javax.faces.FacesException