- 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
Constructors Constructor Description StringExpression()
Creates a defaultStringExpression
. -
Method Summary
Modifier and Type Method Description StringExpression
concat(Object other)
Returns aStringExpression
that holds the value of thisStringExpression
concatenated with anotherObject
.String
getValue()
Returns the current value of thisObservableValue
String
getValueSafe()
Returns usually the value of thisStringExpression
.BooleanBinding
greaterThan(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than a constant value.BooleanBinding
greaterThan(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than anotherObservableStringValue
.BooleanBinding
greaterThanOrEqualTo(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than or equal to a constant value.BooleanBinding
greaterThanOrEqualTo(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than or equal to anotherObservableStringValue
.BooleanBinding
isEmpty()
BooleanBinding
isEqualTo(String other)
BooleanBinding
isEqualTo(ObservableStringValue other)
BooleanBinding
isEqualToIgnoreCase(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is equal to a constant value ignoring case.BooleanBinding
isEqualToIgnoreCase(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are equal ignoring case.BooleanBinding
isNotEmpty()
BooleanBinding
isNotEqualTo(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is not equal to a constant value.BooleanBinding
isNotEqualTo(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are not equal.BooleanBinding
isNotEqualToIgnoreCase(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is not equal to a constant value ignoring case.BooleanBinding
isNotEqualToIgnoreCase(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are not equal ignoring case.BooleanBinding
isNotNull()
BooleanBinding
isNull()
IntegerBinding
length()
Creates a newIntegerBinding
that holds the length of thisStringExpression
.BooleanBinding
lessThan(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than a constant value.BooleanBinding
lessThan(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than anotherObservableStringValue
.BooleanBinding
lessThanOrEqualTo(String other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than or equal to a constant value.BooleanBinding
lessThanOrEqualTo(ObservableStringValue other)
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than or equal to anotherObservableStringValue
.static StringExpression
stringExpression(ObservableValue<?> value)
Returns aStringExpression
that wraps aObservableValue
.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface javafx.beans.Observable
addListener, removeListener
Methods inherited from interface javafx.beans.value.ObservableObjectValue
get
Methods inherited from interface javafx.beans.value.ObservableValue
addListener, removeListener
-
Constructor Details
-
StringExpression
public StringExpression()Creates a defaultStringExpression
.
-
-
Method Details
-
getValue
Description copied from interface:ObservableValue
Returns the current value of thisObservableValue
- Specified by:
getValue
in interfaceObservableValue<String>
- Returns:
- The current value
-
getValueSafe
Returns usually the value of thisStringExpression
. Only if the value isnull
an emptyString
is returned instead.- Returns:
- the value of this
StringExpression
or the emptyString
-
stringExpression
Returns aStringExpression
that wraps aObservableValue
. If theObservableValue
is already aStringExpression
, it will be returned. Otherwise a newStringBinding
is created that holds the value of theObservableValue
converted to aString
.- Parameters:
value
- The sourceObservableValue
- Returns:
- A
StringExpression
that wraps theObservableValue
if necessary - Throws:
NullPointerException
- ifvalue
isnull
-
concat
Returns aStringExpression
that holds the value of thisStringExpression
concatenated with anotherObject
.If the value of this
StringExpression
changes, the value of the resultingStringExpression
is updated automatically. Also if the otherObject
is an implementation ofObservableValue
, changes in the otherObject
are reflected automatically in the resultingStringExpression
.- Parameters:
other
- the otherObject
- Returns:
- the new
StringExpression
-
isEqualTo
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are equal.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is equal to a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isNotEqualTo
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are not equal.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isNotEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is not equal to a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isEqualToIgnoreCase
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are equal ignoring case.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
isEqualToIgnoreCase
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is equal to a constant value ignoring case.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isNotEqualToIgnoreCase
Creates a newBooleanBinding
that holdstrue
if this and anotherObservableStringValue
are not equal ignoring case.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
isNotEqualToIgnoreCase
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is not equal to a constant value ignoring case.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
greaterThan
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than anotherObservableStringValue
.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
greaterThan
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
lessThan
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than anotherObservableStringValue
.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
lessThan
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
greaterThanOrEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than or equal to anotherObservableStringValue
.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
greaterThanOrEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is greater than or equal to a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
lessThanOrEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than or equal to anotherObservableStringValue
.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the secondObservableStringValue
- Returns:
- the new
BooleanBinding
-
lessThanOrEqualTo
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is less than or equal to a constant value.Note: In this comparison a
String
that isnull
is considered equal to an emptyString
.- Parameters:
other
- the constant value- Returns:
- the new
BooleanBinding
-
isNull
- Returns:
- the new
BooleanBinding
-
isNotNull
- Returns:
- the new
BooleanBinding
-
length
Creates a newIntegerBinding
that holds the length of thisStringExpression
.Note: If the value of this
StringExpression
isnull
, the length is considered to be0
.- Returns:
- the new
IntegerBinding
- Since:
- JavaFX 8.0
-
isEmpty
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is empty.Note: If the value of this
StringExpression
isnull
, it is considered to be empty.- Returns:
- the new
BooleanBinding
- Since:
- JavaFX 8.0
-
isNotEmpty
Creates a newBooleanBinding
that holdstrue
if thisStringExpression
is not empty.Note: If the value of this
StringExpression
isnull
, it is considered to be empty.- Returns:
- the new
BooleanBinding
- Since:
- JavaFX 8.0
-