analytics/webcontent/dojo16/dojox/wire/DataWire.js

/*
	Copyright (c) 2004-2012, The Dojo Foundation All Rights Reserved.
	Available via Academic Free License >= 2.1 OR the modified BSD license.
	see: http://dojotoolkit.org/license for details
*/


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

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

dojo.declare("dojox.wire.DataWire", dojox.wire.Wire, {
	//	summary:
	//		A Wire for item attributes of data stores
	//	description:
	//		This class accesses item attributes of data stores with a dotted
	//		notation of attribute names specified to 'attribute' property,
	//		using data APIs of a data store specified to 'dataStore' property.
	//		The root object for this class must be an item of the data store.
	//		Intermediate attribute names in the dotted notation specify
	//		attributes for child items, which are used for repeated calls to
	//		data APIs until reached to a descendant attribute.
	//		Attribute names may have an array index, such as "a[0]", to
	//		identify an array element of the attribute value.
	
	_wireClass: "dojox.wire.DataWire",

	constructor: function(/*Object*/args){
		//	summary:
		//		Initialize properties
		//	description:
		//		If 'dataStore' property is not specified, but 'parent' property
		//		is specified, 'dataStore' property is copied from the parent.
		//	args:
		//		Arguments to initialize properties
		//		dataStore:
		//			A data store
		//		attribute:
		//			A dotted notation to a descendant attribute
		if(!this.dataStore && this.parent){
			this.dataStore = this.parent.dataStore;
		}
	},
	_getValue: function(/*Object*/object){
		//	summary:
		//		Return an attribute value of an item
		//	description:
		//		This method uses a root item passed in 'object' argument and
		//		'attribute' property to call getValue() method of
		//		'dataStore'.
		//		If an attribute name have an array suffix ("[]"), getValues()
		//		method is called, instead.
		//		If an index is specified in the array suffix, an array element
		//		for the index is returned, instead of the array itself.
		//	object:
		//		A root item
		//	returns:
		//		A value found, otherwise 'undefined'
		if(!object || !this.attribute || !this.dataStore){
			return object; //Object
		}

		var value = object;
		var list = this.attribute.split('.');
		for(var i in list){
			value = this._getAttributeValue(value, list[i]);
			if(!value){
				return undefined; //undefined
			}
		}
		return value; //anything
	},

	_setValue: function(/*Object*/object, /*anything*/value){
		//	summary:
		//		Set an attribute value to an item
		//	description:
		//		This method uses a root item passed in 'object' argument and
		//		'attribute' property to identify an item.
		//		Then, setValue() method of 'dataStore' is called with a leaf
		//		attribute name and 'value' argument.
		//		If an attribute name have an array suffix ("[]"), setValues()
		//		method is called, instead.
		//		If an index is specified in the array suffix, an array element
		//		for the index is set to 'value', instead of the array itself.
		//	object:
		//		A root item
		//	value:
		//		A value to set
		//	returns:
		//		'object', or 'undefined' for invalid attribute
		if(!object || !this.attribute || !this.dataStore){
			return object; //Object
		}

		var item = object;
		var list = this.attribute.split('.');
		var last = list.length - 1;
		for(var i = 0; i < last; i++){
			item = this._getAttributeValue(item, list[i]);
			if(!item){
				return undefined; //undefined
			}
		}
		this._setAttributeValue(item, list[last], value);
		return object; //Object
	},

	_getAttributeValue: function(/*Object*/item, /*String*/attribute){
		//	summary:
		//		Return an attribute value of an item
		//	description:
		//		This method uses an item passed in 'item' argument and
		//		'attribute' argument to call getValue() method of 'dataStore'.
		//		If an attribute name have an array suffix ("[]"), getValues()
		//		method is called, instead.
		//		If an index is specified in the array suffix, an array element
		//		for the index is returned, instead of the array itself.
		//	item:
		//		An item
		//	attribute
		//		An attribute name
		//	returns:
		//		A value found, otherwise 'undefined'
		var value = undefined;
		var i1 = attribute.indexOf('[');
		if(i1 >= 0){
			var i2 = attribute.indexOf(']');
			var index = attribute.substring(i1 + 1, i2);
			attribute = attribute.substring(0, i1);
			var array = this.dataStore.getValues(item, attribute);
			if(array){
				if(!index){ // return array for "attribute[]"
					value = array;
				}else{
					value = array[index];
				}
			}
		}else{
			value = this.dataStore.getValue(item, attribute);
		}
		return value; //anything
	},

	_setAttributeValue: function(/*Object*/item, /*String*/attribute, /*anything*/value){
		//	summary:
		//		Set an attribute value to an item
		//	description:
		//		This method uses an item passed in 'item' argument and
		//		'attribute' argument to call setValue() method of 'dataStore'
		//		with 'value' argument.
		//		If an attribute name have an array suffix ("[]"), setValues()
		//		method is called, instead.
		//		If an index is specified in the array suffix, an array element
		//		for the index is set to 'value', instead of the array itself.
		//	item:
		//		An item
		//	attribute:
		//		An attribute name
		//	value:
		//		A value to set
		var i1 = attribute.indexOf('[');
		if(i1 >= 0){
			var i2 = attribute.indexOf(']');
			var index = attribute.substring(i1 + 1, i2);
			attribute = attribute.substring(0, i1);
			var array = null;
			if(!index){ // replace whole array for "attribute[]"
				array = value;
			}else{
				array = this.dataStore.getValues(item, attribute);
				if(!array){
					array = [];
				}
				array[index] = value;
			}
			this.dataStore.setValues(item, attribute, array);
		}else{
			this.dataStore.setValue(item, attribute, value);
		}
	}
});

}