`
longgangbai
  • 浏览: 7325791 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

XMLHTTP对象的API详解

阅读更多

XMLHttpRequest

提供客户端同http服务器通讯的协议

Dim HttpReq As New MSXML2.XMLHTTP30 
HttpReq.open "GET", "http://localhost/books.xml", False 
HttpReq.send 
MsgBox HttpReq.responseText 

备注

客户端可以通过XmlHttp对象(MSXML2.XMLHTTP.3.0)向http服务器发送请求并使用微软XML文档对象模型Microsoft® XML Document Object Model (DOM)处理回应。

XMLHttpRequest成员

属性

 

onreadystatechange 指定当readyState属性改变时的事件处理句柄。只写
readyState 返回当前请求的状态,只读.
responseBody 将回应信息正文以unsigned byte数组形式返回.只读
responseStream 以Ado Stream对象的形式返回响应信息。只读
responseText 将响应信息作为字符串返回.只读
responseXML 将响应信息格式化为Xml Document对象并返回,只读
status 返回当前请求的http状态码.只读
statusText 返回当前请求的响应行状态,只读

 

* 表示此属性是W3C文档对象模型的扩展.

方法

 

abort 取消当前请求
getAllResponseHeaders 获取响应的所有http头
getResponseHeader 从响应信息中获取指定的http头
open 创建一个新的http请求,并指定此请求的方法、URL以及验证信息(用户名/密码)
send 发送请求到http服务器并接收回应
setRequestHeader 单独指定请求的某个http头

 

onreadystatechange

指定当readyState属性改变时的事件处理句柄

语法

oXMLHttpRequest.onreadystatechange = funcMyHandler; 

如下的例子演示当XMLHTTPRequest对象的readyState属性改变时调用HandleStateChange函数,当数据接收完毕后(readystate == 4)此页面上的一个按钮将被激活

var xmlhttp=null; 
function PostOrder(xmldoc) 
{ 
   var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.5.0"); 
   xmlhttp.Open("POST", "http://myserver/orders/processorder.asp", false);   
   xmlhttp.onreadystatechange= HandleStateChange; 
   xmlhttp.Send(xmldoc); 
   myButton.disabled = true; 
} 
function HandleStateChange() 
{ 
   if (xmlhttp.readyState == 4) 
   { 
     myButton.disabled = false; 
     alert("Result = " + xmlhttp.responseXML.xml); 
   } 
} 

备注

此属性只写,为W3C文档对象模型的扩展.

readyState

返回XMLHTTP请求的当前状态

语法

lValue = oXMLHttpRequest.readyState; 
var XmlHttp; 
XmlHttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 

function send() { 
    XmlHttp.onreadystatechange = doHttpReadyStateChange; 
    XmlHttp.open("GET", "http://localhost/sample.xml", true); 
    XmlHttp.send(); 
} 

function doHttpReadyStateChange() { 
    if (XmlHttp.readyState == 4) { 
       alert("Done"); 
    } 
} 

备注

变量,此属性只读,状态用长度为4的整型表示.定义如下:

 

0 (未初始化) 对象已建立,但是尚未初始化(尚未调用open方法)
1 (初始化) 对象已建立,尚未调用send方法
2 (发送数据) send方法已调用,但是当前的状态及http头未知
3 (数据传送中) 已接收部分数据,因为响应及http头不全,这时通过responseBody和responseText获取部分数据会出现错误,
4 (完成) 数据接收完毕,此时可以通过通过responseBody和responseText获取完整的回应数据

 

responseBody

返回某一格式的服务器响应数据

语法

strValue = oXMLHttpRequest.responseBody; 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/books.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.responseBody); 

备注

变量,此属性只读,以unsigned array格式表示直接从服务器返回的未经解码的二进制数据。

responseStream

以Ado Stream对象的形式返回响应信息

语法

strValue = oXMLHttpRequest.responseStream; 

备注

变量,此属性只读,以Ado Stream对象的形式返回响应信息。

responseText

将响应信息作为字符串返回

语法

strValue = oXMLHttpRequest.responseText; 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/books.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.responseText); 

备注

变量,此属性只读,将响应信息作为字符串返回。
XMLHTTP尝试将响应信息解码为Unicode字符串,XMLHTTP默认将响应数据的编码定为UTF-8,如果服务器返回的数据带BOM(byte-order mark),XMLHTTP可以解码任何UCS-2 (big or little endian)或者UCS-4 数据。注意,如果服务器返回的是xml文档,此属性并不处理xml文档中的编码声明。你需要使用responseXML来处理。

responseXML

将响应信息格式化为Xml Document对象并返回

语法

var objDispatch = oXMLHttpRequest.responseXML; 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/books.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.responseXML.xml); 

备注

变量,此属性只读,将响应信息格式化为Xml Document对象并返回。如果响应数据不是有效的XML文档,此属性本身不返回XMLDOMParseError,可以通过处理过的DOMDocument对象获取错误信息。

status

返回当前请求的http状态码

语法

lValue = oXMLHttpRequest.status; 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/books.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.status); 

返回值

长整形标准http状态码,定义如下:

Number Description

100

Continue

101

Switching protocols

200

OK

201

Created

202

Accepted

203

Non-Authoritative Information

204

No Content

205

Reset Content

206

Partial Content

300

Multiple Choices

301

Moved Permanently

302

Found

303

See Other

304

Not Modified

305

Use Proxy

307

Temporary Redirect

400

Bad Request

401

Unauthorized

402

Payment Required

403

Forbidden

404

Not Found

405

Method Not Allowed

406

Not Acceptable

407

Proxy Authentication Required

408

Request Timeout

409

Conflict

410

Gone

411

Length Required

412

Precondition Failed

413

Request Entity Too Large

414

Request-URI Too Long

415

Unsupported Media Type

416

Requested Range Not Suitable

417

Expectation Failed

500

Internal Server Error

501

Not Implemented

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

505

HTTP Version Not Supported

 

备注

长整形,此属性只读,返回当前请求的http状态码,此属性仅当数据发送并接收完毕后才可获取。

statusText

返回当前请求的响应行状态

语法

strValue = oXMLHttpRequest.statusText; 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/books.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.statusText); 

备注

字符串,此属性只读,以BSTR返回当前请求的响应行状态,此属性仅当数据发送并接收完毕后才可获取。

abort

取消当前请求

语法

oXMLHttpRequest.abort(); 

备注

调用此方法后,当前请求返回UNINITIALIZED 状态。

getAllResponseHeaders

获取响应的所有http头

语法

strValue = oXMLHttpRequest.getAllResponseHeaders(); 
var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/sample.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.getAllResponseHeaders()); 

输出由web服务器返回的http头信息:

Server:Microsoft-IIS/5.1 
X-Powered-By:ASP.NET 
Date:Sat, 07 Jun 2003 23:23:06 GMT 
Content-Type:text/xml 
Accept-Ranges:bytes 
Last Modified:Sat, 06 Jun 2003 17:19:04 GMT 
ETag:"a0e2eeba4f2cc31:97f" 
Content-Length:9 

备注

每个http头名称和值用冒号分割,并以\r\n结束。当send方法完成后才可调用该方法。

getResponseHeader

从响应信息中获取指定的http头

语法

strValue = oXMLHttpRequest.getResponseHeader(bstrHeader); 
var xmlhttp = new ActiveXObject("MSXML2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/sample.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.getResponseHeader("Server")); 

输出http头中的server列:当前web服务器的版本及名称。

备注

当send方法成功后才可调用该方法。如果服务器返回的文档类型为"text/xml", 则这句话xmlhttp.getResponseHeader("Content-Type");将返回字符串"text/xml"。可以使用getAllResponseHeaders方法获取完整的http头信息。

open

创建一个新的http请求,并指定此请求的方法、URL以及验证信息

语法

oXMLHttpRequest.open(bstrMethod, bstrUrl, varAsync, bstrUser, bstrPassword); 

参数

bstrMethod
http方法,例如:POST、GET、PUT及PROPFIND。大小写不敏感。

bstrUrl
请求的URL地址,可以为绝对地址也可以为相对地址。

varAsync[可选]
布尔型,指定此请求是否为异步方式,默认为true。如果为真,当状态改变时会调用onreadystatechange属性指定的回调函数。

bstrUser[可选]
如果服务器需要验证,此处指定用户名,如果未指定,当服务器需要验证时,会弹出验证窗口。

bstrPassword[可选]
验证信息中的密码部分,如果用户名为空,则此值将被忽略。

下面的例子演示从服务器请求book.xml,并显示其中的book字段。

var xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET","http://localhost/books.xml", false); 
xmlhttp.send(); 
var book = xmlhttp.responseXML.selectSingleNode("//book[@id='bk101']"); 
alert(book.xml); 

备注

调用此方法后,可以调用send方法向服务器发送数据。

send

发送请求到http服务器并接收回应

语法

oXMLHttpRequest.send(varBody); 

参数

varBody
欲通过此请求发送的数据。

xmlhttp = new ActiveXObject("Msxml2.XMLHTTP.3.0"); 
xmlhttp.open("GET", "http://localhost/sample.xml", false); 
xmlhttp.send(); 
alert(xmlhttp.responseXML.xml); 

备注

此方法的同步或异步方式取决于open方法中的bAsync参数,如果bAsync == False,此方法将会等待请求完成或者超时时才会返回,如果bAsync == True,此方法将立即返回。

This method takes one optional parameter, which is the requestBody to use. The acceptable VARIANT input types are BSTR, SAFEARRAY of UI1 (unsigned bytes), IDispatch to an XML Document Object Model (DOM) object, and IStream *. You can use only chunked encoding (for sending) when sending IStream * input types. The component automatically sets the Content-Length header for all but IStream * input types.

如果发送的数据为BSTR,则回应被编码为utf-8, 必须在适当位置设置一个包含charset的文档类型头。

If the input type is a SAFEARRAY of UI1, the response is sent as is without additional encoding. The caller must set a Content-Type header with the appropriate content type.

如果发送的数据为XML DOM object,则回应将被编码为在xml文档中声明的编码,如果在xml文档中没有声明编码,则使用默认的UTF-8。

If the input type is an IStream *, the response is sent as is without additional encoding. The caller must set a Content-Type header with the appropriate content type.

setRequestHeader

单独指定请求的某个http头

语法

oXMLHttpRequest.setRequestHeader(bstrHeader, bstrValue); 

参数

bstrHeader
字符串,头名称。

bstrValue
字符串,值。

 

备注

如果已经存在已此名称命名的http头,则覆盖之。此方法必须在open方法后调用。

分享到:
评论

相关推荐

    XMLHTTP API学习总结

    ### XMLHTTP API学习总结 #### 一、XMLHttpRequest概述 **XMLHttpRequest** 是一个用于实现客户端与服务器异步通信的标准接口。它使得网页能够通过JavaScript发起HTTP请求,并且无需重新加载整个页面即可从服务器...

    xmlHttp详解

    XMLHttp对象提供了多种属性来获取服务器的响应信息: - `readyState`: 表示请求/响应过程的当前状态,共有5个值,4表示请求已完成且响应已就绪。 - `status`: 响应的状态码,200表示成功。 - `responseText`或`...

    易语言源码xmlhttp简单应用.rar

    1. 创建XMLHTTP对象:在易语言中,我们可以使用“创建对象”命令创建XMLHTTP对象,如“创建 对象,变量名为xmlhttp,类型为XMLHTTP”。这将创建一个XMLHTTP实例,为后续的网络通信做好准备。 2. 打开HTTP连接:使用...

    ajax教程html详解

    ajax教程,详细说明了XmlHttp是一套可以在Javascript、...客户端可以通过XmlHttp对象(MSXML2.XMLHTTP.3.0)向http服务器发送请求并使用微软XML文档对象模型Microsoft® XML Document Object Model (DOM)处理回应。

    Microsoft.XMLHttp组件的属性方法

    #### XMLHTTP对象的readyState属性 `readyState`属性是`XMLHTTP`对象的一个关键特性,它反映了服务器处理请求的状态。该属性可以帮助开发者了解请求的进度,并据此执行相应的逻辑或更新用户界面。 - **0(未初始化...

    XML实用大全 XMLHttp

    当服务器响应时,XMLHttp对象会触发一系列的事件,如onreadystatechange,我们可以在此事件中检查readyState和status属性来确定请求的状态和是否成功。 在“XML实用大全-chm”和“xmlhttp.CHM”这两个CHM文件中,很...

    易语言xmlhttp简单应用

    2. **创建XMLHTTP对象**:使用`新建`命令创建一个XMLHTTP对象实例,如`.新建 XMLHTTP`,以便后续操作。 3. **设置请求参数**:在发送请求前,需要配置XMLHTTP对象的一些属性,比如请求方法(GET或POST)、URL、超时...

    XMLHTTPRequest对象详解

    在Internet Explorer中,由于ActiveX的支持,可以使用`new ActiveXObject('Microsoft.XMLHTTP')`创建对象。而在非IE浏览器(如Firefox, Safari, Opera等)中,XMLHTTPRequest被实现为一个内置的JavaScript对象,可以...

    VB6 http post 发送与返回内容处理

    在VB6中,我们可以使用MSXML库中的XMLHTTP对象。在代码中,你需要引用Microsoft XML库,然后实例化XMLHTTP对象: ```vb Dim xhr As New MSXML2.XMLHTTP ``` 接下来,设置HTTP请求的相关属性,如URL、请求类型...

    vb6.0调用webservice详解

    2. **理解代理类**:生成的代理类包含了Web服务的所有操作,每个方法对应Web服务的一个API。你可以像操作普通VB对象一样操作这些方法,传递参数并接收返回值。 3. **实例化Web服务**:在代码中,你需要创建代理类的...

    ajax xmlhttp javascript

    ### AJAX详解:异步JavaScript与XML的精妙融合 AJAX(Asynchronous JavaScript and XML)是一种在无需重新加载整个网页的情况下,能够更新部分网页的技术。它通过在后台与服务器进行少量数据交换,使得网页可以动态...

    XMLHttpRequest对象

    ### XMLHTTPRequest对象详解 在现代Web开发中,Ajax(Asynchronous JavaScript and XML)技术的应用非常广泛,它使得网页能够实现局部刷新,提升了用户体验。而这一切的基础便是`XMLHttpRequest`对象,一个用于在...

    ajax框架,经典结构

    ### AJAX框架经典结构详解 #### 一、引言 AJAX(Asynchronous JavaScript and XML)是一种在无需重新加载整个网页的情况下,能够更新部分网页的技术。它通过在后台与服务器进行少量数据交换,使得网页可以实现动态...

    ajax异步请求

    ### AJAX异步请求详解 #### 一、引言 随着Web技术的发展,用户对网站的交互性和实时性有了更高的需求。传统的网页提交方式在提交表单时会重新加载整个页面,这种方式不仅耗时而且用户体验较差。为了解决这一问题,...

    ajax五步法

    ### AJAX五步法详解 **一、创建XMLHttpRequest对象** 在使用AJAX进行异步通信时,第一步至关重要,即创建`XMLHttpRequest`对象。此对象是实现AJAX的核心,允许JavaScript执行HTTP请求,无需重新加载整个网页即可与...

    ajax原理文档说明txt格式

    XMLHttpRequest对象详解 - **状态码**:`XMLHttpRequest`提供了多种状态码,其中200表示成功,404表示未找到资源等。 - **响应处理**:可以通过`responseText`或`responseXML`获取服务器响应的数据。 - **错误...

Global site tag (gtag.js) - Google Analytics