Examples of BeanAdapter

DisplayProject.binding.beans.BeanAdapter
sun.com/products/javabeans/docs/spec.html">Java Bean Specification. See below for a comparison with the more frequently used PresentationModel class and the rarely used PropertyAdapter.
ValueModels can be created for a property name using {@link #getValueModel(String)} or for a triple of (property name, getter name, setter name) using {@link #getValueModel(String,String,String)}. If you just specify the property name, the adapter uses the standard Java Bean introspection to lookup the available properties and how to read and write the property value. In case of custom readers and writers you may specify a custom BeanInfo class, or as a shortcut use the method that accepts the optional getter and setter name. If these are specified, introspection will be bypassed and a PropertyDescriptor will be created for the given property name, getter and setter name. Note: For each property name subsequent calls to these methods must use the same getter and setter names. Attempts to violate this constraint are rejected with an UsageException.
Property values for a given property name can be read using {@link #getValue(String)}. To set a value for a for a property name invoke {@link #setValue(String,Object)}.
Optionally the BeanAdapter can observe changes in bound properties as described in section 7.4 of the Bean specification. The bean then must provide support for listening on properties as described in section 7.4 of this specification. You can enable this feature by setting the constructor parameter observeChanges to true. If the adapter observes changes, the ValueModels returned by #getValueModel will fire value change events, i.e. PropertyChangeEvents for the property "value". Even if you ignore property changes, you can access the adapted property value via #getValue(). It's just that you won't be notified about changes.
In addition you can observe the bean's bound properties by registering PropertyChangeListeners with the bean using #addBeanPropertyChangeListener. These listeners will be removed from the old bean before the bean changes and will be re-added after the new bean has been set. Therefore these listeners will be notified about changes only if the current bean changes a property. They won't be notified if the bean changes - and in turn the property value. If you want to observes property changes caused by bean changes too, register with the adapting ValueModel as returned by #getValueModel(String).
The BeanAdapter provides two access styles to the target bean that holds the adapted property: you can specify a bean directly, or you can use a bean channel to access the bean indirectly. In the latter case you specify a ValueModel that holds the bean that in turn holds the adapted properties.
If the adapted bean is null the BeanAdapter can neither read nor set a value. In this case #getValue returns null and #setValue will silently ignore the new value.
This adapter throws three PropertyChangeEvents if the bean changes: beforeBean, bean and afterBean. This is useful when sharing a bean channel and you must perform an operation before or after other listeners handle a bean change. Since you cannot rely on the order listeners will be notified, only the beforeBean and afterBean events are guaranteed to be fired before and after the bean change is fired. Note that #getBean() returns the new bean before any of these three PropertyChangeEvents is fired. Therefore listeners that handle these events must use the event's old and new value to determine the old and new bean. The order of events fired during a bean change is:
1. this adapter's bean channel fires a value change,
2. this adapter fires a beforeBean change,
3. this adapter fires the bean change,
4. this adapter fires an afterBean change.
Unused BeanAdapters that observe changes have a PropertyChangeListener registered with the target bean if the bean is not null. It is recommended to remove this listener by invoking #release if the observed bean lives much longer than the adapter. After #release has been called you cannot use the BeanAdapter instance any longer. As an alternative you can use event listener lists that implement references with WeakReference.
Constraints: If property changes shall be observed, the bean class must support bound properties, i. e. it must provide the following pair of methods for registration of multicast property change event listeners:
```
 public void addPropertyChangeListener(PropertyChangeListener x); public void removePropertyChangeListener(PropertyChangeListener x); 
```
PropertyAdapter vs. BeanAdapter vs. PresentationModel
Basically the BeanAdapter does for multiple properties what the {@link DisplayProject.binding.beans.PropertyAdapter} does for a single bean property. If you adapt multiple properties of the same bean, you better use the BeanAdapter. It registers a single PropertyChangeListener with the bean, where multiple PropertyAdapters would register multiple listeners. If you adapt bean properties for an editor, you will typically use the {@link DisplayProject.binding.PresentationModel}. The PresentationModel is more powerful than the BeanAdapter. It adds support for buffered models, and provides an extensible mechanism for observing the change state of the bean and related objects.
Basic Examples:
```
 // Direct access, ignores changes Address address = new Address() BeanAdapter adapter = new BeanAdapter(address); adapter.setValue("street", "Broadway"); System.out.println(address.getStreet());        // Prints "Broadway" address.setStreet("Franz-Josef-Str."); System.out.println(adapter.getValue("street")); // Prints "Franz-Josef-Str." //Direct access, observes changes BeanAdapter adapter = new BeanAdapter(address, true); // Indirect access, ignores changes ValueHolder addressHolder = new ValueHolder(address1); BeanAdapter adapter = new BeanAdapter(addressHolder); adapter.setValue("street", "Broadway");         // Sets the street in address1 System.out.println(address1.getStreet());       // Prints "Broadway" adapter.setBean(address2); adapter.setValue("street", "Robert-Koch-Str."); // Sets the street in address2 System.out.println(address2.getStreet());       // Prints "Robert-Koch-Str." // Indirect access, observes changes ValueHolder addressHolder = new ValueHolder(); BeanAdapter adapter = new BeanAdapter(addressHolder, true); addressHolder.setValue(address1); address1.setStreet("Broadway"); System.out.println(adapter.getValue("street")); // Prints "Broadway" // Access through ValueModels Address address = new Address(); BeanAdapter adapter = new BeanAdapter(address); ValueModel streetModel = adapter.getValueModel("street"); ValueModel cityModel   = adapter.getValueModel("city"); streetModel.setValue("Broadway"); System.out.println(address.getStreet());        // Prints "Broadway" address.setCity("Hamburg"); System.out.println(cityModel.getValue());       // Prints "Hamburg" 
```
Adapter Chain Example:
Builds an adapter chain from a domain model to the presentation layer.
```
 Country country = new Country(); country.setName("Germany"); country.setEuMember(true); BeanAdapter countryAdapter = new BeanAdapter(country, true); JTextField nameField = new JTextField(); nameField.setDocument(new DocumentAdapter( countryAdapter.getValueModel("name"))); JCheckBox euMemberBox = new JCheckBox("Is EU Member"); euMemberBox.setModel(new ToggleButtonAdapter( countryAdapter.getValueModel("euMember"))); // Using factory methods JTextField nameField   = Factory.createTextField(country, "name"); JCheckBox  euMemberBox = Factory.createCheckBox (country, "euMember"); euMemberBox.setText("Is EU Member"); 
```
are performed in the event dispatch thread. In case the adapted bean is changed in a thread other than the event dispatch thread, such a feature would help complying with Swing's single thread rule. The feature could be implemented by an extended PropertyChangeSupport.
PropertyChangeEvents. This affects the classes PropertyAdapter, BeanAdapter, and PresentationModel. Basically the PropertyAdapter and the BeanAdapter's internal SimplePropertyAdapter's shall be able to optionally self-fire a PropertyChangeEvent in case the bean does not. There are several downsides with self-firing events compared to bound bean properties. See Issue 49 for more information about the downsides.
The observeChanges constructor parameter shall be replaced by a more fine-grained choice to not observe (former observeChanges=false), to observe bound properties (former observeChanges=true), and a new setting for self-firing PropertyChangeEvents if a value is set. The latter case may be further splitted up to specify how the self-fired PropertyChangeEvent is created:
1. oldValue=null, newValue=null
2. oldValue=null, newValue=the value set
3. oldValue=value read before the set, newValue=the value set
4. oldValue=value read before the set, newValue=value read after the set
@author Karsten Lentzsch @version $Revision: 1.26 $ @see DisplayProject.binding.beans.PropertyAdapter @see ValueModel @see ValueModel#getValue() @see ValueModel#setValue(Object) @see PropertyChangeEvent @see PropertyChangeListener @see java.beans.Introspector @see java.beans.BeanInfo @see PropertyDescriptor Copyright (c) 2002-2005 JGoodies Karsten Lentzsch. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of JGoodies Karsten Lentzsch nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
com.caucho.jaxb.adapters.BeanAdapter
com.jgoodies.binding.beans.BeanAdapter
net.helipilot50.stocktrade.displayproject.binding.beans.BeanAdapter
sun.com/products/javabeans/docs/spec.html">Java Bean Specification. See below for a comparison with the more frequently used PresentationModel class and the rarely used PropertyAdapter.
ValueModels can be created for a property name using {@link #getValueModel(String)} or for a triple of (property name, getter name, setter name) using {@link #getValueModel(String,String,String)}. If you just specify the property name, the adapter uses the standard Java Bean introspection to lookup the available properties and how to read and write the property value. In case of custom readers and writers you may specify a custom BeanInfo class, or as a shortcut use the method that accepts the optional getter and setter name. If these are specified, introspection will be bypassed and a PropertyDescriptor will be created for the given property name, getter and setter name. Note: For each property name subsequent calls to these methods must use the same getter and setter names. Attempts to violate this constraint are rejected with an UsageException.
Property values for a given property name can be read using {@link #getValue(String)}. To set a value for a for a property name invoke {@link #setValue(String,Object)}.
Optionally the BeanAdapter can observe changes in bound properties as described in section 7.4 of the Bean specification. The bean then must provide support for listening on properties as described in section 7.4 of this specification. You can enable this feature by setting the constructor parameter observeChanges to true. If the adapter observes changes, the ValueModels returned by #getValueModel will fire value change events, i.e. PropertyChangeEvents for the property "value". Even if you ignore property changes, you can access the adapted property value via #getValue(). It's just that you won't be notified about changes.
In addition you can observe the bean's bound properties by registering PropertyChangeListeners with the bean using #addBeanPropertyChangeListener. These listeners will be removed from the old bean before the bean changes and will be re-added after the new bean has been set. Therefore these listeners will be notified about changes only if the current bean changes a property. They won't be notified if the bean changes - and in turn the property value. If you want to observes property changes caused by bean changes too, register with the adapting ValueModel as returned by #getValueModel(String).
The BeanAdapter provides two access styles to the target bean that holds the adapted property: you can specify a bean directly, or you can use a bean channel to access the bean indirectly. In the latter case you specify a ValueModel that holds the bean that in turn holds the adapted properties.
If the adapted bean is null the BeanAdapter can neither read nor set a value. In this case #getValue returns null and #setValue will silently ignore the new value.
This adapter throws three PropertyChangeEvents if the bean changes: beforeBean, bean and afterBean. This is useful when sharing a bean channel and you must perform an operation before or after other listeners handle a bean change. Since you cannot rely on the order listeners will be notified, only the beforeBean and afterBean events are guaranteed to be fired before and after the bean change is fired. Note that #getBean() returns the new bean before any of these three PropertyChangeEvents is fired. Therefore listeners that handle these events must use the event's old and new value to determine the old and new bean. The order of events fired during a bean change is:
1. this adapter's bean channel fires a value change,
2. this adapter fires a beforeBean change,
3. this adapter fires the bean change,
4. this adapter fires an afterBean change.
Unused BeanAdapters that observe changes have a PropertyChangeListener registered with the target bean if the bean is not null. It is recommended to remove this listener by invoking #release if the observed bean lives much longer than the adapter. After #release has been called you cannot use the BeanAdapter instance any longer. As an alternative you can use event listener lists that implement references with WeakReference.
Constraints: If property changes shall be observed, the bean class must support bound properties, i. e. it must provide the following pair of methods for registration of multicast property change event listeners:
```
 public void addPropertyChangeListener(PropertyChangeListener x); public void removePropertyChangeListener(PropertyChangeListener x); 
```
PropertyAdapter vs. BeanAdapter vs. PresentationModel
Basically the BeanAdapter does for multiple properties what the {@link net.helipilot50.stocktrade.displayproject.binding.beans.PropertyAdapter} does for a single bean property. If you adapt multiple properties of the same bean, you better use the BeanAdapter. It registers a single PropertyChangeListener with the bean, where multiple PropertyAdapters would register multiple listeners. If you adapt bean properties for an editor, you will typically use the {@link net.helipilot50.stocktrade.displayproject.binding.PresentationModel}. The PresentationModel is more powerful than the BeanAdapter. It adds support for buffered models, and provides an extensible mechanism for observing the change state of the bean and related objects.
Basic Examples:
```
 // Direct access, ignores changes Address address = new Address() BeanAdapter adapter = new BeanAdapter(address); adapter.setValue("street", "Broadway"); System.out.println(address.getStreet());        // Prints "Broadway" address.setStreet("Franz-Josef-Str."); System.out.println(adapter.getValue("street")); // Prints "Franz-Josef-Str." //Direct access, observes changes BeanAdapter adapter = new BeanAdapter(address, true); // Indirect access, ignores changes ValueHolder addressHolder = new ValueHolder(address1); BeanAdapter adapter = new BeanAdapter(addressHolder); adapter.setValue("street", "Broadway");         // Sets the street in address1 System.out.println(address1.getStreet());       // Prints "Broadway" adapter.setBean(address2); adapter.setValue("street", "Robert-Koch-Str."); // Sets the street in address2 System.out.println(address2.getStreet());       // Prints "Robert-Koch-Str." // Indirect access, observes changes ValueHolder addressHolder = new ValueHolder(); BeanAdapter adapter = new BeanAdapter(addressHolder, true); addressHolder.setValue(address1); address1.setStreet("Broadway"); System.out.println(adapter.getValue("street")); // Prints "Broadway" // Access through ValueModels Address address = new Address(); BeanAdapter adapter = new BeanAdapter(address); ValueModel streetModel = adapter.getValueModel("street"); ValueModel cityModel   = adapter.getValueModel("city"); streetModel.setValue("Broadway"); System.out.println(address.getStreet());        // Prints "Broadway" address.setCity("Hamburg"); System.out.println(cityModel.getValue());       // Prints "Hamburg" 
```
Adapter Chain Example:
Builds an adapter chain from a domain model to the presentation layer.
```
 Country country = new Country(); country.setName("Germany"); country.setEuMember(true); BeanAdapter countryAdapter = new BeanAdapter(country, true); JTextField nameField = new JTextField(); nameField.setDocument(new DocumentAdapter( countryAdapter.getValueModel("name"))); JCheckBox euMemberBox = new JCheckBox("Is EU Member"); euMemberBox.setModel(new ToggleButtonAdapter( countryAdapter.getValueModel("euMember"))); // Using factory methods JTextField nameField   = Factory.createTextField(country, "name"); JCheckBox  euMemberBox = Factory.createCheckBox (country, "euMember"); euMemberBox.setText("Is EU Member"); 
```
are performed in the event dispatch thread. In case the adapted bean is changed in a thread other than the event dispatch thread, such a feature would help complying with Swing's single thread rule. The feature could be implemented by an extended PropertyChangeSupport.
PropertyChangeEvents. This affects the classes PropertyAdapter, BeanAdapter, and PresentationModel. Basically the PropertyAdapter and the BeanAdapter's internal SimplePropertyAdapter's shall be able to optionally self-fire a PropertyChangeEvent in case the bean does not. There are several downsides with self-firing events compared to bound bean properties. See Issue 49 for more information about the downsides.
The observeChanges constructor parameter shall be replaced by a more fine-grained choice to not observe (former observeChanges=false), to observe bound properties (former observeChanges=true), and a new setting for self-firing PropertyChangeEvents if a value is set. The latter case may be further splitted up to specify how the self-fired PropertyChangeEvent is created:
1. oldValue=null, newValue=null
2. oldValue=null, newValue=the value set
3. oldValue=value read before the set, newValue=the value set
4. oldValue=value read before the set, newValue=value read after the set
@author Karsten Lentzsch @version $Revision: 1.26 $ @see net.helipilot50.stocktrade.displayproject.binding.beans.PropertyAdapter @see ValueModel @see ValueModel#getValue() @see ValueModel#setValue(Object) @see PropertyChangeEvent @see PropertyChangeListener @see java.beans.Introspector @see java.beans.BeanInfo @see PropertyDescriptor Copyright (c) 2002-2005 JGoodies Karsten Lentzsch. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: o Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. o Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. o Neither the name of JGoodies Karsten Lentzsch nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
org.apache.pivot.beans.BeanAdapter
Exposes Java bean properties of an object via the {@link Map}interface. A call to {@link Map#get(Object)} invokes the getter forthe corresponding property, and a call to {@link Map#put(Object,Object)} invokes the property's setter.
Properties may provide multiple setters; the appropriate setter to invoke is determined by the type of the value being set. If the value is null, the return type of the getter method is used.
Getter methods must be named "getProperty" where "property" is the property name. If there is no "get" method, then an "isProperty" method can also be used. Setter methods (if present) must be named "setProperty".
Getter and setter methods are checked before straight fields named "property" in order to support proper data encapsulation. And only public and non-static methods and fields can be accessed.
org.jboss.xb.spi.BeanAdapter
BeanAdapter. @author Adrian Brock @version $Revision: 1.1 $

Examples of org.apache.pivot.beans.BeanAdapter

        } catch (SerializationException e) {
            e.printStackTrace();
        }


        EnumBean enumBean = new EnumBean();
        BeanAdapter ba = new BeanAdapter(enumBean);


        ba.put("orientationField", Orientation.HORIZONTAL);
        dumpField(enumBean, ba);
        ba.put("orientationField", "vertical");
        dumpField(enumBean, ba);


        ba.put("orientation", Orientation.HORIZONTAL);
        dumpSetter(enumBean, ba);
        ba.put("orientation", Orientation.VERTICAL);
        dumpSetter(enumBean, ba);
        ba.put("orientation", null);
        dumpSetter(enumBean, ba);


        // Force an error to check the IllegalArgumentException message
        // ba.put("orientation", Vote.APPROVE);
    }

View Full Code Here

Examples of org.jboss.xb.spi.BeanAdapter

   public void handle(PropertyInfo propertyInfo, TypeInfo propertyType, Object parent, Object child, QName qName)
   {
      if(trace)
         log.trace("handle entry " + qName + ", property=" + propertyInfo.getName() + ", parent=" + parent + ", child=" + child);
      
      BeanAdapter beanAdapter = (BeanAdapter) parent;
      
      Map<Object, Object> m = null;
      if(mapFactory == null)
      {
         // it's wrapped, so the parent expected to be a map
         m = (Map<Object, Object>) beanAdapter.getValue();
      }
      else
      {
         try
         {
            if (propertyInfo.getGetter() != null)
               m = (Map<Object, Object>) beanAdapter.get(propertyInfo);
         }
         catch (Throwable t)
         {
            throw new RuntimeException("QName " + qName + " error getting map property " + propertyInfo.getName()
                  + " for " + BuilderUtil.toDebugString(parent), t);
         }


         // No map so create one
         if (m == null)
         {
            try
            {
               m = mapFactory.createMap();
            }
            catch (Throwable t)
            {
               throw new RuntimeException("QName " + qName + " error creating map: " + propertyType.getName(), t);
            }


            try
            {
               beanAdapter.set(propertyInfo, m);
            }
            catch (Throwable t)
            {
               throw new RuntimeException("QName " + qName + " error setting map property " + propertyInfo.getName()
                     + " for " + BuilderUtil.toDebugString(parent) + " with value " + BuilderUtil.toDebugString(m), t);

View Full Code Here

0 1 2 3 4 5

TOP

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.