jQuery-1.9.1源码分析系列（十六）ajax——响应数据处理和api整理

ajax在得到请求响应后主要会做两个处理：获取响应数据和使用类型转化器转化数据

a.获取响应数据

　　获取响应数据是调用ajaxHandleResponses函数来处理。

　　ajaxHandleResponses的功能有：

　　- 为jqXHR设置所有responseXXX字段(值便是响应数据)

　　- 找到正确的dataType (在content-type和预期的dataType两者中的一个)

　　- 返回正确的响应数据

　　我们看一个响应数据的格式：

　　responses = {
　　　　text: "{"code":500,"data":null,"message"："all exist","sessionId":"wsdfhl333sdfs"}"
　　}

 

　　设置responseXXX只有两种responseXML和responseText

//填写responseXXX(responseXML/responseText)字段，
for ( type in responseFields ) {
if ( type in responses ) {
jqXHR[ responseFields[type] ] = responses[ type ];
}
}

　　找到正确的dataType。这是一个逐一探测的过程

// 除去自动添加的dataType类型，同时在此过程中获得Content-Type类型
while( dataTypes[ 0 ] === "*" ) {
dataTypes.shift();
if ( ct === undefined ) {
ct = s.mimeType || jqXHR.getResponseHeader("Content-Type");
}
}

//检查我们是否正在处理一个已知的content-type
if ( ct ) {
for ( type in contents ) {
if ( contents[ type ] && contents[ type ].test( ct ) ) {
dataTypes.unshift( type );
break;
}
}
}

//检查看看我们是否有预期的数据类型的响应
if ( dataTypes[ 0 ] in responses ) {
finalDataType = dataTypes[ 0 ];
} else {
//尝试可转换的数据类型
for ( type in responses ) {
if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[0] ] ) {
finalDataType = type;
break;
}
if ( !firstDataType ) {
firstDataType = type;
}
}
// Or just use first one
finalDataType = finalDataType || firstDataType;
}

　　返回正确的响应数据

// 如果我们找到一个dataType
// 把dataType到dataTypes中去，如果需要的话
// 返回相应的响应数据
if ( finalDataType ) {
if ( finalDataType !== dataTypes[ 0 ] ) {
dataTypes.unshift( finalDataType );
}
　　　　 return responses[ finalDataType ];
　　}
}

 

b.类型转化器

　　ajax有四种转换器

converters: {
// 任意内容转换为字符串
// window.String 将会在min文件中被压缩为 a.String
"* text": window.String,

// 文本转换为HTML（true表示不需要转换，直接返回）
"text html": true,

// 文本转换为JSON对象
"text json": jQuery.parseJSON,

// 文本转换为XML
"text xml": jQuery.parseXML
}

　　其中jQuery.parseJSON/jQuery.parseXML点击看详情

　　除此之外还有为script专门拓展的

// Ajax请求设置默认的值
jQuery.ajaxSetup({
/**
* 内容类型发送请求头（Content-Type），用于通知服务器该请求需要接收何种类型的返回结果。
* 如果accepts设置需要修改，推荐在$.ajaxSetup() 方法中设置一次。
* @type {Object}
*/
accepts: {
script: "text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"
},
contents: {
script: /(?:java|ecma)script/
},
converters: {
"text script": function(text) {
jQuery.globalEval(text);
return text;
}
}

　　还有一个在jsonp预处理的时候添加的

s.converters["script json"] = function() {
if ( !responseContainer ) {
jQuery.error( callbackName + " was not called" );
}
return responseContainer[ 0 ];
};

 

　　dataType无非就那么几种情况

　　1：dataType为空,自动转化

　　此时jQuery只能根据报文头信息是猜测当前需要处理的类型（ajaxHandleResponses中）

// 删除掉通配dataType，得到返回的Content-Type
while (dataTypes[0] === "*") {
dataTypes.shift();
if (ct === undefined) {
ct = s.mimeType || jqXHR.getResponseHeader("Content-Type");
}
}

　　通过xhr.getAllResponseHeaders()得到报文头信息，然后去匹配Content-Type所有对象的值即可

　　当然找到这个Content-Type = “html”,我们还得看看有没有对应处理的方法，如果有就需要替换这个dataTypes（ajaxHandleResponses中）

// 看看是不是我们能处理的Content-Type，比如图片这类二进制类型就不好处理了
if (ct) {
// 实际上能处理的就是text、xml和json
for (type in contents) {
if (contents[type] && contents[type].test(ct)) {
dataTypes.unshift(type);
break;
}
}
}

dc34

　　经过这个流程后，dataTypes 本来是* 就变成了对应的html了，这是jquery内部的自动转化过程。

 

　　2：dataType开发者指定 

　　xml, json, script, html, jsop

　　

　　最终ajax成功以后统一调用ajaxConvert函数处理。所以转换器总结起来就一句话：类型转换器将服务端响应的responseText或responseXML，转换为请求时指定的数据类型dataType，如果没有指定类型就依据响应头Content-Type自动处理。根据目标类型选择响应的转换器转换成目标数据。

　　

c. jQuery. ajaxSetup ( target[, settings] )

　　函数如果用于外部使用没有settings这个参数：用于设置AJAX的全局默认设置。

　　这个函数有两个用法

　　1.当target、settings两个参数传递的时候，创建一个完整成熟的设置对象（包含ajaxSettings和传递的settings）写入到target中。最终jQuery.ajaxSettings这个全局变量没有改变。这个用法主要是jQuery内部使用，外部使用没有意义。

　　2.当settings不存在的时候（即只有一个参数），则将target写入jQuery.ajaxSettings。这个用法在外部使用较多。主要是设置AJAX的全局默认设置。

　　查看源码

//创建一个完整成熟的设置对象（包含ajaxSettings和传递的settings）写入到target中。
//如果settings省略，则将target写入ajaxSettings.
ajaxSetup: function( target, settings ) {
return settings ?
ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
ajaxExtend( jQuery.ajaxSettings, target );
}

　　使用到ajaxExtend函数，通过jQuery.ajaxSettings.flatOptions指定那些选项不做深度拓展（深度拷贝替换），其他的都做深度拓展。默认的不做深度拓展的选项只有两个jQuery.ajaxSettings.flatOptions: {url: true,context: true}。外部可以直接将不做深度拓展的选项添加到jQuery.ajaxSettings.flatOptions上。

//为ajax选项专门做拓展的函数
//对flatOptions里面的选项(不需要深度拓展（深度拷贝替换）)
function ajaxExtend( target, src ) {
var deep, key,
flatOptions = jQuery.ajaxSettings.flatOptions || {};

//针对不需要深度拓展的选项保存在target[key]中，需要深度拓展的选项保存在deep[key]中。
for ( key in src ) {
if ( src[ key ] !== undefined ) {
( flatOptions[ key ] ? target : ( deep || (deep = {}) ) )[ key ] = src[ key ];
}
}
//将deep中的内容深度拓展（深度拷贝替换）到target中
if ( deep ) {
jQuery.extend( true, target, deep );
}
return target;
}

 

d. ajax相关api

jQuery.get(url [, data ] [, success ] [, type ])（函数用于通过HTTP GET形式的AJAX请求获取远程数据。

jQuery.get()函数用于实现简单的GET形式的AJAX请求，它在底层是使用jQuery.ajax()来实现的，只是省略了大多数不常用的参数设置，并仅限于HTTP GET方式。请注意，该函数是通过异步方式加载数据的。这里介绍的jQuery.get()是一个全局方法(无需创建jQuery对象即可调用，你可以理解为静态函数)。jQuery中还有一个同名的实例方法get()，用于获取当前jQuery对象中匹配的指定索引的DOM元素。）

 

jQuery.post(url [, data ] [, success ] [, type ])（函数用于通过HTTP POST形式的AJAX请求获取远程数据。

jQuery.post()函数用于实现简单的POST形式的Ajax请求，它在底层是使用jQuery.ajax()来实现的，只是省略了大多数不常用的参数设置，并仅限于HTTP POST方式。请注意，该函数是通过异步方式加载数据的）

 

jQuery.getJSON(url [, data ] [, success ])（函数用于通过HTTP GET形式的AJAX请求获取远程JSON编码的数据。JSON是一种数据格式，JS原生支持JSON格式，通过jQuery.getJSON()从服务器获得的JSON数据，jQuery会先尝试将其转为对应的JS对象。如果请求的URL中包括"callback=?"等类似的部分，jQuery会自动将其视作JSONP，并执行对应的回调函数来获取JSON数据。

重要注意：服务器返回的JSON数据必须符合严格的JSON语法，例如：所有属性名称必须加双引号，所有字符串值也必须加双引号(而不是单引号)。请注意，该函数是通过异步方式加载数据的。）

 

jQuery.getScript(url [, success ])（函数用于通过HTTP GET形式的加载JavaScript文件并运行它。该函数用于动态加载JS文件，并在全局作用域下执行文件中的JS代码。该函数可以加载跨域的JS文件。请注意，该函数是通过异步方式加载数据的）

 

jQuery.fn.load(url [, data ] [, complete ])（函数用于从服务器加载数据，并使用返回的html内容替换当前匹配元素的内容。load()函数默认使用GET方式，如果提供了对象形式的数据，则自动转为POST方式。load()函数只会替换每个匹配元素的内部内容(innerHTML)，所以他会默认dataType为html。你还可以在URL字符串后面追加指定的选择器(与URL之间用空格隔开)，以便于只使用加载的html文档中匹配选择器的部分内容来替换当前匹配元素的内容。如果该文档没有匹配选择器的内容，就使用空字符串("")来替换当前匹配元素的内容。

如果当前jQuery对象没有匹配任何元素，则不会执行远程加载请求。

这里介绍的load()是一个Ajax请求函数，jQuery中还有一个同名的事件函数load()，用于在文档加载完成时执行指定的函数。该函数属于jQuery对象(实例)。该函数在底层是基于函数jQuery.ajax()实现的）

 

jQuery.ajaxPrefilter([ dataType ,] handler)（函数用于指定预先处理Ajax参数选项的回调函数。在所有参数选项被jQuery.ajax()函数处理之前，你可以使用该函数设置的回调函数来预先更改任何参数选项。

　　你还可以指定数据类型(dataType)，从而只预先处理指定数据类型的参数选项。该函数可以调用多次，以便于为不同数据类型的AJAX请求指定不同的回调函数

　　dataType（可选/String类型）

　　一个或多个用空格隔开的数据类型所组成的字符串。如果未指定该参数，则表示所有数据类型。可用的数据类型为"xml"、 "html"、 "text"、 "json"、 "jsonp"、 "script"。该字符串为它们之间的任意组合(多种类型用空格隔开)，例如："xml"、 "text html"、 "script json jsonp"。

　　handler （Function类型）

　　用于预处理参数选项的回调函数。它有以下3个参数：

　　options：(Object对象)当前AJAX请求的所有参数选项。

　　originalOptions：(Object对象)传递给$.ajax()方法的未经修改的参数选项。

　　jqXHR：当前请求的jqXHR对象(经过jQuery封装的XMLHttpRequest对象)。

）

 

jQuery.ajaxSetup(settingsObj) (函数用于设置AJAX的全局默认设置。该函数用于更改jQuery中AJAX请求的默认设置选项。之后执行的所有AJAX请求，如果对应的选项参数没有设置，将使用更改后的默认设置。)

 

jQuery.fn.serialize()（函数用于序列化一组表单元素，将表单内容编码为用于提交的字符串。serialize()函数常用于将表单内容序列化，以便用于AJAX提交。

　　该函数主要根据用于提交的有效表单控件的name和value，将它们拼接为一个可直接用于表单提交的文本字符串，该字符串已经过标准的URL编码处理(字符集编码为UTF-8)。

　　该函数不会序列化不需要提交的表单控件，这和常规的表单提交行为是一致的。例如：不在<form>标签内的表单控件不会被提交、没有name属性的表单控件不会被提交、带有disabled属性的表单控件不会被提交、没有被选中的表单控件不会被提交。

　　与常规表单提交不一样的是：常规表单一般会提交带有name的按钮控件，而serialize()函数不会序列化带有name的按钮控件。）

 

jQuery.fn.serializeArray()（函数用于序列化一组表单元素，将表单内容编码为一个JavaScript数组。常用于将表单内容序列化为JSON对象，以便于被编码为JSON格式的字符串。

　　该函数会将可用于提交的每个表单控件封装成一个Object对象，该对象有name和value属性，对应该表单控件的name和value属性。然后将这些Object对象封装为一个数组并返回。

　　该函数不会序列化不需要提交的表单控件，这和常规的表单提交行为是一致的。例如：不在<form>标签内的表单控件不会被提交、没有name属性的表单控件不会被提交、带有disabled属性的表单控件不会被提交、没有被选中的表单控件不会被提交。

　　与常规表单提交不一样的是：常规表单一般会提交带有name的按钮控件，而serializeArray()函数不会序列化带有name的按钮控件。）

 

jQuery.param(obj [, traditional ])（将一个JS数组或纯粹的对象序列化为字符串值，以便用于URL查询字符串或AJAX请求。如果传入的不是数组或"纯粹的对象"，则返回空字符串("")；如果传入的是null、undefined等无法访问属性的值，则直接报错。

　　所谓"纯粹的对象"，就是通过{}或new Object()自行创建的对象。JS内置的Boolean、Number、String、Date、RegExp、Function、Window等类型的对象都不算是"纯粹的对象"。

　　返回的字符串已经过URL编码处理(采用的字符集为UTF-8)）

 

jQuery.fn.ajaxStart(handlerFn)（为AJAX请求的ajaxStart事件绑定处理函数）

jQuery.fn.ajaxSend(handlerFn)（设置当AJAX请求即将被发送时执行的回调函数。）

jQuery.fn.ajaxComplete(handlerFn)（设置当AJAX请求完成(无论成功或失败)时执行的回调函数。）

jQuery.fn.ajaxSuccess(handlerFn)（设置当AJAX请求成功完成时执行的回调函数。）

jQuery.fn.ajaxError(handlerFn)（设置当AJAX请求失败时执行的回调函数。）

jQuery.fn.ajaxStop(handlerFn)（为AJAX请求的ajaxStop事件绑定处理函数。）

　　

　　到此为止，jQuery 1.9.1版本的源码分析完毕。欢迎拍砖指正。

 

　　如果觉得本文不错，请点击右下方【推荐】！