SuperMap.Request

SuperMap.Request命名空间包含了方便使用XMLHttpRequest请求的方法。这些方法使用跨浏览器的W3C兼容类 SuperMap.Request.XMLHttpRequest 来辅助工作。

Summary

SuperMap.Request	SuperMap.Request命名空间包含了方便使用XMLHttpRequest请求的方法。这些方法使用跨浏览器的W3C兼容类 SuperMap.Request.XMLHttpRequest 来辅助工作。
Constants
DEFAULT_CONFIG	{Object} 所有请求的默认配置。
URL_SPLIT_REGEX
Properties
events	用来处理 SuperMap.Request 类的对象上的所有事件。
Functions
DELETE	发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 DELETE。
GET	发送GET请求。附加的配置属性记录在 issue 方法中，方法属性设置为 GET 。
HEAD	发送HTTP HEAD请求。附加的配置属性记录在 issue 方法中，方法属性设置为HEAD。
issue	创建XMLHttpRequest，打开设置header,绑定一个回调函数返回完成状态，并且可以发送数据。建议使用以下几种请求方式： GET, POST, PUT, DELETE, OPTIONS, 或 HEAD 。
OPTIONS	发送HTTP OPTIONS请求。附加的配置属性记录在 issue 方法中，方法属性设置为 OPTIONS。
POST	发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 POST ，Content-Type设置为application/xml。
PUT	发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 PUT ，Content-Type设置为application/xml。

Constants

DEFAULT_CONFIG

{Object} 所有请求的默认配置。

URL_SPLIT_REGEX

Properties

events

用来处理 SuperMap.Request 类的对象上的所有事件。

监听器发送的event对象带有以下三个属性：

request	{SuperMap.Request.XMLHttpRequest} 的请求对象。
config	{Object} 发送指定请求方法的配置对象。
requestUrl	{String} 请求的url。

Supported event types

complete	当发送的请求得到响应时触发。
success	HTTP获得成功状态码(200-299)时触发。
failure	HTTP没有获得成功状态码时触发。

Functions

issue

issue: function( config )

创建XMLHttpRequest，打开设置header,绑定一个回调函数返回完成状态，并且可以发送数据。建议使用以下几种请求方式： GET, POST, PUT, DELETE, OPTIONS, 或 HEAD 。

Parameters

config

{Object} 发送请求的配置属性。

config属性可以设为

method	{String} 可以为GET, POST, PUT, DELETE, HEAD, OPTIONS。默认为GET。
url	{String} 请求的url。
async	{Boolean} 异步请求，默认为true。
user	{String} 验证通过的用户，清除当前的用户设置为null 。
password	{String} 身份验证的密码。清除当前的密码则设为null 。
proxy	{String} 代理。
params	{Object} 添加到作为请求字符串的url上的key:value。
headers	{Object} 设置在请求上的带有header:value的对象。
data	{String \| Document} 请求发送的数据，仅仅适用于 POST 和 PUT 请求。
callback	{Function} 请求完成时调用函数。判断请求是否失败，检查request的status属性。
success	{Function} 如果请求的状态是在200到299，则调用此函数。
failure	{Function} 如果请求的状态是不在200到299，则调用此函数。
scope	{Object} 如果回调函数是对象上的公共方法，则在此对象上设置该函数。

Returns

{XMLHttpRequest} 请求的对象。如要在响应之前中止请求，调用请求对象的abort方法

GET

GET: function( config )

发送GET请求。附加的配置属性记录在 issue 方法中，方法属性设置为 GET 。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。

POST

POST: function( config )

发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 POST ，Content-Type设置为application/xml。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。

PUT

PUT: function( config )

发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 PUT ，Content-Type设置为application/xml。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。

DELETE

DELETE: function( config )

发送POST的请求。附加的配置属性记录在 issue 方法中，方法属性设置为 DELETE。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。

HEAD

HEAD: function( config )

发送HTTP HEAD请求。附加的配置属性记录在 issue 方法中，方法属性设置为HEAD。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。

OPTIONS

OPTIONS: function( config )

发送HTTP OPTIONS请求。附加的配置属性记录在 issue 方法中，方法属性设置为 OPTIONS。

Parameters

config

{Object} 发送请求的配置属性。

Returns

{XMLHttpRequest} 请求对象。