wp/nwyj/.svn/pristine/79/794e7fde171f16404d894e748b0202deec387a56.svn-base

if (!dojo._hasResource["dojox.wire.Wire"]) { // _hasResource checks added by
												// build. Do not use
												// _hasResource directly in your
												// code.
	dojo._hasResource["dojox.wire.Wire"] = true;
	dojo.provide("dojox.wire.Wire");

	dojo.require("dojox.wire._base");

	dojo.declare("dojox.wire.Wire", null, {
		// summary:
		// A default and base Wire to access an object property
		// description:
		// This class accesses a property of an object with a dotted notation
		// specified to 'property' property, such as "a.b.c", which identifies
		// a descendant property, "object.a.b.c".
		// Property names in the dotted notation may have an array index, such
		// as "a[0]", to identify an array element, literally, "object.a[0]".
		// When a notation start with an array index, such as "[0].a", it
		// specifies an array element of the root object (array),
		// "object[0].a".
		// This class also serves as a base class for other Wire classes,
		// preparing a root object and converting a return value, so that
		// sub-classes just can implement _getValue() and _setValue() called
		// from getValue() and setValue() implemented by this calss.

		_wireClass : "dojox.wire.Wire",

		constructor : function(/* Object */args) {
			// summary:
			// Initialize properties
			// description:
			// If 'converter' property is specified and is a string for
			// a converter class, an instanceof the converter class is
			// created.
			// args:
			// Arguments to initialize properties
			// object:
			// A root object (or another Wire to access a root object)
			// property:
			// A dotted notation to a descendant property
			// type:
			// A type of the return value (for the source Wire)
			// converter:
			// A converter object (or class name) to convert the return
			// value (for the source Wire)
			dojo.mixin(this, args);

			if (this.converter) {
				if (dojo.isString(this.converter)) {
					// First check the object tree for it. Might be defined
					// variable
					// name/global function (like a jsId, or just a function
					// name).
					var convertObject = dojo.getObject(this.converter);
					if (dojo.isFunction(convertObject)) {
						// We need to see if this is a pure function or an
						// object constructor...
						try {
							var testObj = new convertObject();
							if (testObj && !dojo.isFunction(testObj["convert"])) {
								// Looks like a 'pure' function...
								this.converter = {
									convert : convertObject
								};
							} else {
								this.converter = testObj;
							}
						} catch (e) {
							// Do if this fails.
						}
					} else if (dojo.isObject(convertObject)) {
						// It's an object, like a jsId ... see if it has a
						// convert function
						if (dojo.isFunction(convertObject["convert"])) {
							this.converter = convertObject;
						}
					}

					// No object with that name (Converter is still a string),
					// then look for a class that needs to be dynamically
					// loaded...
					if (dojo.isString(this.converter)) {
						var converterClass = dojox.wire
								._getClass(this.converter);
						if (converterClass) {
							this.converter = new converterClass();
						} else {
							this.converter = undefined;
						}
					}
				} else if (dojo.isFunction(this.converter)) {
					this.converter = {
						convert : this.converter
					};
				}
			}
		},

		getValue : function(/* Object||Array */defaultObject) {
			// summary:
			// Return a value of an object
			// description:
			// This method first determins a root object as follows:
			// 1. If 'object' property specified,
			// 1.1 If 'object' is a Wire, its getValue() method is called to
			// obtain a root object.
			// 1.2 Otherwise, use 'object' as a root object.
			// 2. Otherwise, use 'defaultObject' argument.
			// 3. If 'property' is specified, it is used to get a property
			// value.
			// Then, if a sub-class implements _getValue() method, it is
			// called with the root object to get the return value.
			// Otherwise, the root object (typically, a property valye) is
			// used for the return value.
			// Finally, if 'type' property is specified, the return value is
			// converted to the specified primitive type ("string", "number",
			// "boolean" and "array").
			// If 'converter' property is specified, its convert() method is
			// called to convert the value.
			// defaultObject:
			// A default root object
			// returns:
			// A value found
			var object = undefined;
			if (dojox.wire.isWire(this.object)) {
				object = this.object.getValue(defaultObject);
			} else {
				object = (this.object || defaultObject);
			}

			if (this.property) {
				var list = this.property.split('.');
				for (var i in list) {
					if (!object) {
						return object; // anything (null, undefined, etc)
					}
					object = this._getPropertyValue(object, list[i]);
				}
			}

			var value = undefined;
			if (this._getValue) {
				value = this._getValue(object);
			} else {
				value = object;
			}

			if (value) {
				if (this.type) {
					if (this.type == "string") {
						value = value.toString();
					} else if (this.type == "number") {
						value = parseInt(value);
					} else if (this.type == "boolean") {
						value = (value != "false");
					} else if (this.type == "array") {
						if (!dojo.isArray(value)) {
							value = [value];
						}
					}
				}
				if (this.converter && this.converter.convert) {
					value = this.converter.convert(value, this); // optional
																	// "this"
																	// context
				}
			}
			return value; // anything
		},

		setValue : function(/* anything */value, /* Object||Array */defaultObject) {
			// summary:
			// Set a value to an object
			// description:
			// This method first determins a root object as follows:
			// 1. If 'object' property specified,
			// 1.1 If 'object' is a Wire, its getValue() method is called to
			// obtain a root object.
			// 1.2 Otherwise, use 'object' as a root object.
			// 2. Otherwise, use 'defaultObject' argument.
			// 3. If 'property' is specified, it is used to get a property
			// value.
			// Then, if a sub-class implements _setValue() method, it is
			// called with the root object and 'value' argument to set
			// the value.
			// Otherwise, 'value' is set to a property specified with
			// 'property' property.
			// If the root object is undefined and 'object' property is a Wire
			// and a new object is created and returned by _setValue() it is
			// set through 'object' (setValue() method).
			// value:
			// A value to set
			// defaultObject:
			// A default root object
			var object = undefined;
			if (dojox.wire.isWire(this.object)) {
				object = this.object.getValue(defaultObject);
			} else {
				object = (this.object || defaultObject);
			}

			var property = undefined;
			if (this.property) {
				if (!object) {
					if (dojox.wire.isWire(this.object)) {
						object = {};
						this.object.setValue(object, defaultObject);
					} else {
						throw new Error(this._wireClass
								+ ".setValue(): invalid object");
					}
				}
				var list = this.property.split('.');
				var last = list.length - 1;
				for (var i = 0; i < last; i++) {
					var p = list[i];
					var o = this._getPropertyValue(object, p);
					if (!o) {
						o = {};
						this._setPropertyValue(object, p, o);
					}
					object = o;
				}
				property = list[last];
			}

			if (this._setValue) {
				if (property) {
					var o = this._getPropertyValue(object, property);
					if (!o) {
						o = {};
						this._setPropertyValue(object, property, o);
					}
					object = o;
				}
				var newObject = this._setValue(object, value);
				if (!object && newObject) {
					if (dojox.wire.isWire(this.object)) {
						this.object.setValue(newObject, defaultObject);
					} else {
						throw new Error(this._wireClass
								+ ".setValue(): invalid object");
					}
				}
			} else {
				if (property) {
					this._setPropertyValue(object, property, value);
				} else {
					if (dojox.wire.isWire(this.object)) {
						this.object.setValue(value, defaultObject);
					} else {
						throw new Error(this._wireClass
								+ ".setValue(): invalid property");
					}
				}
			}
		},

		_getPropertyValue : function(/* Object||Array */object, /* String */
				property) {
			// summary:
			// Return a property value of an object
			// description:
			// A value for 'property' of 'object' is returned.
			// If 'property' ends with an array index, it is used to indentify
			// an element of an array property.
			// If 'object' implements getPropertyValue(), it is called with
			// 'property' to obtain the property value.
			// If 'object' implements a getter for the property, it is called
			// to obtain the property value.
			// object:
			// A default root object
			// property:
			// A property name
			// returns:
			// A value found, otherwise 'undefined'
			var value = undefined;
			var i1 = property.indexOf('[');
			if (i1 >= 0) {
				var i2 = property.indexOf(']');
				var index = property.substring(i1 + 1, i2);
				var array = null;
				if (i1 === 0) { // object is array
					array = object;
				} else {
					property = property.substring(0, i1);
					array = this._getPropertyValue(object, property);
					if (array && !dojo.isArray(array)) {
						array = [array];
					}
				}
				if (array) {
					value = array[index];
				}
			} else if (object.getPropertyValue) {
				value = object.getPropertyValue(property);
			} else {
				var getter = "get" + property.charAt(0).toUpperCase()
						+ property.substring(1);
				if (object[getter]) {
					value = object[getter]();
				} else {
					value = object[property];
				}
			}
			return value; // anything
		},

		_setPropertyValue : function(/* Object||Array */object, /* String */
				property, /* anything */value) {
			// summary:
			// Set a property value to an object
			// description:
			// 'value' is set to 'property' of 'object'.
			// If 'property' ends with an array index, it is used to indentify
			// an element of an array property to set the value.
			// If 'object' implements setPropertyValue(), it is called with
			// 'property' and 'value' to set the property value.
			// If 'object' implements a setter for the property, it is called
			// with 'value' to set the property value.
			// object:
			// An object
			// property:
			// A property name
			// value:
			// A value to set
			var i1 = property.indexOf('[');
			if (i1 >= 0) {
				var i2 = property.indexOf(']');
				var index = property.substring(i1 + 1, i2);
				var array = null;
				if (i1 === 0) { // object is array
					array = object;
				} else {
					property = property.substring(0, i1);
					array = this._getPropertyValue(object, property);
					if (!array) {
						array = [];
						this._setPropertyValue(object, property, array);
					}
				}
				array[index] = value;
			} else if (object.setPropertyValue) {
				object.setPropertyValue(property, value);
			} else {
				var setter = "set" + property.charAt(0).toUpperCase()
						+ property.substring(1);
				if (object[setter]) {
					object[setter](value);
				} else {
					object[property] = value;
				}
			}
		}
	});

}