| 1 | ------------------------------------------------------------------------------- |
|---|
| 2 | DojoX IO |
|---|
| 3 | ------------------------------------------------------------------------------- |
|---|
| 4 | Version 0.4.0 |
|---|
| 5 | Release date: 07/04/2008 |
|---|
| 6 | ------------------------------------------------------------------------------- |
|---|
| 7 | Project state: |
|---|
| 8 | experimental |
|---|
| 9 | ------------------------------------------------------------------------------- |
|---|
| 10 | Credits |
|---|
| 11 | Bryan Forbes (bryan AT reigndropsfall.net) |
|---|
| 12 | Kris Zyp (kris AT sitepen.com) |
|---|
| 13 | James Burke (jburke AT dojotoolkit.org) |
|---|
| 14 | Tom Trenka (ttrenka AT gmail.com) |
|---|
| 15 | |
|---|
| 16 | ------------------------------------------------------------------------------- |
|---|
| 17 | Project description |
|---|
| 18 | |
|---|
| 19 | A Collection of advanced and experimental IO modules: |
|---|
| 20 | |
|---|
| 21 | * scriptFrame.js - Uses an iframe for dojo.io.script requests. Useful in some |
|---|
| 22 | long-polling comet situations in Firefox and Opera. Those browsers execute scripts |
|---|
| 23 | in DOM order, not network-receive order, so a long-polling script will block other |
|---|
| 24 | dynamically appended scripts from running until it completes. By using an iframe |
|---|
| 25 | for the dojo.io.script requests, this issue can be avoided. |
|---|
| 26 | |
|---|
| 27 | * xhrMultiPart.js - Constructs multi-part mime XHR requests. Useful when wanting |
|---|
| 28 | multi-part requests but not using a form with a file input. Note that it does not |
|---|
| 29 | allow you to send files from local disks -- a form with a file input is required |
|---|
| 30 | for that use case. xhrMultipart is not useful in that use case. |
|---|
| 31 | |
|---|
| 32 | * xhrPlugins.js - An adapter registry for having multiple XHR handlers (like |
|---|
| 33 | XDomainRequest, CS-XHR, proxy, and window.name) |
|---|
| 34 | |
|---|
| 35 | * windowName.js - Cross-domain transport using window.name |
|---|
| 36 | xhrWindowNamePlugin.js - window.name plugin for XHR adapter registry |
|---|
| 37 | |
|---|
| 38 | * httpParse.js - HTTP message parser. Parses to an XHR like interface. |
|---|
| 39 | |
|---|
| 40 | * OAuth.js - Object to be used for signing OpenAuth requests. Includes easy |
|---|
| 41 | wrappers for xhr. |
|---|
| 42 | |
|---|
| 43 | ------------------------------------------------------------------------------- |
|---|
| 44 | Dependencies: |
|---|
| 45 | |
|---|
| 46 | DojoX IO xhrMultiPart depends on Dojo Core and DojoX UUID's generateRandomUuid |
|---|
| 47 | function. |
|---|
| 48 | |
|---|
| 49 | xhrWindowNamePlugin depends on dojox.secure.capability for safe JSON parsing |
|---|
| 50 | |
|---|
| 51 | OAuth depends on dojox.encoding.digests.SHA1. |
|---|
| 52 | ------------------------------------------------------------------------------- |
|---|
| 53 | Documentation |
|---|
| 54 | |
|---|
| 55 | ------------------------------------------------------------------------------- |
|---|
| 56 | Installation instructions |
|---|
| 57 | |
|---|
| 58 | Grab the following from the Dojo SVN Repository: |
|---|
| 59 | http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid.js |
|---|
| 60 | http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid/* |
|---|
| 61 | http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/secure/* |
|---|
| 62 | http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/encoding/digests/* |
|---|
| 63 | |
|---|
| 64 | Install into the following directory structure: |
|---|
| 65 | /dojox/uuid/ |
|---|
| 66 | /dojox/secure/ |
|---|
| 67 | /dojox/encoding/digests/ |
|---|
| 68 | |
|---|
| 69 | AND |
|---|
| 70 | |
|---|
| 71 | Grab the following from the Dojo SVN Repository: |
|---|
| 72 | http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/io/* |
|---|
| 73 | |
|---|
| 74 | Install into the following directory structure: |
|---|
| 75 | /dojox/io/ |
|---|
| 76 | |
|---|
| 77 | ...both of which should be at the same level as your Dojo checkout. |
|---|
| 78 | ------------------------------------------------------------------------------- |
|---|
| 79 | Additional Notes |
|---|
| 80 | |
|---|
| 81 | The information contained in this README does not pertain to DojoX XHR IFrame Proxy. |
|---|
| 82 | For that information see proxy/README. |
|---|
