README 3.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  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. Project description
  17. A Collection of advanced and experimental IO modules:
  18. * scriptFrame.js - Uses an iframe for dojo.io.script requests. Useful in some
  19. long-polling comet situations in Firefox and Opera. Those browsers execute scripts
  20. in DOM order, not network-receive order, so a long-polling script will block other
  21. dynamically appended scripts from running until it completes. By using an iframe
  22. for the dojo.io.script requests, this issue can be avoided.
  23. * xhrMultiPart.js - Constructs multi-part mime XHR requests. Useful when wanting
  24. multi-part requests but not using a form with a file input. Note that it does not
  25. allow you to send files from local disks -- a form with a file input is required
  26. for that use case. xhrMultipart is not useful in that use case.
  27. * xhrPlugins.js - An adapter registry for having multiple XHR handlers (like
  28. XDomainRequest, CS-XHR, proxy, and window.name)
  29. * windowName.js - Cross-domain transport using window.name
  30. xhrWindowNamePlugin.js - window.name plugin for XHR adapter registry
  31. * httpParse.js - HTTP message parser. Parses to an XHR like interface.
  32. * OAuth.js - Object to be used for signing OpenAuth requests. Includes easy
  33. wrappers for xhr.
  34. -------------------------------------------------------------------------------
  35. Dependencies:
  36. DojoX IO xhrMultiPart depends on Dojo Core and DojoX UUID's generateRandomUuid
  37. function.
  38. xhrWindowNamePlugin depends on dojox.secure.capability for safe JSON parsing
  39. OAuth depends on dojox.encoding.digests.SHA1.
  40. -------------------------------------------------------------------------------
  41. Documentation
  42. -------------------------------------------------------------------------------
  43. Installation instructions
  44. Grab the following from the Dojo SVN Repository:
  45. http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid.js
  46. http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/uuid/*
  47. http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/secure/*
  48. http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/encoding/digests/*
  49. Install into the following directory structure:
  50. /dojox/uuid/
  51. /dojox/secure/
  52. /dojox/encoding/digests/
  53. AND
  54. Grab the following from the Dojo SVN Repository:
  55. http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/io/*
  56. Install into the following directory structure:
  57. /dojox/io/
  58. ...both of which should be at the same level as your Dojo checkout.
  59. -------------------------------------------------------------------------------
  60. Additional Notes
  61. The information contained in this README does not pertain to DojoX XHR IFrame Proxy.
  62. For that information see proxy/README.