/* * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved. * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. * * * * * * * * * * * * * * * * * * * * */ package javafx.beans.property; import com.sun.javafx.binding.SetExpressionHelper; import java.lang.ref.WeakReference; import javafx.beans.InvalidationListener; import javafx.beans.Observable; import javafx.beans.value.ChangeListener; import javafx.beans.value.ObservableValue; import javafx.collections.ObservableSet; import javafx.collections.SetChangeListener; /** * The class {@code SetPropertyBase} is the base class for a property * wrapping an {@link javafx.collections.ObservableSet}. * * It provides all the functionality required for a property except for the * {@link #getBean()} and {@link #getName()} methods, which must be implemented * by extending classes. * * @see javafx.collections.ObservableSet * @see SetProperty * * @param the type of the {@code Set} elements * @since JavaFX 2.1 */ public abstract class SetPropertyBase extends SetProperty { private final SetChangeListener setChangeListener = change -> { invalidateProperties(); invalidated(); fireValueChangedEvent(change); }; private ObservableSet value; private ObservableValue> observable = null; private InvalidationListener listener = null; private boolean valid = true; private SetExpressionHelper helper = null; private SizeProperty size0; private EmptyProperty empty0; /** * The Constructor of {@code SetPropertyBase} */ public SetPropertyBase() {} /** * The constructor of the {@code SetPropertyBase}. * * @param initialValue * the initial value of the wrapped value */ public SetPropertyBase(ObservableSet initialValue) { this.value = initialValue; if (initialValue != null) { initialValue.addListener(setChangeListener); } } @Override public ReadOnlyIntegerProperty sizeProperty() { if (size0 == null) { size0 = new SizeProperty(); } return size0; } private class SizeProperty extends ReadOnlyIntegerPropertyBase { @Override public int get() { return size(); } @Override public Object getBean() { return SetPropertyBase.this; } @Override public String getName() { return "size"; } @Override protected void fireValueChangedEvent() { super.fireValueChangedEvent(); } } @Override public ReadOnlyBooleanProperty emptyProperty() { if (empty0 == null) { empty0 = new EmptyProperty(); } return empty0; } private class EmptyProperty extends ReadOnlyBooleanPropertyBase { @Override public boolean get() { return isEmpty(); } @Override public Object getBean() { return SetPropertyBase.this; } @Override public String getName() { return "empty"; } @Override protected void fireValueChangedEvent() { super.fireValueChangedEvent(); } } @Override public void addListener(InvalidationListener listener) { helper = SetExpressionHelper.addListener(helper, this, listener); } @Override public void removeListener(InvalidationListener listener) { helper = SetExpressionHelper.removeListener(helper, listener); } @Override public void addListener(ChangeListener> listener) { helper = SetExpressionHelper.addListener(helper, this, listener); } @Override public void removeListener(ChangeListener> listener) { helper = SetExpressionHelper.removeListener(helper, listener); } @Override public void addListener(SetChangeListener listener) { helper = SetExpressionHelper.addListener(helper, this, listener); } @Override public void removeListener(SetChangeListener listener) { helper = SetExpressionHelper.removeListener(helper, listener); } /** * Sends notifications to all attached * {@link javafx.beans.InvalidationListener InvalidationListeners}, * {@link javafx.beans.value.ChangeListener ChangeListeners}, and * {@link javafx.collections.SetChangeListener}. * * This method is called when the value is changed, either manually by * calling {@link #set(javafx.collections.ObservableSet)} or in case of a bound property, if the * binding becomes invalid. */ protected void fireValueChangedEvent() { SetExpressionHelper.fireValueChangedEvent(helper); } /** * Sends notifications to all attached * {@link javafx.beans.InvalidationListener InvalidationListeners}, * {@link javafx.beans.value.ChangeListener ChangeListeners}, and * {@link javafx.collections.SetChangeListener}. * * This method is called when the content of the list changes. * * @param change the change that needs to be propagated */ protected void fireValueChangedEvent(SetChangeListener.Change change) { SetExpressionHelper.fireValueChangedEvent(helper, change); } private void invalidateProperties() { if (size0 != null) { size0.fireValueChangedEvent(); } if (empty0 != null) { empty0.fireValueChangedEvent(); } } private void markInvalid(ObservableSet oldValue) { if (valid) { if (oldValue != null) { oldValue.removeListener(setChangeListener); } valid = false; invalidateProperties(); invalidated(); fireValueChangedEvent(); } } /** * The method {@code invalidated()} can be overridden to receive * invalidation notifications. This is the preferred option in * {@code Objects} defining the property, because it requires less memory. * * The default implementation is empty. */ protected void invalidated() { } @Override public ObservableSet get() { if (!valid) { value = observable == null ? value : observable.getValue(); valid = true; if (value != null) { value.addListener(setChangeListener); } } return value; } @Override public void set(ObservableSet newValue) { if (isBound()) { throw new java.lang.RuntimeException((getBean() != null && getName() != null ? getBean().getClass().getSimpleName() + "." + getName() + " : ": "") + "A bound value cannot be set."); } if (value != newValue) { final ObservableSet oldValue = value; value = newValue; markInvalid(oldValue); } } @Override public boolean isBound() { return observable != null; } @Override public void bind(final ObservableValue> newObservable) { if (newObservable == null) { throw new NullPointerException("Cannot bind to null"); } if (!newObservable.equals(this.observable)) { unbind(); observable = newObservable; if (listener == null) { listener = new Listener<>(this); } observable.addListener(listener); markInvalid(value); } } @Override public void unbind() { if (observable != null) { value = observable.getValue(); observable.removeListener(listener); observable = null; } } /** * Returns a string representation of this {@code SetPropertyBase} object. * @return a string representation of this {@code SetPropertyBase} object. */ @Override public String toString() { final Object bean = getBean(); final String name = getName(); final StringBuilder result = new StringBuilder("SetProperty ["); if (bean != null) { result.append("bean: ").append(bean).append(", "); } if ((name != null) && (!name.equals(""))) { result.append("name: ").append(name).append(", "); } if (isBound()) { result.append("bound, "); if (valid) { result.append("value: ").append(get()); } else { result.append("invalid"); } } else { result.append("value: ").append(get()); } result.append("]"); return result.toString(); } private static class Listener implements InvalidationListener { private final WeakReference> wref; public Listener(SetPropertyBase ref) { this.wref = new WeakReference>(ref); } @Override public void invalidated(Observable observable) { SetPropertyBase ref = wref.get(); if (ref == null) { observable.removeListener(this); } else { ref.markInvalid(ref.value); } } } }