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<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:

FilterTableModel<Entity,Attribute<?>>, 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<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.AbstractEntityRowEditor<R extends EntityEditor<R>>	An abstract EntityTableModel.EntityRowEditor implementation.

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

EntityTableModel.EntityRowEditor, EntityTableModel.OnInsert

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>

Nested classes/interfaces inherited from interface is.codion.common.model.component.table.FilterTableModel

FilterTableModel.Builder<R,C>, FilterTableModel.ColumnValues<C>, FilterTableModel.Export<C>, FilterTableModel.TableColumns<R,C>

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, FilterTableModel<Entity,Attribute<?>> filterModel)
protected	AbstractEntityTableModel(E editModel, EntityQueryModel queryModel, FilterTableModel<Entity,Attribute<?>> filterModel)

Method Summary

Modifier and Type	Method	Description
final FilterTableModel.TableColumns<Entity,Attribute<?>>	columns()
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 E	editModel()	Returns the EntityEditModel associated with this table model
final R	editor()	Returns the EntityEditor associated with this table model
final Entities	entities()
final EntityDefinition	entityDefinition()
final EntityType	entityType()
final FilterTableModel.Export<Attribute<?>>	export()
protected static Supplier<Map<Attribute<?>,ConditionModel<?>>>	filterConditions(EntityDefinition entityDefinition)
protected FilterTableModel<Entity,Attribute<?>>	filterModel()
final TableConditionModel<Attribute<?>>	filters()
final FilterModel.Items<Entity>	items()
protected static Predicate<Entity>	itemValidator(EntityType entityType)
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 FilterTableModel.sort() order is used as a basis for the EntityQueryModel order by clause.
final EntityQueryModel	query()
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 FilterTableSort<Entity,Attribute<?>>	sort()
protected static FilterTableModel.TableColumns<Entity,Attribute<?>>	tableColumns(EntityDefinition entityDefinition)
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
final FilterTableModel.ColumnValues<Attribute<?>>	values()	Provides access to column values

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

refresh, rowEditor

Methods inherited from interface is.codion.common.model.component.table.FilterTableModel

selection

Constructor Details

AbstractEntityTableModel

protected AbstractEntityTableModel(E editModel,
 FilterTableModel<Entity,Attribute<?>> filterModel)

Parameters:

editModel - the edit model

filterModel - the filter model

AbstractEntityTableModel

protected AbstractEntityTableModel(E editModel,
 EntityQueryModel queryModel,
 FilterTableModel<Entity,Attribute<?>> 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<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<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<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<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<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<R>>

Returns:

the edit model associated with this table model

editor

public final R editor()

Description copied from interface: EntityTableModel

Returns the EntityEditor associated with this table model

Specified by:

editor 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<R>>

Returns:

the editor 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<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<R>>

Returns:

the connection used by this table model

orderQuery

public final State orderQuery()

Description copied from interface: EntityTableModel

Specifies whether the current FilterTableModel.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<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<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<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<R>>

Parameters:

keys - the primary keys of the entities to select

items

public final FilterModel.Items<Entity> items()

Specified by:

items in interface FilterModel<M extends EntityModel<M,E,T,R>>

Returns:

the model items

values

public final FilterTableModel.ColumnValues<Attribute<?>> values()

Description copied from interface: FilterTableModel

Provides access to column values

Specified by:

values in interface FilterTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>>

Returns:

the FilterTableModel.ColumnValues

columns

public final FilterTableModel.TableColumns<Entity,Attribute<?>> columns()

Specified by:

columns in interface FilterTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>>

Returns:

the table columns

filters

public final TableConditionModel<Attribute<?>> filters()

Specified by:

filters in interface FilterTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>>

Returns:

the TableConditionModel used to filter this table model

sort

public final FilterTableSort<Entity,Attribute<?>> sort()

Specified by:

sort in interface FilterModel<M extends EntityModel<M,E,T,R>>

Specified by:

sort in interface FilterTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>>

Returns:

the sort

export

public final FilterTableModel.Export<Attribute<?>> export()

Specified by:

export in interface FilterTableModel<M extends EntityModel<M,E,T,R>,E extends EntityEditModel<M,E,T,R>>

Returns:

a FilterTableModel.Export instance for exporting the table model data

filterModel

protected FilterTableModel<Entity,Attribute<?>> filterModel()

Returns:

the underlying model

tableColumns

protected static FilterTableModel.TableColumns<Entity,Attribute<?>> tableColumns(EntityDefinition entityDefinition)

Parameters:

entityDefinition - the entity definition

Returns:

FilterTableModel.TableColumns based on the visible attributes of the given entity definition

filterConditions

protected static Supplier<Map<Attribute<?>,ConditionModel<?>>> filterConditions(EntityDefinition entityDefinition)

Parameters:

entityDefinition - the entity definition

Returns:

a Supplier providing the filter condition models based on the given entity definition

itemValidator

protected static Predicate<Entity> itemValidator(EntityType entityType)

Parameters:

entityType - the entity type

Returns:

a Predicate validating that items are of the given entity type

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