The DataStore Framework helps you manage structured data.  You will often use it to build some or all of the model layer in your application.  It provides many of the same features found Object-Relational Mapping (ORM) tools such as in CoreData, ActiveRecord, or DataMapper in about 50K of JavaScript.

This programming guide will tell you everything you need to know about using the DataStore framework in your SproutCore application including how to import data from your server, work with local storage, and how to model data.

Who Should Read This Guide

You should read this guide if you plan to use the SproutCore DataStore API to store and manage data objects in your application.

Outline

• About the DataStore - Overview of the major parts of the DataStore
• Defining Your Model – All about creating SC.Record classes, modeling relationships, etc.
• Using Fixtures - How to get going quickly with test data before you have a server
• Working With Records
  • About Records - Details on how SC.Record's work and their states. 
  • Using Records - Details on working with the SC.Record API.
• Finding Records 
  • Your First Find - Basic introduction to finding multiple Records in the Store
  • Finding With Queries - First steps to using special conditions with the Query API
  • SproutCore Query Language (SCQL) - Details on the query language used for local queries
• Buffering Changes
  • NestedStores - How to buffer changes in your application
• Connecting To Your Server
  • About DataSources- how to write the code to connect to your server
  • Fetching Data - supporting fetch()
  • Retrieving Records - supporting retrieveRecords()
  • Committing Changes - support commitRecords() [and createRecords(), updateRecords(), destroyRecords()]
  • Pushing Data - how to push data received from the server
• Other Topics
  • Django Integration - get an auto-generated data model, data source, and SproutCore admin application for your Django project