01: /*
02: * @(#)ValidationObject.java 1.32 03/01/23
03: *
04: * Copyright 2002 - 2005 JIDE Software Inc. All rights reserved.
05: */
06:
07: package com.jidesoft.validation;
08:
09: import java.util.EventObject;
10:
11: /**
12: * ValidationObject is an object containing the information that needed by Validator.
13: * The base class has three things - source, new value and old value.
14: * <p/>
15: * The source is the object who has the Validator. In the case of cell
16: * editor, cell editor will be the source. In the case of table, source will be
17: * the table.
18: * <p/>
19: * Normally ValidationObject are accompanied by the old and new value.
20: * If the new value is a primitive
21: * type (such as int or boolean) it must be wrapped as the
22: * corresponding java.lang.* Object type (such as Integer or Boolean).
23: * <p/>
24: * Null values may be provided for the old and the new values if their
25: * true values are not known.
26: * <p/>
27: * Users can extend this class to create their own ValidationObject to provide
28: * additional information that needed by Validator. For example, TableValidationObject
29: * extends ValidationObject to add row and column information.
30: */
31:
32: public class ValidationObject extends EventObject {
33:
34: /**
35: * New value. May be null if not known.
36: */
37: private Object _newValue;
38:
39: /**
40: * Previous value. May be null if not known.
41: */
42: private Object _oldValue;
43:
44: /**
45: * Constructs a new <code>ValidationObject</code>.
46: *
47: * @param source The source that sends this ValidationObject.
48: * @param oldValue The old value.
49: * @param newValue The new value.
50: */
51: public ValidationObject(Object source, Object oldValue,
52: Object newValue) {
53: super (source);
54: _newValue = newValue;
55: _oldValue = oldValue;
56: }
57:
58: /**
59: * Sets the new value, expressed as an Object.
60: *
61: * @return The new value, expressed as an Object.
62: */
63: public Object getNewValue() {
64: return _newValue;
65: }
66:
67: /**
68: * Gets the old value, expressed as an Object.
69: *
70: * @return The old value, expressed as an Object.
71: */
72: public Object getOldValue() {
73: return _oldValue;
74: }
75:
76: @Override
77: public String toString() {
78: String properties = " source=" + getSource() + " oldValue="
79: + getOldValue() + " newValue=" + getNewValue() + " ";
80: return getClass().getName() + "[" + properties + "]";
81: }
82: }
|