Andrej Cimperšek - diploma

-------------------------------------------------------------------------------

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.