org.springframework.beans
Class MutablePropertyValues

java.lang.Object
  org.springframework.beans.MutablePropertyValues

All Implemented Interfaces:

PropertyValues

Direct Known Subclasses:

ServletRequestParameterPropertyValues

public class MutablePropertyValues

extends java.lang.Object

implements PropertyValues

Default implementation of the PropertyValues interface. Allows simple manipulation of properties, and provides constructors to support deep copy and construction from a Map.

Since:

13 May 2001

Version:

$Id: MutablePropertyValues.java,v 1.6 2004/03/18 02:46:12 trisberg Exp $

Author:

Rod Johnson

Constructor Summary

MutablePropertyValues()
Creates a new empty MutablePropertyValues object.

MutablePropertyValues(java.util.Map map)
Construct a new PropertyValues object from a Map.

MutablePropertyValues(PropertyValues other)
Deep copy constructor.

Method Summary

void	addPropertyValue(PropertyValue pv) Add a PropertyValue object, replacing any existing one for the respective property.
void	addPropertyValue(java.lang.String propertyName, java.lang.Object propertyValue) Overloaded version of addPropertyValue that takes a property name and a property value.
PropertyValues	changesSince(PropertyValues old) Return the changes since the previous PropertyValues.
boolean	contains(java.lang.String propertyName) Is there a property value for this property?
PropertyValue	getPropertyValue(java.lang.String propertyName) Return the property value with the given name.
PropertyValue[]	getPropertyValues() Return an array of the PropertyValue objects held in this object.
void	removePropertyValue(PropertyValue pv) Remove the given PropertyValue, if contained.
void	removePropertyValue(java.lang.String propertyName) Overloaded version of removePropertyValue that takes a property name.
void	setPropertyValueAt(PropertyValue pv, int i) Modify a PropertyValue object held in this object.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MutablePropertyValues

public MutablePropertyValues()

Creates a new empty MutablePropertyValues object. Property values can be added with the addPropertyValue methods.

See Also:

addPropertyValue(PropertyValue), addPropertyValue(String, Object)

MutablePropertyValues

public MutablePropertyValues(PropertyValues other)

Deep copy constructor. Guarantees PropertyValue references are independent, although it can't deep copy objects currently referenced by individual PropertyValue objects

MutablePropertyValues

public MutablePropertyValues(java.util.Map map)

Construct a new PropertyValues object from a Map.

Parameters:

map - Map with property values keyed by property name, which must be a String

Method Detail

addPropertyValue

public void addPropertyValue(PropertyValue pv)

Add a PropertyValue object, replacing any existing one for the respective property.

Parameters:

pv - PropertyValue object to add

addPropertyValue

public void addPropertyValue(java.lang.String propertyName,
                             java.lang.Object propertyValue)

Overloaded version of addPropertyValue that takes a property name and a property value.

Parameters:

propertyName - name of the property

propertyValue - value of the property

See Also:

addPropertyValue(PropertyValue)

removePropertyValue

public void removePropertyValue(PropertyValue pv)

Remove the given PropertyValue, if contained.

Parameters:

pv - the PropertyValue to remove

removePropertyValue

public void removePropertyValue(java.lang.String propertyName)

Overloaded version of removePropertyValue that takes a property name.

Parameters:

propertyName - name of the property

See Also:

removePropertyValue(PropertyValue)

setPropertyValueAt

public void setPropertyValueAt(PropertyValue pv,
                               int i)

Modify a PropertyValue object held in this object. Indexed from 0.

getPropertyValues

public PropertyValue[] getPropertyValues()

Description copied from interface: PropertyValues

Return an array of the PropertyValue objects held in this object.

Specified by:

getPropertyValues in interface PropertyValues

Returns:

an array of the PropertyValue objects held in this object.

getPropertyValue

public PropertyValue getPropertyValue(java.lang.String propertyName)

Description copied from interface: PropertyValues

Return the property value with the given name.

Specified by:

getPropertyValue in interface PropertyValues

Parameters:

propertyName - name to search for

Returns:

pv or null

contains

public boolean contains(java.lang.String propertyName)

Description copied from interface: PropertyValues

Is there a property value for this property?

Specified by:

contains in interface PropertyValues

Parameters:

propertyName - name of the property we're interested in

Returns:

whether there is a property value for this property

changesSince

public PropertyValues changesSince(PropertyValues old)

Description copied from interface: PropertyValues

Return the changes since the previous PropertyValues. Subclasses should also override equals.

Specified by:

changesSince in interface PropertyValues

Parameters:

old - old property values

Returns:

PropertyValues updated or new properties. Return the empty PropertyValues if there are no changes.

toString

public java.lang.String toString()