dojox/data/AndOrReadStore.js

• Provides:

  • dojox.data.AndOrReadStore

• Requires:

  • dojo.data.util.filter in common
  • dojo.data.util.simpleFetch in common
  • dojo.date.stamp in common

• dojox.data.AndOrReadStore

  • type

    Function

  • chains:
    • dojo.data.util.simpleFetch: (prototype)
  • parameters:
    • keywordParameters: (typeof Object)

      typeMap: object)
      The structure of the typeMap object is as follows:
      {
      type0: function || object,
      type1: function || object,
      ...
      typeN: function || object
      }
      Where if it is a function, it is assumed to be an object constructor that takes the
      value of _value as the initialization parameters.  If it is an object, then it is assumed
      to be an object of general form:
      {
      type: function, //constructor.
      deserialize:	function(value) //The function that parses the value and constructs the object defined by type appropriately.
      }

  • summary

    AndOrReadStore uses ItemFileReadStore as a base, modifying only the query (_fetchItems) section.
    Supports queries of the form: query:"id:1* OR dept:'Sales Department' || (id:2* && NOT dept:S*)"
    Includes legacy/widget support via:
    query:{complexQuery:"id:1* OR dept:'Sales Department' || (id:2* && NOT dept:S*)"}
    The ItemFileReadStore implements the dojo.data.api.Read API and reads
    data from JSON files that have contents in this format --
    { items: [
    { name:'Kermit', color:'green', age:12, friends:['Gonzo', {_reference:{name:'Fozzie Bear'}}]},
    { name:'Fozzie Bear', wears:['hat', 'tie']},
    { name:'Miss Piggy', pets:'Foo-Foo'}
    ]}
    Note that it can also contain an 'identifer' property that specified which attribute on the items
    in the array of items that acts as the unique identifier for that item.
    
    
    
    use "" rather than undefined for the benefit of the parser (#3539)

• dojox.data.AndOrReadStore.constructor

  • constructor - constructor
  • type

    Function

  • parameters:
    • keywordParameters: (typeof Object)

      typeMap: object)
      The structure of the typeMap object is as follows:
      {
      type0: function || object,
      type1: function || object,
      ...
      typeN: function || object
      }
      Where if it is a function, it is assumed to be an object constructor that takes the
      value of _value as the initialization parameters.  If it is an object, then it is assumed
      to be an object of general form:
      {
      type: function, //constructor.
      deserialize:	function(value) //The function that parses the value and constructs the object defined by type appropriately.
      }

  • summary

    constructor

• dojox.data.AndOrReadStore.url

  • type

    String

• dojox.data.AndOrReadStore._ccUrl

  • type

    String

• dojox.data.AndOrReadStore.data

  • type

    Object

• dojox.data.AndOrReadStore.typeMap

  • type

    Object

• dojox.data.AndOrReadStore.clearOnClose

  • type

    Object

• dojox.data.AndOrReadStore.urlPreventCache

  • type

    bool

• dojox.data.AndOrReadStore.hierarchical

  • type

    Object

• dojox.data.AndOrReadStore._assertIsItem

  • parameters:
    • item: (typeof item)

      The item to test for being contained by the store.

  • summary

    This function tests whether the item passed in is indeed an item in the store.

  • type

    Function

• dojox.data.AndOrReadStore._assertIsAttribute

  • parameters:
    • attribute: (typeof attribute-name-string)

      The attribute to test for being contained by the store.

  • summary

    This function tests whether the item passed in is indeed a valid 'attribute' like type for the store.

  • type

    Function

• dojox.data.AndOrReadStore.getValue

  • parameters:
    • item: (typeof item)
    • attribute: (typeof attribute-name-string)
    • defaultValue: (typeof value)
  • returns

    mixed

  • summary

    See dojo.data.api.Read.getValue()

  • type

    Function

• dojox.data.AndOrReadStore.getValues

  • parameters:
    • item: (typeof item)
    • attribute: (typeof attribute-name-string)
  • returns

    Array

  • summary

    See dojo.data.api.Read.getValues()

  • type

    Function

• dojox.data.AndOrReadStore.getAttributes

  • parameters:
    • item: (typeof item)
  • returns

    Array

  • summary

    See dojo.data.api.Read.getAttributes()

  • type

    Function

• dojox.data.AndOrReadStore.hasAttribute

  • parameters:
    • item: (typeof item)
    • attribute: (typeof attribute-name-string)
  • summary

    See dojo.data.api.Read.hasAttribute()

  • type

    Function

• dojox.data.AndOrReadStore.containsValue

  • parameters:
    • item: (typeof item)
    • attribute: (typeof attribute-name-string)
    • value: (typeof anything)
  • returns

    boolean.

  • summary

    See dojo.data.api.Read.containsValue()

  • type

    Function

• dojox.data.AndOrReadStore._containsValue

  • parameters:
    • item: (typeof item)

      The data item to examine for attribute values.

    • attribute: (typeof attribute-name-string)

      The attribute to inspect.

    • value: (typeof anything)

      The value to match.

    • regexp: (typeof RegExp)

      Optional regular expression generated off value if value was of string type to handle wildcarding.
      If present and attribute values are string, then it can be used for comparison instead of 'value'

  • returns

    Boolean

  • summary

    Internal function for looking at the values contained by the item.

  • description

    Internal function for looking at the values contained by the item.  This
    function allows for denoting if the comparison should be case sensitive for
    strings or not (for handling filtering cases where string case should not matter)

  • type

    Function

• dojox.data.AndOrReadStore.isItem

  • parameters:
    • something: (typeof anything)
  • returns

    Boolean

  • summary

    See dojo.data.api.Read.isItem()

  • type

    Function

• dojox.data.AndOrReadStore.isItemLoaded

  • parameters:
    • something: (typeof anything)
  • returns

    boolean

  • summary

    See dojo.data.api.Read.isItemLoaded()

  • type

    Function

• dojox.data.AndOrReadStore.loadItem

  • parameters:
    • keywordArgs: (typeof object)
  • summary

    See dojo.data.api.Read.loadItem()

  • type

    Function

• dojox.data.AndOrReadStore.getFeatures

  • returns

    Object

  • summary

    See dojo.data.api.Read.getFeatures()

  • type

    Function

• dojox.data.AndOrReadStore.getLabel

  • parameters:
    • item: (typeof item)
  • returns

    String|undefined

  • summary

    See dojo.data.api.Read.getLabel()

  • type

    Function

• dojox.data.AndOrReadStore.getLabelAttributes

  • parameters:
    • item: (typeof item)
  • returns

    array|null

  • summary

    See dojo.data.api.Read.getLabelAttributes()

  • type

    Function

• dojox.data.AndOrReadStore._fetchItems

  • parameters:
    • keywordArgs: (typeof Object)
    • findCallback: (typeof Function)
    • errorCallback: (typeof Function)
  • summary

    See dojo.data.util.simpleFetch.fetch()
    filter modified to permit complex queries where
    logical operators are case insensitive:
    , NOT AND OR ( ) ! && ||
    Note:  "," included for quoted/string legacy queries.

  • type

    Function

• dojox.data.AndOrReadStore._jsonFileUrl

• dojox.data.AndOrReadStore._jsonData

  • type

    Object

• dojox.data.AndOrReadStore._loadInProgress

  • type

    bool

• dojox.data.AndOrReadStore._loadFinished

  • type

    bool

• dojox.data.AndOrReadStore._handleQueuedFetches

  • summary

    Internal function to execute delayed request in the store.
    Execute any deferred fetches now.

  • type

    Function

• dojox.data.AndOrReadStore._queuedFetches

  • type

    Array

• dojox.data.AndOrReadStore._getItemsArray

  • parameters:
    • queryOptions: (typeof object)

      The query options parameter, if any.

  • summary

    Internal function to determine which list of items to search over.

  • type

    Function

• dojox.data.AndOrReadStore.close

  • parameters:
    • request: (typeof dojo.data.api.Request)

      || keywordArgs || null

  • summary

    See dojo.data.api.Read.close()

  • type

    Function

• dojox.data.AndOrReadStore._arrayOfAllItems

  • type

    Array

• dojox.data.AndOrReadStore._arrayOfTopLevelItems

  • type

    Array

• dojox.data.AndOrReadStore._itemsByIdentity

  • type

    Object

• dojox.data.AndOrReadStore._getItemsFromLoadedData

  • parameters:
    • dataObject: (typeof Object)

      The JS data object containing the raw data to convery into item format.

  • summary

    Function to parse the loaded data into item format and build the internal items array.

  • description

    Function to parse the loaded data into item format and build the internal items array.

  • return_summary

    array
    Array of items in store item format.

  • type

    Function

• dojox.data.AndOrReadStore._labelAttr

• dojox.data.AndOrReadStore._features.dojo.data.api.Identity

• dojox.data.AndOrReadStore._addReferenceToMap

  • parameters:
    • refItem: (typeof item)

      The item that is referenced.

    • parentItem: (typeof item)

      The item that holds the new reference to refItem.

    • attribute: (typeof string)

      The attribute on parentItem that contains the new reference.

  • summary

    Method to add an reference map entry for an item and attribute.

  • description

    Method to add an reference map entry for an item and attribute. 		 //

  • type

    Function

• dojox.data.AndOrReadStore.getIdentity

  • parameters:
    • item: (typeof item)
  • returns

    Number|Object||String|null

  • summary

    See dojo.data.api.Identity.getIdentity()

  • type

    Function

• dojox.data.AndOrReadStore.fetchItemByIdentity

  • parameters:
    • keywordArgs: (typeof Object)
  • summary

    See dojo.data.api.Identity.fetchItemByIdentity()

  • type

    Function

• dojox.data.AndOrReadStore._getItemByIdentity

  • parameters:
    • identity: (typeof Object)
  • returns

    Object

  • summary

    Internal function to look an item up by its identity map.

  • type

    Function

• dojox.data.AndOrReadStore.getIdentityAttributes

  • parameters:
    • item: (typeof item)
  • returns

    null|Array

  • summary

    See dojo.data.api.Identity.getIdentifierAttributes()

  • type

    Function

• dojox.data.AndOrReadStore._forceLoad

  • summary

    Internal function to force a load of the store if it hasn't occurred yet.  This is required
    for specific functions to work properly.

  • type

    Function

• dojox.data.AndOrReadStore._datatypeMap

  • type

    Object

• dojox.data.AndOrReadStore._datatypeMap.Date

  • type

    Object

• dojox.data.AndOrReadStore._features

  • type

    Object

• dojox.data.AndOrReadStore._storeRefPropName

  • type

    String

• dojox.data.AndOrReadStore._itemNumPropName

  • type

    String

• dojox.data.AndOrReadStore._rootItemPropName

  • type

    String

• dojox.data.AndOrReadStore._reverseRefMap

  • type

    String

• dojox.data

  • type

    Object

• dojox

  • type

    Object