/* * 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.adapter; import com.sun.javafx.property.adapter.ReadOnlyJavaBeanPropertyBuilderHelper; import com.sun.javafx.property.adapter.ReadOnlyPropertyDescriptor; import java.lang.reflect.Method; /** * A {@code ReadOnlyJavaBeanObjectPropertyBuilder} can be used to create * {@link ReadOnlyJavaBeanObjectProperty ReadOnlyJavaBeanObjectProperties}. To create * a {@code ReadOnlyJavaBeanObjectProperty} one first has to call {@link #create()} * to generate a builder, set the required properties, and then one can * call {@link #build()} to generate the property. *
* Not all properties of a builder have to specified, there are several * combinations possible. As a minimum the {@link #name(java.lang.String)} of * the property and the {@link #bean(java.lang.Object)} have to be specified. * If the name of the getter follows the conventions, this is sufficient. * Otherwise it is possible to specify an alternative name for the getter * ({@link #getter(java.lang.String)}) or * the getter {@code Methods} directly ({@link #getter(java.lang.reflect.Method)}). *
* All methods to change properties return a reference to this builder, to enable * method chaining. *
* If you have to generate adapters for the same property of several instances
* of the same class, you can reuse a {@code ReadOnlyJavaBeanObjectPropertyBuilder}.
* by switching the Java Bean instance (with {@link #bean(java.lang.Object)} and
* calling {@link #build()}.
*
* @see ReadOnlyJavaBeanObjectProperty
*
* @param T the type of the wrapped {@code Object}
* @since JavaFX 2.1
*/
public final class ReadOnlyJavaBeanObjectPropertyBuilder