Package org.springframework.beans
This package contains interfaces and classes for manipulating Java beans. It is used by most other Spring packages.
A BeanWrapper object may be used to set and get bean properties, singly or in bulk.
The classes in this package are discussed in Chapter 11 of Expert One-On-One J2EE Design and Development by Rod Johnson (Wrox, 2002).
Interface Summary Interface Description BeanInfoFactory Strategy interface for creatingBeanInfoinstances for Spring beans.BeanMetadataElement Interface to be implemented by bean metadata elements that carry a configuration source object.BeanWrapper The central interface of Spring's low-level JavaBeans infrastructure.ConfigurablePropertyAccessor Interface that encapsulates configuration methods for a PropertyAccessor.Mergeable Interface representing an object whose value set can be merged with that of a parent object.PropertyAccessor Common interface for classes that can access named properties (such as bean properties of an object or fields in an object) Serves as base interface forBeanWrapper.PropertyEditorRegistrar Interface for strategies that register customproperty editorswith aproperty editor registry.PropertyEditorRegistry Encapsulates methods for registering JavaBeansPropertyEditors.PropertyValues Holder containing one or morePropertyValueobjects, typically comprising one update for a specific target bean.TypeConverter Interface that defines type conversion methods.Class Summary Class Description AbstractNestablePropertyAccessor A basicConfigurablePropertyAccessorthat provides the necessary infrastructure for all typical use cases.AbstractNestablePropertyAccessor.PropertyHandler A handler for a specific property.AbstractNestablePropertyAccessor.PropertyTokenHolder Holder class used to store property tokens.AbstractPropertyAccessor Abstract implementation of thePropertyAccessorinterface.BeanMetadataAttribute Holder for a key-value style attribute that is part of a bean definition.BeanMetadataAttributeAccessor Extension ofAttributeAccessorSupport, holding attributes asBeanMetadataAttributeobjects in order to keep track of the definition source.BeanUtils Static convenience methods for JavaBeans: for instantiating beans, checking bean property types, copying bean properties, etc.BeanWrapperImpl DefaultBeanWrapperimplementation that should be sufficient for all typical use cases.CachedIntrospectionResults Internal class that caches JavaBeansPropertyDescriptorinformation for a Java class.DirectFieldAccessor ConfigurablePropertyAccessorimplementation that directly accesses instance fields.ExtendedBeanInfoFactory BeanInfoFactoryimplementation that evaluates whether bean classes have "non-standard" JavaBeans setter methods and are thus candidates for introspection by Spring's (package-visible)ExtendedBeanInfoimplementation.MutablePropertyValues Default implementation of thePropertyValuesinterface.PropertyAccessorFactory Simple factory facade for obtainingPropertyAccessorinstances, in particular forBeanWrapperinstances.PropertyAccessorUtils Utility methods for classes that perform bean property access according to thePropertyAccessorinterface.PropertyEditorRegistrySupport Base implementation of thePropertyEditorRegistryinterface.PropertyMatches Helper class for calculating property matches, according to a configurable distance.PropertyValue Object to hold information and value for an individual bean property.PropertyValuesEditor Editorfor aPropertyValuesobject.SimpleTypeConverter Simple implementation of theTypeConverterinterface that does not operate on a specific target object.TypeConverterSupport Base implementation of theTypeConverterinterface, using a package-private delegate.Exception Summary Exception Description BeanInstantiationException Exception thrown when instantiation of a bean failed.BeansException Abstract superclass for all exceptions thrown in the beans package and subpackages.ConversionNotSupportedException Exception thrown when no suitable editor or converter can be found for a bean property.FatalBeanException Thrown on an unrecoverable problem encountered in the beans packages or sub-packages, e.g.InvalidPropertyException Exception thrown when referring to an invalid bean property.MethodInvocationException Thrown when a bean property getter or setter method throws an exception, analogous to an InvocationTargetException.NotReadablePropertyException Exception thrown on an attempt to get the value of a property that isn't readable, because there's no getter method.NotWritablePropertyException Exception thrown on an attempt to set the value of a property that is not writable (typically because there is no setter method).NullValueInNestedPathException Exception thrown when navigation of a valid nested property path encounters a NullPointerException.PropertyAccessException Superclass for exceptions related to a property access, such as type mismatch or invocation target exception.PropertyBatchUpdateException Combined exception, composed of individual PropertyAccessException instances.TypeMismatchException Exception thrown on a type mismatch when trying to set a bean property.