Module is.codion.framework.model

Package is.codion.framework.model

Class AbstractEntityTableModel<E extends EntityEditModel>

java.lang.Object

is.codion.framework.model.AbstractEntityTableModel<E>

Type Parameters:

E - the EntityEditModel type

All Implemented Interfaces:

FilterModel<Entity>, EntityTableModel<E>

Direct Known Subclasses:

SwingEntityTableModel

public abstract class AbstractEntityTableModel<E extends EntityEditModel>
extends Object
implements EntityTableModel<E>

An abstract EntityTableModel implementation

Nested Class Summary

Nested classes/interfaces inherited from interface is.codion.framework.model.EntityTableModel

EntityTableModel.OnInsert

Nested classes/interfaces inherited from interface is.codion.common.model.FilterModel

FilterModel.AbstractRefresher<T>, FilterModel.FilteredItems<T>, FilterModel.Items<T>, FilterModel.Refresher<T>, FilterModel.VisibleItems<T>

Field Summary

Fields inherited from interface is.codion.framework.model.EntityTableModel

HANDLE_EDIT_EVENTS, ON_INSERT

Fields inherited from interface is.codion.common.model.FilterModel

ASYNC_REFRESH

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractEntityTableModel(E editModel, FilterModel<Entity> filterModel)
protected	AbstractEntityTableModel(E editModel, FilterModel<Entity> filterModel, EntityQueryModel queryModel)

Method Summary

Modifier and Type	Method	Description
final EntityConnection	connection()	Do not cache or keep the connection returned by this method in a long living field, since it may become invalid and thereby unusable.
final EntityConnectionProvider	connectionProvider()
final Collection<Entity>	deleteSelected()	Deletes the selected entities
final State	editable()
final <C extends E> C	editModel()
final Entities	entities()
final EntityDefinition	entityDefinition()
final EntityType	entityType()
protected FilterModel<Entity>	filterModel()
final State	handleEditEvents()
final FilterModel.Items<Entity>	items()
final Value<EntityTableModel.OnInsert>	onInsert()
protected abstract void	onRowsUpdated(int fromIndex, int toIndex)	Notifies all listeners that the given rows have changed
final EntityQueryModel	queryModel()
final void	refresh()	Refreshes the items in this model using its FilterModel.Refresher.
final void	refresh(Collection<Entity.Key> keys)	Refreshes the entities with the given keys by re-selecting them from the underlying database.
final void	refresh(Consumer<Collection<Entity>> onRefresh)	Refreshes the data in this filter model using its FilterModel.Refresher.
final FilterModel.Refresher<Entity>	refresher()
final State	removeDeleted()
final void	replace(ForeignKey foreignKey, Collection<Entity> foreignKeyValues)	For every entity in this table model, replaces the foreign key instance bearing the primary key with the corresponding entity from foreignKeyValues, useful when attribute values have been changed in the referenced entity that must be reflected in the table model.
final void	replace(Collection<Entity> entities)	Replaces the given entities in this table model
final void	select(Collection<Entity.Key> keys)	Selects entities according to the primary keys in primaryKeys
final String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface is.codion.framework.model.EntityTableModel

selection

Constructor Details

AbstractEntityTableModel

protected AbstractEntityTableModel(E editModel,
 FilterModel<Entity> filterModel)

Parameters:

editModel - the edit model

filterModel - the filter model

AbstractEntityTableModel

protected AbstractEntityTableModel(E editModel,
 FilterModel<Entity> filterModel,
 EntityQueryModel queryModel)

Parameters:

editModel - the edit model

filterModel - the filter model

queryModel - the table query model

Throws:

IllegalArgumentException - in case the edit and query model entity types do not match

Method Details

entities

public final Entities entities()

Specified by:

entities in interface EntityTableModel<E extends EntityEditModel>

Returns:

the underlying domain entities

entityDefinition

public final EntityDefinition entityDefinition()

Specified by:

entityDefinition in interface EntityTableModel<E extends EntityEditModel>

Returns:

the definition of the underlying entity

toString

public final String toString()

Overrides:

toString in class Object

onInsert

public final Value<EntityTableModel.OnInsert> onInsert()

Specified by:

onInsert in interface EntityTableModel<E extends EntityEditModel>

Returns:

the Value controlling the action to perform when entities are inserted via the associated edit model

See Also:

• EntityTableModel.ON_INSERT

removeDeleted

public final State removeDeleted()

Specified by:

removeDeleted in interface EntityTableModel<E extends EntityEditModel>

Returns:

the State controlling whether entities that are deleted via the associated edit model should be automatically removed from this table model

handleEditEvents

public final State handleEditEvents()

Specified by:

handleEditEvents in interface EntityTableModel<E extends EntityEditModel>

Returns:

the State controlling whether this table model handles entity edit events, by replacing updated entities

See Also:

• EntityEditEvents

entityType

public final EntityType entityType()

Specified by:

entityType in interface EntityTableModel<E extends EntityEditModel>

Returns:

the type of the entity this table model is based on

editModel

public final <C extends E> C editModel()

Specified by:

editModel in interface EntityTableModel<E extends EntityEditModel>

Type Parameters:

C - the edit model type Returns the EntityEditModel associated with this table model

Returns:

the edit model associated with this table model

connectionProvider

public final EntityConnectionProvider connectionProvider()

Specified by:

connectionProvider in interface EntityTableModel<E extends EntityEditModel>

Returns:

the connection provider used by this table model

connection

public final EntityConnection connection()

Description copied from interface: EntityTableModel

Do not cache or keep the connection returned by this method in a long living field, since it may become invalid and thereby unusable.

Specified by:

connection in interface EntityTableModel<E extends EntityEditModel>

Returns:

the connection used by this table model

queryModel

public final EntityQueryModel queryModel()

Specified by:

queryModel in interface EntityTableModel<E extends EntityEditModel>

Returns:

the underlying query model

editable

public final State editable()

Specified by:

editable in interface EntityTableModel<E extends EntityEditModel>

Returns:

the State controlling whether this table model is editable

replace

public final void replace(Collection<Entity> entities)

Description copied from interface: EntityTableModel

Replaces the given entities in this table model

Specified by:

replace in interface EntityTableModel<E extends EntityEditModel>

Parameters:

entities - the entities to replace

refresh

public final void refresh(Collection<Entity.Key> keys)

Description copied from interface: EntityTableModel

Refreshes the entities with the given keys by re-selecting them from the underlying database.

Specified by:

refresh in interface EntityTableModel<E extends EntityEditModel>

Parameters:

keys - the keys of the entities to refresh

select

public final void select(Collection<Entity.Key> keys)

Description copied from interface: EntityTableModel

Selects entities according to the primary keys in primaryKeys

Specified by:

select in interface EntityTableModel<E extends EntityEditModel>

Parameters:

keys - the primary keys of the entities to select

deleteSelected

public final Collection<Entity> deleteSelected()
                                        throws DatabaseException

Description copied from interface: EntityTableModel

Deletes the selected entities

Specified by:

deleteSelected in interface EntityTableModel<E extends EntityEditModel>

Returns:

the deleted entities

Throws:

DatabaseException - in case of a database exception

items

public final FilterModel.Items<Entity> items()

Specified by:

items in interface FilterModel<E extends EntityEditModel>

Returns:

the model items

refresher

public final FilterModel.Refresher<Entity> refresher()

Specified by:

refresher in interface FilterModel<E extends EntityEditModel>

Returns:

this models Refresher instance

refresh

public final void refresh()

Description copied from interface: FilterModel

Refreshes the items in this model using its FilterModel.Refresher.

Specified by:

refresh in interface FilterModel<E extends EntityEditModel>

See Also:

• FilterModel.refresh()

refresh

public final void refresh(Consumer<Collection<Entity>> onRefresh)

Description copied from interface: FilterModel

Refreshes the data in this filter model using its FilterModel.Refresher. Note that this method only throws exceptions when run synchronously off the user interface thread. Use FilterModel.Refresher.failure() to listen for exceptions that happen during asynchronous refresh.

Specified by:

refresh in interface FilterModel<E extends EntityEditModel>

Parameters:

onRefresh - called after a successful refresh, may be null

See Also:

• FilterModel.Refresher.observer()
• FilterModel.Refresher.success()
• FilterModel.Refresher.failure()
• FilterModel.Refresher.async()

replace

public final void replace(ForeignKey foreignKey,
 Collection<Entity> foreignKeyValues)

Description copied from interface: EntityTableModel

For every entity in this table model, replaces the foreign key instance bearing the primary key with the corresponding entity from foreignKeyValues, useful when attribute values have been changed in the referenced entity that must be reflected in the table model.

Specified by:

replace in interface EntityTableModel<E extends EntityEditModel>

Parameters:

foreignKey - the foreign key

foreignKeyValues - the foreign key entities

filterModel

protected FilterModel<Entity> filterModel()

Returns:

the underlying filter model

onRowsUpdated

protected abstract void onRowsUpdated(int fromIndex,
 int toIndex)

Notifies all listeners that the given rows have changed

Parameters:

fromIndex - the from index

toIndex - the to index