com.technia.tvc.core.table

Class AbstractEditableTableBean<T extends TableData>

java.lang.Object

com.technia.tvc.core.util.BasicAttributeSupport

com.technia.tvc.core.table.AbstractTableBean<T>

com.technia.tvc.core.table.AbstractPaginatedTableBean<T>

com.technia.tvc.core.table.AbstractSelectionTableBean<T>

com.technia.tvc.core.table.AbstractEditableTableBean<T>

All Implemented Interfaces:

EnvironmentSupport, com.technia.tvc.core.db.inquiry.InquirySupport, com.technia.tvc.core.db.jpo.JPOSupport, ContextMenuSupport, MenuBarSupport, PageConfigSupport, ViewSupport, EditableTableBean<T>, EntryProcessable, com.technia.tvc.core.table.EvaluatedTableBean<T>, GroupableTableBean<T>, PaginatedTableBean<T>, SelectionTableBean<T>, StructureModifiableTableBean<T>, TableBean<T>, TableBeanProxy, TableDataProvider<T>, AttributeSupport, java.lang.Cloneable

Direct Known Subclasses:

AbstractSortableTableBean

public abstract class AbstractEditableTableBean<T extends TableData>
extends AbstractSelectionTableBean<T>
implements EditableTableBean<T>, StructureModifiableTableBean<T>

This class provides a default implementation for the EditableTableBean interface.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractEditableTableBean.CellUpdaterTableClient This TableClient is used when performing updates to one or more rows, after a cell on the row has been modified.
static class	AbstractEditableTableBean.CommitResultImpl
static class	AbstractEditableTableBean.ConnectResultImpl
static class	AbstractEditableTableBean.DeleteResultImpl
static class	AbstractEditableTableBean.DisconnectResultImpl
static class	AbstractEditableTableBean.ObjectResultImpl
static class	AbstractEditableTableBean.RemoveResultImpl
static class	AbstractEditableTableBean.ReplaceResultImpl
static class	AbstractEditableTableBean.UpdateResultImpl

Nested classes/interfaces inherited from class com.technia.tvc.core.table.AbstractPaginatedTableBean

AbstractPaginatedTableBean.CurrentPageEvaluationParams, AbstractPaginatedTableBean.TablePage

Nested classes/interfaces inherited from class com.technia.tvc.core.table.AbstractTableBean

AbstractTableBean.DefaultNavigationHandler, AbstractTableBean.TableClientImpl, AbstractTableBean.TableDataIterator, AbstractTableBean.ViewListenerProxy

Nested classes/interfaces inherited from interface com.technia.tvc.core.table.StructureModifiableTableBean

StructureModifiableTableBean.CallBack, StructureModifiableTableBean.CommitResult, StructureModifiableTableBean.CommitResults, StructureModifiableTableBean.ConnectResult, StructureModifiableTableBean.ConnectSpec, StructureModifiableTableBean.DeleteResult, StructureModifiableTableBean.DisconnectResult, StructureModifiableTableBean.ReplaceResult, StructureModifiableTableBean.ReplaceSpec, StructureModifiableTableBean.UpdateResult

Nested classes/interfaces inherited from interface com.technia.tvc.core.table.TableDataProvider

TableDataProvider.Displayed<T extends TableData>, TableDataProvider.Empty<T extends TableData>, TableDataProvider.Specific<T extends TableData>, TableDataProvider.Visible<T extends TableData>

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	editable Holds whether the table is editable or not.
protected boolean	editSupported Holds whether the implmentation supports editing or not.
protected boolean	structureModificationSupported Holds whether the implementation supports structure editing or not

Fields inherited from class com.technia.tvc.core.table.AbstractTableBean

DEFAULT_VISIBLE_TABLE_DATA_FILTER, EVALUATION_REQUIRED_TABLE_DATA_FILTER, SELECTED_TABLE_DATA_FILTER

Fields inherited from interface com.technia.tvc.core.table.TableDataProvider

EMPTY

Constructor Summary

Constructors

Constructor and Description
AbstractEditableTableBean()

Method Summary

Modifier and Type	Method and Description
void	addTableEditListenerListener(TableEditListener listener) Adds a TableEditListener to the table.
protected void	afterConnect(StructureModifiableTableBean.ConnectResult result)
protected void	afterDisconnect(AbstractEditableTableBean.DisconnectResultImpl result)
protected void	afterEdit(TableData[] data, Cell[] cells, java.lang.String value, Environment env)
protected void	afterEdit(TableData data, CellValue value, Environment env)
StructureModifiableTableBean.ConnectResult	connect(StructureModifiableTableBean.ConnectSpec spec) This method performs the creation of a connection, typically between two objects but might be done between a connection and an object or between two connections.
protected AbstractEditableTableBean.ConnectResultImpl	createConnectResult(StructureModifiableTableBean.ConnectSpec spec)
protected AbstractEditableTableBean.DisconnectResultImpl	createDisconnectResult()
protected AbstractEditableTableBean.ReplaceResultImpl	createReplaceResult(StructureModifiableTableBean.ReplaceSpec spec)
StructureModifiableTableBean.DisconnectResult	disconnect(java.lang.String[] connectionIds) This method performs a disconnect of a connection with the specified ID.
void	editCell(TableData data, Cell cell, int valueIndex, java.lang.String value, Environment env) This method performs the actual editing of a cell.
void	editCells(TableData[] data, Cell[] cells, java.lang.String value, Environment env) Edit the cells of the specified column for the specified data instances.
protected void	fireWasEditedEvent(TableData[] data, Cell[] cells, java.lang.String value, Environment env)
protected void	fireWasEditedEvent(TableData data, CellValue value, java.lang.String newValue, Environment env) Fires a after edit event.
protected boolean	getReuseCellsForEditEvaluation()
java.util.Iterator<TableEditListener>	getTableEditListeners()
boolean	isEditable() Returns a boolean value indicating whether the table is editable or not.
boolean	isEditSupported() Returns a boolean value indicating whether the implementation supports editing.
boolean	isStructureModificationSupported() Returns whether or not this implementation supports structure edit
protected void	onClone(TableBean<T> c) Create a deep copy of this object.
protected void	onNavigate(TableBean<? extends TableData> structure, java.lang.String objectId) Initialize the StructureBean when navigating.
protected StructureModifiableTableBean.ConnectResult	performConnect(StructureModifiableTableBean.ConnectSpec spec)
protected StructureModifiableTableBean.DisconnectResult	performDisconnect(java.lang.String[] connectionIds)
protected StructureModifiableTableBean.ReplaceResult	performReplace(StructureModifiableTableBean.ReplaceSpec spec)
void	removeTableEditListener(TableEditListener listener) Removes the TableEditListener from the table.
StructureModifiableTableBean.ReplaceResult	replace(StructureModifiableTableBean.ReplaceSpec spec) This method performs a replace of an object on a connection
void	setEditable(boolean editable) Sets whether the table should be editable or not.
protected void	setEditSupported(boolean editSupported) Sets whether the implementation supports editing or not.
protected void	setStructureModificationSupported(boolean structureModificationSupported) Sets whether the implementation supports structure editing or not.
protected void	validate(StructureModifiableTableBean.ReplaceSpec spec)
protected void	validateSpec(StructureModifiableTableBean.ConnectSpec spec)

Methods inherited from class com.technia.tvc.core.table.AbstractSelectionTableBean

addSelectionListener, createDefaultSelectionModel, getSelectionModel, removeSelectionListener, selectableChanged, selectionChanged, setSelectionModel

Methods inherited from class com.technia.tvc.core.table.AbstractPaginatedTableBean

addPaginationChangeListener, asNonPaginatedTable, evaluateColumns, firePaginationChanged, getCurrentPage, getDisplayedTableData, getPageCount, getPageTableData, getPageTableDataRange, getPaginationThreshold, getUnpaginatedTableData, getUnpaginatedTableDataCount, isOnlyEvaluateCurrentPage, isPaginated, isPaginationForced, isPaginationSupported, isProxyInvokation, isValid, removePaginationChangeListener, setCurrentPage, setOnlyEvaluateCurrentPage, setPageTableDataRange, setPaginated, setPaginationSupported, setPaginationThreshold, validate

Methods inherited from class com.technia.tvc.core.table.AbstractTableBean

accept, addEntryProcessor, addTableClonedListener, addTableContentListener, addTableGroupedListener, addTableListener, addTableNavigateListener, addVisibleTableDataFilter, clearEntryProcessor, clearRows, clearRowsBeforeEvaluation, clearVisibleTableDataFilter, clone, createEvaluationChain, createNavigationHandler, createNavigationHandler, createTableClient, createTableHeaders, ensureTable, ensureView, evaluate, evaluateColumns, fireColumnsUpdatedEvent, fireDidNavigateEvent, fireTableChangedEvent, fireTableContentAdded, fireTableContentCleared, fireTableContentRemoved, fireTableEvaluatedEvent, fireTableInvalidatedEvent, fireTableSortedEvent, fireViewChangedEvent, fireVisualsChangedEvent, fireWasClonedEvent, fireWasGroupedEvent, getCalculations, getCellAt, getChoosableViews, getColumnAt, getColumnByName, getColumnCount, getColumnIndex, getColumnList, getColumns, getContextMenu, getDisplayedTableDataCount, getEntryProcessor, getEntryProcessors, getEnv, getEnv, getEvaluationChain, getEvaluationRequiredTableData, getEvaluationRequiredTableDataCount, getFilteredTableData, getFilteredTableDataCount, getHasParent, getHeader, getLocaleForHeaders, getMenuBar, getMode, getNavigationHandler, getNavigationHandler, getObjectIdForHeaders, getPageConfig, getParent, getSelectedTableData, getSelectedTableDataCount, getSubHeader, getTableClonedListeners, getTableContentListeners, getTableData, getTableData, getTableDataAt, getTableDataCount, getTableDataWithId, getTableGroupedListeners, getTableListeners, getTableNavigateListeners, getView, getViewFactory, getVisibleColumnAt, getVisibleColumnByName, getVisibleColumnCount, getVisibleColumns, getVisibleTableData, getVisibleTableDataCount, getVisibleTableDataFilters, getVisibleTableDataFilters, group, hasCellAt, hasEvaluationForcedColumns, hasTableData, hasVisibleTableDataFilter, invalidate, invalidateTableData, isColumnsLoaded, isEvaluateReadOnly, isEvaluationForcedFor, isEvaluationRequired, isHeaderHTML, isNavigateSupported, isOnlyEvaluateVisibleColumns, isSubHeaderHTML, isTableChangeable, isViewChangeable, isVisible, isVisibleColumn, isVisibleColumnImpl, isVisualsChangeable, loadFromInquiry, loadFromJPO, navigate, navigate, onColumnsUpdated, onGroup, onTableChanged, onTableEvaluated, onTableInvalidated, onTableSorted, onViewChanged, onVisualsChanged, paramString, reload, removeEntryProcessor, removeParent, removeTableClonedListener, removeTableContentListener, removeTableData, removeTableData, removeTableGroupedListener, removeTableListener, removeTableNavigateListener, removeVisibleTableDataFilter, removeVisibleTableDataFilters, setChoosableViews, setContextMenu, setEntryProcessor, setEntryProcessors, setEnv, setEvaluateReadOnly, setHeader, setHeader, setMenuBar, setNavigateSupported, setOnlyEvaluateVisibleColumns, setPageConfig, setParent, setSubHeader, setSubHeader, setTableChangeable, setView, setView, setViewChangeable, setViewFactory, setVisualsChangeable, toString

Methods inherited from class com.technia.tvc.core.util.BasicAttributeSupport

getAttribute, getAttributeMap, getAttributeNames, removeAttribute, setAttribute

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.technia.tvc.core.table.TableBean

accept, addTableClonedListener, addTableContentListener, addTableGroupedListener, addTableListener, addTableNavigateListener, addVisibleTableDataFilter, clearVisibleTableDataFilter, clone, getCalculations, getCellAt, getColumnAt, getColumnByName, getColumnCount, getColumnIndex, getColumnList, getColumns, getDisplayedTableData, getDisplayedTableDataCount, getEvaluationRequiredTableData, getEvaluationRequiredTableDataCount, getFilteredTableData, getFilteredTableDataCount, getHasParent, getHeader, getNavigationHandler, getNavigationHandler, getParent, getSelectedTableData, getSelectedTableDataCount, getSubHeader, getTableClonedListeners, getTableData, getTableData, getTableData, getTableDataAt, getTableDataCount, getTableDataWithId, getTableGroupedListeners, getTableListeners, getTableNavigateListeners, getVisibleColumnAt, getVisibleColumnByName, getVisibleColumnCount, getVisibleColumns, getVisibleTableData, getVisibleTableDataCount, getVisibleTableDataFilters, getVisibleTableDataFilters, hasCellAt, hasTableData, hasVisibleTableDataFilter, invalidate, isHeaderHTML, isNavigateSupported, isOnlyEvaluateVisibleColumns, isSubHeaderHTML, isValid, isVisible, isVisibleColumn, navigate, navigate, reload, removeParent, removeTableClonedListener, removeTableContentListener, removeTableData, removeTableData, removeTableData, removeTableGroupedListener, removeTableListener, removeTableNavigateListener, removeVisibleTableDataFilter, removeVisibleTableDataFilters, setHeader, setHeader, setOnlyEvaluateVisibleColumns, setParent, setSubHeader, setSubHeader, validate

Methods inherited from interface com.technia.tvc.core.gui.view.ViewSupport

getChoosableViews, getView, getViewFactory, isTableChangeable, isViewChangeable, isVisualsChangeable, setChoosableViews, setView, setView, setViewFactory

Methods inherited from interface com.technia.tvc.core.gui.menubar.MenuBarSupport

getMenuBar, setMenuBar

Methods inherited from interface com.technia.tvc.core.gui.menubar.ContextMenuSupport

getContextMenu, setContextMenu

Methods inherited from interface com.technia.tvc.core.db.inquiry.InquirySupport

isInquirySupported, loadFromInquiry, loadFromInquiry

Methods inherited from interface com.technia.tvc.core.db.jpo.JPOSupport

loadFromJPO, loadFromJPO

Methods inherited from interface com.technia.tvc.core.db.aef.env.EnvironmentSupport

getEnv, getEnv, setEnv

Methods inherited from interface com.technia.tvc.core.util.AttributeSupport

getAttribute, getAttributeNames, removeAttribute, setAttribute

Methods inherited from interface com.technia.tvc.core.gui.page.PageConfigSupport

getPageConfig, setPageConfig

Field Detail

editable

protected boolean editable

Holds whether the table is editable or not.

editSupported

protected boolean editSupported

Holds whether the implmentation supports editing or not.

structureModificationSupported

protected boolean structureModificationSupported

Holds whether the implementation supports structure editing or not

Constructor Detail

AbstractEditableTableBean

public AbstractEditableTableBean()

Method Detail

onClone

protected void onClone(TableBean<T> c)

Description copied from class: AbstractPaginatedTableBean

Create a deep copy of this object.

Overrides:

onClone in class AbstractSelectionTableBean<T extends TableData>

addTableEditListenerListener

public void addTableEditListenerListener(TableEditListener listener)

Adds a TableEditListener to the table.

Specified by:

addTableEditListenerListener in interface EditableTableBean<T extends TableData>

Parameters:

listener - the TableEditListener to add.

removeTableEditListener

public void removeTableEditListener(TableEditListener listener)

Removes the TableEditListener from the table.

Specified by:

removeTableEditListener in interface EditableTableBean<T extends TableData>

Parameters:

listener - the TableEditListener to remove.

getTableEditListeners

public java.util.Iterator<TableEditListener> getTableEditListeners()

Specified by:

getTableEditListeners in interface EditableTableBean<T extends TableData>

Returns:

All table-edit-listeners added

setEditable

public final void setEditable(boolean editable)

Sets whether the table should be editable or not.

Specified by:

setEditable in interface EditableTableBean<T extends TableData>

Parameters:

editable - boolean value indicating whether the table should be editable or not.

isEditable

public final boolean isEditable()

Returns a boolean value indicating whether the table is editable or not.

Specified by:

isEditable in interface EditableTableBean<T extends TableData>

Returns:

true if the table is editable.

isEditSupported

public final boolean isEditSupported()

Returns a boolean value indicating whether the implementation supports editing.

Specified by:

isEditSupported in interface EditableTableBean<T extends TableData>

Returns:

true if the implementation supports editing.

setEditSupported

protected final void setEditSupported(boolean editSupported)

Sets whether the implementation supports editing or not.

Parameters:

editSupported - whether the implementation supports editing or not.

connect

public StructureModifiableTableBean.ConnectResult connect(StructureModifiableTableBean.ConnectSpec spec)
                                                   throws TVCException

Description copied from interface: StructureModifiableTableBean

This method performs the creation of a connection, typically between two objects but might be done between a connection and an object or between two connections.

The implementation will decide what to do based upon the incoming specification.

Specified by:

connect in interface StructureModifiableTableBean<T extends TableData>

Parameters:

spec - The connection specification

Returns:

The result of the operation as a StructureModifiableTableBean.ConnectResult

Throws:

TVCException - If unable to perform the connect operation

validateSpec

protected void validateSpec(StructureModifiableTableBean.ConnectSpec spec)
                     throws java.lang.IllegalArgumentException,
                            TVCException

Throws:

java.lang.IllegalArgumentException

TVCException

performConnect

protected StructureModifiableTableBean.ConnectResult performConnect(StructureModifiableTableBean.ConnectSpec spec)
                                                             throws TVCException

Throws:

TVCException

createConnectResult

protected AbstractEditableTableBean.ConnectResultImpl createConnectResult(StructureModifiableTableBean.ConnectSpec spec)

afterConnect

protected void afterConnect(StructureModifiableTableBean.ConnectResult result)

disconnect

public StructureModifiableTableBean.DisconnectResult disconnect(java.lang.String[] connectionIds)
                                                         throws TVCException

Description copied from interface: StructureModifiableTableBean

This method performs a disconnect of a connection with the specified ID.

Specified by:

disconnect in interface StructureModifiableTableBean<T extends TableData>

Parameters:

connectionIds - The id's of the connection(s) to remove.

Returns:

The result instance

Throws:

TVCException - If unable to perform the disconnect operation

performDisconnect

protected StructureModifiableTableBean.DisconnectResult performDisconnect(java.lang.String[] connectionIds)
                                                                   throws TVCException

Throws:

TVCException

createDisconnectResult

protected AbstractEditableTableBean.DisconnectResultImpl createDisconnectResult()

afterDisconnect

protected void afterDisconnect(AbstractEditableTableBean.DisconnectResultImpl result)

replace

public StructureModifiableTableBean.ReplaceResult replace(StructureModifiableTableBean.ReplaceSpec spec)
                                                   throws TVCException

Description copied from interface: StructureModifiableTableBean

This method performs a replace of an object on a connection

Specified by:

replace in interface StructureModifiableTableBean<T extends TableData>

Parameters:

spec - The specification for the replace operation

Returns:

The result of the replace operation

Throws:

TVCException - If unable to perform the replace operation

validate

protected void validate(StructureModifiableTableBean.ReplaceSpec spec)
                 throws TVCException

Throws:

TVCException

performReplace

protected StructureModifiableTableBean.ReplaceResult performReplace(StructureModifiableTableBean.ReplaceSpec spec)
                                                             throws TVCException

Throws:

TVCException

createReplaceResult

protected AbstractEditableTableBean.ReplaceResultImpl createReplaceResult(StructureModifiableTableBean.ReplaceSpec spec)

isStructureModificationSupported

public boolean isStructureModificationSupported()

Returns whether or not this implementation supports structure edit

Specified by:

isStructureModificationSupported in interface StructureModifiableTableBean<T extends TableData>

Returns:

true if the implementation supports structure modifications.

setStructureModificationSupported

protected final void setStructureModificationSupported(boolean structureModificationSupported)

Sets whether the implementation supports structure editing or not.

Parameters:

structureModificationSupported - whether the implementation supports editing or not.

editCell

public void editCell(TableData data,
                     Cell cell,
                     int valueIndex,
                     java.lang.String value,
                     Environment env)
              throws TVCException

This method performs the actual editing of a cell.

Specified by:

editCell in interface EditableTableBean<T extends TableData>

Parameters:

data - the TableData that *owns* the cell.

cell - the cell to edit.

valueIndex - The index of the value to be edited.

value - the new value.

env - the environment.

Throws:

TVCException - if unable to edit the cell.

fireWasEditedEvent

protected void fireWasEditedEvent(TableData data,
                                  CellValue value,
                                  java.lang.String newValue,
                                  Environment env)
                           throws TVCException

Fires a after edit event.

Throws:

TVCException

Since:

2014.3.0

afterEdit

protected void afterEdit(TableData data,
                         CellValue value,
                         Environment env)
                  throws TVCException

Parameters:

data -

value -

env -

Throws:

TVCException

Since:

2009.1

editCells

public void editCells(TableData[] data,
                      Cell[] cells,
                      java.lang.String value,
                      Environment env)
               throws TVCException

Edit the cells of the specified column for the specified data instances.

Specified by:

editCells in interface EditableTableBean<T extends TableData>

Parameters:

data - the TableData instances that *owns* the cells to be edited.

cells - the cells to edit. The length of this array must match the length of the data array.

value - the new value.

env - the environment.

Throws:

TVCException - if unable to edit the cell.

Since:

4.0

fireWasEditedEvent

protected void fireWasEditedEvent(TableData[] data,
                                  Cell[] cells,
                                  java.lang.String value,
                                  Environment env)
                           throws TVCException

Throws:

TVCException

afterEdit

protected void afterEdit(TableData[] data,
                         Cell[] cells,
                         java.lang.String value,
                         Environment env)
                  throws TVCException

Parameters:

data -

cells -

value -

env -

Throws:

TVCException

Since:

2014.3.0

onNavigate

protected void onNavigate(TableBean<? extends TableData> structure,
                          java.lang.String objectId)
                   throws TVCException

Initialize the StructureBean when navigating.

Overrides:

onNavigate in class AbstractSelectionTableBean<T extends TableData>

Throws:

TVCException

Since:

4.1.0

getReuseCellsForEditEvaluation

protected boolean getReuseCellsForEditEvaluation()

Returns:

Returns whether the evaluator will reuse Cell instances while evaluating the table after an edit operation.

Since:

6.0.0