Additional methods

In addition to the standard store api, the store provides a few additional methods of note:

• setData(data)

  Set the store's data to the supplied object and then load or setup that data with the required meta info.

• cleanMeta(data)

  Recurse through the provided data object and remove any meta information that has attached. This method also removes any IDs that were auto generated. IDs provided to the store will not be touched.

• dump(options)

  Takes a options keyword parameter accepting clone, cleanMeta, and suppressExportMeta Boolean options and an export type option that takes "raw" or "json" as the parameters.

Two additional notification events are also triggered in this store, onSave() and onRevert() which will each be called after their respective events have completed.

Constructor Parameters

The jsonPathStore takes a single optional parameter in the form of a JavaScript object containing one or more of the following properties:

data

JSON String or JavaScript Object JSON String or JavaScript object this store will control JSON is converted into an object, and an object passed to the store will be used directly. If no data and no url is provide, an empty object, {}, will be used as the initial store.

url - string

Load data from this url in JSON format and use the Object created from the data as the data source.

indexOnLoad - Boolean

Parse the data object and set individual objects up as appropriate. This will add meta data and assign id's to objects that don't have them as defined by the idAttribute option. Disabling this option will keep this parsing from happening until a query is performed at which time only the top level of an item has meta info stored. This might work in some situations, but you will almost always want to indexOnLoad or use another option which will create an index. Defaults to true.

idAttribute - string

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. There are utility routines for exporting data from the store that can clean any generated IDs before exporting and leave preexisting id's in tact.

metaLabel - string

Defaults to '_meta' overrides the attribute name that is used by the store for attaching meta information to an object while in the store's control. Defaults to '_meta'.

hideMetaAttributes - Boolean

Defaults to False. When enabled, calls to getAttributes() will not include the meta attribute.

autoIdPrefix: string

Defaults to "_auto_". This string is used as the prefix to any objects which have a generated id. A numeric index is appended to this string to complete the ID

mode: dojox.data.ASYNC_MODE || dojox.data.SYNC_MODE

Defaults to ASYNC_MODE. This option sets the default mode for this store. Sync calls return their data immediately from the calling function instead of calling the callback functions. Functions such as fetchItemByIdentity() and fetch() both accept a string parameter in addition to the normal keywordArgs parameter. When passed this option, SYNC_MODE will automatically be used even when the default mode of the system is ASYNC_MODE. A normal request to fetch or fetchItemByIdentity (with kwArgs object) can also include a mode property to override this setting for that one request.

Programmatic example

var store = new dojox.data.jsonPathStore({data: {
     fruits: [
          {id: 1, type: apple},
          {id: 2, type: orange}
     ],
     vegetables: [
          {id: 3, type: "broccoli"}
     ]
 });

Declarative example

<div data-dojo-id="store" data-dojo-type="dojox.data.jsonPathStore" data-dojo-props="url:'/path/to/store.js'"></div>