httpManager


简介:

httpManager网络异步请求,通过rd.httpManager获取对象。

方法:

回调方法:

sendRequest


发送网络请求
rd.httpManager.sendRequest(options,HTTPManagerSuccessCallback, HTTPManagerErrorCallback,HTTPManagerProgressCallback);
说明

发送网络请求。 网络请求成功可通过HTTPManagerSuccessCallback回调函数返回。网络请求失败则调用回调函数HTTPManagerErrorCallback。网络请求上传的进度可调用回调函数HTTPManagerProgressCallback。

示例:
var option = {
            method:'GET',
            url:'http://api.u148.net/json/6/1',
            dataType:'json',
            timeout:30000,
            offline:'true',
            expires:60000};

            rd.httpManager.sendRequest(option,function(responseHeader,data)
                {alert(data);},
                function(responseCode,responseHeader,responseMessage)
                {alert(responseMessage);
            });
参数:
  • options:( HTTPManagerOption )必选 网络请求参数
    • HTTPManagerOption:JSON对象,网络请求参数
      • method: (String )可选 异步请求方法类型 包含GET、POST、PUT、DELETE、 HEAD方法,默认为GET请求
      • url: (String )必选 网络请求地址
      • dataType: (String )必选 服务端的响应类型,包括json或者text。
      • bodyType: (String )可选 请求所传入数据类型,"text" 表示对请示的数据保持原始状态,"json"表示对数据转换成key-value请求到服务器(仅Android)。
      • timeout: (Number )可选 网络请求超时时间。单位ms,默认为30000ms。
        • HTTPHeader: (JSON )可选 请求头
        • offline: (String )可选 是否直接调用离线数据 包括"true","false","undefined"。默认为"undefined"。 offline具体参数说明:
          • "true": 直接调用缓存数据,如果缓存数据不存在,执行请求并缓存返回数据;
          • "false": 直接请求数据,并把请求到的数据缓存;
          • "undefined": 直接请求数据,不缓存请求到的数据。
      • expires: (String)可选 离线缓存过期时间。单位为ms。
        • certificate: (JSON )可选 添加证书信息
          • path: (String)可选 证书(.p12证书)的路径
          • password: (String)可选 提取证书的密码。
      • form: (JSON )可选 表单方式提交数据。form字段与body字段不能同时使用。
        • values:(JSON)
        • files:(Array) 支持多文件,包含JSON对象
          • name:(String):必选 表单里的文件域
          • path:(String):必选 上传文件的路径
          • fileName :(String):可选 服务器端保存的文件名称
          • mimeType :(String):可选 上传文件的媒体类型
            • body:(String)可选 字符串形式提交数据。body字段与form字段不能同时使用。
  • HTTPManagerOption:网络请求参数

      HTTPManagerOption {
            property String method,
            property String url,
            property String dataType,
            property String bodyType,
            property Number timeout,
            property JSON HTTPHeader,
            property String offline,
            property Number expires,
            property JSON certificate
                {
                    property String path,
                    property String password,
                };
            property JSON form
                {
                    property JSON values,
                    property Array files
                        [{
                            property String name,
                            property String path,
                            property String fileName,
                            property String mimeType
                        }];
                };  
            property String body;
          }
    
  • HTTPManagerSuccessCallback:网络请求成功的回调函数

      function HTTPManagerSuccessCallback(responseHeader,data) {
          // Handle success
      }
    
    • responseHeader: (JSON对象) 必选 服务器响应头信息
    • data: ( JSON/String ) 必选 服务器返回数据。具体类型依赖于传入的options.dataType字段
    • 返回值:无返回值
  • HTTPManagerErrorCallback:网络请求失败的回调函数

      function HTTPManagerErrorCallback(
          responseCode,responseHeader,responseMessage){
      // Handle error
      }
    
    • responseCode: ( Number ) 必选 服务器响应状态码
    • responseHeader: ( JSON ) 必选 服务器响应头
    • responseMessage: ( String ) 必选 错误信息
    • 返回值:无返回值
  • HTTPManagerProgressCallback: 网络请求上传进度的回调函数。上传的进度,只有包含上传文件的时候才会执行该回调

      function HTTPManagerProgressCallback(progress) {
      // Handle progress
      }
    
    • progress: ( Number ) 必选 上传的进度,0.00~1.00
    • 返回值:无返回值