1
/* IVLE - Informatics Virtual Learning Environment
2
* Copyright (C) 2007-2008 The University of Melbourne
4
* This program is free software; you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License as published by
6
* the Free Software Foundation; either version 2 of the License, or
7
* (at your option) any later version.
9
* This program is distributed in the hope that it will be useful,
10
* but WITHOUT ANY WARRANTY; without even the implied warranty of
11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
* GNU General Public License for more details.
14
* You should have received a copy of the GNU General Public License
15
* along with this program; if not, write to the Free Software
16
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
* Module: File Browser (client)
23
/* Url names for apps */
26
service_app = "fileservice";
28
download_app = "download";
30
/* Mapping MIME types onto handlers.
31
* "text" : When navigating to a text file, the text editor is opened.
32
* "image" : When navigating to an image, the image is displayed (rather than
33
* going to the text editor).
34
* "audio" : When navigating to an audio file, a "play" button is presented.
35
* "binary" : When navigating to a binary file, offer it as a download through
38
* If a file is not on the list, its default action is determined by the first
39
* part of its content type, where "text/*", "image/*" and "audio/*" are
40
* treated as above, and other types are simply treated as binary.
43
"application/x-javascript" : "text",
44
"application/javascript" : "text",
45
"application/json" : "text",
46
"application/xml" : "text"
49
/* Mapping MIME types to icons, just the file's basename */
51
"text/directory": "dir.png",
52
"text/x-python": "py.png"
55
default_type_icon = "txt.png";
57
/* Relative to IVLE root */
58
type_icons_path = "media/images/mime";
59
type_icons_path_large = "media/images/mime/large";
61
/* Mapping SVN status to icons, just the file's basename */
64
"normal": "normal.png",
66
"missing": "missing.png",
67
"deleted": "deleted.png",
68
"modified": "modified.png",
69
"conflicted": "conflicted.png",
70
"revision": "revision.png"
73
/* Mapping SVN status to "nice" strings */
75
"unversioned": "Temporary file",
76
"normal": "Permanent file",
77
"added": "Temporary file (scheduled to be added)",
78
"missing": "Permanent file (missing)",
79
"deleted": "Permanent file (scheduled for deletion)",
80
"replaced": "Permanent file (replaced)",
81
"modified": "Permanent file (modified)",
82
"merged": "Permanent file (merged)",
83
"conflicted": "Permanent file (conflicted)",
84
"revision": "Past Permanent file (revision)"
87
default_svn_icon = null;
88
default_svn_nice = "Unknown status";
90
svn_icons_path = "media/images/svn";
92
published_icon = "media/images/interface/published.png";
94
/* List of MIME types considered "executable" by the system.
95
* Executable files offer a "run" link, implying that the "serve"
96
* application can interpret them.
103
/* Global variables */
105
/** The listing object returned by the server as JSON */
108
current_revision = null;
111
/** Filenames of all files selected
112
* (Only used by dir listings, but still needs to be [] for files, so that
113
* update_actions knows that nothing is selected).
117
upload_callback_count = 0; /* See upload_callback */
119
/** Calls the server using Ajax, performing an action on the server side.
120
* Receives the response from the server and performs a refresh of the page
121
* contents, updating it to display the returned data (such as a directory
122
* listing, file preview, or editor pane).
123
* Always makes a POST request.
126
* \param action String. Name of the action to perform, as defined in the
128
* \param path URL path to make the request to, within the application.
129
* \param args Argument object, as described in util.parse_url and friends.
130
* This should contain the arguments to the action, but NOT the action
131
* itself. (Also a minor side-effect; the "args" object will be mutated
132
* to include the action attribute).
133
* \param content_type String, optional.
134
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
135
* Defaults to "application/x-www-form-urlencoded".
136
* "multipart/form-data" is recommended for large uploads.
138
function do_action(action, path, args, content_type, ignore_response)
140
args.action = action;
141
/* Callback action, when the server returns */
142
var callback = function(response)
144
/* Check for action errors reported by the server, and report them
146
var error = response.getResponseHeader("X-IVLE-Action-Error");
148
/* Note: This header (in particular) comes URI-encoded, to
149
* allow multi-line error messages. Decode */
150
alert("Error: " + decodeURIComponent(error.toString()) + ".");
151
/* Now read the response and set up the page accordingly */
152
if (ignore_response != true)
153
handle_response(path, response, true);
155
/* Call the server and perform the action. This mutates the server. */
156
ajax_call(callback, service_app, path, args, "POST", content_type);
159
/** Calls the server using Ajax, requesting a directory listing. This should
160
* not modify the server in any way. Receives the response from the server and
161
* performs a refresh of the page contents, updating it to display the
162
* returned data (such as a directory listing, file preview, or editor pane).
163
* Called "navigate", can also be used for a simple refresh.
164
* Always makes a GET request.
167
function navigate(path)
169
callback = function(response)
171
/* Read the response and set up the page accordingly */
172
handle_response(path, response, false, url.args);
174
/* Get any query strings */
175
url = parse_url(window.location.href);
177
/* Call the server and request the listing. */
178
ajax_call(callback, service_app, path, url.args, "GET");
181
/* Refreshes the current view.
182
* Calls navigate on the current path.
186
if (maybe_save('All changes since the last save will be lost!'))
187
navigate(current_path);
190
/** Determines the "handler type" from a MIME type.
191
* The handler type is a string, either "text", "image", "audio" or "binary".
193
function get_handler_type(content_type)
197
if (content_type in type_handlers)
198
return type_handlers[content_type];
200
{ /* Based on the first part of the MIME type */
201
var handler_type = content_type.split('/')[0];
202
if (handler_type != "text" && handler_type != "image" &&
203
handler_type != "audio")
204
handler_type = "binary";
209
/** Given an HTTP response object, cleans up and rebuilds the contents of the
210
* page using the response data. This does not navigate away from the page, it
211
* merely rebuilds most of the data.
212
* Note that depending on the type of data returned, this could result in a
213
* directory listing, an image preview, an editor pane, etc.
214
* Figures out the type and calls the appropriate function.
215
* \param path URL path which the request was made for. This can (among other
216
* things) be used to update the URL in the location bar.
217
* \param response XMLHttpRequest object returned by the server. Should
218
* contain all the response data.
219
* \param is_action Boolean. True if this is the response to an action, false
220
* if this is the response to a simple listing. This is used in handling the
222
* \param url_args Arguments dict, for the arguments passed to the URL
223
* in the browser's address bar (will be forwarded along).
225
function handle_response(path, response, is_action, url_args)
227
/* TODO: Set location bar to "path" */
230
/* Clear away the existing page contents */
233
/* Check the status, and if not 200, read the error and handle this as an
235
if (response.status != 200)
237
var error = response.getResponseHeader("X-IVLE-Return-Error");
239
error = response.statusText;
245
var top_level_dir = path==username;
248
var req = ajax_call(null, "userservice", "get_enrolments", null, "GET")
249
subjects = decode_response(req);
253
/* This will always return a listing, whether it is a dir or a file.
255
var listing = response.responseText;
256
/* The listing SHOULD be valid JSON text. Parse it into an object. */
259
listing = JSON.parse(listing);
260
file_listing = listing.listing; /* Global */
266
var err = document.createElement("div");
267
var p = dom_make_text_elem("p", "Error: "
268
+ "There was an unexpected server error processing "
269
+ "the selected command.");
271
p = dom_make_text_elem("p", "If the problem persists, please "
272
+ "contact the system administrator.")
274
p = document.createElement("p");
275
var refresh = document.createElement("input");
276
refresh.setAttribute("type", "button");
277
refresh.setAttribute("value", "Back to file view");
278
refresh.setAttribute("onclick", "refresh()");
279
p.appendChild(refresh);
285
var err = document.createElement("div");
286
var p = dom_make_text_elem("p", "Error: "
287
+ "There was an unexpected server error retrieving "
288
+ "the requested file or directory.");
290
p = dom_make_text_elem("p", "If the problem persists, please "
291
+ "contact the system administrator.")
297
/* Get "." out, it's special */
298
current_file = file_listing["."]; /* Global */
299
delete file_listing["."];
301
if ('revision' in listing)
303
current_revision = listing.revision;
306
/* Check if this is a directory listing or file contents */
307
var isdir = response.getResponseHeader("X-IVLE-Return") == "Dir";
311
home_listing(listing, subjects, path);
315
/* Need to make a 2nd ajax call, this time get the actual file
317
callback = function(response)
319
/* Read the response and set up the page accordingly */
320
handle_contents_response(path, response);
322
/* Call the server and request the listing. */
324
args = shallow_clone_object(url_args);
327
/* This time, get the contents of the file, not its metadata */
328
args['return'] = "contents";
329
ajax_call(callback, service_app, path, args, "GET");
331
update_actions(isdir);
334
function handle_contents_response(path, response)
336
/* Treat this as an ordinary file. Get the file type. */
337
var content_type = response.getResponseHeader("Content-Type");
338
var handler_type = get_handler_type(content_type);
339
would_be_handler_type = handler_type;
340
/* handler_type should now be set to either
341
* "text", "image", "audio" or "binary". */
342
switch (handler_type)
345
handle_text(path, response.responseText,
346
would_be_handler_type);
349
/* TODO: Custom image handler */
350
handle_binary(path, response.responseText);
353
/* TODO: Custom audio handler */
354
handle_binary(path, response.responseText);
362
/* Called when a form upload comes back (from an iframe).
363
* Refreshes the page.
365
function upload_callback()
367
/* This has a pretty nasty hack, which happens to work.
368
* upload_callback is set as the "onload" callback for the iframe which
369
* receives the response from the server for uploading a file.
370
* This means it gets called twice. Once when initialising the iframe, and
371
* a second time when the actual response comes back.
372
* All we want to do is call navigate to refresh the page. But we CAN'T do
373
* that on the first load or it will just go into an infinite cycle of
374
* refreshing. We need to refresh the page ONLY on the second refresh.
375
* upload_callback_count is reset to 0 just before the iframe is created.
377
upload_callback_count++;
378
if (upload_callback_count >= 2)
380
myFrame = frames['upload_iframe'].document;
381
data = myFrame.firstChild.childNodes[1].firstChild.firstChild.nodeValue;
382
data = JSON.parse(data);
384
alert("Error: " + decodeURIComponent(data['Error']));
385
document.getElementsByName('data')[0].value = '';
390
/** Deletes all "dynamic" content on the page.
391
* This returns the page back to the state it is in when the HTML arrives to
392
* the browser, ready for another handler to populate it.
396
dom_removechildren(document.getElementById("filesbody"));
399
/* Checks if a file needs to be saved. If it does, the user will be asked
400
* if they want to continue anyway. The caller must specify a warning
401
* sentence which indicates the consequences of continuing.
402
* Returns true if we should continue, and false if we should not.
404
function maybe_save(warning)
406
if (warning == null) warning = '';
407
if (current_file.isdir) return true;
408
if (document.getElementById("save_button").disabled) return true;
409
return confirm("This file has unsaved changes. " + warning +
410
"\nAre you sure you wish to continue?");
413
/** Deletes all "dynamic" content on the page necessary to navigate from
414
* one directory listing to another (does not clear as much as clearpage
416
* This is the equivalent of calling clearpage() then
417
* setup_for_dir_listing(), assuming the page is already on a dir listing.
419
function clearpage_dir()
421
dom_removechildren(document.getElementById("path"));
422
dom_removechildren(document.getElementById("files"));
423
dom_removechildren(document.getElementById("sidepanel"));
426
/*** HANDLERS for different types of responses (such as dir listing, file,
430
* message may either be a string, or a DOM node, which will be placed inside
433
function handle_error(message)
435
var files = document.getElementById("filesbody");
437
if (typeof(message) == "string")
439
txt_elem = dom_make_text_elem("div", "Error: "
440
+ message.toString() + ".")
444
/* Assume message is a DOM node */
445
txt_elem = document.createElement("div");
446
txt_elem.appendChild(message);
448
txt_elem.setAttribute("class", "padding error");
449
files.appendChild(txt_elem);
452
/** Given a path, filename and optional revision, returns a URL to open that
453
* revision of that file.
455
function build_revision_url(path, filename, revision)
457
bits = {'path': app_path(this_app, path, filename)};
458
if (current_revision)
460
bits['query_string'] = 'r=' + revision;
462
return build_url(bits);
465
/** Given a mime type, returns the path to the icon.
466
* \param type String, Mime type.
467
* \param sizelarge Boolean, optional.
468
* \return Path to the icon. Has applied make_path, so it is relative to site
471
function mime_type_to_icon(type, sizelarge)
474
if (type in type_icons)
475
filename = type_icons[type];
477
filename = default_type_icon;
479
return make_path(path_join(type_icons_path_large, filename));
481
return make_path(path_join(type_icons_path, filename));
484
/** Given an svnstatus, returns the path to the icon.
485
* \param type String, svn status.
486
* \return Path to the icon. Has applied make_path, so it is relative to site
487
* root. May return null to indicate no SVN icon.
489
function svnstatus_to_icon(svnstatus)
492
if (svnstatus in svn_icons)
493
filename = svn_icons[svnstatus];
495
filename = default_svn_icon;
496
if (filename == null) return null;
497
return make_path(path_join(svn_icons_path, filename));
500
/** Given an svnstatus, returns the "nice" string.
502
function svnstatus_to_string(svnstatus)
504
if (svnstatus in svn_nice)
505
return svn_nice[svnstatus];
507
return default_svn_nice;
510
/** Displays a download link to the binary file.
512
function handle_binary(path)
514
var files = document.getElementById("filesbody");
515
var div = document.createElement("div");
516
files.appendChild(div);
517
div.setAttribute("class", "padding");
518
var download_link = app_path(download_app, path);
519
var par1 = dom_make_text_elem("p",
520
"The file " + path + " is a binary file. To download this file, " +
521
"click the following link:");
522
var par2 = dom_make_link_elem("p",
523
"Download " + path, "Download " + path, download_link);
524
div.appendChild(par1);
525
div.appendChild(par2);
528
/* Enable or disable actions1 moreactions actions. Takes either a single
529
* name, or an array of them.*/
530
function set_action_state(names, which, allow_on_revision)
532
if (!(names instanceof Array)) names = Array(names);
534
for (var i=0; i < names.length; i++)
536
element = document.getElementById('act_' + names[i]);
538
!(current_file.svnstatus == 'revision' && !allow_on_revision))
541
element.setAttribute("class", "choice");
542
element.removeAttribute("disabled");
547
element.setAttribute("class", "disabled");
548
element.setAttribute("disabled", "disabled");
553
/* Updates the list of available actions based on files selected */
554
function update_actions()
557
var numsel = selected_files.length;
558
var svn_selection = false;
562
svn_selection = true;
563
for (var i = 0; i < selected_files.length; i++){
564
if (file_listing[selected_files[i]]["svnstatus"] == "unversioned")
566
svn_selection = false;
575
/* Display information about the current directory instead */
576
filename = path_basename(current_path);
579
else if (numsel == 1)
581
filename = selected_files[0];
582
file = file_listing[filename];
585
/* Update each action node in the topbar.
586
* This includes enabling/disabling actions as appropriate, and
587
* setting href/onclick attributes. */
591
/* Available if exactly one file is selected */
592
var open = document.getElementById("act_open");
595
open.setAttribute("class", "choice");
597
open.setAttribute("title",
598
"Navigate to this directory in the file browser");
600
open.setAttribute("title",
601
"Edit or view this file");
602
open.setAttribute("href", build_revision_url(current_path, filename,
607
open.setAttribute("class", "disabled");
608
open.removeAttribute("title");
609
open.removeAttribute("href");
613
/* Available if zero or one files are selected,
614
* and only if this is a file, not a directory */
615
var serve = document.getElementById("act_serve");
616
if (numsel <= 1 && !file.isdir && current_file.svnstatus != 'revision')
618
serve.setAttribute("class", "choice");
619
serve.setAttribute("onclick",
620
"return maybe_save('The last saved version will be served.')");
622
serve.setAttribute("href",
623
app_path(serve_app, current_path));
625
serve.setAttribute("href",
626
app_path(serve_app, current_path, filename));
630
serve.setAttribute("class", "disabled");
631
serve.removeAttribute("href");
632
serve.removeAttribute("onclick");
636
/* Available if exactly one file is selected,
637
* and it is a Python file.
639
var run = document.getElementById("act_run");
641
if (numsel <= 1 && !file.isdir && file.type == "text/x-python"
642
&& current_file.svnstatus != 'revision')
646
// In the edit window
647
var localpath = path_join('/home', current_path);
651
// In the browser window
652
var localpath = path_join('/home', current_path, filename);
654
run.setAttribute("class", "choice");
655
run.setAttribute("onclick", "runfile('" + localpath + "')");
659
run.setAttribute("class", "disabled");
660
run.removeAttribute("onclick");
664
/* Always available for current files.
665
* If 0 files selected, download the current file or directory as a ZIP.
666
* If 1 directory selected, download it as a ZIP.
667
* If 1 non-directory selected, download it.
668
* If >1 files selected, download them all as a ZIP.
670
var download = document.getElementById("act_download");
671
if (current_file.svnstatus == 'revision')
673
download.setAttribute("class", "disabled");
674
download.removeAttribute("onclick");
676
else if (numsel <= 1)
678
download.setAttribute("class", "choice")
681
download.setAttribute("href",
682
app_path(download_app, current_path));
684
download.setAttribute("title",
685
"Download the current directory as a ZIP file");
687
download.setAttribute("title",
688
"Download the current file");
692
download.setAttribute("href",
693
app_path(download_app, current_path, filename));
695
download.setAttribute("title",
696
"Download the selected directory as a ZIP file");
698
download.setAttribute("title",
699
"Download the selected file");
704
/* Make a query string with all the files to download */
705
var dlpath = urlencode_path(app_path(download_app, current_path)) + "?";
706
for (var i=0; i<numsel; i++)
707
dlpath += "path=" + encodeURIComponent(selected_files[i]) + "&";
708
dlpath = dlpath.substr(0, dlpath.length-1);
709
download.setAttribute("class", "choice")
710
download.setAttribute("href", dlpath);
711
download.setAttribute("title",
712
"Download the selected files as a ZIP file");
715
/* Refresh - No changes required */
717
/* Publish and Submit */
718
/* If this directory is under subversion and selected/unselected file is a
720
var publish = document.getElementById("act_publish");
721
var submit = document.getElementById("act_submit");
722
var pubcond = numsel <= 1 && file.isdir;
725
/* If this dir is already published, call it "Unpublish" */
728
publish.setAttribute("value", "unpublish");
729
publish.setAttribute("title" ,"Make it so this directory "
730
+ "can not be seen by anyone on the web");
731
publish.textContent = "Unpublish";
733
publish.setAttribute("value", "publish");
734
publish.setAttribute("title","Make it so this directory "
735
+ "can be seen by anyone on the web");
736
publish.textContent = "Publish";
739
set_action_state(["publish", "submit"], pubcond);
742
/* If exactly 1 non-directory file is selected, and its parent
743
* directory is published.
745
set_action_state("share", numsel == 1 && !file.isdir &&
746
current_file.published);
749
/* If exactly 1 file is selected */
750
set_action_state("rename", numsel == 1);
752
/* Delete, cut, copy */
753
/* If >= 1 file is selected */
754
set_action_state(["delete", "cut", "copy"], numsel >= 1);
756
/* Paste, new file, new directory, upload */
757
/* Disable if the current file is not a directory */
758
set_action_state(["paste", "newfile", "mkdir", "upload"], current_file.isdir);
760
/* Subversion actions */
761
/* These are only useful if we are in a versioned directory and have some
763
set_action_state(["svnadd",], numsel >= 1 && current_file.svnstatus);
764
/* And these are only usefull is ALL the selected files are versioned */
765
set_action_state(["svnremove", "svnrevert", "svncommit", "svncopy",
766
"svncut"], numsel >= 1 && current_file.svnstatus && svn_selection);
768
/* Diff, log and update only support one path at the moment, so we must
769
* have 0 or 1 versioned files selected. If 0, the directory must be
771
single_versioned_path = (
773
(numsel == 1 && (svnst = file_listing[selected_files[0]].svnstatus)) ||
774
(numsel == 0 && (svnst = current_file.svnstatus))
775
) && svnst != "unversioned");
776
set_action_state(["svndiff", "svnupdate"], single_versioned_path);
778
/* We can resolve if we have a file selected and it is conflicted. */
779
set_action_state("svnresolved", single_versioned_path && numsel == 1 && svnst == "conflicted");
781
/* Log should be available for revisions as well. */
782
set_action_state("svnlog", single_versioned_path, true);
784
/* There is currently nothing on the More Actions menu of use
785
* when the current file is not a directory. Hence, just remove
787
* (This makes some of the above decisions somewhat redundant).
788
* We also take this opportunity to show the appropriate actions2
789
* bar for this path. It should either be a save or upload widget.
791
if (current_file.isdir)
793
var actions2_directory = document.getElementById("actions2_directory");
794
actions2_directory.setAttribute("style", "display: inline;");
795
var moreactions = document.getElementById("moreactions_area");
796
moreactions.setAttribute("style", "display: inline;");
800
var actions2_file = document.getElementById("actions2_file");
801
actions2_file.setAttribute("style", "display: inline;");
807
/** Event handler for when an item of the "More actions..." dropdown box is
808
* selected. Performs the selected action. */
809
function handle_moreactions()
811
var moreactions = document.getElementById("moreactions");
812
if (moreactions.value == "top")
814
var selectedaction = moreactions.value;
815
/* Reset to "More actions..." */
816
moreactions.selectedIndex = 0;
818
/* If 0 files selected, filename is the name of the current dir.
819
* If 1 file selected, filename is that file.
821
if (selected_files.length == 0)
822
filename = path_basename(current_path);
823
else if (selected_files.length == 1)
824
filename = selected_files[0];
828
/* Now handle the selected action */
829
switch(selectedaction)
832
action_publish(selected_files);
835
action_unpublish(selected_files);
838
//alert("Not yet implemented: Sharing files");
839
window.open(public_app_path(serve_app, current_path, filename), 'share')
843
alert("Not yet implemented: Submit");
846
action_rename(filename);
849
action_delete(selected_files);
852
action_copy(selected_files);
855
action_cut(selected_files);
867
show_uploadpanel(true);
870
action_add(selected_files);
873
action_remove(selected_files);
876
action_revert(selected_files);
879
window.location = path_join(app_path('diff'), current_path, selected_files[0] || '');
882
action_update(selected_files);
885
action_resolved(selected_files);
888
action_commit(selected_files);
891
window.location = path_join(app_path('svnlog'), current_path, selected_files[0] || '');
894
action_svncopy(selected_files);
897
action_svncut(selected_files);
902
/** User clicks "Run" button.
903
* Do an Ajax call and print the test output.
905
function runfile(localpath)
907
if (!maybe_save('The last saved version will be run.')) return false;
909
/* Dump the entire file to the console */
910
var callback = function()
912
console_enter_line("execfile('" + localpath + "')", "block");
914
start_server(callback)
918
/** Called when the page loads initially.
920
function browser_init()
922
/* Navigate (internally) to the path in the URL bar.
923
* This causes the page to be populated with whatever is at that address,
924
* whether it be a directory or a file.
926
var path = parse_url(window.location.href).path;
927
/* Strip out root_dir + "/files" from the front of the path */
928
var strip = make_path(this_app);
929
if (path.substr(0, strip.length) == strip)
930
path = path.substr(strip.length+1);
933
/* See if this is an edit path */
934
strip = make_path(edit_app);
935
if (path.substr(0, strip.length) == strip)
937
path = path.substr(strip.length+1);
941
if (path.length == 0)
943
/* Navigate to the user's home directory by default */
added
removed
www/media/browser/browser.js
