597
/** Creates a random string of length length,
598
* consisting of alphanumeric characters.
600
var rand_chars = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZ"
601
+ "abcdefghiklmnopqrstuvwxyz";
602
function random_string(length)
604
var str = Array(length);
606
for (var i=0; i<length; i++)
608
v = Math.floor(Math.random() * rand_chars.length);
609
str[i] = rand_chars.charAt(v);
614
/** Makes an XMLHttpRequest call to the server.
606
/** Makes an asynchronous XMLHttpRequest call to the server.
615
607
* Sends the XMLHttpRequest object containing the completed response to a
616
608
* specified callback function.
618
610
* \param callback A callback function. Will be called when the response is
619
611
* complete. Passed 1 parameter, an XMLHttpRequest object containing the
620
* completed response. If callback is null this is a syncronous request
621
* otherwise this is an asynchronous request.
612
* completed response.
622
613
* \param app IVLE app to call (such as "fileservice").
623
614
* \param path URL path to make the request to, within the application.
624
615
* \param args Argument object, as described in parse_url and friends.
625
* \param method String; "GET", "POST", "PUT", or "PATCH"
626
* \param content_type String, optional.
616
* \param method String; "GET" or "POST"
617
* \param content_type String, optional. Only applies if method is "POST".
618
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
627
619
* Defaults to "application/x-www-form-urlencoded".
629
621
function ajax_call(callback, app, path, args, method, content_type)
623
if (content_type != "multipart/form-data")
632
624
content_type = "application/x-www-form-urlencoded";
633
625
path = app_path(app, path);
635
627
/* A random string, for multipart/form-data
636
628
* (This is not checked against anywhere else, it is solely defined and
637
629
* used within this function) */
638
var boundary = random_string(20);
630
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
639
631
var xhr = new_xmlhttprequest();
640
var asyncronous = callback != null;
643
xhr.onreadystatechange = function()
632
xhr.onreadystatechange = function()
634
if (xhr.readyState == 4)
645
if (xhr.readyState == 4)
651
639
if (method == "GET")
653
641
/* GET sends the args in the URL */
654
642
url = build_url({"path": path, "args": args});
655
643
/* open's 3rd argument = true -> asynchronous */
656
xhr.open(method, url, asyncronous);
644
xhr.open(method, url, true);
661
/* POST & PUT & PATCH sends the args in the request body */
649
/* POST sends the args in application/x-www-form-urlencoded */
662
650
url = encodeURI(path);
663
xhr.open(method, url, asyncronous);
651
xhr.open(method, url, true);
665
653
if (content_type == "multipart/form-data")
667
655
xhr.setRequestHeader("Content-Type",
668
"multipart/form-data; boundary=" + boundary);
656
"multipart/form-data, boundary=" + boundary);
669
657
message = make_multipart_formdata(args, boundary);
671
else if (content_type == "application/x-www-form-urlencoded")
673
661
xhr.setRequestHeader("Content-Type", content_type);
674
662
message = make_query_string(args);
676
else if (content_type == "application/json")
678
xhr.setRequestHeader("Content-Type", content_type);
679
message = JSON.stringify(args);
683
xhr.setRequestHeader("Content-Type", content_type);
664
xhr.setRequestHeader("Content-Length", message.length);
686
665
xhr.send(message);
688
/* Only return the XHR for syncronous requests */
695
/** Attempts to JSON decodes a response object
696
* If a non-200 response or the JSON decode fails then returns null
698
function decode_response(response)
700
if (response.status == 200)
704
var responseText = response.responseText;
705
return JSON.parse(responseText);