Class StringExpression

java.lang.Object

javafx.beans.binding.StringExpression

All Implemented Interfaces:: Observable, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>

Direct Known Subclasses:: ReadOnlyStringProperty, StringBinding

public abstract class StringExpression extends Object implements ObservableStringValue

StringExpression is an ObservableStringValue plus additional convenience methods to generate bindings in a fluent style.

A concrete sub-class of StringExpression has to implement the method ObservableObjectValue.get(), which provides the actual value of this expression.

Note: all implementation of BooleanBinding returned by the comparisons in this class consider a String that is null equal to an empty String.

Since:: JavaFX 2.0

Constructor Summary

Constructor	Description
`StringExpression()`	Creates a default `StringExpression`.

Method Summary

Modifier and Type	Method	Description
`StringExpression`	`concat(Object other)`	Returns a `StringExpression` that holds the value of this `StringExpression` concatenated with another `Object`.
`String`	`getValue()`	Returns the current value of this `ObservableValue`
`final String`	`getValueSafe()`	Returns usually the value of this `StringExpression`.
`BooleanBinding`	`greaterThan(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is greater than a constant value.
`BooleanBinding`	`greaterThan(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is greater than another `ObservableStringValue`.
`BooleanBinding`	`greaterThanOrEqualTo(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is greater than or equal to a constant value.
`BooleanBinding`	`greaterThanOrEqualTo(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is greater than or equal to another `ObservableStringValue`.
`BooleanBinding`	`isEmpty()`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is empty.
`BooleanBinding`	`isEqualTo(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is equal to a constant value.
`BooleanBinding`	`isEqualTo(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this and another `ObservableStringValue` are equal.
`BooleanBinding`	`isEqualToIgnoreCase(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is equal to a constant value ignoring case.
`BooleanBinding`	`isEqualToIgnoreCase(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this and another `ObservableStringValue` are equal ignoring case.
`BooleanBinding`	`isNotEmpty()`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is not empty.
`BooleanBinding`	`isNotEqualTo(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is not equal to a constant value.
`BooleanBinding`	`isNotEqualTo(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this and another `ObservableStringValue` are not equal.
`BooleanBinding`	`isNotEqualToIgnoreCase(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is not equal to a constant value ignoring case.
`BooleanBinding`	`isNotEqualToIgnoreCase(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this and another `ObservableStringValue` are not equal ignoring case.
`BooleanBinding`	`isNotNull()`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is not `null`.
`BooleanBinding`	`isNull()`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is `null`.
`IntegerBinding`	`length()`	Creates a new `IntegerBinding` that holds the length of this `StringExpression`.
`BooleanBinding`	`lessThan(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is less than a constant value.
`BooleanBinding`	`lessThan(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is less than another `ObservableStringValue`.
`BooleanBinding`	`lessThanOrEqualTo(String other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is less than or equal to a constant value.
`BooleanBinding`	`lessThanOrEqualTo(ObservableStringValue other)`	Creates a new `BooleanBinding` that holds `true` if this `StringExpression` is less than or equal to another `ObservableStringValue`.
`static StringExpression`	`stringExpression(ObservableValue<?> value)`	Returns a `StringExpression` that wraps a `ObservableValue`.

Methods declared in class java.lang.Object

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

Methods declared in interface javafx.beans.Observable

addListener, removeListener, subscribe

Methods declared in interface javafx.beans.value.ObservableObjectValue

get

Methods declared in interface javafx.beans.value.ObservableValue

addListener, flatMap, map, orElse, removeListener, subscribe, subscribe, when

Constructor Details

StringExpression

public StringExpression()

Creates a default StringExpression.

Method Details

getValue

public String getValue()

Description copied from interface: ObservableValue

Returns the current value of this ObservableValue

Specified by:: getValue in interface ObservableValue<String>
Returns:: The current value

getValueSafe

public final String getValueSafe()

Returns usually the value of this StringExpression. Only if the value is null an empty String is returned instead.

Returns:: the value of this StringExpression or the empty String

stringExpression

public static StringExpression stringExpression(ObservableValue<?> value)

Returns a StringExpression that wraps a ObservableValue. If the ObservableValue is already a StringExpression, it will be returned. Otherwise a new StringBinding is created that holds the value of the ObservableValue converted to a String.

Parameters:: value - The source ObservableValue
Returns:: A StringExpression that wraps the ObservableValue if necessary
Throws:: NullPointerException - if value is null

concat

public StringExpression concat(Object other)

Returns a StringExpression that holds the value of this StringExpression concatenated with another Object.

If the value of this StringExpression changes, the value of the resulting StringExpression is updated automatically. Also if the other Object is an implementation of ObservableValue, changes in the other Object are reflected automatically in the resulting StringExpression.

Parameters:: other - the other Object
Returns:: the new StringExpression