GrepCode: org.springframework.beans.PropertyValue (.java) - Class

Maven-Central
/
org.springframework / spring-beans
/
2.5.6

3.1.1.RELEASE
3.0.6.RELEASE
3.0.5.RELEASE
3.0.4.RELEASE
3.0.3.RELEASE
3.0.2.RELEASE
3.0.1.RELEASE
3.0.0.RELEASE
2.5.6
2.5.6.SEC03
2.5.6.SEC02
2.5.5
2.5.4
2.5.3
2.5.2
2.5.1
1.2.1
/
org.springframework.beans.PropertyValue
Find Usages
Diff
Raw
Download
HTML Widget
Stack Overflow Questions
1
  /*
2
   * Copyright 2002-2007 the original author or authors.
3
   *
4
   * Licensed under the Apache License, Version 2.0 (the "License");
5
   * you may not use this file except in compliance with the License.
6
   * You may obtain a copy of the License at
7
   *
8
   *      http://www.apache.org/licenses/LICENSE-2.0
9
   *
10
  * Unless required by applicable law or agreed to in writing, software
11
  * distributed under the License is distributed on an "AS IS" BASIS,
12
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
  * See the License for the specific language governing permissions and
14
  * limitations under the License.
15
  */
16
 
17
 package org.springframework.beans;
18
 
19
 import java.beans.PropertyDescriptor;
20
 import java.io.Serializable;
21
 
22
 import org.springframework.util.Assert;
23
 import org.springframework.util.ObjectUtils;

 Object to hold information and value for an individual bean property.
 Using an object here, rather than just storing all properties in
 a map keyed by property name, allows for more flexibility, and the
 ability to handle indexed properties etc in an optimized way.

 Note that the value doesn't need to be the final required type:
 A BeanWrapper implementation should handle any necessary conversion,
 as this object doesn't know anything about the objects it will be applied to.

 
 Author(s):Rod JohnsonRob HarropJuergen Hoeller Since:13 May 2001 See also:PropertyValuesBeanWrapper
41
 
42
 public class PropertyValue extends BeanMetadataAttributeAccessor implements Serializable {
43
 
44
 	private final String name;
45
 
46
 	private final Object value;
47
 
48
 	private Object source;
49
 
50
 	private boolean converted = false;
51
 
52
 	private Object convertedValue;

	
Package-visible field that indicates whether conversion is necessary
54
 
55
 	volatile Boolean conversionNecessary;

	
Package-visible field for caching the resolved property path tokens
57
 
58
 	volatile Object resolvedTokens;

	
Package-visible field for caching the resolved PropertyDescriptor
60
 
61
 	volatile PropertyDescriptor resolvedDescriptor;


	
 Create a new PropertyValue instance.
 
 Parameters:name the name of the property (never null)value the value of the property (possibly before type conversion)
68
 
69
 	public PropertyValue(String name, Object value) {
70
 		this.name = name;
71
 		this.value = value;
72
 	}

	
 Copy constructor.
 
 Parameters:original the PropertyValue to copy (never null)
77
 
78
 	public PropertyValue(PropertyValue original) {
79
 		Assert.notNull(original, "Original must not be null");
80
 		this.name = original.getName();
81
 		this.value = original.getValue();
82
 		this.source = original.getSource();
83
 		this.conversionNecessary = original.conversionNecessary;
84
 		this.resolvedTokens = original.resolvedTokens;
85
 		this.resolvedDescriptor = original.resolvedDescriptor;
86
 		copyAttributesFrom(original);
87
 	}

	
 Constructor that exposes a new value for an original value holder.
 The original holder will be exposed as source of the new holder.
 
 Parameters:original the PropertyValue to link to (never null)newValue the new value to apply
94
 
95
 	public PropertyValue(PropertyValue original, Object newValue) {
96
 		Assert.notNull(original, "Original must not be null");
97
 		this.name = original.getName();
98
 		this.value = newValue;
99
 		this.source = original;
100
		this.conversionNecessary = original.conversionNecessary;
101
		this.resolvedTokens = original.resolvedTokens;
102
		this.resolvedDescriptor = original.resolvedDescriptor;
103
		copyAttributesFrom(original);
104
	}


	
 Return the name of the property.
 
109
110
	public String getName() {
111
		return this.name;
112
	}

	
 Return the value of the property.
 Note that type conversion will not have occurred here.
 It is the responsibility of the BeanWrapper implementation to
 perform type conversion.
 
119
120
	public Object getValue() {
121
		return this.value;
122
	}

	
 Return the original PropertyValue instance for this value holder.
 
 Returns:the original PropertyValue (either a source of this
 value holder or this value holder itself).
128
129
	public PropertyValue getOriginalPropertyValue() {
130
		PropertyValue original = this;
131
		while (original.source instanceof PropertyValue && original.source != original) {
132
			original = (PropertyValue) original.source;
133
		}
134
		return original;
135
	}

	
 Return whether this holder contains a converted value already (true),
 or whether the value still needs to be converted (false).
 
140
141
	public synchronized boolean isConverted() {
142
		return this.converted;
143
	}

	
 Set the converted value of the constructor argument,
 after processed type conversion.
 
148
149
	public synchronized void setConvertedValue(Object value) {
150
		this.converted = true;
151
		this.convertedValue = value;
152
	}

	
 Return the converted value of the constructor argument,
 after processed type conversion.
 
157
158
	public synchronized Object getConvertedValue() {
159
		return this.convertedValue;
160
	}
161
162
163
	public boolean equals(Object other) {
164
		if (this == other) {
165
			return true;
166
		}
167
		if (!(other instanceof PropertyValue)) {
168
			return false;
169
		}
170
		PropertyValue otherPv = (PropertyValue) other;
171
		return (this.name.equals(otherPv.name) &&
172
				ObjectUtils.nullSafeEquals(this.value, otherPv.value) &&
173
				ObjectUtils.nullSafeEquals(this.source, otherPv.source));
174
	}
175
176
	public int hashCode() {
177
		return this.name.hashCode() * 29 + ObjectUtils.nullSafeHashCode(this.value);
178
	}
179
180
	public String toString() {
181
		return "bean property '" + this.name + "'";
182
	}
183
184
}