sproutit-sproutcore 1.0.0.20090407205609 → 1.0.0.20090408130025

data/frameworks/sproutcore/frameworks/datastore/system/query.js

@@ -0,0 +1,128 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+require('core') ;
+/**
+  @class
+
+  Description
+
+  @extends SC.Object
+  @extends SC.SparseArray
+  @static
+  @since SproutCore 1.0
+*/
+
+SC.Query = SC.SparseArray.extend(
+/** @scope SC.Query.prototype */ {
+
+  queryString: '',
+  truthFunction: null,
+  conditions: null,
+  store: null,
+  // delegate: null,  
+  recordType: null,
+  needRecord: false,
+  
+  length: 0,
+  
+  createTruthFunction: function(queryString) {
+    this.set('queryString', queryString);
+    
+    /* Need parsing here from Thomas.. curently hacked. */
+    var hackComponents = [queryString.split('=')[0]];
+    
+    var components = queryString.split('=');
+    
+    var needRecord = this.willNeedRecord(hackComponents);
+    this.set('needRecord', needRecord);
+
+    if(needRecord) {
+      this.truthFunction = function(rec, conditions) {
+          if(!rec) return NO;
+          return (rec.get(components[0]) == conditions[0]);
+      };
+    } else {
+      this.truthFunction = function(rec, conditions) {
+          if(!rec) return NO;
+          return (rec[components[0]] == conditions[0]);
+      };
+    }
+  },
+  
+  willNeedRecord: function(components) {
+    
+    var rec = this.get('delegate').createCompRecord(this.get('recordType'));
+    var needRecord = NO;
+    for(var i=0, iLen=components.length; i<iLen; i++) {
+      if(rec[components[i]]) {
+        needRecord = YES;
+      }
+    }
+    console.log('needRecord: ' + needRecord);
+    return needRecord;
+  },
+
+  
+  parse: function(recordType, queryString, conditions) {
+    this.set('recordType', recordType);
+    this.createTruthFunction(queryString);
+    this.loadConditions(conditions);
+  },
+  
+  loadConditions: function(conditions) {
+    if(!conditions) {
+      conditions = null;
+    }
+    this.set('conditions', conditions);
+  },
+  
+  performQuery: function() {
+    var store = this.get('delegate');
+
+    if(!store) return null;
+    
+    this.beginPropertyChanges();
+    
+    this._storeKeysForQuery = store.performQuery(this);
+    this.set('length', this._storeKeysForQuery.length);
+
+  //  this.enumerableContentDidChange() ;
+    this.endPropertyChanges();
+    return this;
+  },
+
+  recordsDidChange: function() {
+    this.invokeOnce(this.performQuery);
+  },
+  
+  objectAt: function(idx)
+  {
+    if (idx < 0) return undefined ;
+    if (idx >= this.get('length')) return undefined;
+    return this.fetchContentAtIndex(idx);
+  },
+
+  fetchContentAtIndex: function(idx) {
+    var store = this.get('delegate') ;
+    var storeKey = this._storeKeysForQuery[idx];
+    var ret = null; 
+    if(store && storeKey) {
+      ret = store.materializeRecord(storeKey);
+    }
+    return ret;
+  },
+    
+  _storeKeysForQuery: null,
+  
+  init: function() {
+    sc_super();
+    this._storeKeysForQuery = [];
+  }
+  
+
+}) ;

data/frameworks/sproutcore/frameworks/datastore/system/record_array.js

@@ -0,0 +1,149 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/**
+  @class
+
+  A RecordArray wraps an array of storeKeys, converting them into materialized
+  record objects from the owner store on demand.  A Record Array instance is
+  usually returned when you call SC.Store#findAll() or SC.Store#recordsFor().
+  
+  @extends SC.Object
+  @extends SC.Enumerable
+  @extends SC.Array
+  @since SproutCore 1.0
+*/
+
+SC.RecordArray = SC.Object.extend(SC.Enumerable, SC.Array,
+  /** @scope SC.RecordArray.prototype */ {
+    
+  /**
+    The store that owns this record array.  All record arrays must have a 
+    store to function properly.
+  
+    @property {SC.Store}
+  */
+  store: null,
+
+  /**
+    SC.Array object that will provide the store keys for the array.  The 
+    record array will register itself as an observer for this array.
+    
+    @property {SC.Array}
+  */
+  storeKeys: null,
+
+  // ..........................................................
+  // ARRAY PRIMITIVES
+  // 
+
+  /**
+    Returned length is a pass-through to the storeKeys array.
+  */
+  length: function() {
+    var storeKeys = this.get('storeKeys');
+    return storeKeys ? storeKeys.get('length') : 0;
+  }.property('storeKeys').cacheable(),
+
+  /**
+    Looks up the store key in the store keys array and materializes a
+    records.
+  */
+  objectAt: function(idx) {
+    var recs      = this._records, 
+        storeKeys = this.get('storeKeys'),
+        store     = this.get('store'),
+        storeKey, ret ;
+    
+    if (!storeKeys || !store) return undefined; // nothing to do
+    if (recs && (ret=recs[idx])) return ret ; // cached
+    
+    // not in cache, materialize
+    if (!recs) this._records = recs = [] ; // create cache
+    storeKey = storeKeys.objectAt(idx);
+    if (storeKey) {
+      
+      // if record is not loaded already, then ask the data source to 
+      // retrieve it
+      if (store.readStatus(storeKey) === SC.Record.EMPTY) {
+        store.retrieveRecord(null, null, storeKey);
+      }
+      recs[idx] = ret = store.materializeRecord(storeKey);
+    }
+    return ret ;
+  },
+  
+  /**
+    Pass through to the underlying array.  The passed in objects must be
+    records, which can be converted to storeKeys.
+  */
+  replace: function(idx, amt, recs) {
+    var storeKeys = this.get('storeKeys'), 
+        len       = recs ? (recs.get ? recs.get('length') : recs.length) : 0,
+        i, keys;
+        
+    if (!storeKeys) throw "storeKeys required";
+    
+    // map to store keys
+    keys = [] ;
+    for(i=0;i<len;i++) keys[i] = recs.objectAt(i).get('storeKey');
+    
+    // pass along - if allowed, this should trigger the content observer 
+    storeKeys.replace(idx, amt, keys);
+    return this; 
+  },
+  
+  // ..........................................................
+  // INTERNAL SUPPORT
+  // 
+  
+  /** @private 
+    Invoked whenever the storeKeys array changes.  Observes changes.
+  */
+  _storeKeysDidChange: function() {
+    var storeKeys = this.get('storeKeys');
+    var prev = this._prevStoreKeys, f = this._storeKeysContentDidChange;
+
+    if (storeKeys === prev) return this; // nothing to do
+    
+    if (prev) {
+      prev.removeObserver('[]', this, f);
+    }
+
+    this._prevStoreKeys = storeKeys;
+
+    if (storeKeys) {
+      storeKeys.addObserver('[]', this, f);
+    }
+    
+    var rev = (storeKeys) ? storeKeys.propertyRevision : -1 ;
+    this._storeKeysContentDidChange(storeKeys, '[]', storeKeys, rev);
+    
+  }.observes('storeKeys'),
+  
+  /** @private
+    Invoked whenever the content of the storeKeys array changes.  This will
+    dump any cached record lookup and then notify that the enumerable content
+    has changed.
+  */
+  _storeKeysContentDidChange: function(target, key, value, rev) {
+    this._records = null ; // clear cache
+    
+    this.beginPropertyChanges()
+      .notifyPropertyChange('length')
+      .enumerableContentDidChange()
+    .endPropertyChanges();
+  },
+  
+  init: function() {
+    sc_super();
+    this._storeKeysDidChange();
+  }
+  
+  
+});
+