blob: 46419838129904e30f235531ec7dcbce15c29156 [file] [log] [blame]
-------------------------------------------------------------------------------
DojoX Data
-------------------------------------------------------------------------------
Version 1.1
Release date: 03/18/2008
-------------------------------------------------------------------------------
Project state: production
-------------------------------------------------------------------------------
Project authors
Jared Jurkiewicz (jared.jurkiewicz@gmail.com) (FileStore, HtmlStore, XmlStore, FlickrStore, CssRuleStore, CssClassStore, AppStore, others).
Shane O'Sullivan (shaneosullivan1@gmail.com) (FlickrRestStore, AtomReadStore, GoogleSeachStore, GoogleFeedStore)
Wolfram Kriesing (wolfram@kriesing.de) (QueryReadStore)
Dustin Machi (dmachi@dojotolkit.org) (jsonPathStore);
Russell Jones (KeyValueStore) (CLA)
Benjamin Schell (KeyValueStore, CssRuleStore, CssClassStore, AppStore, OpenSearchStore) (Corporate CLA)
Kurt Stutsman (kurt@snaplogic.org) (SnapLogicStore)
Kris Zyp (kzyp@dojotoolkit.org) (JsonRestStore, PersevereStore, S3JsonRestStore, CouchDBRestStore)
Frank Fortson (frank.fortson@equorum.com) (AndOrReadStore, AndOrWriteStore)
-------------------------------------------------------------------------------
Project description
The DojoX Data project is a container for extensions and extra example stores
that implement the dojo.data APIs. It may also contain utility functions for
working with specific types of data.
-------------------------------------------------------------------------------
Dependencies:
DojoX Data has dependencies on core dojo (dojo.data), dojox.xml for XmlStore
and dojox.data.dom(deprecated) and the D.O.H. unit test framework
-------------------------------------------------------------------------------
Documentation:
See the Dojo API tool (http://dojotoolkit.org/api)
-------------------------------------------------------------------------------
Contributions:
For contributions to be committed into the dojox repository, the datastore
should have basic unit tests that exercise the API's that the store declares it
implements. Documentation and demos are a plus, but unit tests are required
to be committed into this sub-package. This is necessary to help keep the
provided datastores as stable as possible.
-------------------------------------------------------------------------------
Installation instructions
Grab the following from the Dojo SVN Repository:
http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/data/*
Install into the following directory structure:
/dojox/data/
...which should be at the same level as your Dojo checkout.
/dojox/data/*
Require in the dojox.data stores you wish to use.
-------------------------------------------------------------------------------
Additional Notes:
dojox.data.AtomReadStore - Reads Atom XML documents.
dojox.data.CvsStore - comma-separated (spreadsheet output)
datastore implementation
dojox.data.FlickrRestStore - advanced version of: dojox.data.FlickrStore
(Caching + user key support)
dojox.data.FlickrStore - data store driven by Flickr.com public API.
dojox.data.HtmlTableStore - Implementation of an HTML Table reading
datastore
dojox.data.HtmlStore - Implementation of an HTML reading datastore. Can
handle tables, ordered and un-ordered lists, and lists of divs.
dojox.data.OpmlStore - Store for reading OMPL formatted data
dojox.data.XmlStore - datastore for XML based services or
documents.
dojox.data.QueryReadStore - datastore to provide serverside URL query
matching. Similar to the 0.4.X ComboBox dataUrl parameter.
dojox.data.jsonPathStore - datastore that takes an arbitrary js object
and uses it as the store. Pre-Alpha at the moment.
dojox.data.KeyValueStore - datastore that mimics a key/value property
file format.
dojox.data.SnapLogicStore - Store to interface to SnapLogic data services.
dojox.data.JsonRestStore - Store to interface with RESTful HTTP/JSON web services.
dojox.data.PersevereStore - Extension of JsonRestStore for Persevere
dojox.data.CouchDBRestStore - Extension of JsonRestStore for CouchDB
dojox.data.S3JsonRestStore - Extension of JsonRestStore for Amazon S3
dojox.data.GoogleSearchStore - Store to interface Google's AJAX search services.
There are many subclasses of this store for particular types of searches:
dojox.data.GoogleWebSearchStore
dojox.data.GoogleBlogSearchStore
dojox.data.GoogleLocalSearchStore
dojox.data.GoogleVideoSearchStore
dojox.data.GoogleNewsSearchStore
dojox.data.GoogleBookSearchStore
dojox.data.GoogleImageSearchStore
dojox.data.AndOrReadStore - Demonstrating a more complex query format allowing AND/OR.
Based directly on dojo.data.ItemFileReadStore.
dojox.data.AndOrWriteStore - Demonstrating a more complex query format allowing AND/OR.
Based directly on dojo.data.ItemFileWriteStore.
dojox.data.FileStore - A lazy-loading store designed for searching filesystems with a provided
PHP back end. Implements dojo.data.api.Read and dojo.data.api.Identity
dojox.data.CssRuleStore - A store that allows searching/querying over Css rules loaded in the page in
the browser.
dojox.data.CssClassStore - A store that allows searching/querying over what classes are defined in the page in
the browser.
dojox.data.AppStore - A store that implements full read, write, and identity APIs for working with ATOM documents.
The store uses the full APP protocol.
dojox.data.OpenSearchStore - A store that implements OpenSearch provider search capability.