javafx.beans.property.MapPropertyBase Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of openjfx-78-backport Show documentation
Show all versions of openjfx-78-backport Show documentation
This is a backport of OpenJFX 8 to run on Java 7.
The newest version!
/*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package javafx.beans.property;
import com.sun.javafx.binding.MapExpressionHelper;
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.*;
/**
* The class {@code MapPropertyBase} is the base class for a property
* wrapping an {@link javafx.collections.ObservableMap}.
*
* 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.ObservableMap
* @see MapProperty
*
* @param the type of the key elements of the {@code Map}
* @param the type of the value elements of the {@code Map}
* @since JavaFX 2.1
*/
public abstract class MapPropertyBase extends MapProperty {
private final MapChangeListener mapChangeListener = new MapChangeListener() {
@Override
public void onChanged(Change change) {
invalidateProperties();
invalidated();
fireValueChangedEvent(change);
}
};
private ObservableMap value;
private ObservableValue> observable = null;
private InvalidationListener listener = null;
private boolean valid = true;
private MapExpressionHelper helper = null;
private SizeProperty size0;
private EmptyProperty empty0;
/**
* The Constructor of {@code MapPropertyBase}
*/
public MapPropertyBase() {}
/**
* The constructor of the {@code MapPropertyBase}.
*
* @param initialValue
* the initial value of the wrapped value
*/
public MapPropertyBase(ObservableMap initialValue) {
this.value = initialValue;
if (initialValue != null) {
initialValue.addListener(mapChangeListener);
}
}
@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 MapPropertyBase.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 MapPropertyBase.this;
}
@Override
public String getName() {
return "empty";
}
@Override
protected void fireValueChangedEvent() {
super.fireValueChangedEvent();
}
}
@Override
public void addListener(InvalidationListener listener) {
helper = MapExpressionHelper.addListener(helper, this, listener);
}
@Override
public void removeListener(InvalidationListener listener) {
helper = MapExpressionHelper.removeListener(helper, listener);
}
@Override
public void addListener(ChangeListener> listener) {
helper = MapExpressionHelper.addListener(helper, this, listener);
}
@Override
public void removeListener(ChangeListener> listener) {
helper = MapExpressionHelper.removeListener(helper, listener);
}
@Override
public void addListener(MapChangeListener listener) {
helper = MapExpressionHelper.addListener(helper, this, listener);
}
@Override
public void removeListener(MapChangeListener listener) {
helper = MapExpressionHelper.removeListener(helper, listener);
}
/**
* Sends notifications to all attached
* {@link javafx.beans.InvalidationListener InvalidationListeners},
* {@link javafx.beans.value.ChangeListener ChangeListeners}, and
* {@link javafx.collections.MapChangeListener}.
*
* This method is called when the value is changed, either manually by
* calling {@link #set(javafx.collections.ObservableMap)} or in case of a bound property, if the
* binding becomes invalid.
*/
protected void fireValueChangedEvent() {
MapExpressionHelper.fireValueChangedEvent(helper);
}
/**
* Sends notifications to all attached
* {@link javafx.beans.InvalidationListener InvalidationListeners},
* {@link javafx.beans.value.ChangeListener ChangeListeners}, and
* {@link javafx.collections.MapChangeListener}.
*
* This method is called when the content of the list changes.
*
* @param change the change that needs to be propagated
*/
protected void fireValueChangedEvent(MapChangeListener.Change change) {
MapExpressionHelper.fireValueChangedEvent(helper, change);
}
private void invalidateProperties() {
if (size0 != null) {
size0.fireValueChangedEvent();
}
if (empty0 != null) {
empty0.fireValueChangedEvent();
}
}
private void markInvalid(ObservableMap oldValue) {
if (valid) {
if (oldValue != null) {
oldValue.removeListener(mapChangeListener);
}
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 ObservableMap get() {
if (!valid) {
value = observable == null ? value : observable.getValue();
valid = true;
if (value != null) {
value.addListener(mapChangeListener);
}
}
return value;
}
@Override
public void set(ObservableMap newValue) {
if (isBound()) {
throw new RuntimeException("A bound value cannot be set.");
}
if (value != newValue) {
final ObservableMap 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(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 MapPropertyBase} object.
* @return a string representation of this {@code MapPropertyBase} object.
*/
@Override
public String toString() {
final Object bean = getBean();
final String name = getName();
final StringBuilder result = new StringBuilder("MapProperty [");
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(MapPropertyBase ref) {
this.wref = new WeakReference<>(ref);
}
@Override
public void invalidated(Observable observable) {
MapPropertyBase ref = wref.get();
if (ref == null) {
observable.removeListener(this);
} else {
ref.markInvalid(ref.value);
}
}
}
}