egret.URLRequest

包    egret

类    public class URLRequest

继承    egret.URLRequest → egret.HashObject

URLRequest 类可捕获单个 HTTP 请求中的所有信息。

公共属性

属性
data : any 一个对象，它包含将随 URL 请求一起传输的数据
method : string 请求方式，有效值为URLRequestMethod.GET 或 URLRequestMethod.POST
requestHeaders : Array<egret.URLRequestHeader> 要追加到 HTTP 请求的 HTTP 请求标头的数组
url : string 所请求的 URL

公共方法

方法
URLRequest(url:string) 创建一个 egret.URLRequest 对象

属性详细信息

data

data : any = null

• 支持版本:Egret 2.4
• 运行平台:Web,Native

一个对象，它包含将随 URL 请求一起传输的数据。该属性与 method 属性配合使用。当 method 值为 GET 时，将使用 HTTP 查询字符串语法将 data 值追加到 URLRequest.url 值。当 method 值为 POST（或 GET 之外的任何值）时，将在 HTTP 请求体中传输 data 值。URLRequest API 支持二进制 POST，并支持 URL 编码变量和字符串。该数据对象可以是 ArrayBuffer、URLVariables 或 String 对象。该数据的使用方式取决于所用对象的类型：如果该对象为 ArrayBuffer 对象，则 ArrayBuffer 对象的二进制数据用作 POST 数据。对于 GET，不支持 ArrayBuffer 类型的数据。如果该对象是 URLVariables 对象，并且该方法是 POST，则使用 x-www-form-urlencoded 格式对变量进行编码，并且生成的字符串会用作 POST 数据。如果该对象是 URLVariables 对象，并且该方法是 GET，则 URLVariables 对象将定义要随 URLRequest 对象一起发送的变量。否则，该对象会转换为字符串，并且该字符串会用作 POST 或 GET 数据。

method

method : string = URLRequestMethod.GET

• 支持版本:Egret 2.4
• 运行平台:Web,Native

请求方式，有效值为URLRequestMethod.GET 或 URLRequestMethod.POST。

requestHeaders

requestHeaders : Array<egret.URLRequestHeader> = []

• 支持版本:Egret 2.4
• 运行平台:Web,Native

要追加到 HTTP 请求的 HTTP 请求标头的数组。该数组由 URLRequestHeader 对象组成。数组中的每一对象必须是包含一个名称字符串和一个值字符串的 URLRequestHeader 对象。由于浏览器兼容性原因，该属性在 html5 中并未实现

url

url : string = ""

• 支持版本:Egret 2.4
• 运行平台:Web,Native

所请求的 URL。

方法详细信息

URLRequest()

public URLRequest(url:string)

创建一个 egret.URLRequest 对象

• 支持版本:Egret 2.4
• 运行平台:Web,Native
• 参数
  • url:string - 进行网络请求的地址

示例

/*
 * 以下示例演示了使用 URLLoader 加载图片资源。
 */
class  URLRequestExample  extends  egret.DisplayObjectContainer  {
  public  constructor()  {
    super();
    this.startLoad();
  }
  private  startLoad():  void  {
    //创建 URLLoader 对象
    const loader: egret.URLLoader  =  new  egret.URLLoader();
    //设置加载方式为纹理
    loader.dataFormat  = egret.URLLoaderDataFormat.TEXTURE;
    //添加加载完成侦听
    loader.addEventListener(egret.Event.COMPLETE,  this.onLoadComplete,  this);
    //添加加载失败侦听
    loader.addEventListener(egret.IOErrorEvent.IO_ERROR,  this.onLoadError,  this);
    const url:  string  =  "resource/assets/egret_icon.png";
    const request: egret.URLRequest  =  new  egret.URLRequest(url);
    //开始加载
    loader.load(request);
  }
  private  onLoadComplete(event: egret.Event):  void  {
    egret.log("onLoadComplete");
    const loader: egret.URLLoader  =  <egret.URLLoader>event.target;
    //获取加载到的纹理对象
    const texture: egret.Texture  =  <egret.Texture>loader.data;
    egret.log(texture);
  }
  private  onLoadError():  void  {
    egret.log("onLoadError");
  }
}