Module is.codion.framework.model
Package is.codion.framework.model

Interface EntityEditModel

All Known Implementing Classes:
AbstractEntityEditModel
public interface EntityEditModel
Specifies a class for editing Entity instances.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    EntityEditModel.Delete
    Represents a task for deleting entities.
    static interface 
    EntityEditModel.Insert
    Represents a task for inserting entities, split up for use with a background thread.
    static interface 
    EntityEditModel.Update
    Represents a task for updating entities.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final is.codion.common.property.PropertyValue<Boolean>
    EDIT_EVENTS
    Specifies whether edit models post their insert, update and delete events to EntityEditEvents
    Value type: Boolean
    Default value: true
    static final is.codion.common.property.PropertyValue<Boolean>
    PERSIST_FOREIGN_KEYS
    Specifies whether writable foreign key values should persist when the model is cleared or set to null
    Value type: Boolean
    Default value: true
    static final is.codion.common.property.PropertyValue<Boolean>
    WARN_ABOUT_UNSAVED_DATA
    Indicates whether the application should ask for confirmation when exiting if some data is unsaved
    and whether it should warn when unsaved data is about to be lost, i.e.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
    Adds the given entities to all foreign key models based on that entity type
    void
    addAfterDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addAfterInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addAfterUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addBeforeDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addBeforeInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addBeforeUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
     
    void
    addConfirmOverwriteListener(Consumer<is.codion.common.state.State> listener)
     
    <T> void
    addEditListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
    Adds a listener notified each time the value associated with the given attribute is edited via put(Attribute, Object) or remove(Attribute), note that this event is only fired if the value actually changes.
    void
    addEntityListener(Consumer<is.codion.framework.domain.entity.Entity> listener)
    Notified each time the entity is set via set(Entity) or setDefaults().
    void
    addInsertUpdateOrDeleteListener(Runnable listener)
     
    void
    addValueChangeListener(Consumer<is.codion.framework.domain.entity.attribute.Attribute<?>> listener)
     
    <T> void
    addValueListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
    Adds a listener notified each time the value associated with the given attribute changes, either via editing or when the active entity is set.
    is.codion.framework.db.EntityConnectionProvider
    connectionProvider()
     
    EntityEditModel.Delete
    createDelete()
    Creates a new EntityEditModel.Delete instance for deleting the active entity.
    EntityEditModel.Delete
    createDelete(Collection<is.codion.framework.domain.entity.Entity> entities)
    Creates a new EntityEditModel.Delete instance for deleting the given entities.
    EntitySearchModel
    createForeignKeySearchModel(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
    Creates a EntitySearchModel for looking up entities referenced by the given foreign key, using the search attributes defined for that entity type.
    EntityEditModel.Insert
    createInsert()
    Creates a new EntityEditModel.Insert instance for inserting the active entity.
    EntityEditModel.Insert
    createInsert(Collection<is.codion.framework.domain.entity.Entity> entities)
    Creates a new EntityEditModel.Insert instance for inserting the given entities.
    EntityEditModel.Update
    createUpdate()
    Creates a new EntityEditModel.Update instance for updating the active entity.
    EntityEditModel.Update
    createUpdate(Collection<is.codion.framework.domain.entity.Entity> entities)
    Creates a new EntityEditModel.Update instance for updating the given entities.
    void
    delete()
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    void
    delete(Collection<is.codion.framework.domain.entity.Entity> entities)
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    is.codion.common.state.State
    deleteEnabled()
    Disabling delete causes an exception being thrown when deleting.
    is.codion.common.state.State
    editEvents()
     
    is.codion.framework.domain.entity.Entities
    entities()
     
    is.codion.framework.domain.entity.Entity
    entity()
     
    is.codion.framework.domain.entity.EntityDefinition
    entityDefinition()
     
    is.codion.framework.domain.entity.EntityType
    entityType()
     
    is.codion.common.state.StateObserver
    exists()
     
    EntitySearchModel
    foreignKeySearchModel(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
     
    <T> T
    get(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
    Returns the value associated with the given attribute
    is.codion.framework.domain.entity.Entity
    insert()
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    Collection<is.codion.framework.domain.entity.Entity>
    insert(Collection<is.codion.framework.domain.entity.Entity> entities)
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    is.codion.common.state.State
    insertEnabled()
    Disabling insert causes an exception being thrown when inserting.
    is.codion.common.state.StateObserver
    isNotNull(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
     
    is.codion.common.state.StateObserver
    isNull(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
     
    is.codion.common.state.StateObserver
    modified()
    Returns a StateObserver indicating when and if any values in the underlying Entity have been modified.
    is.codion.common.state.StateObserver
    modified(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
    Returns a StateObserver instance indicating whether the value of the given attribute has been modified.
    boolean
    nullable(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
     
    <T> Optional<T>
    optional(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
    Returns the value associated with the given attribute
    is.codion.common.state.State
    overwriteWarning()
     
    is.codion.common.state.State
    persist(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
    Returns a State controlling whether the last used value for this attribute should persist when the model is cleared.
    is.codion.common.state.StateObserver
    primaryKeyNull()
     
    <T> T
    put(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, T value)
    Sets the given value in the underlying Entity
    is.codion.common.state.State
    readOnly()
    Making this edit model read-only prevents any changes from being persisted to the database, trying to insert, update or delete will cause an exception being thrown, it does not prevent editing.
    is.codion.framework.domain.entity.Entity
    referencedEntity(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
    Returns the value associated with the given foreign key.
    void
    refreshEntity()
    Refreshes the active Entity from the database, discarding all changes.
    <T> T
    remove(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
    Removes the given value from the underlying Entity
    void
    remove(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
    Removes the given entities from all foreign key models based on that entity type and clears any foreign key values referencing them.
    void
    removeAfterDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeAfterInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeAfterUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeBeforeDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeBeforeInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeBeforeUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
    Removes the given listener.
    void
    removeConfirmOverwriteListener(Consumer<is.codion.common.state.State> listener)
    Removes the given listener.
    <T> void
    removeEditListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
    Removes the given listener.
    void
    removeEntityListener(Consumer<is.codion.framework.domain.entity.Entity> listener)
    Removes the given listener.
    void
    removeInsertUpdateOrDeleteListener(Runnable listener)
    Removes the given listener.
    void
    removeValueChangeListener(Consumer<is.codion.framework.domain.entity.attribute.Attribute<?>> listener)
     
    <T> void
    removeValueListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
    Removes the given listener.
    void
    replace(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
    For every field referencing the given foreign key values, replaces that foreign key instance with the corresponding entity from entities, useful when attribute values have been changed in the referenced entity that must be reflected in the edit model.
    void
    set(is.codion.framework.domain.entity.Entity entity)
    Copies the values from the given Entity into the underlying Entity being edited by this edit model.
    <T> void
    setDefault(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Supplier<T> defaultValue)
    Sets the default value supplier for the given attribute.
    void
    setDefaults()
    Populates this edit model with default values.
    is.codion.framework.domain.entity.Entity
    update()
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    Collection<is.codion.framework.domain.entity.Entity>
    update(Collection<is.codion.framework.domain.entity.Entity> entities)
    Note: This method must be called on the UI thread in case a panel has been based on this model.
    is.codion.common.state.State
    updateEnabled()
    Disabling update causes an exception being thrown when updating.
    is.codion.common.state.State
    updateMultipleEnabled()
    Disabling updating multiple entities causes an exception being thrown when trying to update multiple entities at a time.
    is.codion.common.state.StateObserver
    valid()
     
    is.codion.common.state.StateObserver
    valid(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
     
    void
    validate()
    Validates the current state of the entity
    void
    validate(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
    Validates the value associated with the given attribute, using the underlying validator.
    void
    validate(is.codion.framework.domain.entity.Entity entity)
    Validates the given entity, using the underlying validator.
    void
    validate(Collection<is.codion.framework.domain.entity.Entity> entities)
    Validates the given entities, using the underlying validator.
    <T> is.codion.common.value.Value<T>
    value(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
    Returns a Value based on attribute in this edit model, note that subsequent calls for the same attribute return the same value instance.

  • Field Details

    • PERSIST_FOREIGN_KEYS

      static final is.codion.common.property.PropertyValue<Boolean> PERSIST_FOREIGN_KEYS
      Specifies whether writable foreign key values should persist when the model is cleared or set to null
      Value type: Boolean
      Default value: true

    • WARN_ABOUT_UNSAVED_DATA

      static final is.codion.common.property.PropertyValue<Boolean> WARN_ABOUT_UNSAVED_DATA
      Indicates whether the application should ask for confirmation when exiting if some data is unsaved
      and whether it should warn when unsaved data is about to be lost, i.e. due to selection changes. Value type: Boolean
      Default value: false

    • EDIT_EVENTS

      static final is.codion.common.property.PropertyValue<Boolean> EDIT_EVENTS
      Specifies whether edit models post their insert, update and delete events to EntityEditEvents
      Value type: Boolean
      Default value: true

  • Method Details

    • entityType

      is.codion.framework.domain.entity.EntityType entityType()
      Returns:
      the type of the entity this edit model is based on

    • connectionProvider

      is.codion.framework.db.EntityConnectionProvider connectionProvider()
      Returns:
      the connection provider used by this edit model

    • setDefaults

      void setDefaults()
      Populates this edit model with default values.
      See Also:

    • set

      void set(is.codion.framework.domain.entity.Entity entity)
      Copies the values from the given Entity into the underlying Entity being edited by this edit model. If entity is null the effect is the same as calling setDefaults().
      Parameters:
      entity - the entity
      See Also:

    • refreshEntity

      void refreshEntity()
      Refreshes the active Entity from the database, discarding all changes. If the active Entity is new then calling this method has no effect.

    • entity

      is.codion.framework.domain.entity.Entity entity()
      Returns:
      an immutable version of the Entity instance being edited
      See Also:
      • Entity.immutable()

    • isNull

      is.codion.common.state.StateObserver isNull(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Parameters:
      attribute - the attribute
      Returns:
      a StateObserver indicating whether the value of the given attribute is null

    • isNotNull

      is.codion.common.state.StateObserver isNotNull(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Parameters:
      attribute - the attribute
      Returns:
      a StateObserver indicating whether the value of the given attribute is not null

    • nullable

      boolean nullable(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Parameters:
      attribute - the attribute
      Returns:
      true if this value is allowed to be null in the underlying entity

    • put

      <T> T put(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, T value)
      Sets the given value in the underlying Entity
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute to associate the given value with
      value - the value to associate with the given attribute
      Returns:
      the previous value, if any

    • remove

      <T> T remove(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
      Removes the given value from the underlying Entity
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      Returns:
      the value, if any

    • get

      <T> T get(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
      Returns the value associated with the given attribute
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      Returns:
      the value associated with the given attribute

    • optional

      <T> Optional<T> optional(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
      Returns the value associated with the given attribute
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      Returns:
      the value associated with the given attribute, an empty Optional in case it is null

    • referencedEntity

      is.codion.framework.domain.entity.Entity referencedEntity(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
      Returns the value associated with the given foreign key.
      Parameters:
      foreignKey - the foreign key
      Returns:
      the foreign key value

    • value

      <T> is.codion.common.value.Value<T> value(is.codion.framework.domain.entity.attribute.Attribute<T> attribute)
      Returns a Value based on attribute in this edit model, note that subsequent calls for the same attribute return the same value instance.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      Returns:
      a Value based on the given edit model value

    • entities

      is.codion.framework.domain.entity.Entities entities()
      Returns:
      the underlying domain entities

    • entityDefinition

      is.codion.framework.domain.entity.EntityDefinition entityDefinition()
      Returns:
      the definition of the underlying entity

    • overwriteWarning

      is.codion.common.state.State overwriteWarning()
      Returns:
      a state controlling whether this edit model triggers a warning before overwriting unsaved data
      See Also:

    • readOnly

      is.codion.common.state.State readOnly()
      Making this edit model read-only prevents any changes from being persisted to the database, trying to insert, update or delete will cause an exception being thrown, it does not prevent editing. Use insertEnabled(), updateEnabled() and deleteEnabled() to configure the enabled state of those specific actions.
      Returns:
      the State controlling whether this model is read only

    • insertEnabled

      is.codion.common.state.State insertEnabled()
      Disabling insert causes an exception being thrown when inserting.
      Returns:
      the state controlling whether inserting is enabled via this edit model

    • updateEnabled

      is.codion.common.state.State updateEnabled()
      Disabling update causes an exception being thrown when updating.
      Returns:
      the state controlling whether updating is enabled via this edit model

    • updateMultipleEnabled

      is.codion.common.state.State updateMultipleEnabled()
      Disabling updating multiple entities causes an exception being thrown when trying to update multiple entities at a time.
      Returns:
      the state controlling whether updating multiple entities is enabled

    • deleteEnabled

      is.codion.common.state.State deleteEnabled()
      Disabling delete causes an exception being thrown when deleting.
      Returns:
      the state controlling whether deleting is enabled via this edit model

    • createForeignKeySearchModel

      EntitySearchModel createForeignKeySearchModel(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
      Creates a EntitySearchModel for looking up entities referenced by the given foreign key, using the search attributes defined for that entity type.
      Parameters:
      foreignKey - the foreign key for which to create a EntitySearchModel
      Returns:
      a EntitySearchModel for looking up entities of the type referenced by the given foreign key attribute,
      Throws:
      IllegalStateException - in case no searchable attributes can be found for the entity type referenced by the given foreign key

    • foreignKeySearchModel

      EntitySearchModel foreignKeySearchModel(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey)
      Parameters:
      foreignKey - the foreign key for which to retrieve the EntitySearchModel
      Returns:
      the EntitySearchModel associated with the foreignKey, if no search model has been initialized for the given foreign key, a new one is created, associated with the foreign key and returned.

    • setDefault

      <T> void setDefault(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Supplier<T> defaultValue)
      Sets the default value supplier for the given attribute. Used when the underlying value is not persistent. Use setDefaults() or set(Entity) with a null parameter to populate the model with the default values.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      defaultValue - the default value supplier
      See Also:

    • editEvents

      is.codion.common.state.State editEvents()
      Returns:
      a state controlling whether this edit model posts insert, update and delete events on the EntityEditEvents event bus.
      See Also:

    • persist

      is.codion.common.state.State persist(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Returns a State controlling whether the last used value for this attribute should persist when the model is cleared.
      Parameters:
      attribute - the attribute
      Returns:
      a State controlling whether the given attribute value should persist when the model is cleared
      See Also:

    • insert

      is.codion.framework.domain.entity.Entity insert() throws is.codion.common.db.exception.DatabaseException, is.codion.framework.domain.entity.exception.ValidationException
      Note: This method must be called on the UI thread in case a panel has been based on this model. Performs an insert on the active entity, sets the primary key values of the active entity according to the primary key of the inserted entity
      Returns:
      the inserted entity
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails
      IllegalStateException - in case inserting is not enabled
      See Also:
      • EntityValidator.validate(Entity)

    • insert

      Collection<is.codion.framework.domain.entity.Entity> insert(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.common.db.exception.DatabaseException, is.codion.framework.domain.entity.exception.ValidationException
      Note: This method must be called on the UI thread in case a panel has been based on this model. Performs an insert on the given entities.
      Parameters:
      entities - the entities to insert
      Returns:
      a list containing the inserted entities
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails
      IllegalStateException - in case inserting is not enabled
      See Also:

    • update

      is.codion.framework.domain.entity.Entity update() throws is.codion.common.db.exception.DatabaseException, is.codion.framework.domain.entity.exception.ValidationException
      Note: This method must be called on the UI thread in case a panel has been based on this model. Performs an update on the active entity
      Returns:
      the updated entity
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      is.codion.common.db.exception.RecordModifiedException - in case the entity has been modified since it was loaded
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails
      IllegalStateException - in case updating is not enabled
      is.codion.common.db.exception.UpdateException - in case the active entity is not modified
      See Also:
      • EntityValidator.validate(Entity)

    • update

      Collection<is.codion.framework.domain.entity.Entity> update(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.common.db.exception.DatabaseException, is.codion.framework.domain.entity.exception.ValidationException
      Note: This method must be called on the UI thread in case a panel has been based on this model. Updates the given entities.
      Parameters:
      entities - the entities to update
      Returns:
      the updated entities
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      is.codion.common.db.exception.RecordModifiedException - in case an entity has been modified since it was loaded
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails
      IllegalStateException - in case updating is not enabled
      See Also:

    • delete

      void delete() throws is.codion.common.db.exception.DatabaseException
      Note: This method must be called on the UI thread in case a panel has been based on this model.
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      IllegalStateException - in case deleting is not enabled
      See Also:

    • delete

      void delete(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.common.db.exception.DatabaseException
      Note: This method must be called on the UI thread in case a panel has been based on this model.
      Parameters:
      entities - the entities to delete
      Throws:
      is.codion.common.db.exception.DatabaseException - in case of a database exception
      IllegalStateException - in case deleting is not enabled
      See Also:

    • createInsert

      EntityEditModel.Insert createInsert() throws is.codion.framework.domain.entity.exception.ValidationException
      Creates a new EntityEditModel.Insert instance for inserting the active entity.
      Returns:
      a new EntityEditModel.Insert instance
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails

    • createInsert

      EntityEditModel.Insert createInsert(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.framework.domain.entity.exception.ValidationException
      Creates a new EntityEditModel.Insert instance for inserting the given entities.
      Parameters:
      entities - the entities to insert
      Returns:
      a new EntityEditModel.Insert instance
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails

    • createUpdate

      EntityEditModel.Update createUpdate() throws is.codion.framework.domain.entity.exception.ValidationException
      Creates a new EntityEditModel.Update instance for updating the active entity.
      Returns:
      a new EntityEditModel.Update instance
      Throws:
      IllegalArgumentException - in case the active entity is unmodified
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails

    • createUpdate

      EntityEditModel.Update createUpdate(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.framework.domain.entity.exception.ValidationException
      Creates a new EntityEditModel.Update instance for updating the given entities.
      Parameters:
      entities - the entities to update
      Returns:
      a new EntityEditModel.Update instance
      Throws:
      IllegalArgumentException - in case any of the given entities are unmodified
      is.codion.framework.domain.entity.exception.ValidationException - in case validation fails

    • createDelete

      EntityEditModel.Delete createDelete()
      Creates a new EntityEditModel.Delete instance for deleting the active entity.
      Returns:
      a new EntityEditModel.Delete instance

    • createDelete

      EntityEditModel.Delete createDelete(Collection<is.codion.framework.domain.entity.Entity> entities)
      Creates a new EntityEditModel.Delete instance for deleting the given entities.
      Parameters:
      entities - the entities to delete
      Returns:
      a new EntityEditModel.Delete instance

    • add

      void add(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
      Adds the given entities to all foreign key models based on that entity type
      Parameters:
      foreignKey - the foreign key
      entities - the values

    • remove

      void remove(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
      Removes the given entities from all foreign key models based on that entity type and clears any foreign key values referencing them.
      Parameters:
      foreignKey - the foreign key
      entities - the values

    • replace

      void replace(is.codion.framework.domain.entity.attribute.ForeignKey foreignKey, Collection<is.codion.framework.domain.entity.Entity> entities)
      For every field referencing the given foreign key values, replaces that foreign key instance with the corresponding entity from entities, useful when attribute values have been changed in the referenced entity that must be reflected in the edit model.
      Parameters:
      foreignKey - the foreign key
      entities - the foreign key entities

    • validate

      void validate(is.codion.framework.domain.entity.attribute.Attribute<?> attribute) throws is.codion.framework.domain.entity.exception.ValidationException
      Validates the value associated with the given attribute, using the underlying validator.
      Parameters:
      attribute - the attribute the value is associated with
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - if the given value is not valid for the given attribute

    • validate

      void validate() throws is.codion.framework.domain.entity.exception.ValidationException
      Validates the current state of the entity
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - in case the entity is invalid

    • validate

      void validate(Collection<is.codion.framework.domain.entity.Entity> entities) throws is.codion.framework.domain.entity.exception.ValidationException
      Validates the given entities, using the underlying validator. For entities of a type other than this edit model is based on, their respective validators are used.
      Parameters:
      entities - the entities to validate
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - on finding the first invalid entity
      See Also:
      • EntityDefinition.validator()

    • validate

      void validate(is.codion.framework.domain.entity.Entity entity) throws is.codion.framework.domain.entity.exception.ValidationException
      Validates the given entity, using the underlying validator. For entities of a type other than this edit model is based on, their respective validators are used.
      Parameters:
      entity - the entity to validate
      Throws:
      is.codion.framework.domain.entity.exception.ValidationException - in case the entity is invalid
      NullPointerException - in case the entity is null

    • valid

      is.codion.common.state.StateObserver valid()
      Returns:
      a StateObserver indicating the valid status of the underlying Entity.
      See Also:

    • valid

      is.codion.common.state.StateObserver valid(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Parameters:
      attribute - the attribute
      Returns:
      a StateObserver indicating the valid status of the given attribute.

    • modified

      is.codion.common.state.StateObserver modified()
      Returns a StateObserver indicating when and if any values in the underlying Entity have been modified.
      Returns:
      a StateObserver indicating the modified state of this edit model

    • modified

      is.codion.common.state.StateObserver modified(is.codion.framework.domain.entity.attribute.Attribute<?> attribute)
      Returns a StateObserver instance indicating whether the value of the given attribute has been modified.
      Parameters:
      attribute - the attribute
      Returns:
      a StateObserver indicating the modified state of the value of the given attribute
      Throws:
      IllegalArgumentException - in case attribute is not part of the underlying entity
      See Also:

    • exists

      is.codion.common.state.StateObserver exists()
      Returns:
      a StateObserver indicating whether the active entity exists in the database

    • primaryKeyNull

      is.codion.common.state.StateObserver primaryKeyNull()
      Returns:
      a StateObserver indicating whether the primary key of the active entity is null

    • addEditListener

      <T> void addEditListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
      Adds a listener notified each time the value associated with the given attribute is edited via put(Attribute, Object) or remove(Attribute), note that this event is only fired if the value actually changes.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute for which to monitor value edits
      listener - a listener notified each time the value of the given attribute is edited via this model

    • removeEditListener

      <T> void removeEditListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
      Removes the given listener.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute
      listener - the listener to remove

    • addValueListener

      <T> void addValueListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
      Adds a listener notified each time the value associated with the given attribute changes, either via editing or when the active entity is set.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute for which to monitor value changes
      listener - a listener notified each time the value of the attribute changes
      See Also:

    • removeValueListener

      <T> void removeValueListener(is.codion.framework.domain.entity.attribute.Attribute<T> attribute, Consumer<T> listener)
      Removes the given listener.
      Type Parameters:
      T - the value type
      Parameters:
      attribute - the attribute for which to remove the listener
      listener - the listener to remove

    • addValueChangeListener

      void addValueChangeListener(Consumer<is.codion.framework.domain.entity.attribute.Attribute<?>> listener)
      Parameters:
      listener - a listener notified each time a value changes, providing the attribute

    • removeValueChangeListener

      void removeValueChangeListener(Consumer<is.codion.framework.domain.entity.attribute.Attribute<?>> listener)
      Parameters:
      listener - the listener to remove

    • addEntityListener

      void addEntityListener(Consumer<is.codion.framework.domain.entity.Entity> listener)
      Notified each time the entity is set via set(Entity) or setDefaults().
      Parameters:
      listener - a listener notified each time the entity is set, possibly to null
      See Also:

    • removeEntityListener

      void removeEntityListener(Consumer<is.codion.framework.domain.entity.Entity> listener)
      Removes the given listener.
      Parameters:
      listener - the listener to remove

    • addBeforeInsertListener

      void addBeforeInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified before an insert is performed

    • removeBeforeInsertListener

      void removeBeforeInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addAfterInsertListener

      void addAfterInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified each time insert has been performed

    • removeAfterInsertListener

      void removeAfterInsertListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addBeforeUpdateListener

      void addBeforeUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified before an update is performed

    • removeBeforeUpdateListener

      void removeBeforeUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addAfterUpdateListener

      void addAfterUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified each time an update has been performed, with the updated entities, mapped to their respective original primary keys, that is, the primary keys before the update was performed

    • removeAfterUpdateListener

      void removeAfterUpdateListener(Consumer<Map<is.codion.framework.domain.entity.Entity.Key,is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addBeforeDeleteListener

      void addBeforeDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified before a delete is performed

    • removeBeforeDeleteListener

      void removeBeforeDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addAfterDeleteListener

      void addAfterDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Parameters:
      listener - a listener to be notified each time delete has been performed

    • removeAfterDeleteListener

      void removeAfterDeleteListener(Consumer<Collection<is.codion.framework.domain.entity.Entity>> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addInsertUpdateOrDeleteListener

      void addInsertUpdateOrDeleteListener(Runnable listener)
      Parameters:
      listener - a listener notified each time one or more entities are updated, inserted or deleted via this model

    • removeInsertUpdateOrDeleteListener

      void removeInsertUpdateOrDeleteListener(Runnable listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove

    • addConfirmOverwriteListener

      void addConfirmOverwriteListener(Consumer<is.codion.common.state.State> listener)
      Parameters:
      listener - a listener notified each time the active entity is about to be set

    • removeConfirmOverwriteListener

      void removeConfirmOverwriteListener(Consumer<is.codion.common.state.State> listener)
      Removes the given listener.
      Parameters:
      listener - a listener to remove