百度的Ajax.js文件(其实就在百度页面上挂着呢……)
/**//*Title: [Ajax.js简介]
文件名: ajax.js
版本:v1.0.0-100
版权:(c)Baidu.com
作者:chenlin
简介:
> 这个文件是对xmlhttp异步请求进行了简单的封装,
> 主要是将prototytp进行了简化,如果要使用复杂的功能可以使用prototype的ajax.js
> 外部使用时,主要调用方式为
> var myAjax=new Ajax.Request(
> url,
> {
> method: 'get',
> asynchronous: true,
> onSuccess: function(xmlHttp)
> {
> },
> onFailure:function(xmlHttp){
> },
> onException:function(exception){
> }
> }
> );
> 另可使用myAjax.header()和myAjax.evalResponse();
> 其他的都为内部调用函数,外部尽量不要使用。Class: Ajax.Request类
*/Function.prototype.bind = function(object) ...{
var __method = this;
return function() ...{
__method.apply(object, arguments);
}};
/**//*基础ajax类
> 封装了一个函数:Ajax.getTransport()返回一个xmlhttp对象
> 这个类里的函数一般不使用。
*/var Ajax = ...{
getTransport: function() ...{
return Try.these(
function() ...{return new ActiveXObject('Msxml2.XMLHTTP')},
function() ...{return new ActiveXObject('Microsoft.XMLHTTP')},
function() ...{return new XMLHttpRequest()} ) || false;
}};
/**//*基础ajax.base类
> 封装了三个函数:
> setOptions:设置进行ajax请求的参数
> responseIsSuccess:判断异步请求返回是否成功
> responseIsFailure:判断异步请求返回是否失败
> 这个类里的函数也没有必要在实际中使用,只有在扩展是才会使用到
*/Ajax.Base = function() ...{};
Ajax.Base.prototype = ...{
setOptions: function(options) ...{
this.options = ...{
method: 'post',//异步请求方法,可以为get和post,此处为默认post asynchronous: true, //设置是否为异步方式发送, parameters: '' //传递参数,参数都是url编码格式a=valueOfA&b=valueOfB } Object.extend(this.options, options || ...{});//以上三个属性为异步请求的基本属性。 },
responseIsSuccess: function() ...{
return this.transport.status == undefined
|| this.transport.status == 0
|| (this.transport.status >= 200 && this.transport.status < 300);
},
responseIsFailure: function() ...{
return !this.responseIsSuccess();
}};
/**//** 生成一个类Ajax.Request
*/Ajax.Request = new Class();
/**//*定义了xmlhttp请求的状态。
> 0 (未初始化) 对象已建立,但是尚未初始化(尚未调用open方法)
> 1 (初始化) 对象已建立,尚未调用send方法
> 2 (发送数据) send方法已调用,但是当前的状态及http头未知
> 3 (数据传送中) 已接收部分数据,因为响应及http头不全,这时通过responseBody和responseText获取部分数据会出现错误,
> 4 (完成) 数据接收完毕,此时可以通过通过responseBody和responseText获取完整的回应数据
*/Ajax.Request.Events = ['Uninitialized', 'Loading', 'Loaded', 'Interactive', 'Complete'];
/**//**Ajax.Request对象,需要实例化对象,
*
*/Ajax.Request.prototype = Object.extend(new Ajax.Base(),...{
initialize: function(url, options) ...{
this.transport = Ajax.getTransport(); //返回xmlhttp对象 this.setOptions(options); //设置请求的参数,在初始化时写 this.request(url); //进行异步请求 },
request: function(url) ...{
var parameters = this.options.parameters || '';
if (parameters.length > 0) parameters += '&_=';
try ...{
this.url = url;
/**//* * 如果是get方法的化,就将parameters里的内容添加到url里
*/ if (this.options.method == 'get' && parameters.length > 0)
this.url += (this.url.match(/?/) ? '&' : '?') + parameters;
/**//* * 调用xmlhttp的请求函数,进行请求
*/ this.transport.open(this.options.method, this.url,
this.options.asynchronous);
/**//* * 如果是异步请求,对onreadystatechange绑定函数,对于为什么要用定时器,没10ms将状态设为Loading,我也没有明白。
*/ if (this.options.asynchronous) ...{
this.transport.onreadystatechange = this.onStateChange.bind(this);
setTimeout((function() ...{this.respondToReadyState(1)}).bind(this), 10);
} this.setRequestHeaders(); //设置请求里的头部信息,包括编码等信息 /**//* * 对与post方式请求,也可以通过options里的postBody来设,这里就将postbody放到参数里进行传递
*/ var body = this.options.postBody ? this.options.postBody : parameters;
/**//* * 发送post数据
*/ this.transport.send(this.options.method == 'post' ? body : null);
} catch (e) ...{
this.dispatchException(e);
} },
setRequestHeaders: function() ...{
var requestHeaders = ['X-Requested-With', 'XMLHttpRequest'];
if (this.options.method == 'post') ...{
requestHeaders.push('Content-type',
'application/x-www-form-urlencoded');
/**//* Force "Connection: close" for Mozilla browsers to work around
* a bug where XMLHttpReqeuest sends an incorrect Content-length
* header. See Mozilla Bugzilla #246651.
*/ if (this.transport.overrideMimeType)
requestHeaders.push('Connection', 'close');
} if (this.options.requestHeaders)
requestHeaders.push.apply(requestHeaders, this.options.requestHeaders);
for (var i = 0; i < requestHeaders.length; i += 2)
this.transport.setRequestHeader(requestHeaders[i], requestHeaders[i+1]);
},
/**//** 状态改变时,执行respondToReadyState,判断当状态为1时不执行。
*/ onStateChange: function() ...{
var readyState = this.transport.readyState;
if (readyState != 1)
this.respondToReadyState(this.transport.readyState);
},
/**//* * 返回异步请求返回文件的头部信息,name表示名字,函数返回参数值
*/ header: function(name) ...{
try ...{
return this.transport.getResponseHeader(name);
} catch (e) ...{} },
/**//* *如果返回header信息里包括X-JSON/xxx,则会执行xxx的内容
*不是很明白这里,为什么要eval
*/ evalJSON: function() ...{
try ...{
return eval(this.header('X-JSON'));
} catch (e) ...{} },
/**//* * 很简单的函数,如果返回Content-type为text/javascript,则会调用此函数进行执行,我认为这处用途不大
*/ evalResponse: function() ...{
try ...{
return eval(this.transport.responseText);
} catch (e) ...{
this.dispatchException(e);
} },
/**//* *根据返回的状态决定该执行的步骤
*/ respondToReadyState: function(readyState) ...{
var event = Ajax.Request.Events[readyState];
var transport = this.transport, json = this.evalJSON();
if (event == 'Complete') ...{
/**//* *此处如果状态处于完成状态则会进行分析分别调用onSuccess和onFailure,所以一般onComplete不调用为好
*/ try ...{
(this.options['on' + this.transport.status]
|| this.options['on' + (this.responseIsSuccess() ? 'Success' : 'Failure')]
|| function()...{})(transport, json);
} catch (e) ...{
this.dispatchException(e);
} /**//* * 此处对返回js进行了eval
*/ if ((this.header('Content-type') || '').match(/^text/javascript/i))
this.evalResponse();
} try ...{
(this.options['on' + event] || function()...{})(transport, json);
} catch (e) ...{
this.dispatchException(e);
} /**//*
* Avoid memory leak in MSIE: clean up the oncomplete event handler
*/ if (event == 'Complete')
this.transport.onreadystatechange = function()...{};
},
/**//* *错误时调用,一般外部使用onException:function(){}
*/ dispatchException: function(exception) ...{
(this.options.onException || function()...{})(this, exception);
} } );