| Package | laya.net |
| Class | public class HttpRequest |
| Inheritance | HttpRequest  EventDispatcher Object |
HttpRequest 通过封装 HTML XMLHttpRequest 对象提供了对 HTTP 协议的完全的访问，包括做出 POST 和 HEAD 请求以及普通的 GET 请求的能力。 HttpRequest 只提供以异步的形式返回 Web 服务器的响应，并且能够以文本或者二进制的形式返回内容。
注意：建议每次请求都使用新的 HttpRequest 对象，因为每次调用该对象的send方法时，都会清空之前设置的数据，并重置 HTTP 请求的状态，这会导致之前还未返回响应的请求被重置，从而得不到之前请求的响应结果。
| Property | Defined By | ||
|---|---|---|---|
| data : * [read-only] 返回的数据。 | HttpRequest | ||
| http : * [read-only]
本对象所封装的原生 XMLHttpRequest 引用。
| HttpRequest | ||
| url : String [read-only] 请求的地址。 | HttpRequest | ||
| Method | Defined By | ||
|---|---|---|---|
 | event(type:String, data:* = null):Boolean
派发事件。
| EventDispatcher | |
| hasListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
| EventDispatcher | |
| isMouseEvent(type:String):Boolean
检测指定事件类型是否是鼠标事件。
| EventDispatcher | |
| off(type:String, caller:*, listener:Function, onceOnly:Boolean = false):EventDispatcher
从 EventDispatcher 对象中删除侦听器。
| EventDispatcher | |
| offAll(type:String = null):EventDispatcher
从 EventDispatcher 对象中删除指定事件类型的所有侦听器。
| EventDispatcher | |
| on(type:String, caller:*, listener:Function, args:Array = null):EventDispatcher
使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知。
| EventDispatcher | |
| once(type:String, caller:*, listener:Function, args:Array = null):EventDispatcher
使用 EventDispatcher 对象注册指定类型的事件侦听器对象，以使侦听器能够接收事件通知，此侦听事件响应一次后自动移除。
| EventDispatcher | |
send(url:String, data:* = null, method:String = get, responseType:String = text, headers:Array = null):void
发送 HTTP 请求。
| HttpRequest | ||
| Event | Summary | Defined By | ||
|---|---|---|---|---|
| 请求结束后调度。 | HttpRequest | |||
| 请求出错时调度。 | HttpRequest | |||
| 请求进度改变时调度。 | HttpRequest | |||
| data | property |
Hide Inherited Public Methods
Show Inherited Public Methodsdata:* [read-only] 返回的数据。
public function get data():*| http | property |
http:* [read-only] 本对象所封装的原生 XMLHttpRequest 引用。
public function get http():*| url | property |
url:String [read-only] 请求的地址。
public function get url():String| send | () | method |
public function send(url:String, data:* = null, method:String = get, responseType:String = text, headers:Array = null):void发送 HTTP 请求。
Parameters
url:String — 请求的地址。大多数浏览器实施了一个同源安全策略，并且要求这个 URL 与包含脚本的文本具有相同的主机名和端口。
| |
data:* (default = null) | |
method:String (default = get) | |
responseType:String (default = text) | |
headers:Array (default = null) |
| complete | Event |
| error | Event |
| progress | Event |