?YUI IO是一个通讯工具，用于数据获取和内容更新，它使用XMLHttpRequest对象来用于“同区域”请求，当用于“跨区域”请求时，使用相反的传输工具。

开始

<script src="http://yui.yahooapis.com/3.3.0/build/yui/yui-min.js"
    charset="utf-8"></script>

?

// Create a new YUI instance and populate it with the required modules.
YUI().use('io', function (Y) {

    // IO is available and ready for use.

});

一个简单的通讯

?io()方法是用于HTTP请求的最主要方法，这个方法接受的两个参数：uri和configuration

uri：这个参数指定通讯的的URI

configuration：这个参数是一个名值对（key value）的对象，它指定通讯的配置。更多的配置参数请参见下面的：The Configuration Object

io()方法返回一个带有下列成员的对象。

id:通讯过程中的唯一标识

abort():终止指定的通讯

isInProgress():放回一个布尔值，指出通讯是否已经完成。

下面是一个GET通讯：

?

使用IO工具

使用io

模块：

配置对象：

事件：

同步请求：

跨域请求：

序列号HTML表单作为数据：

在HTML表单上上传文件：

设置HTTP头部：

队列：

?

模块：

Io的 核心和补充 功能 分为 基本 模块和 子模块，来使得在选择需要的功能时，加入适合的模块。

配置对象：

这个对象是io()方法的第二个参数，所有属性是可选的，如下。

?

?

??? 响应对象

当一个交互，以XHR对象作为传输工具，响应的数据将作为一个事件处理的对象被传递。

注意：涉及到文件上传或者是跨域请求的交互，使用alternate transports，将仅仅populate responseText或者responseXML域。HTTP status和响应头部（response headers）要么是不可取的（inaccessible）要么是无效的。

?

事件：

两种事件区别不清楚。global 和Transaction。global event，全局事件？；Transaction event 事务事件？

YUI io事件提供了在事务处理（翻译成交互准确不？）过程中获取状态和数据的功能。有两个方面的io事件：global 和transaction。对于所有的事务处理，global event总是被io激发，并且这些事件对所有的订阅者（subscribers）都是有效的。如果它们有定义在Configuration 对象的句柄（handlers），则Transaction events 被创建并激发。global event 的定义结构为：io:eventname 。

以下是subscribe Globle event的例子。

?

function onStart(transactionid, arguments) {
  // transactionid : The transaction's ID.
  // arguments: Array ['foo','bar'].
}

// Subscribe to "io.start".
Y.on('io:start', onStart, Y, { start: ['foo','bar']; );

function onComplete(transactionid, response, arguments) {
  // transactionid : The transaction's ID.
  // response: The response object.
  // arguments: Object containing an array { complete: ['foo', 'bar'] }.
}

// Subscribe to "io.complete".
Y.on('io:complete', onComplete, 
            Y, { complete: ['foo', 'bar'] } );

function onSuccess(transactionid, response, arguments) {
  // transactionid : The transaction's ID.
  // response: The response object.
  // arguments: Boolean value "true".
}

// Subscribe to "io.success".
Y.on('io:success', onSuccess, Y, true);

function onFailure(transactionid, response, arguments) {
  // transactionid : The transaction's ID.
  // response: The response object.  Only status and 
  //           statusText are populated when the 
  //           transaction is terminated due to abort 
  //           or timeout.  The status will read
  //           0, and statusText will return "timeout" 
  //           or "abort" depending on the mode of 
  //           termination.
  // arguments: String "Transaction Failed".
}
// Subscribe to "io.failure".
Y.on('io:failure', onFailure, Y, 'Transaction Failed');

function onEnd(transactionid, arguments) {
  // transactionid : The transaction's ID.
  // arguments: Number 0.
}

// Subscribe to "io.end".
Y.on('io:end', onEnd, Y, 0);

下面的例子证实一个io 交互，这个交互带有订阅到（subscribe to）io:complete上的事件句柄。

// Create a YUI instance using io module.
YUI().use("io-base", function(Y) {
	/*
	 * 为事件"io:complete"创建一个函数作为事件句柄。
	 *
	 * 这个函数将接受以下参数：
	 * - ID：The ID of the transaction
	 * - response data：Object containing the response data.
	 * - Argument one defined when subscribing to the event(e.g., "foo").
	 * - Argument two defined when subscribing to the event(e.g., "bar").
	 */
	function onComplete(transactionId, responseObject, arg1, arg2) {
		/*
		 * 参数responseObject是响应对象，它提供的属性包括：
		 * - status
		 * - statusText
		 * - getResponseHeader(headerName)
		 * - getAllResponseHeaders
		 * - responseText
		 * - responseXML
		 *
		 * 注意：一个XDR交互中，只有responseText或者responseXML是被定义的属性。
		 */
	};

	/*
	 * 使用Y.on订阅到事件io:complete
	 *
	 * - 'io:complete' : 订阅到这个io事件
	 * - onComplete : 将被定义到io:complete上的事件句柄。
	 * - Y : 事件句柄执行的内容，在这个例子中，theYUI sandbox？？？（什么意思？）。因为onComplete被定义为一个全局函数。
	 *       
	 * - 'foo' : The first argument received by the event handler.
	 * - 'bar' : The second argument received by the event handler.
	 *           Additional arguments can be defined, as desired.
	 */
	Y.on('io:complete', onComplete, Y, "foo", "bar");

	// Starts the transaction.
	var request = Y.io(uri);
});


?

同步事务：

对于同域请求，YUI io可以被指明来发送一个同步请求，它将停止所有的脚本执行，直到transaction完成。当transaction完成，响应数据are directly accessible through the object returned by Y.io(), and the data are also accessible through all io events。当使用同步请求，abort()和isInProgress()无效。

// Create a YUI instance using the io-base module.
YUI().use("io-base", function(Y) {
	var cfg,
		request;
	// Create a configuration object for the synchronous transaction.
	cfg = {
		sync: true,
		arguments: { 'foo' : 'bar' }
	};

	/*
	 * var request will contain the following fields, when the
	 * transaction is complete:
	 * - id
	 * - status
	 * - statusText
	 * - getResponseHeader()
	 * - getAllResponseHeaders()
	 * - responseText
	 * - responseXML
	 * - arguments
	 */
	request = Y.io(uri, cfg);
});

跨域请求：

alternate transport 是什么？

交互方式

默认：XMLHttpRequest

也可以用：flash

?

这块不会，请高手指教。

序列号HTML表单作为数据：

YUI io能够序列化HTML表单域到一个UTF-8字符串，名值对。如果transaction是HTTP GET，数据将作为查询字符串加到URI上，如果transaction是HTTP POST ，数据将为POST信息。

// Create a YUI instance using the io-form sub-module.
YUI().use("io-form", function(Y) {
	// Create a configuration object for the file upload transaction.
	// The form configuration should include two defined properties:
	// id: This can be the ID or an object reference to the HTML form.
	// useDisabled: Set this property to "true" to include disabled
	//              HTML form fields, as part of the data.  By
	//              default, disabled fields are excluded from the
	//              serialization.
	// The HTML form data are sent as a UTF-8 encoded key-value string.
	var cfg = {
		method: 'POST',
		form: {
			id: formObject,
			useDisabled: true
		}
	};

	// Define a function to handle the response data.
	function complete(id, o, args) {
	  var id = id; // Transaction ID.
	  var data = o.responseText; // Response data.
	  var args = args[1]; // 'ipsum'.
	};

	// Subscribe to event "io:complete", and pass an array
	// as an argument to the event handler "complete".
	Y.on('io:complete', complete, Y, { 'foo':'bar' });

	// Start the transaction.
	var request = Y.io(uri, cfg);
});

在HTML表单中上传文件：

The default XHR transport, used in io, cannot upload HTML form data that include elements of type="file". In this situation, io will use an alternate transport -- an iframe -- to facilitate the transaction. The response data must be one of the following content types: "text/html", "text/plain", "text/xml". The following example shows how to configure a transaction involving file upload：

?

设置HTTP头部：

YUI().use("io-base", function(Y) {

	// 设置一个新的HTTP头部。Set a new default HTTP header.
	Y.io.header('Content-Type', 'application/json');

	// 移除一个已经存在的头部，使用相同的方法，但忽略它的值。
	Y.io.header('Content-Type');
});

队列：

?

// Create a YUI instance using the io queue sub-module.
//比较简单，不翻译了。
YUI().use("io-queue", function(Y) {

	// Stop the queue so transactions can be stored.
	Y.io.queue.stop();

	// Send four transactions into the queue for storage.
	var task0 = Y.io.queue(uri);
	var task1 = Y.io.queue(uri);
	var task2 = Y.io.queue(uri);
	var task3 = Y.io.queue(uri);

	// Promote task2 to the top of the queue.
	Y.io.queue.promote(task2);

	// Purge task3 from the queue.
	Y.io.queue.purge(task3);

	// Re-start the queue.
	// Transactions are sent in the following order: task2, task0, task 1.
	// Transaction callbacks, if provided, will be processed in the same
	// sequence: task2, task0, task1, regardless of actual response order.
	//
	Y.io.queue.start();
});?

安全公告
已知的问题

?