| ------------------------------------------------------------------------------- |
| DojoX IO |
| ------------------------------------------------------------------------------- |
| Version 0.4.0 |
| Release date: 07/04/2008 |
| ------------------------------------------------------------------------------- |
| Project state: |
| experimental |
| ------------------------------------------------------------------------------- |
| Credits |
| Bryan Forbes (bryan AT reigndropsfall.net) |
| Kris Zyp (kris AT sitepen.com) |
| James Burke (jburke AT dojotoolkit.org) |
| Tom Trenka (ttrenka AT gmail.com) |
| |
| ------------------------------------------------------------------------------- |
| Project description |
| |
| A Collection of advanced and experimental IO modules: |
| |
| * scriptFrame.js - Uses an iframe for dojo.io.script requests. Useful in some |
| long-polling comet situations in Firefox and Opera. Those browsers execute scripts |
| in DOM order, not network-receive order, so a long-polling script will block other |
| dynamically appended scripts from running until it completes. By using an iframe |
| for the dojo.io.script requests, this issue can be avoided. |
| |
| * xhrMultiPart.js - Constructs multi-part mime XHR requests. Useful when wanting |
| multi-part requests but not using a form with a file input. Note that it does not |
| allow you to send files from local disks -- a form with a file input is required |
| for that use case. xhrMultipart is not useful in that use case. |
| |
| * xhrPlugins.js - An adapter registry for having multiple XHR handlers (like |
| XDomainRequest, CS-XHR, proxy, and window.name) |
| |
| * windowName.js - Cross-domain transport using window.name |
| xhrWindowNamePlugin.js - window.name plugin for XHR adapter registry |
| |
| * httpParse.js - HTTP message parser. Parses to an XHR like interface. |
| |
| * OAuth.js - Object to be used for signing OpenAuth requests. Includes easy |
| wrappers for xhr. |
| |
| ------------------------------------------------------------------------------- |
| Dependencies: |
| |
| DojoX IO xhrMultiPart depends on Dojo Core and DojoX UUID's generateRandomUuid |
| function. |
| |
| xhrWindowNamePlugin depends on dojox.secure.capability for safe JSON parsing |
| |
| OAuth depends on dojox.encoding.digests.SHA1. |
| ------------------------------------------------------------------------------- |
| Documentation |
| |
| ------------------------------------------------------------------------------- |
| Installation instructions |
| |
| Grab the following from the Dojo SVN Repository: |
| http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid.js |
| http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid/* |
| http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/secure/* |
| http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/encoding/digests/* |
| |
| Install into the following directory structure: |
| /dojox/uuid/ |
| /dojox/secure/ |
| /dojox/encoding/digests/ |
| |
| AND |
| |
| Grab the following from the Dojo SVN Repository: |
| http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/io/* |
| |
| Install into the following directory structure: |
| /dojox/io/ |
| |
| ...both of which should be at the same level as your Dojo checkout. |
| ------------------------------------------------------------------------------- |
| Additional Notes |
| |
| The information contained in this README does not pertain to DojoX XHR IFrame Proxy. |
| For that information see proxy/README. |