345
/** Writes a JSONable object to the cookie under a particular key
346
* (JSON encoded and URL encoded).
348
function write_cookie(key, value)
350
var sendstr = encodeURIComponent(key) + "="
351
+ encodeURIComponent(JSON.stringify(value))
352
+ "; path=" + urlencode_path(root_dir);
353
/* This actually just assigns to the key, not replacing the whole cookie
354
* as it appears to. */
355
document.cookie = sendstr;
357
/** Reads a cookie which has a JSONable object encoded as its value.
358
* Returns the object, parsed from JSON.
360
function read_cookie(key)
362
var cookies = document.cookie.split(";");
363
var checkstart = encodeURIComponent(key) + "=";
364
var checklen = checkstart.length;
365
for (var i=0; i<cookies.length; i++)
367
var cookie = cookies[i];
368
while (cookie[0] == ' ')
369
cookie = cookie.substr(1);
370
if (cookie.substr(0, checklen) == checkstart)
372
var valstr = cookie.substr(checklen);
373
valstr = decodeURIComponent(valstr);
374
return JSON.parse(valstr);
379
344
/** Given an argument map, as output in the args parameter of the return of
380
345
* parseurl, gets the first occurence of an argument in the URL string.
381
346
* If the argument was not found, returns null.
603
/** Creates a random string of length length,
604
* consisting of alphanumeric characters.
606
var rand_chars = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZ"
607
+ "abcdefghiklmnopqrstuvwxyz";
608
function random_string(length)
610
var str = Array(length);
612
for (var i=0; i<length; i++)
614
v = Math.floor(Math.random() * rand_chars.length);
615
str[i] = rand_chars.charAt(v);
620
/** Makes an XMLHttpRequest call to the server.
563
/** Makes an asynchronous XMLHttpRequest call to the server.
621
564
* Sends the XMLHttpRequest object containing the completed response to a
622
565
* specified callback function.
624
567
* \param callback A callback function. Will be called when the response is
625
568
* complete. Passed 1 parameter, an XMLHttpRequest object containing the
626
* completed response. If callback is null this is a syncronous request
627
* otherwise this is an asynchronous request.
569
* completed response.
628
570
* \param app IVLE app to call (such as "fileservice").
629
571
* \param path URL path to make the request to, within the application.
630
572
* \param args Argument object, as described in parse_url and friends.
631
* \param method String; "GET", "POST", "PUT", or "PATCH"
632
* \param content_type String, optional.
573
* \param method String; "GET" or "POST"
574
* \param content_type String, optional. Only applies if method is "POST".
575
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
633
576
* Defaults to "application/x-www-form-urlencoded".
635
578
function ajax_call(callback, app, path, args, method, content_type)
580
if (content_type != "multipart/form-data")
638
581
content_type = "application/x-www-form-urlencoded";
639
582
path = app_path(app, path);
641
584
/* A random string, for multipart/form-data
642
585
* (This is not checked against anywhere else, it is solely defined and
643
586
* used within this function) */
644
var boundary = random_string(20);
587
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
645
588
var xhr = new_xmlhttprequest();
646
var asyncronous = callback != null;
649
xhr.onreadystatechange = function()
589
xhr.onreadystatechange = function()
591
if (xhr.readyState == 4)
651
if (xhr.readyState == 4)
657
596
if (method == "GET")
659
598
/* GET sends the args in the URL */
660
599
url = build_url({"path": path, "args": args});
661
600
/* open's 3rd argument = true -> asynchronous */
662
xhr.open(method, url, asyncronous);
601
xhr.open(method, url, true);
667
/* POST & PUT & PATCH sends the args in the request body */
606
/* POST sends the args in application/x-www-form-urlencoded */
668
607
url = encodeURI(path);
669
xhr.open(method, url, asyncronous);
608
xhr.open(method, url, true);
671
610
if (content_type == "multipart/form-data")
673
612
xhr.setRequestHeader("Content-Type",
674
"multipart/form-data; boundary=" + boundary);
613
"multipart/form-data, boundary=" + boundary);
675
614
message = make_multipart_formdata(args, boundary);
677
else if (content_type == "application/x-www-form-urlencoded")
679
618
xhr.setRequestHeader("Content-Type", content_type);
680
619
message = make_query_string(args);
682
else if (content_type == "application/json")
684
xhr.setRequestHeader("Content-Type", content_type);
685
message = JSON.stringify(args);
689
xhr.setRequestHeader("Content-Type", content_type);
621
xhr.setRequestHeader("Content-Length", message.length);
692
622
xhr.send(message);
694
/* Only return the XHR for syncronous requests */
701
/** Attempts to JSON decodes a response object
702
* If a non-200 response or the JSON decode fails then returns null
704
function decode_response(response)
706
if (response.status == 200)
710
var responseText = response.responseText;
711
return JSON.parse(responseText);