Module is.codion.swing.framework.ui

Package is.codion.swing.framework.ui.component

Class EntitySearchField

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.text.JTextComponent

javax.swing.JTextField

is.codion.swing.common.ui.component.text.HintTextField

is.codion.swing.framework.ui.component.EntitySearchField

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants

public final class EntitySearchField
extends is.codion.swing.common.ui.component.text.HintTextField

A UI component based on the EntitySearchModel. The search is triggered by the ENTER key and behaves in the following way: If the search result is empty a message is shown, if a single entity fits the condition then that entity is selected, otherwise a component displaying the entities fitting the condition is shown in a dialog allowing either a single or multiple selection based on the search model settings. EntitySearchField.ListSelector is the default EntitySearchField.Selector. Use builder(EntitySearchModel) or builder(EntityType, EntityConnectionProvider) for a builder instance.

See Also:

• EntitySearchModel
• builder(EntityType, EntityConnectionProvider)
• builder(EntitySearchModel)
• singleSelectionValue()
• multiSelectionValue()
• selectorFactory(Function)
• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	EntitySearchField.Builder	Builds a entity search field.
static interface	EntitySearchField.ListSelector	A EntitySearchField.Selector based on a JList.
static enum	EntitySearchField.SearchIndicator	The ways which a search field can indicate that a search is in progress.
static interface	EntitySearchField.Selector	Provides a way for the user to select one or more of a given set of entities
static interface	EntitySearchField.TableSelector	A EntitySearchField.Selector based on a FilteredTable.

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

JTextField.AccessibleJTextField

Nested classes/interfaces inherited from class javax.swing.text.JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

Modifier and Type	Field	Description
static final is.codion.common.property.PropertyValue<EntitySearchField.SearchIndicator>	SEARCH_INDICATOR	Specifies the way a EntitySearchField indicates that a search is in progress.

Fields inherited from class javax.swing.JTextField

notifyAction

Fields inherited from class javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

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

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Method Summary

Modifier and Type	Method	Description
static EntitySearchField.Builder	builder(is.codion.framework.domain.entity.EntityType entityType, is.codion.framework.db.EntityConnectionProvider connectionProvider)	Instantiates a new EntitySearchField.Builder
static EntitySearchField.Builder	builder(is.codion.framework.model.EntitySearchModel searchModel)	Instantiates a new EntitySearchField.Builder
static EntitySearchField.ListSelector	listSelector(is.codion.framework.model.EntitySearchModel searchModel)
is.codion.framework.model.EntitySearchModel	model()
is.codion.swing.common.ui.component.value.ComponentValue<Collection<is.codion.framework.domain.entity.Entity>,EntitySearchField>	multiSelectionValue()
void	searchIndicator(EntitySearchField.SearchIndicator searchIndicator)
is.codion.common.state.State	searchOnFocusLost()
void	selectorFactory(Function<is.codion.framework.model.EntitySearchModel,EntitySearchField.Selector> selectorFactory)	Sets the factory for the EntitySearchField.Selector responsible for selecting items from the search result.
is.codion.swing.common.ui.component.value.ComponentValue<is.codion.framework.domain.entity.Entity,EntitySearchField>	singleSelectionValue()
static EntitySearchField.TableSelector	tableSelector(is.codion.framework.model.EntitySearchModel searchModel)
void	transferFocusOnEnter(boolean transferFocusOnEnter)
void	updateUI()

Methods inherited from class is.codion.swing.common.ui.component.text.HintTextField

addFocusListener, addPropertyChangeListener, hintText, paint

Methods inherited from class javax.swing.JTextField

actionPropertyChanged, addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAccessibleContext, getAction, getActionListeners, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, getUIClassID, isValidateRoot, paramString, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setDocument, setFont, setHorizontalAlignment, setScrollOffset

Methods inherited from class javax.swing.text.JTextComponent

addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, viewToModel, viewToModel2D, write

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, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, 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, 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, addHierarchyBoundsListener, addHierarchyListener, 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, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Details

SEARCH_INDICATOR

public static final is.codion.common.property.PropertyValue<EntitySearchField.SearchIndicator> SEARCH_INDICATOR

Specifies the way a EntitySearchField indicates that a search is in progress. Value type: EntitySearchField.SearchIndicator
Default value: EntitySearchField.SearchIndicator.WAIT_CURSOR

Method Details

updateUI

public void updateUI()

Overrides:

updateUI in class JTextComponent

model

public is.codion.framework.model.EntitySearchModel model()

Returns:

the search model this search field is based on

transferFocusOnEnter

public void transferFocusOnEnter(boolean transferFocusOnEnter)

Parameters:

transferFocusOnEnter - true if this component should transfer focus on Enter

searchIndicator

public void searchIndicator(EntitySearchField.SearchIndicator searchIndicator)

Parameters:

searchIndicator - the search indicator type

See Also:

• SEARCH_INDICATOR

selectorFactory

public void selectorFactory(Function<is.codion.framework.model.EntitySearchModel,EntitySearchField.Selector> selectorFactory)

Sets the factory for the EntitySearchField.Selector responsible for selecting items from the search result.

Parameters:

selectorFactory - a factory for the EntitySearchField.Selector implementation to use when presenting a selection dialog to the user

Throws:

NullPointerException - in case selectorFactory is null

searchOnFocusLost

public is.codion.common.state.State searchOnFocusLost()

Returns:

the State controlling whether this field should trigger a search when it loses focus

singleSelectionValue

public is.codion.swing.common.ui.component.value.ComponentValue<is.codion.framework.domain.entity.Entity,EntitySearchField> singleSelectionValue()

Returns:

a ComponentValue for selecting a single entity

multiSelectionValue

public is.codion.swing.common.ui.component.value.ComponentValue<Collection<is.codion.framework.domain.entity.Entity>,EntitySearchField> multiSelectionValue()

Returns:

a ComponentValue for selecting multiple entities

builder

public static EntitySearchField.Builder builder(is.codion.framework.domain.entity.EntityType entityType,
 is.codion.framework.db.EntityConnectionProvider connectionProvider)

Instantiates a new EntitySearchField.Builder

Parameters:

entityType - the entity type

connectionProvider - the connection provider

Returns:

a new builder instance

builder

public static EntitySearchField.Builder builder(is.codion.framework.model.EntitySearchModel searchModel)

Instantiates a new EntitySearchField.Builder

Parameters:

searchModel - the search model on which to base the search field

Returns:

a new builder instance

listSelector

public static EntitySearchField.ListSelector listSelector(is.codion.framework.model.EntitySearchModel searchModel)

Parameters:

searchModel - the search model

Returns:

a EntitySearchField.Selector based on a JList.

tableSelector

public static EntitySearchField.TableSelector tableSelector(is.codion.framework.model.EntitySearchModel searchModel)

Parameters:

searchModel - the search model

Returns:

a EntitySearchField.Selector based on a FilteredTable.