Module is.codion.swing.framework.ui
Package is.codion.swing.framework.ui

Class EntityEditPanel

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
is.codion.swing.framework.ui.EntityEditComponentPanel
is.codion.swing.framework.ui.EntityEditPanel
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible
public abstract class EntityEditPanel extends EntityEditComponentPanel
A UI component based on a EntityEditModel.
See Also:

  • Constructor Details

    • EntityEditPanel

      public EntityEditPanel(is.codion.swing.framework.model.SwingEntityEditModel editModel)
      Instantiates a new EntityEditPanel based on the given EntityEditModel
      Parameters:
      editModel - the EntityEditModel instance to base this EntityEditPanel on

    • EntityEditPanel

      public EntityEditPanel(is.codion.swing.framework.model.SwingEntityEditModel editModel, EntityComponents entityComponents)
      Instantiates a new EntityEditPanel based on the given EntityEditModel
      Parameters:
      editModel - the EntityEditModel instance to base this EntityEditPanel on
      entityComponents - the entity components instance to use when creating components

    • EntityEditPanel

      public EntityEditPanel(is.codion.swing.framework.model.SwingEntityEditModel editModel, Consumer<EntityEditPanel.Config> configuration)
      Instantiates a new EntityEditPanel based on the given EntityEditModel
      Parameters:
      editModel - the EntityEditModel instance to base this EntityEditPanel on
      configuration - provides access to the panel configuration

    • EntityEditPanel

      public EntityEditPanel(is.codion.swing.framework.model.SwingEntityEditModel editModel, EntityComponents entityComponents, Consumer<EntityEditPanel.Config> configuration)
      Instantiates a new EntityEditPanel based on the given EntityEditModel
      Parameters:
      editModel - the EntityEditModel instance to base this EntityEditPanel on
      entityComponents - the entity components instance to use when creating components
      configuration - provides access to the panel configuration

  • Method Details

    • toString

      public final String toString()
      Overrides:
      toString in class Component

    • active

      public final is.codion.common.state.State active()
      Returns:
      a State controlling whether this panel is active, enabled and ready to receive input

    • clearAndRequestFocus

      public final void clearAndRequestFocus()
      Clears the underlying edit model and requests the initial focus.
      See Also:

    • control

      public final is.codion.common.value.Value<is.codion.swing.common.ui.control.Control> control(EntityEditPanel.EditControl editControl)
      Returns a Value containing the control associated with controlCode, an empty Value if no such control is available. Note that standard controls are populated during initialization, so until then, these values may be empty.
      Parameters:
      editControl - the control code
      Returns:
      the Value containing the control associated with controlCode

    • controls

      public final is.codion.swing.common.ui.control.Controls controls()
      Returns a Controls instance containing all the controls this edit panel provides via createControls().
      Returns:
      the Controls provided by this edit panel
      Throws:
      IllegalStateException - in case the panel has not been initialized
      See Also:

    • initialize

      public final EntityEditPanel initialize()
      Initializes this EntityEditPanel. This method marks this panel as initialized which prevents it from running again, whether an exception occurs or not.
      Returns:
      this EntityEditPanel instance

    • insertWithConfirmation

      public final boolean insertWithConfirmation()
      Performs insert on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.insertConfirmer(Confirmer). Note that the default insert EntityEditPanel.Confirmer simply returns true, so in order to implement a insert confirmation you must set the EntityEditPanel.Confirmer via EntityEditPanel.Config.insertConfirmer(Confirmer).
      Returns:
      true in case of successful insert, false otherwise
      See Also:

    • insert

      public final boolean insert()
      Performs insert on the active entity without asking for confirmation
      Returns:
      true in case of successful insert, false otherwise

    • deleteWithConfirmation

      public final boolean deleteWithConfirmation()
      Performs delete on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.deleteConfirmer(Confirmer).
      Returns:
      true if the delete operation was successful
      See Also:

    • delete

      public final boolean delete()
      Performs delete on the active entity without asking for confirmation
      Returns:
      true if the delete operation was successful

    • updateWithConfirmation

      public final boolean updateWithConfirmation()
      Performs update on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.updateConfirmer(Confirmer).
      Returns:
      true if the update operation was successful
      See Also:

    • update

      public final boolean update()
      Performs update on the active entity without asking for confirmation.
      Returns:
      true if the update operation was successful

    • initialized

      public final boolean initialized()
      Returns:
      true if this panel has been initialized
      See Also:

    • confirmInsert

      protected final boolean confirmInsert()
      Returns:
      true if confirmed

    • confirmUpdate

      protected final boolean confirmUpdate()
      Returns:
      true if confirmed

    • confirmDelete

      protected final boolean confirmDelete()
      Returns:
      true if confirmed

    • insertCommand

      protected final is.codion.swing.common.ui.control.Control.Command insertCommand(boolean confirm)
      Returns an async insert command
      Parameters:
      confirm - true if confirmation should be performed
      Returns:
      a new async insert command

    • updateCommand

      protected final is.codion.swing.common.ui.control.Control.Command updateCommand(boolean confirm)
      Returns an async update command
      Parameters:
      confirm - true if confirmation should be performed
      Returns:
      a new async update command

    • deleteCommand

      protected final is.codion.swing.common.ui.control.Control.Command deleteCommand(boolean confirm)
      Returns an async delete command
      Parameters:
      confirm - true if confirmation should be performed
      Returns:
      a new async delete command

    • onException

      protected void onException(Exception exception)
      Propagates the exception to onValidationException(ValidationException) or onReferentialIntegrityException(ReferentialIntegrityException) depending on type, otherwise forwards to the super implementation.
      Overrides:
      onException in class EntityEditComponentPanel
      Parameters:
      exception - the exception to handle
      See Also:

    • onReferentialIntegrityException

      protected void onReferentialIntegrityException(is.codion.common.db.exception.ReferentialIntegrityException exception)
      Called when a ReferentialIntegrityException occurs. If a Database.Operation.DELETE operation is being performed and the referential integrity error handling is ReferentialIntegrityErrorHandling.DISPLAY_DEPENDENCIES, the dependencies of the entity involved are displayed to the user, otherwise onException(Exception) is called.
      Parameters:
      exception - the exception
      See Also:

    • onValidationException

      protected void onValidationException(is.codion.framework.domain.entity.exception.ValidationException exception)
      Displays the exception message after which the component involved receives the focus.
      Parameters:
      exception - the exception

    • createControls

      protected is.codion.swing.common.ui.control.Controls createControls()
      Creates a Controls instance containing all the controls available in this edit panel
      Returns:
      the Controls available in this edit panel

    • setupControls

      protected void setupControls()
      Override to setup any custom controls. This default implementation is empty. This method is called after all standard controls have been initialized.
      See Also:

    • initializeUI

      protected abstract void initializeUI()
      Initializes this EntityEditPanel UI, that is, creates and lays out the components required for editing the underlying entity type. 
         protected void initializeUI() {
      initialFocusAttribute().set(DomainModel.USER_NAME);

      createTextField(DomainModel.USER_NAME);
      createTextField(DomainModel.USER_ADDRESS);

      setLayout(new GridLayout(2, 1, 5, 5);

      addInputPanel(DomainModel.USER_NAME);
      addInputPanel(DomainModel.USER_ADDRESS);
  }