311
310
if (("path" in obj) && obj.path != null)
313
312
var path = urlencode_path(obj.path.toString());
314
if (url.length > 0 && path.length > 0 && path.charAt(0) != "/")
313
if (url.length > 0 && path.length > 0 && path[0] != "/")
315
314
path = "/" + path;
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.
491
456
function pathlist_to_path(pathlist)
493
458
ret = path_join.apply(null, pathlist);
494
if (ret.charAt(ret.length-1) != '/')
459
if (ret[ret.length-1] != '/')
512
477
return make_path(path_join.apply(null, arguments));
515
/** Generates an absolute URL to a public application
517
function public_app_path(app /*,...*/)
519
return location.protocol + "//" + public_host
520
+ make_path(path_join.apply(null, arguments));
523
480
/** Given a path, gets the "basename" (the last path segment).
525
482
function path_basename(path)
538
495
return str.substr(str.length - substring.length) == substring;
498
/** Equivalent to Python's repr.
499
* Gets the JavaScript string representation.
500
* Actually just calls JSON.stringify.
504
return JSON.stringify(str);
541
507
/** Removes all occurences of a value from an array.
543
509
Array.prototype.removeall = function(val)
553
519
arr.splice(j, i-j);
556
/** Shallow-clones an object */
557
function shallow_clone_object(obj)
565
/** Returns a new XMLHttpRequest object, in a somewhat browser-agnostic
568
function new_xmlhttprequest()
573
return new XMLHttpRequest();
577
/* Internet Explorer */
580
return new ActiveXObject("Msxml2.XMLHTTP");
586
return new ActiveXObject("Microsoft.XMLHTTP");
590
throw("Your browser does not support AJAX. "
591
+ "IVLE requires a modern browser.");
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.
615
* Sends the XMLHttpRequest object containing the completed response to a
616
* specified callback function.
522
/** Makes an XMLHttpRequest call to the server. Waits (synchronously) for a
523
* response, and returns an XMLHttpRequest object containing the completed
618
* \param callback A callback function. Will be called when the response is
619
* 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.
622
526
* \param app IVLE app to call (such as "fileservice").
623
527
* \param path URL path to make the request to, within the application.
624
528
* \param args Argument object, as described in parse_url and friends.
626
530
* \param content_type String, optional. Only applies if method is "POST".
627
531
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
628
532
* Defaults to "application/x-www-form-urlencoded".
533
* \return An XMLHttpRequest object containing the completed response.
630
function ajax_call(callback, app, path, args, method, content_type)
535
function ajax_call(app, path, args, method, content_type)
632
537
if (content_type != "multipart/form-data")
633
538
content_type = "application/x-www-form-urlencoded";
636
541
/* A random string, for multipart/form-data
637
542
* (This is not checked against anywhere else, it is solely defined and
638
543
* used within this function) */
639
var boundary = random_string(20);
640
var xhr = new_xmlhttprequest();
641
var asyncronous = callback != null;
644
xhr.onreadystatechange = function()
646
if (xhr.readyState == 4)
544
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
545
var xhr = new XMLHttpRequest();
652
546
if (method == "GET")
654
548
/* GET sends the args in the URL */
655
549
url = build_url({"path": path, "args": args});
656
/* open's 3rd argument = true -> asynchronous */
657
xhr.open(method, url, asyncronous);
550
/* open's 3rd argument = false -> SYNCHRONOUS (wait for response)
551
* (No need for a callback function) */
552
xhr.open(method, url, false);
662
557
/* POST sends the args in application/x-www-form-urlencoded */
663
558
url = encodeURI(path);
664
xhr.open(method, url, asyncronous);
559
xhr.open(method, url, false);
666
561
if (content_type == "multipart/form-data")
668
563
xhr.setRequestHeader("Content-Type",
669
"multipart/form-data; boundary=" + boundary);
564
"multipart/form-data, boundary=" + boundary);
670
565
message = make_multipart_formdata(args, boundary);
674
569
xhr.setRequestHeader("Content-Type", content_type);
675
570
message = make_query_string(args);
572
xhr.setRequestHeader("Content-Length", message.length);
677
573
xhr.send(message);
679
/* Only return the XHR for syncronous requests */
686
/** Attempts to JSON decodes a response object
687
* If a non-200 response or the JSON decode fails then returns null
689
function decode_response(response)
691
if (response.status == 200)
695
var responseText = response.responseText;
696
return JSON.parse(responseText);