a:35:{s:9:"#provides";s:23:"dojox.data.ServiceStore";s:9:"#resource";s:20:"data/ServiceStore.js";s:23:"dojox.data.ServiceStore";a:7:{s:4:"type";s:8:"Function";s:6:"chains";a:2:{s:9:"prototype";a:1:{i:0;s:104:"// lightweight without it, but if it is provided, the ServiceStore will use it.
	dojox.data.ClientFilter";}s:4:"call";a:1:{i:0;s:104:"// lightweight without it, but if it is provided, the ServiceStore will use it.
	dojox.data.ClientFilter";}}s:10:"parameters";a:1:{s:7:"options";a:2:{s:4:"type";s:7:"Keyword";s:7:"summary";s:1596:"arguments
The *schema* parameter
This is a schema object for this store. This should be JSON Schema format.

The *service* parameter
This is the service object that is used to retrieve lazy data and save results
The function should be directly callable with a single parameter of an object id to be loaded

The *idAttribute* parameter
Defaults to 'id'. The name of the attribute that holds an objects id.
This can be a preexisting id provided by the server.
If an ID isn't already provided when an object
is fetched or added to the store, the autoIdentity system
will generate an id for it and add it to the index.

The *estimateCountFactor* parameter
This parameter is used by the ServiceStore to estimate the total count. When
paging is indicated in a fetch and the response includes the full number of items
requested by the fetch's count parameter, then the total count will be estimated
to be estimateCountFactor multiplied by the provided count. If this is 1, then it is assumed that the server
does not support paging, and the response is the full set of items, where the
total count is equal to the numer of items returned. If the server does support
paging, an estimateCountFactor of 2 is a good value for estimating the total count
It is also possible to override _processResults if the server can provide an exact
total count.

The *syncMode* parameter
Setting this to true will set the store to using synchronous calls by default.
Sync calls return their data immediately from the calling function, so
callbacks are unnecessary. This will only work with a synchronous capable service.";}}s:6:"source";s:539:"			this.byId=this.fetchItemByIdentity;
			this._index = {};
			// if the advanced json parser is enabled, we can pass through object updates as onSet events
			if(options){
				dojo.mixin(this,options);
			}
			// We supply a default idAttribute for parser driven construction, but if no id attribute
			//	is supplied, it should be null so that auto identification takes place properly
			this.idAttribute = (options && options.idAttribute) || (this.schema && this.schema._idAttr);
			this.labelAttribute = this.labelAttribute || "label";";s:7:"summary";s:168:"ServiceStore constructor, instantiate a new ServiceStore
A ServiceStore can be configured from a JSON Schema. Queries are just
passed through to the underlying services";s:11:"description";s:1047:"ServiceStore can do client side caching and result set updating if
dojox.data.ClientFilter is loaded. Do this add:

	dojo.require("dojox.data.ClientFilter")
prior to loading the ServiceStore (ClientFilter must be loaded before ServiceStore).
To utilize client side filtering with a subclass, you can break queries into
client side and server side components by putting client side actions in
clientFilter property in fetch calls. For example you could override fetch:

	fetch: function(args){
		// do the sorting and paging on the client side
		args.clientFilter = {start:args.start, count: args.count, sort: args.sort};
		// args.query will be passed to the service object for the server side handling
		return this.inherited(arguments);
	}
When extending this class, if you would like to create lazy objects, you can follow
the example from dojox.data.tests.stores.ServiceStore:

	var lazyItem = {
		_loadObject: function(callback){
			this.name="loaded";
			delete this._loadObject;
			callback(this);
		}
	};
setup a byId alias to the api call";s:9:"classlike";b:1;}s:30:"dojox.data.ServiceStore.schema";a:2:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:35:"dojox.data.ServiceStore.idAttribute";a:3:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:8:"instance";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:32:"dojox.data.ServiceStore.syncMode";a:2:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:43:"dojox.data.ServiceStore.estimateCountFactor";a:2:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:33:"dojox.data.ServiceStore.getSchema";a:4:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:6:"source";s:23:"			return this.schema; ";s:7:"summary";s:0:"";}s:38:"dojox.data.ServiceStore.loadLazyValues";a:2:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:32:"dojox.data.ServiceStore.getValue";a:7:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:3:{s:4:"item";a:2:{s:4:"type";s:6:"Object";s:7:"summary";s:30:"The item to get the value from";}s:8:"property";a:2:{s:4:"type";s:6:"String";s:7:"summary";s:29:"property to look up value for";}s:12:"defaultValue";a:3:{s:8:"optional";b:1;s:4:"type";s:5:"value";s:7:"summary";s:17:"the default value";}}s:6:"source";s:637:"			var value = item[property];
			return value || // return the plain value since it was found;
						(property in item ? // a truthy value was not found, see if we actually have it 
							value : // we do, so we can return it
							item._loadObject ? // property was not found, maybe because the item is not loaded, we will try to load it synchronously so we can get the property 
								(dojox.rpc._sync = true) && arguments.callee.call(this,dojox.data.ServiceStore.prototype.loadItem({item:item}) || {}, property, defaultValue) : // load the item and run getValue again 
								defaultValue);// not in item -> return default value";s:7:"summary";s:38:"Gets the value of an item's 'property'";s:7:"returns";s:105:"return the plain value since it was found;|we do, so we can return it|not in item -> return default value";s:6:"chains";a:1:{s:4:"call";a:1:{i:0;s:16:"arguments.callee";}}}s:33:"dojox.data.ServiceStore.getValues";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:2:"*/";}s:8:"property";a:2:{s:4:"type";s:6:"string";s:7:"summary";s:32:"*/
property to look up value for";}}s:6:"source";s:113:"			var val = this.getValue(item,property);
			return val instanceof Array ? val : val === undefined ? [] : [val];";s:7:"summary";s:163:"Gets the value of an item's 'property' and returns
it.  If this value is an array it is just returned,
if not, the value is added to an array and that is returned.";}s:37:"dojox.data.ServiceStore.getAttributes";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:2:"*/";}}s:6:"source";s:162:"			var res = [];
			for(var i in item){
				if(item.hasOwnProperty(i) && !(i.charAt(0) == '_' && i.charAt(1) == '_')){
					res.push(i);
				}
			}
			return res;";s:7:"summary";s:81:"Gets the available attributes of an item's 'property' and returns
it as an array.";}s:36:"dojox.data.ServiceStore.hasAttribute";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:2:"*/";}s:9:"attribute";a:2:{s:4:"type";s:6:"string";s:7:"summary";s:2:"*/";}}s:6:"source";s:30:"			return attribute in item;		";s:7:"summary";s:35:"Checks to see if item has attribute";}s:37:"dojox.data.ServiceStore.containsValue";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:3:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:2:"*/";}s:9:"attribute";a:2:{s:4:"type";s:6:"string";s:7:"summary";s:2:"*/";}s:5:"value";a:2:{s:4:"type";s:8:"anything";s:7:"summary";s:2:"*/";}}s:6:"source";s:66:"			return dojo.indexOf(this.getValues(item,attribute),value) > -1;";s:7:"summary";s:50:"Checks to see if 'item' has 'value' at 'attribute'";}s:30:"dojox.data.ServiceStore.isItem";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:122:"*/
attribute: /* string */

we have no way of determining if it belongs, we just have object returned from
service queries";}}s:6:"source";s:72:"			return (typeof item == 'object') && item && !(item instanceof Date); ";s:7:"summary";s:40:"Checks to see if the argument is an item";}s:36:"dojox.data.ServiceStore.isItemLoaded";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:2:{s:4:"type";s:6:"object";s:7:"summary";s:2:"*/";}}s:6:"source";s:36:"			return item && !item._loadObject;";s:7:"summary";s:36:"Checks to see if the item is loaded.";}s:32:"dojox.data.ServiceStore.loadItem";a:8:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"args";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:623:"			var item;
			if(args.item._loadObject){
				args.item._loadObject(function(result){
					item = result; // in synchronous mode this can allow loadItem to return the value
					delete item._loadObject;
					var func = result instanceof Error ? args.onError : args.onItem;
					if(func){
						func.call(args.scope, result);				
					}
				});
			}else if(args.onItem){
				// even if it is already loaded, we will use call the callback, this makes it easier to 
				// use when it is not known if the item is loaded (you can always safely call loadItem). 
				args.onItem.call(args.scope, args.item);
			}
			return item;";s:7:"summary";s:378:"Loads an item and calls the callback handler. Note, that this will call the callback
handler even if the item is loaded. Consequently, you can use loadItem to ensure
that an item is loaded is situations when the item may or may not be loaded yet.
If you access a value directly through property access, you can use this to load
a lazy value as well (doesn't need to be an item).";s:7:"returns";s:63:"in synchronous mode this can allow loadItem to return the value";s:8:"examples";a:1:{i:0;s:126:"store.loadItem({
item: item, // this item may or may not be loaded
onItem: function(item){
// do something with the item
}
});";}s:6:"chains";a:1:{s:4:"call";a:1:{i:0;s:11:"args.onItem";}}}s:34:"dojox.data.ServiceStore._currentId";a:3:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:7:"private";b:1;s:7:"summary";s:0:"";}s:39:"dojox.data.ServiceStore._processResults";a:7:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:2:{s:7:"results";a:1:{s:4:"type";s:0:"";}s:8:"deferred";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:10375:"dojo.provide("dojox.data.ServiceStore");


// note that dojox.rpc.Service is not required, you can create your own services


// A ServiceStore is a readonly data store that provides a data.data interface to an RPC service.
// var myServices = new dojox.rpc.Service(dojo.moduleUrl("dojox.rpc.tests.resources", "test.smd"));
// var serviceStore = new dojox.data.ServiceStore({service:myServices.ServiceStore});
// 
// The ServiceStore also supports lazy loading. References can be made to objects that have not been loaded.
//  For example if a service returned:
// {"name":"Example","lazyLoadedObject":{"$ref":"obj2"}}
//
// And this object has accessed using the dojo.data API:
// var obj = serviceStore.getValue(myObject,"lazyLoadedObject");
// The object would automatically be requested from the server (with an object id of "obj2").
//


dojo.declare("dojox.data.ServiceStore",
	// ClientFilter is intentionally not required, ServiceStore does not need it, and is more 
	// lightweight without it, but if it is provided, the ServiceStore will use it.
	dojox.data.ClientFilter,  
	{
		constructor: function(options){
			//summary:
			//		ServiceStore constructor, instantiate a new ServiceStore 
			// 		A ServiceStore can be configured from a JSON Schema. Queries are just 
			// 		passed through to the underlying services
			//
			// options: 
			// 		Keyword arguments
			// The *schema* parameter
			//		This is a schema object for this store. This should be JSON Schema format.
			// 
			// The *service* parameter
			// 		This is the service object that is used to retrieve lazy data and save results 
			// 		The function should be directly callable with a single parameter of an object id to be loaded
			//
			// The *idAttribute* parameter
			//		Defaults to 'id'. The name of the attribute that holds an objects id.
			//		This can be a preexisting id provided by the server.  
			//		If an ID isn't already provided when an object
			//		is fetched or added to the store, the autoIdentity system
			//		will generate an id for it and add it to the index.
			// 
			// The *estimateCountFactor* parameter
			// 		This parameter is used by the ServiceStore to estimate the total count. When
			//		paging is indicated in a fetch and the response includes the full number of items
			//	 	requested by the fetch's count parameter, then the total count will be estimated
			//		to be estimateCountFactor multiplied by the provided count. If this is 1, then it is assumed that the server
			//		does not support paging, and the response is the full set of items, where the
			// 		total count is equal to the numer of items returned. If the server does support
			//		paging, an estimateCountFactor of 2 is a good value for estimating the total count
			//		It is also possible to override _processResults if the server can provide an exact 
			// 		total count.
			//
			// The *syncMode* parameter
			//		Setting this to true will set the store to using synchronous calls by default.
			//		Sync calls return their data immediately from the calling function, so
			//		callbacks are unnecessary. This will only work with a synchronous capable service.
			//
			// description:
			//		ServiceStore can do client side caching and result set updating if 
			// 		dojox.data.ClientFilter is loaded. Do this add:
			//	|	dojo.require("dojox.data.ClientFilter")
			//		prior to loading the ServiceStore (ClientFilter must be loaded before ServiceStore).
			//		To utilize client side filtering with a subclass, you can break queries into
			//		client side and server side components by putting client side actions in
			//		clientFilter property in fetch calls. For example you could override fetch:
			//	|	fetch: function(args){
  			//	|		// do the sorting and paging on the client side
   			//	|		args.clientFilter = {start:args.start, count: args.count, sort: args.sort};
   			//	|		// args.query will be passed to the service object for the server side handling
   			//	|		return this.inherited(arguments);
			//	|	}
			//		When extending this class, if you would like to create lazy objects, you can follow
			//		the example from dojox.data.tests.stores.ServiceStore:
			// |	var lazyItem = {
			// |		_loadObject: function(callback){
			// |			this.name="loaded";
			// |			delete this._loadObject;
			// |			callback(this);
			// |		}
			// |	};
			//setup a byId alias to the api call	
			this.byId=this.fetchItemByIdentity;
			this._index = {};
			// if the advanced json parser is enabled, we can pass through object updates as onSet events
			if(options){
				dojo.mixin(this,options);
			}
			// We supply a default idAttribute for parser driven construction, but if no id attribute
			//	is supplied, it should be null so that auto identification takes place properly
			this.idAttribute = (options && options.idAttribute) || (this.schema && this.schema._idAttr);
			this.labelAttribute = this.labelAttribute || "label";
		},
		schema: null,
		idAttribute: "id",
		syncMode: false,
		estimateCountFactor: 1,
		getSchema: function(){
			return this.schema; 
		},


		loadLazyValues:true,


		getValue: function(/*Object*/ item, /*String*/property, /*value?*/defaultValue){
			// summary:
			//	Gets the value of an item's 'property'
			//
			//	item: 
			//		The item to get the value from
			//	property: 
			//		property to look up value for	
			//	defaultValue: 
			//		the default value
			var value = item[property];
			return value || // return the plain value since it was found;
						(property in item ? // a truthy value was not found, see if we actually have it 
							value : // we do, so we can return it
							item._loadObject ? // property was not found, maybe because the item is not loaded, we will try to load it synchronously so we can get the property 
								(dojox.rpc._sync = true) && arguments.callee.call(this,dojox.data.ServiceStore.prototype.loadItem({item:item}) || {}, property, defaultValue) : // load the item and run getValue again 
								defaultValue);// not in item -> return default value
		},
		getValues: function(item, property){
			// summary:
			//		Gets the value of an item's 'property' and returns
			//		it.  If this value is an array it is just returned,
			//		if not, the value is added to an array and that is returned.
			//
			//	item: /* object */
			//	property: /* string */
			//		property to look up value for	

	
			var val = this.getValue(item,property);
			return val instanceof Array ? val : val === undefined ? [] : [val];
		},


		getAttributes: function(item){
			// summary:
			//	Gets the available attributes of an item's 'property' and returns
			//	it as an array. 
			//
			//	item: /* object */


			var res = [];
			for(var i in item){
				if(item.hasOwnProperty(i) && !(i.charAt(0) == '_' && i.charAt(1) == '_')){
					res.push(i);
				}
			}
			return res;
		},


		hasAttribute: function(item,attribute){
			// summary:
			//		Checks to see if item has attribute
			//
			//	item: /* object */
			//	attribute: /* string */
			return attribute in item;		
		},


		containsValue: function(item, attribute, value){
			// summary:
			//		Checks to see if 'item' has 'value' at 'attribute'
			//
			//	item: /* object */
			//	attribute: /* string */
			//	value: /* anything */
			return dojo.indexOf(this.getValues(item,attribute),value) > -1;
		},




		isItem: function(item){
			// summary:
			//		Checks to see if the argument is an item 
			//
			//	item: /* object */
			//	attribute: /* string */

		
			// we have no way of determining if it belongs, we just have object returned from
			// 	service queries
			return (typeof item == 'object') && item && !(item instanceof Date); 
		},


		isItemLoaded: function(item){
			// summary:
			//		Checks to see if the item is loaded. 
			// 
			//		item: /* object */


			return item && !item._loadObject;
		},


		loadItem: function(args){
			// summary:
			// 		Loads an item and calls the callback handler. Note, that this will call the callback
			// 		handler even if the item is loaded. Consequently, you can use loadItem to ensure
			// 		that an item is loaded is situations when the item may or may not be loaded yet. 
			// 		If you access a value directly through property access, you can use this to load
			// 		a lazy value as well (doesn't need to be an item).
			//
			//	example:
			//		store.loadItem({
			//			item: item, // this item may or may not be loaded
			//			onItem: function(item){
			// 				// do something with the item
			//			}
			//		});

			
			var item;
			if(args.item._loadObject){
				args.item._loadObject(function(result){
					item = result; // in synchronous mode this can allow loadItem to return the value
					delete item._loadObject;
					var func = result instanceof Error ? args.onError : args.onItem;
					if(func){
						func.call(args.scope, result);				
					}
				});
			}else if(args.onItem){
				// even if it is already loaded, we will use call the callback, this makes it easier to 
				// use when it is not known if the item is loaded (you can always safely call loadItem). 
				args.onItem.call(args.scope, args.item);
			}
			return item;
		},
		_currentId : 0,
		_processResults : function(results, deferred){
			// this should return an object with the items as an array and the total count of 
			// items (maybe more than currently in the result set).
			// for example:
			//	| {totalCount:10,[{id:1},{id:2}]}

			
			// index the results, assigning ids as necessary


			if (results && typeof results == 'object'){
				var id = results.__id;
				if(!id){// if it hasn't been assigned yet
					if(this.idAttribute){
						// use the defined id if available
						id = results[this.idAttribute];
					}else{
						id = this._currentId++;
					}
					if(id !== undefined){
						var existingObj = this._index[id];
						if(existingObj){
							for(var j in existingObj){
								delete existingObj[j]; // clear it so we can mixin
							}
							results = dojo.mixin(existingObj,results);
						}
						results.__id = id;
						this._index[id] = results;
					}
				}
				for (var i in results){
					results[i] = this._processResults(results[i], deferred).items;
				}
			}
			var count = results.length;
			return {totalCount: deferred.request.count == count ? (deferred.request.start || 0) + count * this.estimateCountFactor : count, items: results};";s:7:"returns";s:169:"return the plain value since it was found;|we do, so we can return it|not in item -> return default value|in synchronous mode this can allow loadItem to return the value";s:7:"private";b:1;s:7:"summary";s:0:"";}s:29:"dojox.data.ServiceStore.close";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:7:"request";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:54:"			return request && request.abort && request.abort();";s:7:"summary";s:0:"";}s:29:"dojox.data.ServiceStore.fetch";a:6:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"args";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:1146:"			args = args || {};


			if("syncMode" in args ? args.syncMode : this.syncMode){
				dojox.rpc._sync = true;	
			}
			var self = this;

			
			var scope = args.scope || self;
			var defResult = this.cachingFetch ? this.cachingFetch(args) : this._doQuery(args);
			defResult.request = args; 
			defResult.addCallback(function(results){
				if(args.clientFetch){
					results = self.clientSideFetch({query:args.clientFetch,sort:args.sort,start:args.start,count:args.count},results);
				}
				var resultSet = self._processResults(results, defResult);
				results = args.results = resultSet.items;
				if(args.onBegin){
					args.onBegin.call(scope, resultSet.totalCount, args);
				}
				if(args.onItem){
					for(var i=0; i<results.length;i++){	
						args.onItem.call(scope, results[i], args);
					}
				}					
				if(args.onComplete){
					args.onComplete.call(scope, args.onItem ? null : results, args);
				}
				return results;
			});
			defResult.addErrback(args.onError && dojo.hitch(scope, args.onError));
			args.abort = function(){
				// abort the request
				defResult.ioArgs.xhr.abort();
			};
			args.store = this;
			return args;";s:7:"summary";s:477:"See dojo.data.api.Read.fetch

The *queryOptions.cache* parameter
If true, indicates that the query result should be cached for future use. This is only available
if dojox.data.ClientFilter has been loaded before the ServiceStore

The *syncMode* parameter
Indicates that the call should be fetch synchronously if possible (this is not always possible)

The *clientFetch* parameter
This is a fetch keyword argument for explicitly doing client side filtering, querying, and paging";s:6:"chains";a:1:{s:4:"call";a:3:{i:0;s:12:"args.onBegin";i:1;s:11:"args.onItem";i:2;s:15:"args.onComplete";}}}s:32:"dojox.data.ServiceStore._doQuery";a:6:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"args";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:107:"			var query= typeof args.queryStr == 'string' ? args.queryStr : args.query;
			return this.service(query);";s:7:"private";b:1;s:7:"summary";s:0:"";}s:35:"dojox.data.ServiceStore.getFeatures";a:4:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:6:"source";s:127:"			return { 
				"dojo.data.api.Read": true,
				"dojo.data.api.Identity": true, 
				"dojo.data.api.Schema": this.schema
			};";s:7:"summary";s:28:"return the store feature set";}s:32:"dojox.data.ServiceStore.getLabel";a:6:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:12743:"dojo.provide("dojox.data.ServiceStore");


// note that dojox.rpc.Service is not required, you can create your own services


// A ServiceStore is a readonly data store that provides a data.data interface to an RPC service.
// var myServices = new dojox.rpc.Service(dojo.moduleUrl("dojox.rpc.tests.resources", "test.smd"));
// var serviceStore = new dojox.data.ServiceStore({service:myServices.ServiceStore});
// 
// The ServiceStore also supports lazy loading. References can be made to objects that have not been loaded.
//  For example if a service returned:
// {"name":"Example","lazyLoadedObject":{"$ref":"obj2"}}
//
// And this object has accessed using the dojo.data API:
// var obj = serviceStore.getValue(myObject,"lazyLoadedObject");
// The object would automatically be requested from the server (with an object id of "obj2").
//


dojo.declare("dojox.data.ServiceStore",
	// ClientFilter is intentionally not required, ServiceStore does not need it, and is more 
	// lightweight without it, but if it is provided, the ServiceStore will use it.
	dojox.data.ClientFilter,  
	{
		constructor: function(options){
			//summary:
			//		ServiceStore constructor, instantiate a new ServiceStore 
			// 		A ServiceStore can be configured from a JSON Schema. Queries are just 
			// 		passed through to the underlying services
			//
			// options: 
			// 		Keyword arguments
			// The *schema* parameter
			//		This is a schema object for this store. This should be JSON Schema format.
			// 
			// The *service* parameter
			// 		This is the service object that is used to retrieve lazy data and save results 
			// 		The function should be directly callable with a single parameter of an object id to be loaded
			//
			// The *idAttribute* parameter
			//		Defaults to 'id'. The name of the attribute that holds an objects id.
			//		This can be a preexisting id provided by the server.  
			//		If an ID isn't already provided when an object
			//		is fetched or added to the store, the autoIdentity system
			//		will generate an id for it and add it to the index.
			// 
			// The *estimateCountFactor* parameter
			// 		This parameter is used by the ServiceStore to estimate the total count. When
			//		paging is indicated in a fetch and the response includes the full number of items
			//	 	requested by the fetch's count parameter, then the total count will be estimated
			//		to be estimateCountFactor multiplied by the provided count. If this is 1, then it is assumed that the server
			//		does not support paging, and the response is the full set of items, where the
			// 		total count is equal to the numer of items returned. If the server does support
			//		paging, an estimateCountFactor of 2 is a good value for estimating the total count
			//		It is also possible to override _processResults if the server can provide an exact 
			// 		total count.
			//
			// The *syncMode* parameter
			//		Setting this to true will set the store to using synchronous calls by default.
			//		Sync calls return their data immediately from the calling function, so
			//		callbacks are unnecessary. This will only work with a synchronous capable service.
			//
			// description:
			//		ServiceStore can do client side caching and result set updating if 
			// 		dojox.data.ClientFilter is loaded. Do this add:
			//	|	dojo.require("dojox.data.ClientFilter")
			//		prior to loading the ServiceStore (ClientFilter must be loaded before ServiceStore).
			//		To utilize client side filtering with a subclass, you can break queries into
			//		client side and server side components by putting client side actions in
			//		clientFilter property in fetch calls. For example you could override fetch:
			//	|	fetch: function(args){
  			//	|		// do the sorting and paging on the client side
   			//	|		args.clientFilter = {start:args.start, count: args.count, sort: args.sort};
   			//	|		// args.query will be passed to the service object for the server side handling
   			//	|		return this.inherited(arguments);
			//	|	}
			//		When extending this class, if you would like to create lazy objects, you can follow
			//		the example from dojox.data.tests.stores.ServiceStore:
			// |	var lazyItem = {
			// |		_loadObject: function(callback){
			// |			this.name="loaded";
			// |			delete this._loadObject;
			// |			callback(this);
			// |		}
			// |	};
			//setup a byId alias to the api call	
			this.byId=this.fetchItemByIdentity;
			this._index = {};
			// if the advanced json parser is enabled, we can pass through object updates as onSet events
			if(options){
				dojo.mixin(this,options);
			}
			// We supply a default idAttribute for parser driven construction, but if no id attribute
			//	is supplied, it should be null so that auto identification takes place properly
			this.idAttribute = (options && options.idAttribute) || (this.schema && this.schema._idAttr);
			this.labelAttribute = this.labelAttribute || "label";
		},
		schema: null,
		idAttribute: "id",
		syncMode: false,
		estimateCountFactor: 1,
		getSchema: function(){
			return this.schema; 
		},


		loadLazyValues:true,


		getValue: function(/*Object*/ item, /*String*/property, /*value?*/defaultValue){
			// summary:
			//	Gets the value of an item's 'property'
			//
			//	item: 
			//		The item to get the value from
			//	property: 
			//		property to look up value for	
			//	defaultValue: 
			//		the default value
			var value = item[property];
			return value || // return the plain value since it was found;
						(property in item ? // a truthy value was not found, see if we actually have it 
							value : // we do, so we can return it
							item._loadObject ? // property was not found, maybe because the item is not loaded, we will try to load it synchronously so we can get the property 
								(dojox.rpc._sync = true) && arguments.callee.call(this,dojox.data.ServiceStore.prototype.loadItem({item:item}) || {}, property, defaultValue) : // load the item and run getValue again 
								defaultValue);// not in item -> return default value
		},
		getValues: function(item, property){
			// summary:
			//		Gets the value of an item's 'property' and returns
			//		it.  If this value is an array it is just returned,
			//		if not, the value is added to an array and that is returned.
			//
			//	item: /* object */
			//	property: /* string */
			//		property to look up value for	

	
			var val = this.getValue(item,property);
			return val instanceof Array ? val : val === undefined ? [] : [val];
		},


		getAttributes: function(item){
			// summary:
			//	Gets the available attributes of an item's 'property' and returns
			//	it as an array. 
			//
			//	item: /* object */


			var res = [];
			for(var i in item){
				if(item.hasOwnProperty(i) && !(i.charAt(0) == '_' && i.charAt(1) == '_')){
					res.push(i);
				}
			}
			return res;
		},


		hasAttribute: function(item,attribute){
			// summary:
			//		Checks to see if item has attribute
			//
			//	item: /* object */
			//	attribute: /* string */
			return attribute in item;		
		},


		containsValue: function(item, attribute, value){
			// summary:
			//		Checks to see if 'item' has 'value' at 'attribute'
			//
			//	item: /* object */
			//	attribute: /* string */
			//	value: /* anything */
			return dojo.indexOf(this.getValues(item,attribute),value) > -1;
		},




		isItem: function(item){
			// summary:
			//		Checks to see if the argument is an item 
			//
			//	item: /* object */
			//	attribute: /* string */

		
			// we have no way of determining if it belongs, we just have object returned from
			// 	service queries
			return (typeof item == 'object') && item && !(item instanceof Date); 
		},


		isItemLoaded: function(item){
			// summary:
			//		Checks to see if the item is loaded. 
			// 
			//		item: /* object */


			return item && !item._loadObject;
		},


		loadItem: function(args){
			// summary:
			// 		Loads an item and calls the callback handler. Note, that this will call the callback
			// 		handler even if the item is loaded. Consequently, you can use loadItem to ensure
			// 		that an item is loaded is situations when the item may or may not be loaded yet. 
			// 		If you access a value directly through property access, you can use this to load
			// 		a lazy value as well (doesn't need to be an item).
			//
			//	example:
			//		store.loadItem({
			//			item: item, // this item may or may not be loaded
			//			onItem: function(item){
			// 				// do something with the item
			//			}
			//		});

			
			var item;
			if(args.item._loadObject){
				args.item._loadObject(function(result){
					item = result; // in synchronous mode this can allow loadItem to return the value
					delete item._loadObject;
					var func = result instanceof Error ? args.onError : args.onItem;
					if(func){
						func.call(args.scope, result);				
					}
				});
			}else if(args.onItem){
				// even if it is already loaded, we will use call the callback, this makes it easier to 
				// use when it is not known if the item is loaded (you can always safely call loadItem). 
				args.onItem.call(args.scope, args.item);
			}
			return item;
		},
		_currentId : 0,
		_processResults : function(results, deferred){
			// this should return an object with the items as an array and the total count of 
			// items (maybe more than currently in the result set).
			// for example:
			//	| {totalCount:10,[{id:1},{id:2}]}

			
			// index the results, assigning ids as necessary


			if (results && typeof results == 'object'){
				var id = results.__id;
				if(!id){// if it hasn't been assigned yet
					if(this.idAttribute){
						// use the defined id if available
						id = results[this.idAttribute];
					}else{
						id = this._currentId++;
					}
					if(id !== undefined){
						var existingObj = this._index[id];
						if(existingObj){
							for(var j in existingObj){
								delete existingObj[j]; // clear it so we can mixin
							}
							results = dojo.mixin(existingObj,results);
						}
						results.__id = id;
						this._index[id] = results;
					}
				}
				for (var i in results){
					results[i] = this._processResults(results[i], deferred).items;
				}
			}
			var count = results.length;
			return {totalCount: deferred.request.count == count ? (deferred.request.start || 0) + count * this.estimateCountFactor : count, items: results};
		},
		close: function(request){
			return request && request.abort && request.abort();
		},
		fetch: function(args){
			// summary:
			//		See dojo.data.api.Read.fetch
			//
			// The *queryOptions.cache* parameter 
			//		If true, indicates that the query result should be cached for future use. This is only available 
			// 		if dojox.data.ClientFilter has been loaded before the ServiceStore 
			//
			//	The *syncMode* parameter
			//		Indicates that the call should be fetch synchronously if possible (this is not always possible)
			//
			// The *clientFetch* parameter
			//		This is a fetch keyword argument for explicitly doing client side filtering, querying, and paging

			
			args = args || {};


			if("syncMode" in args ? args.syncMode : this.syncMode){
				dojox.rpc._sync = true;	
			}
			var self = this;

			
			var scope = args.scope || self;
			var defResult = this.cachingFetch ? this.cachingFetch(args) : this._doQuery(args);
			defResult.request = args; 
			defResult.addCallback(function(results){
				if(args.clientFetch){
					results = self.clientSideFetch({query:args.clientFetch,sort:args.sort,start:args.start,count:args.count},results);
				}
				var resultSet = self._processResults(results, defResult);
				results = args.results = resultSet.items;
				if(args.onBegin){
					args.onBegin.call(scope, resultSet.totalCount, args);
				}
				if(args.onItem){
					for(var i=0; i<results.length;i++){	
						args.onItem.call(scope, results[i], args);
					}
				}					
				if(args.onComplete){
					args.onComplete.call(scope, args.onItem ? null : results, args);
				}
				return results;
			});
			defResult.addErrback(args.onError && dojo.hitch(scope, args.onError));
			args.abort = function(){
				// abort the request
				defResult.ioArgs.xhr.abort();
			};
			args.store = this;
			return args;
		},
		_doQuery: function(args){
			var query= typeof args.queryStr == 'string' ? args.queryStr : args.query;
			return this.service(query);
		},
		getFeatures: function(){
			// summary:
			// 		return the store feature set


			return { 
				"dojo.data.api.Read": true,
				"dojo.data.api.Identity": true, 
				"dojo.data.api.Schema": this.schema
			};
		},


		getLabel: function(item){
			// summary
			//		returns the label for an item. Just gets the "label" attribute.
			//	
			return this.getValue(item,this.labelAttribute);";s:7:"returns";s:169:"return the plain value since it was found;|we do, so we can return it|not in item -> return default value|in synchronous mode this can allow loadItem to return the value";s:7:"summary";s:0:"";}s:42:"dojox.data.ServiceStore.getLabelAttributes";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:32:"			return [this.labelAttribute];";s:7:"summary";s:75:"returns an array of attributes that are used to create the label of an item";}s:35:"dojox.data.ServiceStore.getIdentity";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:20:"			return item.__id;";s:7:"summary";s:0:"";}s:45:"dojox.data.ServiceStore.getIdentityAttributes";a:5:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"item";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:29:"			return [this.idAttribute];";s:7:"summary";s:109:"returns the attributes which are used to make up the
identity of an item.  Basically returns this.idAttribute";}s:43:"dojox.data.ServiceStore.fetchItemByIdentity";a:6:{s:9:"prototype";s:23:"dojox.data.ServiceStore";s:4:"type";s:8:"Function";s:10:"parameters";a:1:{s:4:"args";a:1:{s:4:"type";s:0:"";}}s:6:"source";s:355:"			var item = this._index[(args._prefix || '') + args.identity];
			if(item && args.onItem){
				args.onItem.call(args.scope, item);
			}else{
				// convert the different spellings
				return this.fetch({
						query: args.identity,
						onComplete: args.onItem,
						onError: args.onError,
						scope: args.scope
					}).results;
			}
			return item;";s:7:"summary";s:77:"fetch an item by its identity, by looking in our index of what we have loaded";s:6:"chains";a:1:{s:4:"call";a:1:{i:0;s:11:"args.onItem";}}}s:28:"dojox.data.ServiceStore.byId";a:2:{s:8:"instance";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:30:"dojox.data.ServiceStore._index";a:3:{s:8:"instance";s:23:"dojox.data.ServiceStore";s:7:"private";b:1;s:7:"summary";s:0:"";}s:38:"dojox.data.ServiceStore.labelAttribute";a:2:{s:8:"instance";s:23:"dojox.data.ServiceStore";s:7:"summary";s:0:"";}s:4:"this";a:2:{s:6:"mixins";a:1:{s:6:"normal";a:1:{i:0;s:7:"options";}}s:7:"summary";s:0:"";}s:11:"existingObj";a:2:{s:6:"mixins";a:1:{s:6:"normal";a:1:{i:0;s:7:"results";}}s:7:"summary";s:0:"";}s:10:"dojox.data";a:2:{s:4:"type";s:6:"Object";s:7:"summary";s:0:"";}s:5:"dojox";a:2:{s:4:"type";s:6:"Object";s:7:"summary";s:0:"";}}