/* * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. * * * * * * * * * * * * * * * * * * * * */ package javafx.beans.binding; import javafx.beans.value.ObservableIntegerValue; import javafx.collections.FXCollections; import javafx.collections.ObservableList; import com.sun.javafx.collections.annotations.ReturnsUnmodifiableCollection; import javafx.beans.value.ObservableValue; /** * A {@code IntegerExpression} is a * {@link javafx.beans.value.ObservableIntegerValue} plus additional convenience * methods to generate bindings in a fluent style. *
* A concrete sub-class of {@code IntegerExpression} has to implement the method
* {@link javafx.beans.value.ObservableIntegerValue#get()}, which provides the
* actual value of this expression.
* @since JavaFX 2.0
*/
public abstract class IntegerExpression extends NumberExpressionBase implements
ObservableIntegerValue {
@Override
public int intValue() {
return get();
}
@Override
public long longValue() {
return (long) get();
}
@Override
public float floatValue() {
return (float) get();
}
@Override
public double doubleValue() {
return (double) get();
}
@Override
public Integer getValue() {
return get();
}
/**
* Returns a {@code IntegerExpression} that wraps a
* {@link javafx.beans.value.ObservableIntegerValue}. If the
* {@code ObservableIntegerValue} is already a {@code IntegerExpression}, it
* will be returned. Otherwise a new
* {@link javafx.beans.binding.IntegerBinding} is created that is bound to
* the {@code ObservableIntegerValue}.
*
* @param value
* The source {@code ObservableIntegerValue}
* @return A {@code IntegerExpression} that wraps the
* {@code ObservableIntegerValue} if necessary
* @throws NullPointerException
* if {@code value} is {@code null}
*/
public static IntegerExpression integerExpression(
final ObservableIntegerValue value) {
if (value == null) {
throw new NullPointerException("Value must be specified.");
}
return (value instanceof IntegerExpression) ? (IntegerExpression) value
: new IntegerBinding() {
{
super.bind(value);
}
@Override
public void dispose() {
super.unbind(value);
}
@Override
protected int computeValue() {
return value.get();
}
@Override
@ReturnsUnmodifiableCollection
public ObservableList
* Note: this method can be used to convert an {@link ObjectExpression} or
* {@link javafx.beans.property.ObjectProperty} of specific number type to IntegerExpression, which
* is essentially an {@code ObservableValue
*
* Note: null values will be interpreted as 0
*
* @param value
* The source {@code ObservableValue}
* @return A {@code IntegerExpression} that wraps the
* {@code ObservableValue} if necessary
* @throws NullPointerException
* if {@code value} is {@code null}
* @since JavaFX 8.0
*/
public static
* IntegerProperty integerProperty = new SimpleIntegerProperty(1);
* ObjectProperty<Integer> objectProperty = new SimpleObjectProperty<>(2);
* BooleanBinding binding = integerProperty.greaterThan(IntegerExpression.integerExpression(objectProperty));
*