/**
* 發(fā)送一個ajax請求
* @author: allstar, erik, berg
* @name ajax.request
* @function
* @grammar ajax.request(url[, options])
* @param {string} url 發(fā)送請求的url
* @param {Object} options 發(fā)送請求的選項(xiàng)參數(shù)
* @config {String} [method] 請求發(fā)送的類型。默認(rèn)為GET
* @config {Boolean} [async] 是否異步請求。默認(rèn)為true（異步）
* @config {String} [data] 需要發(fā)送的數(shù)據(jù)。如果是GET請求的話，不需要這個屬性
* @config {Object} [headers] 要設(shè)置的http request header
* @config {number} [timeout] 超時時間，單位ms
* @config {String} [username] 用戶名
* @config {String} [password] 密碼
* @config {Function} [onsuccess] 請求成功時觸發(fā)，function(XMLHttpRequest xhr, string responseText)。
* @config {Function} [onfailure] 請求失敗時觸發(fā)，function(XMLHttpRequest xhr)。
* @config {Function} [onbeforerequest] 發(fā)送請求之前觸發(fā)，function(XMLHttpRequest xhr)。
*
* @meta standard
* @see ajax.get,ajax.post
*
* @returns {XMLHttpRequest} 發(fā)送請求的XMLHttpRequest對象
*/
var ajax = {};
ajax.request = function(url,options,type){
// 是否需要異步
var async = options.async||true,
// 用戶名、密碼
username = options.username||"",
password = options.password||"",
// 需要傳輸?shù)臄?shù)據(jù)
data = options.data||"",
// GET還是POST
method = (options.method||"GET").toUpperCase(),
// 請求頭
headers = options.headers||{},
// 事件處理函數(shù)表
eventHandler = {},
// 請求數(shù)據(jù)類型
dataType = type||"string";//xml||string
function stateChangeHandler(){
// 看看是否已經(jīng)準(zhǔn)備好了
if(xhr.readyState == 4){
// 得到xhr當(dāng)前狀態(tài)
var sta = xhr.status;
// 判斷是否成功
if(sta == 200||sta == 304){
// 成功則觸發(fā)成功
fire("success");
}else{
// 失敗則觸發(fā)失敗
fire("failure");
}
// 清除綁定
window.setTimeout(function(){
xhr.onreadystatechange= new Function();
if (async){
xhr = null;
}
},0);
}
}
function fire(type){
// 把type變成ontype
type = "on"+type;
// 在事件處理器表中找到對應(yīng)事件的處理函數(shù)
var handler = eventHandler[type];
// 如果函數(shù)存在，則
if(handler){
// 不成功的話
if(type != "onsuccess"){
handler(xhr);
// 成功了
}else{
// 則根據(jù)dataType返回不同的數(shù)據(jù)
handler(xhr,dataType!="xml"?xhr.responseText:xhr.responseXML);
}
}
}
// 組裝eventHandler
for(var key in options){
eventHandler[key] = options[key];
}
// 新建一個XMLHttpRequest對象
var xhr = new XMLHttpRequest();
// 如果方法是GET，則把數(shù)據(jù)組裝到url中
if(method == "GET"){
url += (url.indexOf("?")>=0)?"&":"?";
url += data;
// 清空data
data = null;
}
// 如果是異步
if (async){
// 綁定readystatechange的處理器
xhr.onreadystatechange = stateChangeHandler;
}
// 看看是否需要輸入密碼
if(username){
xhr.open(method,url,async,username,passowrd);
}else{
xhr.open(method,url,async);
}
// 如果是POST
if(method == "POST"){
// 設(shè)置一下請求頭
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
}
// 把options中的請求頭信息全部設(shè)置進(jìn)去
for(var key in headers){
xhr.setRequestHeader(name,headers[key])
}
// 觸發(fā)事件beforerequest
fire("beforerequest");
// 發(fā)送數(shù)據(jù)
xhr.send(data);
// 如果不是異步
if (!async){
// 則直接運(yùn)行stateChangeHandler來處理數(shù)據(jù)
stateChangeHandler();
}
return xhr;
}

/**
* 發(fā)送一個post請求
* @name ajax.post
* @function
* @grammar ajax.post(url, data[, onsuccess])
* @param {string} url 發(fā)送請求的url地址
* @param {string} data 發(fā)送的數(shù)據(jù)
* @param {Function} [onsuccess] 請求成功之后的回調(diào)函數(shù)，function(XMLHttpRequest xhr, string responseText)
* @meta standard
* @see ajax.get,ajax.request
*
* @returns {XMLHttpRequest} 發(fā)送請求的XMLHttpRequest對象
*/
ajax.post = function(url,data,onsuccess){
return ajax.request(url,{"data":data,"onsuccess":onsuccess,method:"POST"});
}

/**
* 發(fā)送一個get請求
* @name ajax.get
* @function
* @grammar ajax.get(url[, onsuccess])
* @param {string} url 發(fā)送請求的url地址
* @param {Function} [onsuccess] 請求成功之后的回調(diào)函數(shù)，function(XMLHttpRequest xhr, string responseText)
* @meta standard
* @see ajax.post,ajax.request
*
* @returns {XMLHttpRequest} 發(fā)送請求的XMLHttpRequest對象
*/
ajax.get = function(url,data,onsuccess){
return ajax.request(url,{"data":data,"onsuccess":onsuccess});
}