src/cm/media/js/lib/yui/yui3.0.0/releasenotes/README.io
author Yves-Marie Haussonne <ymh.work+github@gmail.com>
Fri, 09 May 2014 18:35:26 +0200
changeset 656 a84519031134
parent 0 40c8f766c9b8
permissions -rw-r--r--
add link to "privacy policy" in the header test
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     1
*** 3.0.0 ***
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     2
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     3
* Native cross-domain transactions are now supported in io-xdr.  To specify an XDR transaction, set the configuration object with the following properties:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     4
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     5
- use: Specify either 'native' or 'flash' as the desired XDR transport.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     6
- credentials: Set to true if cookies are to be sent with the request.  Does not work with XDomainRequest(e.g., IE8) or the Flash transport.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     7
- datatType: Set to 'xml' if the response is an XML document.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     8
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     9
For example:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    10
var configuration.xdr = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    11
	use: 'flash', //Required -- 'flash' or 'native'.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    12
	credentials: true, //Optional.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    13
	dataType: 'xml' //Optional.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    14
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    15
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    16
The 'use' property is required.  The others are optional or functionality-specific.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    17
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    18
When using the native transport, io will fallback to the Flash transport if the browser is not capable of supporting the native mode.  Make sure the resource responds with the correct "Access-Control-Allow-Origin" header before attempting a native XDR request.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    19
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    20
* The sub-module 'datatype-xml' is now a dependency for io-xdr, to support XML response data in XDR transactions.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    21
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    22
* XDR transport initialization is simplified to one required value -- the path to Flash transport. For example: Y.io.transport({ src:'io.swf' });
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    23
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    24
*** 3.0.0 beta 1 ***
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    25
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    26
* The io-queue sub-module now implements YUI Queue.  The io queue interface allows transaction callback handlers to be processed in the order the transactions were sent, regardless of actual server response order.  For example:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    27
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    28
- io queue is used to make three requests.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    29
- The actual server response order happens to be: transaction 2, 1, 3.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    30
- However, using the queue interface, the transaction callbacks are processed in the order of: transaction 1, 2, 3.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    31
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    32
* All transaction event flows now resolves to "success" or "failure"; the abort
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    33
event is removed.  Transaction abort and timeout conditions resolve to "failure", and is distinguishable in the response data.  Specifically, the response object's status and statusText properties will be populated as:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    34
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    35
- response.status will be 0.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    36
- response.statusText will be set to "timeout" or "abort" to differentiate the two possible conditions.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    37
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    38
* A new "end" event is introduced in the transaction event flow; this is the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    39
terminal event for all transactions.  Its event handler signature is the same as
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    40
the "start" event, receiving the transaction id and user-defined arguments.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    41
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    42
- The global event name is "io:end".
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    43
- To subscribe to the transaction event, define the "end" property in the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    44
transaction's configuration object. { on: { end: function() { } } }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    45
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    46
*** 3.0.0 PR2 ***
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    47
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    48
* YUI io is now comprised of several modules, allowing users to specify and
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    49
implement only the needed modules.  These modules are:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    50
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    51
- io-base.js: This is the IO base class, using XMLHttpRequest as the transport.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    52
- io-xdr.js: This sub-module extends IO to enable cross-domain transactions
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    53
using Flash as the transport.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    54
- io-form.js: This sub-module extends IO to enable the serialization of an HTML
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    55
form as transaction data.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    56
- io-upload-iframe.js: This sub-module extends IO, to allow file uploads with an
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    57
HTML form, using an iframe transport.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    58
- io-queue.js: This sub-module extends IO to add transaction queuing
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    59
capabilities.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    60
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    61
* [FIXED] SF2262707.  If defined in the configuration object, user-specified,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    62
HTTP "Content-Type" headers will correctly override POST default headers, for
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    63
HTTP POST transactions.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    64
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    65
* XML is not supported as a response datatype when using sub-modules io-xdr.js
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    66
and io-upload-iframe.js.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    67
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    68
*** 3.0.0 PR1 ***
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    69
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    70
* Initial Release