Titanium suds.js的理解

代码部分：

/**

* Suds: A Lightweight JavaScript SOAP Client    一个轻量级的SOAP客户端

* Copyright: 2009 Kevin Whinnery (http://www.kevinwhinnery.com)    版权:xxx

* License: http://www.apache.org/licenses/LICENSE-2.0.html    

* Source: http://github.com/kwhinnery/Suds    源码地址

*/

function SudsClient(_options) {

  //A generic extend function - thanks MooTools    //定义默认变量，修改变量

  function extend(original, extended) {    //传入原件和扩展数据

    extended = extended || {};    //是否拥有对象，木有则创建对象

    for (var key in extended) {    //遍历对象

      if (extended.hasOwnProperty(key)) {    //是否拥有此方法

        original[key] = extended[key];    //将extended自身的方法添加到原件中

      }

    }

    return original;    //返回原件

  }

  

  //Check if an object is an array    //查看一个对象是否为数组

  function isArray(obj) {

    return Object.prototype.toString.call(obj) == '[object Array]';    //获取对象类型

  }

  

  //Grab an XMLHTTPRequest Object    //创建一个XMLHTTPRequest对象

  function getXHR() {

    var xhr;

    if (window.XMLHttpRequest) {

      xhr = new XMLHttpRequest();

    }

    else {

      xhr = new ActiveXObject("Microsoft.XMLHTTP");

    }

    return xhr;    //有对象了

  }

  

  //Parse a string and create an XML DOM object //通过解析string创建一个XMLDOM对象

  function xmlDomFromString(_xml) {    //传进来一个xml格式的string

    var xmlDoc = null;    

    if (window.DOMParser) {    //判断浏览器支持

      parser = new DOMParser();

      xmlDoc = parser.parseFromString(_xml,"text/xml");    //格式成xmlDoc

    }

    else {

      xmlDoc = new ActiveXObject("Microsoft.XMLDOM");

      xmlDoc.async = "false";    //关闭异步

      xmlDoc.loadXML(_xml);    //加载

    }

    return xmlDoc;    //返回

  }

  

  // Convert a JavaScript object to an XML string - takes either an    //将对象(最好是JSON)为XML string

  function convertToXml(_obj) {

    var xml = '';    

    if (isArray(_obj)) {    //先看一下对象是否为数组

      for (var i = 0; i < _obj.length; i++) {

        xml += convertToXml(_obj[i]);

      }

    } else {

      //For now assuming we either have an array or an object graph //假设我们拥有数组或对象任意一个

      for (var key in _obj) {

        xml += '<'+key+'>';

        if (isArray(_obj[key]) || (typeof _obj[key] == 'object' && _obj[key] != null)) {

          xml += convertToXml(_obj[key]);

        }

        else {

          xml += _obj[key];

        }

        xml += '</'+key+'>';

      }

    }

    return xml;    //方法就是遍历整个_obj，再单独遍历单个，将key作为节点，值为值

  }

  

  // Client Configuration //客户端配置

  var config = extend({

    endpoint:'http://localhost',    //这些都是默认配置，在不修改的情况下使用

    targetNamespace: 'http://localhost', //目标命名空间

    envelopeBegin: '<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:ns0="PLACEHOLDER" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">',

    headerBegin: '<soap:Header>',

    headerNode:'head',

    headerEnd: '</soap:Header>',

    bodyBegin:'<soap:Body>',

    envelopeEnd: '</soap:Body></soap:Envelope>',

    timeout: 5000

  },_options);    //_options参数传入需要修改的部分



  // Invoke a web service

  this.invoke = function(_soapAction,_body,_callback,_error,_header) {    //对象调用方法//不需要的直接不传

    //Build request body    

    var body = _body;    //body应该是一个对象样式，转成xml格式

    var header = _header;    //设置header

    

    //Allow straight string input for XML body - if not, build from object

    if (typeof body !== 'string') {        //传入的参数判断

      body = '<'+_soapAction+' xmlns="'+config.targetNamespace+'">';

      body += convertToXml(_body);    //配置格式

      body += '</'+_soapAction+'>';

    }//最终得到xml



    var ebegin = config.envelopeBegin;

    config.envelopeBegin = ebegin.replace('PLACEHOLDER', config.targetNamespace);

    

    //Build Soapaction header - if no trailing slash in namespace, need to splice one in for soap action

    var soapAction = '';    //这段是将_soapAction添加到url中，判定是否有'/'在最后

    if (config.targetNamespace.lastIndexOf('/') != config.targetNamespace.length - 1) {    

      soapAction = config.targetNamespace+'/'+_soapAction;

    }

    else {

      soapAction = config.targetNamespace+_soapAction;

    }

    

    //POST xml 到 服务终结点

    var xhr = getXHR();    //创建对象

    xhr.onload = function() {    //回调函数执行

      _callback.call(this, xmlDomFromString(this.responseText));    //将值转成XMLDOM格式

    };

    xhr.onerror = function() {

      _error.call();    //回调错误代码

    }

    xhr.setTimeout(config.timeout);    //延迟执行时间

    var sendXML = '';    

    if(!header) {    //参数_header暂时木有用到，设置另外的xml doc

        sendXML = config.envelopeBegin+body+config.envelopeEnd;        //发送到值

    } else {

        //Allow straight string input for XML body - if not, build from object

        if (typeof header !== 'string') {    //设置需要的sendXML

          header = '<'+_soapAction+' xmlns="'+config.targetNamespace+'">';

          header += convertToXml(_header);

          header += '</'+_soapAction+'>';

        }

        sendXML = config.envelopeBegin+config.headerBegin+header+config.headerEnd+config.bodyBegin+body+config.envelopeEnd;

    }

    xhr.open('POST',config.endpoint);    //open方法

        xhr.setRequestHeader('Content-Type', 'text/xml'); //请求头类型

        xhr.setRequestHeader('Content-Length', sendXML.length);    //设置长度，节省资源？

        xhr.setRequestHeader('SOAPAction', soapAction);    //设置SOAPAction

        if (config.authorization !== undefined) {    //授权

xhr.setRequestHeader('Authorization', 'Basic ' + config.authorization);

}

        xhr.send(sendXML);    //发送出去

  };

}

使用部分：

var value = '';

var suds = new SudsClient({

    endpoint : url

});



try {

    suds.invoke('', '', function(xmlDoc) {

        var results = xmlDoc.documentElement.getElementsByTagName('EmementName');

        if(results && results.length > 0) {

            value = results.item(0).text;

        }

    });

} catch(e) {

    Ti.API.error('Error: ' + e);

} 

此处使用了GET方法，去掉了很多方法，表示可以使用！

新人初学js，有错误请指出，谢谢！