path: root/lib/xmlrpc.js

/*global exports: false */
"use strict";
// Modification of Matěj Cepl released under the MIT/X11 license
// http://www.opensource.org/licenses/mit-license.php
/*
 *
 * xmlrpc.js beta version 1 Tool for creating XML-RPC formatted requests in
 * JavaScript
 *
 * Copyright 2001 Scott Andrew LePera scott@scottandrew.com
 *
 *
 * License: You are granted the right to use and/or redistribute this code only
 * if this license and the copyright notice are included and you accept that no
 * warranty of any kind is made or implied by the author.
 *
 */

/**
 * checks whether parameter is an array
 *
 * @param obj Object
 * @return Boolean true if obj is array
 *
 * The problem is that in different contexts, Array is not same, and so obj is
 * not an instance of SAME Array.
 */

var XMLRPCMessage = exports.XMLRPCMessage = function XMLRPCMessage(methodname) {
    this.method = methodname || "system.listMethods";
    this.params = [];
    return this;
};

XMLRPCMessage.prototype.myIsArray = function myIsArray(obj) {
    return (typeof obj.sort === 'function');
};


XMLRPCMessage.prototype.setMethod = function (methodName) {
    if (methodName !== undefined) {
        this.method = methodName;
    }
};

XMLRPCMessage.prototype.addParameter = function (data) {
    if (data !== undefined) {
        this.params.push(data);
    }
};

XMLRPCMessage.prototype.xml = function () {

    var method = this.method;

    // assemble the XML message header
    var xml = "";

    xml += "<?xml version=\"1.0\"?>\n";
    xml += "<methodCall>\n";
    xml += "<methodName>" + method + "</methodName>\n";
    xml += "<params>\n";

    // do individual parameters
    this.params.forEach(function (data) {
        xml += "<param>\n";
        xml += "<value>" +
            this.getParamXML(this.dataTypeOf(data),
                data) + "</value>\n";
        xml += "</param>\n";
    }, this);
    xml += "</params>\n";
    xml += "</methodCall>";

    return xml; // for now
};

XMLRPCMessage.prototype.dataTypeOf = function (o) {
    // identifies the data type
    var type = typeof (o);
    type = type.toLowerCase();
    switch (type) {
    case "number":
        if (Math.round(o) === o) {
            type = "i4";
        } else {
            type = "double";
        }
        break;
    case "object":
        if ((o instanceof Date)) {
            type = "date";
        } else if (this.myIsArray(o)) {
            type = "array";
        } else {
            type = "struct";
        }
        break;
    }
    return type;
};

XMLRPCMessage.prototype.doValueXML = function (type, data) {
    var xml = "<" + type + ">" + data + "</" + type + ">";
    return xml;
};

XMLRPCMessage.prototype.doBooleanXML = function (data) {
    var value = (data === true) ? 1 : 0;
    var xml = "<boolean>" + value + "</boolean>";
    return xml;
};

XMLRPCMessage.prototype.doDateXML = function (data) {
    function leadingZero(n) {
        // pads a single number with a leading zero. Heh.
        if (n.length === 1) {
            n = "0" + n;
        }
        return n;
    }
    function dateToISO8601(date) {
        // wow I hate working with the Date object
        var year = date.getYear();
        var month = this.leadingZero(date.getMonth());
        var day = this.leadingZero(date.getDate());
        var time = this.leadingZero(date.getHours()) +
            ":" + this.leadingZero(date.getMinutes()) +
            ":" + this.leadingZero(date.getSeconds());

        var converted = year + month + day + "T" + time;
        return converted;
    }

    var xml = "<dateTime.iso8601>";
    xml += dateToISO8601(data);
    xml += "</dateTime.iso8601>";
    return xml;
};

XMLRPCMessage.prototype.doArrayXML = function (data) {
    var xml = "<array><data>\n";
    for (var i = 0; i < data.length; i++) {
        xml += "<value>" +
            this.getParamXML(this.dataTypeOf(data[i]),
                data[i]) + "</value>\n";
    }
    xml += "</data></array>\n";
    return xml;
};

XMLRPCMessage.prototype.doStructXML = function (data) {
    var xml = "<struct>\n";
    for (var i in data) {
        xml += "<member>\n";
        xml += "<name>" + i + "</name>\n";
        xml += "<value>" + this.getParamXML(this.dataTypeOf(data[i]),
                        data[i]) + "</value>\n";
        xml += "</member>\n";
    }
    xml += "</struct>\n";
    return xml;
};

XMLRPCMessage.prototype.getParamXML = function (type, data) {
    var xml;
    switch (type) {
    case "date":
        xml = this.doDateXML(data);
        break;
    case "array":
        xml = this.doArrayXML(data);
        break;
    case "struct":
        xml = this.doStructXML(data);
        break;
    case "boolean":
        xml = this.doBooleanXML(data);
        break;
    default:
        xml = this.doValueXML(type, data);
        break;
    }
    return xml;
};