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:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	EntityEditPanel.Config	Contains configuration settings for a EntityEditPanel which must be set before the panel is initialized.
static interface	EntityEditPanel.Confirmer	Handles displaying confirmation messages for common actions to the user.
static final class	EntityEditPanel.ControlKeys	The controls available for EntityEditPanels.
static interface	EntityEditPanel.DeleteCommandBuilder	Builds an async delete command
static interface	EntityEditPanel.InsertCommandBuilder	Builds an async insert command
static interface	EntityEditPanel.UpdateCommandBuilder	Builds an async update command

Nested classes/interfaces inherited from class is.codion.swing.framework.ui.EntityEditComponentPanel

EntityEditComponentPanel.Defaults

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class is.codion.swing.framework.ui.EntityEditComponentPanel

DEFAULT_TEXT_FIELD_COLUMNS, MODIFIED_INDICATOR, MODIFIED_INDICATOR_UNDERLINE_STYLE

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
EntityEditPanel(SwingEntityEditModel editModel)	Instantiates a new EntityEditPanel based on the given EntityEditModel
EntityEditPanel(SwingEntityEditModel editModel, Consumer<EntityEditPanel.Config> config)	Instantiates a new EntityEditPanel based on the given EntityEditModel

Method Summary

Modifier and Type	Method	Description
final State	active()
final void	clearAndRequestFocus()	Clears the underlying edit model and requests the initial focus.
protected final void	configureControls(Consumer<Controls.Layout> controlsConfig)	Configures the controls.
protected final boolean	confirmDelete()
protected final boolean	confirmInsert()
protected final boolean	confirmUpdate()
protected final <T extends Control> Value<T>	control(ControlKey<T> controlKey)	Returns a Value containing the control associated with controlKey, an empty Value if no such control is available.
protected final Controls	controls()	Returns a Controls instance containing all the controls configured via configureControls(Consumer).
final boolean	delete()	Performs delete on the active entity without asking for confirmation
protected final EntityEditPanel.DeleteCommandBuilder	deleteCommand()	Returns an async delete command builder
final boolean	deleteWithConfirmation()	Performs delete on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.deleteConfirmer(Confirmer).
final EntityEditPanel	initialize()	Initializes this EntityEditPanel.
final boolean	initialized()
protected abstract void	initializeUI()	Initializes this EntityEditPanel UI, that is, creates and lays out the components required for editing the underlying entity type.
final boolean	insert()	Performs insert on the active entity without asking for confirmation
protected final EntityEditPanel.InsertCommandBuilder	insertCommand()	Returns an async insert command builder
final boolean	insertWithConfirmation()	Performs insert on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.insertConfirmer(Confirmer).
protected void	onException(Exception exception)	Propagates the exception to onValidationException(ValidationException) or onReferentialIntegrityException(ReferentialIntegrityException) depending on type, otherwise forwards to the super implementation.
protected void	onReferentialIntegrityException(ReferentialIntegrityException exception)	Called when a ReferentialIntegrityException occurs.
protected void	onValidationException(ValidationException exception)	Displays the exception message after which the component involved receives the focus.
protected void	setupControls()	Override to setup any custom controls.
final String	toString()
final boolean	update()	Performs update on the active entity without asking for confirmation.
protected final EntityEditPanel.UpdateCommandBuilder	updateCommand()	Returns an async update command builder
final boolean	updateWithConfirmation()	Performs update on the active entity after asking for confirmation using the EntityEditPanel.Confirmer specified via EntityEditPanel.Config.updateConfirmer(Confirmer).

Methods inherited from class is.codion.swing.framework.ui.EntityEditComponentPanel

addInputPanel, addInputPanel, addInputPanel, addInputPanel, addValidator, addValidator, afterInsertFocusAttribute, afterInsertFocusComponent, component, createBigDecimalField, createBooleanComboBox, createCheckBox, createComboBox, createComboBox, createDoubleField, createDoubleSpinner, createForeignKeyComboBox, createForeignKeyComboBoxPanel, createForeignKeyLabel, createForeignKeySearchField, createForeignKeySearchFieldPanel, createForeignKeySearchFieldPanel, createForeignKeyTextField, createInputPanel, createInputPanel, createInputPanel, createInputPanel, createInputPanel, createInputPanel, createIntegerField, createIntegerSpinner, createItemComboBox, createItemSpinner, createLabel, createList, createListSpinner, createLongField, createMaskedTextField, createSlider, createTemporalField, createTemporalFieldPanel, createTextArea, createTextField, createTextFieldPanel, defaults, displayException, editModel, getAfterInsertFocusComponent, getInitialFocusComponent, initialFocusAttribute, initialFocusComponent, modifiedIndicator, requestAfterInsertFocus, requestAfterUpdateFocus, requestComponentFocus, requestInitialFocus, selectableComponents, selectInputComponent, transferFocusOnEnter

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Details

EntityEditPanel

public EntityEditPanel(SwingEntityEditModel editModel)

Instantiates a new EntityEditPanel based on the given EntityEditModel

Parameters:

editModel - the EntityEditModel instance to base this EntityEditPanel on

EntityEditPanel

public EntityEditPanel(SwingEntityEditModel editModel,
 Consumer<EntityEditPanel.Config> config)

Instantiates a new EntityEditPanel based on the given EntityEditModel

Parameters:

editModel - the EntityEditModel instance to base this EntityEditPanel on

config - provides access to the panel configuration

Method Details

toString

public final String toString()

Overrides:

toString in class Component

active

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

• EntityEditModel.EditableEntity.defaults()
• EntityEditComponentPanel.requestInitialFocus()

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:

• EntityEditPanel.Config.insertConfirmer(Confirmer)

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:

• EntityEditPanel.Config.deleteConfirmer(Confirmer)

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:

• EntityEditPanel.Config.updateConfirmer(Confirmer)

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:

• initialize()

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 EntityEditPanel.InsertCommandBuilder insertCommand()

Returns an async insert command builder

Returns:

a new async insert command builder

updateCommand

protected final EntityEditPanel.UpdateCommandBuilder updateCommand()

Returns an async update command builder

Returns:

a new async update command builder

deleteCommand

protected final EntityEditPanel.DeleteCommandBuilder deleteCommand()

Returns an async delete command builder

Returns:

a new async delete command builder

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:

• EntityEditComponentPanel.displayException(Exception)

onReferentialIntegrityException

protected void onReferentialIntegrityException(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:

• EntityEditPanel.Config.referentialIntegrityErrorHandling(ReferentialIntegrityErrorHandling)

onValidationException

protected void onValidationException(ValidationException exception)

Displays the exception message after which the component involved receives the focus.

Parameters:

exception - the exception

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:

• control(ControlKey)

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);
   }
 
 

configureControls

protected final void configureControls(Consumer<Controls.Layout> controlsConfig)

Configures the controls.

Note that the Controls.Layout instance has pre-configured defaults, which must be cleared in order to start with an empty configuration.

 
   configureControls(layout -> layout
           .separator()
           .control(createCustomControl()))
 
 

Defaults:

• ControlKeys#INSERT
• ControlKeys#UPDATE
• ControlKeys#DELETE
• ControlKeys#CLEAR

Parameters:

controlsConfig - provides access to the controls configuration

See Also:

• Controls.Layout.clear()

control

protected final <T extends Control> Value<T> control(ControlKey<T> controlKey)

Returns a Value containing the control associated with controlKey, an empty Value if no such control is available.

Type Parameters:

T - the control type

Parameters:

controlKey - the control key

Returns:

the Value containing the control associated with controlKey

controls

protected final Controls controls()

Returns a Controls instance containing all the controls configured via configureControls(Consumer).

Returns:

the Controls provided by this edit panel

Throws:

IllegalStateException - in case the panel has not been initialized

See Also:

• initialized()
• configureControls(Consumer)