Module is.codion.swing.framework.model
Package is.codion.swing.framework.model.component

Interface EntityComboBoxModel

All Superinterfaces:
ComboBoxModel<Entity>, FilterComboBoxModel<Entity>, FilterModel<Entity>, ListModel<Entity>
public interface EntityComboBoxModel extends FilterComboBoxModel<Entity>

A ComboBoxModel based on an Entity, showing by default all the entities in the underlying table.

To filter a EntityComboBoxModel use filter() to set a Predicate or configure ForeignKey based filtering.

See Also:

  • Field Details

  • Method Details

    • connectionProvider

      EntityConnectionProvider connectionProvider()
      Returns:
      the connection provider used by this combo box model

    • entityDefinition

      EntityDefinition entityDefinition()
      Returns:
      the underlying EntityDefinition

    • find

      Optional<Entity> find(Entity.Key primaryKey)
      Parameters:
      primaryKey - the primary key of the entity to fetch from this model
      Returns:
      the entity with the given key if found in the model, an empty Optional otherwise

    • select

      void select(Entity.Key primaryKey)
      Selects the entity with the given primary key, whether filtered or visible. If the entity is not available in the model this method returns silently without changing the selection.
      Parameters:
      primaryKey - the primary key of the entity to select

    • condition

      Value<Supplier<Condition>> condition()

      Controls the condition supplier used when querying data, setting this to null reverts to the condition specifying all underlying entities.

      The condition supplier may not return null, doing so will cause an exception when refreshing the model items.

      Returns:
      a value controlling the condition supplier

    • filter

      EntityComboBoxModel.Filter filter()
      Returns:
      the EntityComboBoxModel.Filter instance

    • createSelectorValue

      <T> Value<T> createSelectorValue(Attribute<T> attribute)
      Creates a Value linked to the selected entity via the value of the given attribute.
      Type Parameters:
      T - the attribute type
      Parameters:
      attribute - the attribute
      Returns:
      a Value for selecting items by attribute value

    • builder

      static EntityComboBoxModel.Builder builder(EntityType entityType, EntityConnectionProvider connectionProvider)
      Parameters:
      entityType - the type of the entity this combo box model should represent
      connectionProvider - a EntityConnectionProvider instance
      Returns:
      a new EntityComboBoxModel.Builder instance