Module is.codion.common.model
Package is.codion.common.model.table
Interface ColumnConditionModel<C,T>
- Type Parameters:
C- the type used to identify columnsT- the column value type
public interface ColumnConditionModel<C,T>
Specifies a condition model based on a table column, parameters, operator, upper bound and lower bound,
as well as relevant events and states.
For instances create a
ColumnConditionModel.Builder via builder(Object, Class).-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic enumThe possible automatic wildcard typesstatic interfaceBuilds aColumnConditionModelinstance.static interfaceResponsible for creatingColumnConditionModelinstances. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final is.codion.common.property.PropertyValue<ColumnConditionModel.AutomaticWildcard>Specifies whether wildcards are automatically added to string conditions by default
Value type:ColumnConditionModel.AutomaticWildcard
Default value:ColumnConditionModel.AutomaticWildcard.POSTFIXstatic final is.codion.common.property.PropertyValue<Boolean>Specifies whether string based conditions are case-sensitive or not by default
Value type: Boolean
Default value: false -
Method Summary
Modifier and TypeMethodDescriptionbooleanaccepts(Comparable<T> columnValue) Returns true if the given value is accepted by this models condition.voidaddChangeListener(Runnable listener) is.codion.common.state.Stateis.codion.common.value.Value<ColumnConditionModel.AutomaticWildcard>Note that this is only applicable to string based condition models and only used for operatorsOperator.EQUALandOperator.NOT_EQUALstatic <C,T> ColumnConditionModel.Builder<C, T> Returns a newColumnConditionModel.Builderinstance.static Stringcaption(is.codion.common.Operator operator) is.codion.common.state.Statevoidclear()Disables and clears this condition model, that is, sets the upper and lower bounds to null and the operator to the default valueOperator.EQUALis.codion.common.state.Stateenabled()is.codion.common.value.ValueSet<T>format()is.codion.common.state.Statelocked()is.codion.common.value.Value<T>is.codion.common.value.Value<is.codion.common.Operator>operator()List<is.codion.common.Operator>voidremoveChangeListener(Runnable listener) voidsetEqualValue(T value) Sets the values used when theOperator.EQUALis enabled.voidsetEqualValues(Collection<T> values) voidsetLowerBound(T value) voidsetUpperBound(T upper) is.codion.common.value.Value<T>charwildcard()
-
Field Details
-
AUTOMATIC_WILDCARD
static final is.codion.common.property.PropertyValue<ColumnConditionModel.AutomaticWildcard> AUTOMATIC_WILDCARDSpecifies whether wildcards are automatically added to string conditions by default
Value type:ColumnConditionModel.AutomaticWildcard
Default value:ColumnConditionModel.AutomaticWildcard.POSTFIX -
CASE_SENSITIVE
Specifies whether string based conditions are case-sensitive or not by default
Value type: Boolean
Default value: false
-
-
Method Details
-
columnIdentifier
C columnIdentifier()- Returns:
- the column identifier
-
caseSensitive
is.codion.common.state.State caseSensitive()- Returns:
- the State controlling whether this model is case-sensitive, when working with strings
-
format
Format format()- Returns:
- the Format object to use when formatting input, if any
-
dateTimePattern
String dateTimePattern()- Returns:
- the date/time format pattern, if any
-
automaticWildcard
is.codion.common.value.Value<ColumnConditionModel.AutomaticWildcard> automaticWildcard()Note that this is only applicable to string based condition models and only used for operatorsOperator.EQUALandOperator.NOT_EQUAL- Returns:
- the Value controlling whether automatic wildcards are enabled when working with strings
-
autoEnable
is.codion.common.state.State autoEnable()- Returns:
- the
Statecontrolling whether this model is enabled automatically when a condition value is specified
-
locked
is.codion.common.state.State locked()- Returns:
- the state controlling the locked status
-
columnClass
- Returns:
- the column class this condition model is based on
-
setEqualValue
Sets the values used when theOperator.EQUALis enabled.- Parameters:
value- the value to use as condition
-
getEqualValue
T getEqualValue()- Returns:
- the equal value, possibly null
-
setEqualValues
- Parameters:
values- the values to set, an empty Collection for none
-
getEqualValues
Collection<T> getEqualValues()- Returns:
- the equal values, never null
-
setUpperBound
- Parameters:
upper- the new upper bound
-
getUpperBound
T getUpperBound()- Returns:
- the upper bound
-
setLowerBound
- Parameters:
value- the lower bound
-
getLowerBound
T getLowerBound()- Returns:
- the lower bound
-
operators
List<is.codion.common.Operator> operators()- Returns:
- the operators available in this condition model
-
wildcard
char wildcard()- Returns:
- the character used as a wildcard when working with strings
-
enabled
is.codion.common.state.State enabled()- Returns:
- a state controlling the enabled status
-
clear
void clear()Disables and clears this condition model, that is, sets the upper and lower bounds to null and the operator to the default valueOperator.EQUAL -
equalValues
is.codion.common.value.ValueSet<T> equalValues()- Returns:
- a ValueSet based on the equals values of this condition model
-
upperBoundValue
is.codion.common.value.Value<T> upperBoundValue()- Returns:
- a Value based on the upper bound value of this condition model
-
lowerBoundValue
is.codion.common.value.Value<T> lowerBoundValue()- Returns:
- a Value based on the lower bound value of this condition model
-
operator
is.codion.common.value.Value<is.codion.common.Operator> operator()- Returns:
- a Value based on the operator
-
accepts
Returns true if the given value is accepted by this models condition.- Parameters:
columnValue- the column value- Returns:
- true if the given value is accepted by this models condition
-
addChangeListener
- Parameters:
listener- a listener to be notified each time the condition state changes
-
removeChangeListener
- Parameters:
listener- the listener to remove
-
builder
Returns a newColumnConditionModel.Builderinstance.- Type Parameters:
C- the column identifier typeT- the column value type- Parameters:
columnIdentifier- the column identifiercolumnClass- the column class- Returns:
- a new
ColumnConditionModel.Builderinstance
-
caption
- Parameters:
operator- the operator- Returns:
- a caption for the given operator
-