Module is.codion.framework.model

Package is.codion.framework.model

Class AbstractEntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

java.lang.Object

is.codion.framework.model.AbstractEntityTableModel<M,E,T,R>

Type Parameters:

M - the EntityModel type

E - the EntityEditModel type

T - the EntityTableModel type

R - the EntityEditor type

All Implemented Interfaces:

FilterModel<Entity>, EntityTableModel<M,E,T,R>

Direct Known Subclasses:

SwingEntityTableModel

public abstract class AbstractEntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>
extends Object
implements EntityTableModel<M,E,T,R>

An abstract EntityTableModel implementation

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	AbstractEntityTableModel.AbstractEntityTableEditor	An abstract EntityTableModel.EntityTableEditor implementation.

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

EntityTableModel.EntityTableEditor, EntityTableModel.OnInsert, EntityTableModel.RefreshTask

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

FilterModel.AbstractRefresher<T>, FilterModel.FilteredItems<T>, FilterModel.IncludedItems<T>, FilterModel.IncludePredicate<T>, FilterModel.Items<T>, FilterModel.Refresher<T>, FilterModel.Sort<T>

Field Summary

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

ON_INSERT, ORDER_QUERY

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

ASYNC

Constructor Summary

Constructors

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

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 E	editModel()	Returns the EntityEditModel associated with this table model
final Entities	entities()
final EntityDefinition	entityDefinition()
final EntityType	entityType()
protected FilterModel<Entity>	filterModel()
final Value<EntityTableModel.OnInsert>	onInsert()
protected abstract void	onRowsUpdated(int fromIndex, int toIndex)	Notifies all listeners that the given rows have changed
protected abstract Optional<OrderBy>	orderBy()
final State	orderQuery()	Specifies whether the current FilterModel.sort() order is used as a basis for the EntityQueryModel order by clause.
final EntityQueryModel	query()
final EntityTableModel.RefreshTask	refreshTask(Collection<Entity.Key> keys)
final State	removeDeleted()
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()
protected void	updated(ForeignKey foreignKey, Map<Entity.Key,Entity> entities)	Called when entities of the type referenced by the given foreign key are updated

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

editor, refresh, selection

Methods inherited from interface is.codion.common.model.filter.FilterModel

items, sort

Constructor Details

AbstractEntityTableModel

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

Parameters:

editModel - the edit model

filterModel - the filter model

AbstractEntityTableModel

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

Parameters:

editModel - the edit model

queryModel - the table query model

filterModel - the filter 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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the underlying domain entities

entityDefinition

public final EntityDefinition entityDefinition()

Specified by:

entityDefinition in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

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

entityType

public final EntityType entityType()

Specified by:

entityType in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the type of the entity this table model is based on

editModel

public final E editModel()

Description copied from interface: EntityTableModel

Returns the EntityEditModel associated with this table model

Specified by:

editModel in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the edit model associated with this table model

connectionProvider

public final EntityConnectionProvider connectionProvider()

Specified by:

connectionProvider in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the connection used by this table model

orderQuery

public final State orderQuery()

Description copied from interface: EntityTableModel

Specifies whether the current FilterModel.sort() order is used as a basis for the EntityQueryModel order by clause. Note that this only applies to column attributes.

Specified by:

orderQuery in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the State controlling whether the current sort order should be used as a basis for the query order by clause

query

public final EntityQueryModel query()

Specified by:

query in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the underlying query model

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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Parameters:

entities - the entities to replace

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<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Parameters:

keys - the primary keys of the entities to select

deleteSelected

public final Collection<Entity> deleteSelected()

Description copied from interface: EntityTableModel

Deletes the selected entities

Specified by:

deleteSelected in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Returns:

the deleted entities

refreshTask

public final EntityTableModel.RefreshTask refreshTask(Collection<Entity.Key> keys)

Specified by:

refreshTask in interface EntityTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>,T extends EntityTableModel<M,E,T,R>,R extends EntityEditor<M,E,T,R>>

Parameters:

keys - the keys of the entities to refresh

Returns:

a task for refreshing the given entities

filterModel

protected FilterModel<Entity> filterModel()

Returns:

the underlying 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

orderBy

protected abstract Optional<OrderBy> orderBy()

Returns:

a OrderBy instance based on the sort order according to the FilterModel.sort() model, an empty Optional if unsorted

updated

protected void updated(ForeignKey foreignKey,
 Map<Entity.Key,Entity> entities)

Called when entities of the type referenced by the given foreign key are updated

Parameters:

foreignKey - the foreign key

entities - the updated entities, mapped to their original primary key