sproutit-sproutcore 1.0.0.20090416161445 → 1.0.0.20090720093355

data/frameworks/sproutcore/frameworks/datastore/tests/system/many_array/core_methods.js

@@ -0,0 +1,178 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+// test core array-mapping methods for ManyArray
+var store, storeKey, storeId, rec, storeIds, recs;
+module("SC.ManyArray core methods", {
+  setup: function() {
+    // setup dummy app and store
+    MyApp = SC.Object.create({
+      store: SC.Store.create()
+    });
+    
+    // setup a dummy model
+    MyApp.Foo = SC.Record.extend({});
+    
+    // load some data
+    MyApp.store.loadRecords(MyApp.Foo, [
+      { guid: 1, firstName: "John", lastName: "Doe" },
+      { guid: 2, firstName: "Jane", lastName: "Doe" },
+      { guid: 3, firstName: "Emily", lastName: "Parker" },
+      { guid: 4, firstName: "Johnny", lastName: "Cash" }
+    ]);
+    
+    storeKey = MyApp.store.storeKeyFor(MyApp.Foo, 1);
+    
+    // get record
+    rec = MyApp.store.materializeRecord(storeKey);
+    storeId = rec.get('id');
+    
+    // get many array.
+    storeIds = [1,2,3,4];
+    recs = SC.ManyArray.create({ store: MyApp.store, storeIds: storeIds, recordType: MyApp.Foo });
+    
+  }
+});
+
+// ..........................................................
+// LENGTH
+// 
+
+test("should pass through length", function() {
+  equals(recs.get('length'), storeIds.length, 'rec should pass through length');  
+});
+
+test("changing storeIds length should change length of rec array also", function() {
+
+  var oldlen = recs.get('length');
+  
+  storeIds.pushObject(SC.Store.generateStoreKey()); // change length
+  
+  ok(storeIds.length > oldlen, 'precond - storeKeys.length should have changed');
+  equals(recs.get('length'), storeIds.length, 'rec should pass through length');    
+});
+
+// ..........................................................
+// objectAt
+// 
+
+test("should materialize record for object", function() {
+  equals(storeIds[0], storeId, 'precond - storeIds[0] should be storeId');
+  equals(recs.objectAt(0), rec, 'recs.objectAt(0) should materialize record');
+});
+
+test("reading past end of array length should return undefined", function() {
+  equals(recs.objectAt(2000), undefined, 'recs.objectAt(2000) should be undefined');
+});
+
+test("modifying the underlying storeId should change the returned materialized record", function() {
+  // read record once to make it materialized
+  equals(recs.objectAt(0), rec, 'recs.objectAt(0) should materialize record');  
+  
+  // create a new record.
+  var rec2 = MyApp.store.createRecord(MyApp.Foo, { guid: 5, firstName: "Fred" });
+  var storeId2 = rec2.get('id');
+  
+  // add to beginning of storeKey array
+  storeIds.unshiftObject(storeId2);
+  equals(recs.get('length'), 5, 'should now have length of 5');
+  equals(recs.objectAt(0), rec2, 'objectAt(0) should return new record');
+  equals(recs.objectAt(1), rec, 'objectAt(1) should return old record');
+});
+
+test("reading a record not loaded in store should trigger retrieveRecord", function() {
+  var callCount = 0;
+
+  // patch up store to record a call and to make it look like data is not 
+  // loaded.
+  
+  MyApp.store.removeDataHash(storeKey, SC.Record.EMPTY);
+  MyApp.store.retrieveRecord = function() { callCount++; };
+  
+  var rec = recs.objectAt(0);
+  equals(MyApp.store.readStatus(rec), SC.Record.EMPTY, 'precond - storeKey must not be loaded');
+  
+  equals(callCount, 1, 'store.retrieveRecord() should have been called');
+});
+
+// ..........................................................
+// replace()
+// 
+
+test("adding a record to the ManyArray should pass through storeIds", function() {
+
+  // read record once to make it materialized
+  equals(recs.objectAt(0), rec, 'recs.objectAt(0) should materialize record');  
+  
+  // create a new record.
+  var rec2 = MyApp.store.createRecord(MyApp.Foo, { guid: 5, firstName: "rec2" });
+  var storeId2 = rec2.get('id');
+  
+  // add record to beginning of record array
+  recs.unshiftObject(rec2);
+  
+  // verify record array
+  equals(recs.get('length'), 5, 'should now have length of 2');
+  equals(recs.objectAt(0), rec2, 'recs.objectAt(0) should return new record');
+  equals(recs.objectAt(1), rec, 'recs.objectAt(1) should return old record');
+  
+  // verify storeKeys
+  equals(storeIds.objectAt(0), storeId2, 'storeKeys[0] should return new storeKey');
+  equals(storeIds.objectAt(1), storeId, 'storeKeys[1] should return old storeKey');
+});
+
+// ..........................................................
+// Property Observing
+// 
+
+test("changing the underlying storeIds should notify observers of records", function() {
+
+  // setup observer
+  var obj = SC.Object.create({
+    cnt: 0,
+    observer: function() { this.cnt++; }
+  });
+  recs.addObserver('[]', obj, obj.observer); 
+  
+  // now modify storeKeys
+  storeIds.pushObject(5);
+  equals(obj.cnt, 1, 'observer should have fired after changing storeKeys');
+});
+
+test("swapping storeIds array should change ManyArray and observers", function() {
+
+  // setup alternate storeKeys
+  var rec2 = MyApp.store.createRecord(MyApp.Foo, { guid: 5, firstName: "rec2" });
+  var storeId2 = rec2.get('id');
+  var storeIds2 = [storeId2];
+
+  // setup observer
+  var obj = SC.Object.create({
+    cnt: 0,
+    observer: function() { this.cnt++; }
+  });
+  recs.addObserver('[]', obj, obj.observer); 
+  
+  // read record once to make it materialized
+  equals(recs.objectAt(0), rec, 'recs.objectAt(0) should materialize record');  
+  
+  // now swap storeKeys
+  obj.cnt = 0 ;
+  recs.set('storeIds', storeIds2);
+  
+  // verify observer fired and record changed
+  equals(obj.cnt, 1, 'observer should have fired after swap');
+  equals(recs.objectAt(0), rec2, 'recs.objectAt(0) should return new rec');
+  
+  // modify storeKey2, make sure observer fires and content changes
+  obj.cnt = 0;
+  storeIds2.unshiftObject(storeId);
+  equals(obj.cnt, 1, 'observer should have fired after edit');
+  equals(recs.get('length'), 2, 'should reflect new length');
+  equals(recs.objectAt(0), rec, 'recs.objectAt(0) should return pushed rec');  
+
+});

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/chain.js

@@ -13,7 +13,7 @@
 // 
 module("SC.Store#chain - init");
 
-notest("initial setup for chained store", function() {
+test("initial setup for chained store", function() {
   var parent = SC.Store.create();
   var store  = parent.chain();
   

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/commitChanges.js

@@ -18,7 +18,7 @@ module("SC.NestedStore#commitChanges", {
       number: 23,
       bool:   YES
     };
-    args = null;
+    args = [];
     
     storeKey = SC.Store.generateStoreKey();
 
@@ -30,7 +30,6 @@ module("SC.NestedStore#commitChanges", {
     parent.commitChangesFromNestedStore =
     child.commitChangesFromNestedStore =
     store.commitChangesFromNestedStore = function(store, changes, force) {
-      if (!args) args = [];
       args.push({ 
         target: this, 
         store: store, 
@@ -54,10 +53,12 @@ function testStateTransition(shouldIncludeStoreKey) {
   // verify result
   equals(store.storeKeyEditState(storeKey), SC.Store.INHERITED, 'data edit state');
   equals(args.length, 1, 'should have called commitChangesFromNestedStore');
-  equals(args[0].target, parent, 'should have called on parent store');
+
+  var opts = args[0] || {}; // avoid exceptions
+  equals(opts.target, parent, 'should have called on parent store');
   
   // verify if changes passed to callback included storeKey
-  var changes = args[0].changes;
+  var changes = opts.changes;
   var didInclude = changes && changes.contains(storeKey);
   if (shouldIncludeStoreKey) {
     ok(didInclude, 'passed set of changes should include storeKey');
@@ -69,8 +70,8 @@ function testStateTransition(shouldIncludeStoreKey) {
   ok(!store.chainedChanges || store.chainedChanges.length===0, 'should have empty chainedChanges set');
 }
 
-notest("state = INHERITED", function() {
-  
+test("state = INHERITED", function() {
+
   // write in some data to parent
   parent.writeDataHash(storeKey, json);
   
@@ -81,7 +82,7 @@ notest("state = INHERITED", function() {
 });
 
 
-notest("state = LOCKED", function() {
+test("state = LOCKED", function() {
   
   // write in some data to parent
   parent.writeDataHash(storeKey, json);
@@ -95,7 +96,7 @@ notest("state = LOCKED", function() {
   testStateTransition(NO);
 });
 
-notest("state = EDITABLE", function() {
+test("state = EDITABLE", function() {
   
   // write in some data to parent
   store.writeDataHash(storeKey, json);

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/commitChangesFromNestedStore.js

@@ -29,7 +29,7 @@ module("SC.NestedStore#commitChangesFromNestedStore", {
   }
 });
 
-notest("copies changed data hashes, statuses, and revisions", function() {
+test("copies changed data hashes, statuses, and revisions", function() {
   
   // verify preconditions
   equals(store.readDataHash(storeKey), null, 'precond - should not have data yet');
@@ -45,7 +45,7 @@ notest("copies changed data hashes, statuses, and revisions", function() {
     
 });
 
-notest("adds lock on any items not already locked", function() {
+test("adds lock on any items not already locked", function() {
 
   var storeKey2 = SC.Store.generateStoreKey();
   var json2 = { kind: "json2" };
@@ -72,7 +72,7 @@ notest("adds lock on any items not already locked", function() {
   
 });
 
-notest("adds items in chainedChanges to reciever chainedChanges", function() {
+test("adds items in chainedChanges to reciever chainedChanges", function() {
 
   var key1 = SC.Store.generateStoreKey();
 
@@ -87,7 +87,7 @@ notest("adds items in chainedChanges to reciever chainedChanges", function() {
   ok(store.chainedChanges.contains(storeKey), 'chainedChanges should also contain storeKey');
 });
 
-notest("should set hasChanges to YES if has changes", function() {
+test("should set hasChanges to YES if has changes", function() {
   
   var changes = child.chainedChanges;
   ok(changes.length>0, 'precond - should have some changes in child');
@@ -97,7 +97,7 @@ notest("should set hasChanges to YES if has changes", function() {
   equals(store.get('hasChanges'), YES, 'store should now have changes');
 });
 
-notest("should set hasChanges to NO if no changes", function() {
+test("should set hasChanges to NO if no changes", function() {
   
   child = store.chain() ; // get a new child store
   
@@ -113,7 +113,7 @@ notest("should set hasChanges to NO if no changes", function() {
 // SPECIAL CASES
 // 
 
-notest("committing changes should chain back each step", function() {
+test("committing changes should chain back each step", function() {
 
   // preconditions
   equals(child.readDataHash(storeKey), json, 'precond - child should have data');

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/dataHashDidChange.js

@@ -58,7 +58,7 @@ function testStateTransition(fromState, toState) {
   equals(store.get('hasChanges'), YES, 'should have changes');
 } 
 
-notest("edit state = INHERITED, parent editable = NO", function() {
+test("edit state = INHERITED, parent editable = NO", function() {
 
   // verify preconditions
   equals(parent.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - parent store edit state is not EDITABLE');
@@ -66,7 +66,7 @@ notest("edit state = INHERITED, parent editable = NO", function() {
   testStateTransition(SC.Store.INHERITED, SC.Store.LOCKED);
 }) ;
 
-notest("edit state = INHERITED, parent editable = YES", function() {
+test("edit state = INHERITED, parent editable = YES", function() {
 
   // verify preconditions
   parent.readEditableDataHash(storeKey);
@@ -75,12 +75,12 @@ notest("edit state = INHERITED, parent editable = YES", function() {
   testStateTransition(SC.Store.INHERITED, SC.Store.EDITABLE);
 }) ;
 
-notest("edit state = LOCKED", function() {
+test("edit state = LOCKED", function() {
   store.readDataHash(storeKey); // lock
   testStateTransition(SC.Store.LOCKED, SC.Store.LOCKED);
 }) ;
 
-notest("edit state = EDITABLE", function() {
+test("edit state = EDITABLE", function() {
   store.readEditableDataHash(storeKey); // make editable
   testStateTransition(SC.Store.EDITABLE, SC.Store.EDITABLE);
 }) ;
@@ -89,7 +89,7 @@ notest("edit state = EDITABLE", function() {
 // SPECIAL CASES
 // 
 
-notest("calling with array of storeKeys will edit all store keys", function() {
+test("calling with array of storeKeys will edit all store keys", function() {
   
   var storeKeys = [storeKey, SC.Store.generateStoreKey()], idx ;
   store.dataHashDidChange(storeKeys, 2000) ;
@@ -99,7 +99,7 @@ notest("calling with array of storeKeys will edit all store keys", function() {
   }
 });
 
-notest("marking change should update revision but leave lock alone", function() {
+test("marking change should update revision but leave lock alone", function() {
   parent.dataHashDidChange(storeKey); // make sure parent has a revision
   store.readDataHash(storeKey); // cause a lock
   store.dataHashDidChange(storeKey); // update revision

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/discardChanges.js

@@ -65,20 +65,20 @@ function testStateTransition() {
   equals(args, null, 'should not call commitChangesFromNestedStore');
 }
 
-notest("state = INHERITED", function() {
+test("state = INHERITED", function() {
   equals(store.storeKeyEditState(storeKey), SC.Store.INHERITED, 'precond - data edit state');
   testStateTransition();
 });
 
 
-notest("state = LOCKED", function() {
+test("state = LOCKED", function() {
   
   store.readDataHash(storeKey); // force to locked mode
   equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - data edit state');
   testStateTransition();
 });
 
-notest("state = EDITABLE", function() {
+test("state = EDITABLE", function() {
   
   // write in some data to store
   store.writeDataHash(storeKey, json);

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/readDataHash.js

@@ -33,7 +33,7 @@ module("SC.NestedStore#readDataHash", {
 // BASIC STATE TRANSITIONS
 // 
 
-notest("data state=INHERITED, lockOnRead=YES, parent editable=NO", function() {
+test("data state=INHERITED, lockOnRead=YES, parent editable=NO", function() {
   // preconditions
   equals(store.get('lockOnRead'), YES, 'precond - lockOnRead should be YES');
   equals(store.storeKeyEditState(storeKey), SC.Store.INHERITED, 'precond - storeKey should be inherited from parent');
@@ -54,7 +54,7 @@ notest("data state=INHERITED, lockOnRead=YES, parent editable=NO", function() {
 });
 
 
-notest("data state=INHERITED, lockOnRead=NO, parent editable=NO", function() {
+test("data state=INHERITED, lockOnRead=NO, parent editable=NO", function() {
   // preconditions
   store.set('lockOnRead', NO);
   
@@ -77,7 +77,7 @@ notest("data state=INHERITED, lockOnRead=NO, parent editable=NO", function() {
 });
 
 
-notest("data state=INHERITED, lockOnRead=YES, parent editable=YES", function() {
+test("data state=INHERITED, lockOnRead=YES, parent editable=YES", function() {
 
   // preconditions
   
@@ -105,7 +105,7 @@ notest("data state=INHERITED, lockOnRead=YES, parent editable=YES", function() {
   }
 });
 
-notest("data state=LOCKED", function() {
+test("data state=LOCKED", function() {
   
   // preconditions
   store.set('lockOnRead', YES); // make sure reading will lock
@@ -127,7 +127,7 @@ notest("data state=LOCKED", function() {
   }
 });
 
-notest("data state=EDITABLE", function() {
+test("data state=EDITABLE", function() {
   
   // preconditions
   store.set('lockOnRead', YES); // make sure reading will lock
@@ -149,7 +149,7 @@ notest("data state=EDITABLE", function() {
   }
 });
 
-notest("should return null when accessing an unknown storeKey", function() {
+test("should return null when accessing an unknown storeKey", function() {
   equals(store.readDataHash(20000000), null, 'shuld return null for non-existant store key');
   equals(store.storeKeyEditState(20000000), SC.Store.LOCKED, 'should put into locked edit state');
 });
@@ -158,7 +158,7 @@ notest("should return null when accessing an unknown storeKey", function() {
 // SPECIAL CASES
 //
 
-notest("locking deep nested store when top-level parent is editable and middle store is inherited", function() {
+test("locking deep nested store when top-level parent is editable and middle store is inherited", function() {
 
   // first, make the parent store data hash editable
   json = parent.readEditableDataHash(storeKey);

data/frameworks/sproutcore/frameworks/datastore/tests/system/nested_store/readEditableDataHash.js

@@ -28,7 +28,7 @@ module("SC.NestedStore#readEditableDataHash", {
   }
 });
 
-notest("data state=INHERITED, parent editable = NO", function() {
+test("data state=INHERITED, parent editable = NO", function() {
   
   // test preconditions
   equals(parent.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - parent edit state should be LOCKED');
@@ -51,7 +51,7 @@ notest("data state=INHERITED, parent editable = NO", function() {
   }
 });
 
-notest("data state=INHERITED, parent editable = YES", function() {
+test("data state=INHERITED, parent editable = YES", function() {
   
   // test preconditions
   parent.readEditableDataHash(storeKey);
@@ -76,7 +76,7 @@ notest("data state=INHERITED, parent editable = YES", function() {
   
 });
 
-notest("data state=LOCKED", function() {
+test("data state=LOCKED", function() {
   
   // test preconditions
   store.readDataHash(storeKey);
@@ -100,7 +100,7 @@ notest("data state=LOCKED", function() {
   
 });
 
-notest("data state=EDITABLE", function() {
+test("data state=EDITABLE", function() {
   
   // test preconditions
   json = store.readEditableDataHash(storeKey); // get editable json