1 /* 2 * Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javafx.beans.property.adapter; 27 28 import com.sun.javafx.property.adapter.Disposer; 29 import com.sun.javafx.property.adapter.ReadOnlyPropertyDescriptor; 30 import javafx.beans.property.ReadOnlyObjectPropertyBase; 31 32 import java.lang.reflect.InvocationTargetException; 33 import java.lang.reflect.UndeclaredThrowableException; 34 35 import java.security.AccessController; 36 import java.security.AccessControlContext; 37 import java.security.PrivilegedAction; 38 39 import sun.reflect.misc.MethodUtil; 40 41 /** 42 * A {@code ReadOnlyJavaBeanObjectProperty} provides an adapter between a regular 43 * read only Java Bean property of {@code T} and a JavaFX 44 * {@code ReadOnlyObjectProperty}. It cannot be created directly, but a 45 * {@link ReadOnlyJavaBeanObjectPropertyBuilder} has to be used. 46 * <p> 47 * As a minimum, the Java Bean must implement a getter for the 48 * property. If the getter of an instance of this class is called, the property of 49 * the Java Bean is returned. If the Java Bean property is bound (i.e. it supports 50 * PropertyChangeListeners), this {@code ReadOnlyJavaBeanObjectProperty} will be 51 * aware of changes in the Java Bean. Otherwise it can be notified about 52 * changes by calling {@link #fireValueChangedEvent()}. 53 * 54 * @see javafx.beans.property.ReadOnlyObjectProperty 55 * @see ReadOnlyJavaBeanObjectPropertyBuilder 56 * 57 * @param T the type of the wrapped {@code Object} 58 * @since JavaFX 2.1 59 */ 60 public final class ReadOnlyJavaBeanObjectProperty<T> extends ReadOnlyObjectPropertyBase<T> implements ReadOnlyJavaBeanProperty<T> { 61 62 private final ReadOnlyPropertyDescriptor descriptor; 63 private final ReadOnlyPropertyDescriptor.ReadOnlyListener<T> listener; 64 65 private final AccessControlContext acc = AccessController.getContext(); 66 67 ReadOnlyJavaBeanObjectProperty(ReadOnlyPropertyDescriptor descriptor, Object bean) { 68 this.descriptor = descriptor; 69 this.listener = descriptor.new ReadOnlyListener<T>(bean, this); 70 descriptor.addListener(listener); 71 Disposer.addRecord(this, new DescriptorListenerCleaner(descriptor, listener)); 72 } 73 74 /** 75 * {@inheritDoc} 76 * 77 * @throws UndeclaredThrowableException if calling the getter of the Java Bean 78 * property throws an {@code IllegalAccessException} or an 79 * {@code InvocationTargetException}. 80 */ 81 @Override 82 public T get() { 83 return AccessController.doPrivileged((PrivilegedAction<T>) () -> { 84 try { 85 return (T)MethodUtil.invoke(descriptor.getGetter(), getBean(), (Object[])null); 86 } catch (IllegalAccessException e) { 87 throw new UndeclaredThrowableException(e); 88 } catch (InvocationTargetException e) { 89 throw new UndeclaredThrowableException(e); 90 } 91 }, acc); 92 } 93 94 /** 95 * {@inheritDoc} 96 */ 97 @Override 98 public Object getBean() { 99 return listener.getBean(); 100 } 101 102 /** 103 * {@inheritDoc} 104 */ 105 @Override 106 public String getName() { 107 return descriptor.getName(); 108 } 109 110 /** 111 * {@inheritDoc} 112 */ 113 @Override 114 public void fireValueChangedEvent() { 115 super.fireValueChangedEvent(); 116 } 117 118 /** 119 * {@inheritDoc} 120 */ 121 @Override 122 public void dispose() { 123 descriptor.removeListener(listener); 124 125 } 126 }