Package com.amalgamasimulation.desktop.binding.widgets

Class AbstractAutoCompleteTextDataBinding<V>

java.lang.Object

com.amalgamasimulation.desktop.binding.widgets.AbstractTextDataBinding<V>

com.amalgamasimulation.desktop.binding.widgets.AbstractAutoCompleteTextDataBinding<V>

Type Parameters:

V - The type of selectable values

All Implemented Interfaces:

AbstractDataBinding<V>, AbstractSelectObjectDataBinding<V>

Direct Known Subclasses:

AutoCompleteTextDataBinding, ContainerAutoCompleteTextDataBinding

public abstract class AbstractAutoCompleteTextDataBinding<V>
extends AbstractTextDataBinding<V>
implements AbstractSelectObjectDataBinding<V>

Abstract base class for auto-complete text field bindings with support for filtering, sorting, and validation of selectable values. Combines text input with dropdown suggestions from a predefined list of values.

Key features include:

• Auto-complete functionality with configurable matching method
• Value filtering and sorting capabilities
• Built-in validation against allowed values
• Customizable value formatting for display

Author:

Ionov Ivan

See Also:

• AbstractTextDataBinding
• AbstractSelectObjectDataBinding

Field Summary

Fields

Modifier and Type	Field	Description
protected Comparator<V>	comparator	Comparator for sorting auto-complete suggestions.
protected Predicate<V>	filter	Filter predicate for limiting available values in auto-complete suggestions.
protected List<V>	values	The list of available values for auto-completion.

Fields inherited from class com.amalgamasimulation.desktop.binding.widgets.AbstractTextDataBinding

background, canBeNull, controlDecoration, readonly, strategy, text

Constructor Summary

Constructors

Constructor	Description
AbstractAutoCompleteTextDataBinding()

Method Summary

Modifier and Type	Method	Description
void	createBinding()	Creates and initializes the data binding.
protected abstract String	format(V value)	Formats a value for display in the auto-complete dropdown.
void	setComparator(Comparator<V> comparator)	Sets a comparator to define the sorting order of values.
void	setFilter(Predicate<V> filter)	Sets a filter predicate to determine which values should be included.
void	values(List<V> values)	Sets the complete list of available values for selection.

Methods inherited from class com.amalgamasimulation.desktop.binding.widgets.AbstractTextDataBinding

background, canBeNull, enable, executeToModel, executeToTarget, isSenseless, readonly, setControl, strategy

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.amalgamasimulation.desktop.binding.widgets.AbstractDataBinding

createControlDecoration, doAction, enable, executeToModel, executeToTarget, getValue, setControl

Field Details

filter

protected Predicate<V> filter

Filter predicate for limiting available values in auto-complete suggestions. Defaults to accepting all values (always returns true).

comparator

protected Comparator<V> comparator

Comparator for sorting auto-complete suggestions. Defaults to no sorting (always returns 0).

values

protected List<V> values

The list of available values for auto-completion. Defaults to an empty list.

Constructor Details

AbstractAutoCompleteTextDataBinding

public AbstractAutoCompleteTextDataBinding()

Method Details

format

protected abstract String format(V value)

Formats a value for display in the auto-complete dropdown. Must be implemented by concrete subclasses.

Parameters:

value - The value to format

Returns:

String representation of the value

createBinding

public void createBinding()

Description copied from interface: AbstractDataBinding

Creates and initializes the data binding.

Specified by:

createBinding in interface AbstractDataBinding<V>

Overrides:

createBinding in class AbstractTextDataBinding<V>

setFilter

public void setFilter(Predicate<V> filter)

Description copied from interface: AbstractSelectObjectDataBinding

Sets a filter predicate to determine which values should be included.

Specified by:

setFilter in interface AbstractSelectObjectDataBinding<V>

Parameters:

filter - Predicate that returns true for values to include

setComparator

public void setComparator(Comparator<V> comparator)

Description copied from interface: AbstractSelectObjectDataBinding

Sets a comparator to define the sorting order of values.

Specified by:

setComparator in interface AbstractSelectObjectDataBinding<V>

Parameters:

comparator - Comparator to use for sorting values

values

public void values(List<V> values)

Description copied from interface: AbstractSelectObjectDataBinding

Sets the complete list of available values for selection.

Specified by:

values in interface AbstractSelectObjectDataBinding<V>

Parameters:

values - List of all possible values