+++ /dev/null
-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;
- }
- }
- }
-});
-
-}
projects / eow / blobdiff