2 * Copyright 2007, 2008, 2009 Electronic Business Systems Ltd.
4 * This file is part of GSS.
6 * GSS is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * GSS is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with GSS. If not, see <http://www.gnu.org/licenses/>.
19 package gr.ebs.gss.client;
21 import gr.ebs.gss.client.clipboard.Clipboard;
22 import gr.ebs.gss.client.dnd.DnDFocusPanel;
23 import gr.ebs.gss.client.rest.GetCommand;
24 import gr.ebs.gss.client.rest.RestException;
25 import gr.ebs.gss.client.rest.resource.FileResource;
26 import gr.ebs.gss.client.rest.resource.FolderResource;
27 import gr.ebs.gss.client.rest.resource.TrashResource;
28 import gr.ebs.gss.client.rest.resource.UserResource;
30 import java.util.Iterator;
31 import java.util.List;
33 import com.allen_sauer.gwt.dnd.client.DragContext;
34 import com.allen_sauer.gwt.dnd.client.PickupDragController;
35 import com.allen_sauer.gwt.dnd.client.VetoDragException;
36 import com.google.gwt.core.client.EntryPoint;
37 import com.google.gwt.core.client.GWT;
38 import com.google.gwt.user.client.Command;
39 import com.google.gwt.user.client.Cookies;
40 import com.google.gwt.user.client.DOM;
41 import com.google.gwt.user.client.DeferredCommand;
42 import com.google.gwt.user.client.Window;
43 import com.google.gwt.user.client.WindowResizeListener;
44 import com.google.gwt.user.client.ui.AbsolutePanel;
45 import com.google.gwt.user.client.ui.AbstractImagePrototype;
46 import com.google.gwt.user.client.ui.DockPanel;
47 import com.google.gwt.user.client.ui.HTML;
48 import com.google.gwt.user.client.ui.HasHorizontalAlignment;
49 import com.google.gwt.user.client.ui.HasVerticalAlignment;
50 import com.google.gwt.user.client.ui.HorizontalSplitPanel;
51 import com.google.gwt.user.client.ui.Label;
52 import com.google.gwt.user.client.ui.RootPanel;
53 import com.google.gwt.user.client.ui.SourcesTabEvents;
54 import com.google.gwt.user.client.ui.TabListener;
55 import com.google.gwt.user.client.ui.TabPanel;
56 import com.google.gwt.user.client.ui.TreeItem;
57 import com.google.gwt.user.client.ui.VerticalPanel;
58 import com.google.gwt.user.client.ui.Widget;
62 * Entry point classes define <code>onModuleLoad()</code>.
64 public class GSS implements EntryPoint, WindowResizeListener {
67 * A constant that denotes the completion of an IncrementalCommand.
69 public static final boolean DONE = false;
71 public static final int VISIBLE_FILE_COUNT = 100;
74 * Instantiate an application-level image bundle. This object will provide
75 * programmatic access to all the images needed by widgets.
77 private static Images images = (Images) GWT.create(Images.class);
78 private GlassPanel glassPanel = new GlassPanel();
81 * An aggregate image bundle that pulls together all the images for this
82 * application into a single bundle.
84 public interface Images extends TopPanel.Images, StatusPanel.Images, FileMenu.Images, EditMenu.Images, SettingsMenu.Images, GroupMenu.Images, FilePropertiesDialog.Images, MessagePanel.Images, FileList.Images, SearchResults.Images, Search.Images, Groups.Images, Folders.Images {
86 @Resource("gr/ebs/gss/resources/document.png")
87 AbstractImagePrototype folders();
89 @Resource("gr/ebs/gss/resources/edit_group_22.png")
90 AbstractImagePrototype groups();
92 @Resource("gr/ebs/gss/resources/search.png")
93 AbstractImagePrototype search();
97 * The single GSS instance.
99 private static GSS singleton;
102 * Gets the singleton GSS instance.
104 * @return the GSS object
106 public static GSS get() {
107 if (GSS.singleton == null)
108 GSS.singleton = new GSS();
109 return GSS.singleton;
113 * The Application Clipboard implementation;
115 private Clipboard clipboard = new Clipboard();
117 private UserResource currentUserResource;
120 * The top panel that contains the menu bar.
122 private TopPanel topPanel;
125 * The panel that contains the various system messages.
127 private MessagePanel messagePanel = new MessagePanel(GSS.images);
130 * The bottom panel that contains the status bar.
132 private StatusPanel statusPanel = new StatusPanel(GSS.images);
135 * The top right panel that displays the logged in user details
137 private UserDetailsPanel userDetailsPanel = new UserDetailsPanel();
140 * The file list widget.
142 private FileList fileList;
145 * The group list widget.
147 private Groups groups = new Groups(images);
150 * The search result widget.
152 private SearchResults searchResults;
155 * A widget that displays a message indicating that communication with the
156 * server is underway.
158 private LoadingIndicator loading;
161 * The tab panel that occupies the right side of the screen.
163 private TabPanel inner = new TabPanel();
166 * The split panel that will contain the left and right panels.
168 private HorizontalSplitPanel splitPanel = new HorizontalSplitPanel();
171 * The horizontal panel that will contain the search and status panels.
173 private DockPanel searchStatus = new DockPanel();
178 private Search search;
181 * The widget that displays the tree of folders.
183 private Folders folders = new Folders(images);
186 * The currently selected item in the application, for use by the Edit menu
187 * commands. Potential types are Folder, File, User and Group.
189 private Object currentSelection;
192 * The authentication token of the current user.
194 private String token;
197 * The WebDAV password of the current user
199 private String webDAVPassword;
201 private PickupDragController dragController;
203 public void onModuleLoad() {
204 // Initialize the singleton before calling the constructors of the
205 // various widgets that might call GSS.get().
207 RootPanel.get().add(glassPanel, 0, 0);
208 parseUserCredentials();
209 dragController = new PickupDragController(RootPanel.get(), false) {
212 public void previewDragStart() throws VetoDragException {
213 super.previewDragStart();
214 if (context.selectedWidgets.isEmpty())
215 throw new VetoDragException();
217 if(context.draggable != null){
218 DnDFocusPanel toDrop = (DnDFocusPanel) context.draggable;
219 //prevent drag and drop for trashed files and for unselected tree items
220 if(toDrop.getFiles() != null && folders.isTrashItem(folders.getCurrent()))
221 throw new VetoDragException();
222 else if(toDrop.getItem() != null && !toDrop.getItem().equals(folders.getCurrent()))
223 throw new VetoDragException();
224 else if(toDrop.getItem() != null && !toDrop.getItem().isDraggable())
225 throw new VetoDragException();
231 protected Widget newDragProxy(DragContext aContext) {
232 AbsolutePanel container = new AbsolutePanel();
233 DOM.setStyleAttribute(container.getElement(), "overflow", "visible");
234 for (Iterator iterator = aContext.selectedWidgets.iterator(); iterator.hasNext();) {
235 Widget widget = (Widget) iterator.next();
236 DnDFocusPanel book = (DnDFocusPanel) widget;
237 HTML html = book.cloneHTML();
239 container.add(new Label("Drag ME"));
246 dragController.setBehaviorDragProxy(true);
247 dragController.setBehaviorMultipleSelection(false);
248 topPanel = new TopPanel(GSS.images);
249 topPanel.setWidth("100%");
251 messagePanel.setWidth("100%");
252 messagePanel.setVisible(false);
254 search = new Search(images);
255 searchStatus.add(search, DockPanel.WEST);
256 searchStatus.add(userDetailsPanel, DockPanel.EAST);
257 searchStatus.setCellHorizontalAlignment(userDetailsPanel, HasHorizontalAlignment.ALIGN_RIGHT);
258 searchStatus.setCellVerticalAlignment(search, HasVerticalAlignment.ALIGN_MIDDLE);
259 searchStatus.setCellVerticalAlignment(userDetailsPanel, HasVerticalAlignment.ALIGN_MIDDLE);
260 searchStatus.setWidth("100%");
262 fileList = new FileList(images);
264 searchResults = new SearchResults(images);
266 // Inner contains the various lists.
267 inner.getTabBar().setStyleName("gss-TabBar");
268 inner.setStyleName("gss-TabPanel");
269 inner.add(fileList, createHeaderHTML(images.folders(), "Files"), true);
271 inner.add(groups, createHeaderHTML(images.groups(), "Groups"), true);
272 inner.add(searchResults, createHeaderHTML(images.search(), "Search Results"), true);
273 inner.setWidth("100%");
276 inner.addTabListener(new TabListener() {
277 public void onTabSelected(SourcesTabEvents sender, int tabIndex) {
280 fileList.clearSelectedRows();
281 fileList.updateCurrentlyShowingStats();
284 groups.updateCurrentlyShowingStats();
287 searchResults.clearSelectedRows();
288 searchResults.updateCurrentlyShowingStats();
293 public boolean onBeforeTabSelected(SourcesTabEvents sender, int tabIndex) {
298 // Add the left and right panels to the split panel.
299 splitPanel.setLeftWidget(folders);
300 splitPanel.setRightWidget(inner);
301 splitPanel.setSplitPosition("25%");
302 splitPanel.setSize("100%", "100%");
304 // Create a dock panel that will contain the menu bar at the top,
305 // the shortcuts to the left, the status bar at the bottom and the
306 // right panel taking the rest.
307 VerticalPanel outer = new VerticalPanel();
309 outer.add(searchStatus);
310 outer.add(messagePanel);
311 outer.add(splitPanel);
312 outer.add(statusPanel);
313 outer.setWidth("100%");
314 outer.setCellHorizontalAlignment(messagePanel, HasHorizontalAlignment.ALIGN_CENTER);
318 loading = new LoadingIndicator();
320 // Hook the window resize event, so that we can adjust the UI.
321 Window.addWindowResizeListener(this);
323 // Clear out the window's built-in margin, because we want to take
324 // advantage of the entire client area.
325 Window.setMargin("0px");
327 // Finally, add the outer panel to the RootPanel, so that it will be
329 RootPanel.get().add(outer);
331 // Call the window resized handler to get the initial sizes setup. Doing
332 // this in a deferred command causes it to occur after all widgets'
333 // sizes have been computed by the browser.
334 DeferredCommand.addCommand(new Command() {
335 public void execute() {
336 onWindowResized(Window.getClientWidth(), Window.getClientHeight());
342 * Fetches the User object for the specified username.
344 * @param username the username of the user
346 private void fetchUser(final String username) {
347 String path = getApiPath() + username + "/";
348 GetCommand<UserResource> getUserCommand = new GetCommand<UserResource>(UserResource.class, username, path){
351 public void onComplete() {
352 currentUserResource = getResult();
353 final String announcement = currentUserResource.getAnnouncement();
354 if (announcement != null)
355 DeferredCommand.addCommand(new Command() {
356 public void execute() {
357 displayInformation(announcement);
363 public void onError(Throwable t) {
364 GWT.log("Fetching user error", t);
365 if(t instanceof RestException)
366 GSS.get().displayError("No user found:"+((RestException)t).getHttpStatusText());
368 GSS.get().displayError("System error fetching user data:"+t.getMessage());
372 DeferredCommand.addCommand(getUserCommand);
376 * Parse and store the user credentials to the appropriate fields.
378 private void parseUserCredentials() {
379 Configuration conf = (Configuration) GWT.create(Configuration.class);
380 String cookie = conf.authCookie();
381 String auth = Cookies.getCookie(cookie);
382 String domain = Window.Location.getHostName();
383 String path = Window.Location.getPath();
384 Cookies.setCookie(cookie, "", null, domain, path, false);
387 // Redundant, but silences warnings about possible auth NPE, below.
390 int sepIndex = auth.indexOf(conf.cookieSeparator());
393 token = auth.substring(sepIndex + 1, auth.length());
394 final String username = auth.substring(0, sepIndex);
395 if (username == null)
398 refreshWebDAVPassword();
400 DeferredCommand.addCommand(new Command() {
401 public void execute() {
408 * Redirect the user to the login page for authentication.
410 protected void authenticateUser() {
411 Configuration conf = (Configuration) GWT.create(Configuration.class);
412 Window.Location.assign(conf.loginUrl() + "?next=" + GWT.getModuleBaseURL());
416 * Redirect the user to the logout page.
419 Configuration conf = (Configuration) GWT.create(Configuration.class);
420 Window.Location.assign(conf.logoutUrl());
424 * Creates an HTML fragment that places an image & caption together, for use
427 * @param imageProto an image prototype for an image
428 * @param caption the group caption
429 * @return the header HTML fragment
431 private String createHeaderHTML(AbstractImagePrototype imageProto, String caption) {
432 String captionHTML = "<table class='caption' cellpadding='0' " +
433 "cellspacing='0'>" + "<tr><td class='lcaption'>" + imageProto.getHTML() +
434 "</td><td class='rcaption'><b style='white-space:nowrap'> " +
435 caption + "</b></td></tr></table>";
442 * @see com.google.gwt.user.client.WindowResizeListener#onWindowResized(int,int)
444 public void onWindowResized(int width, int height) {
445 // Adjust the split panel to take up the available room in the window.
446 int newHeight = height - splitPanel.getAbsoluteTop() - 44;
449 splitPanel.setHeight("" + newHeight);
452 public boolean isFileListShowing(){
453 int tab = inner.getTabBar().getSelectedTab();
454 if(tab == 0) return true;
458 public boolean isSearchResultsShowing(){
459 int tab = inner.getTabBar().getSelectedTab();
460 if(tab == 2) return true;
465 * Make the user list visible.
467 public void showUserList() {
472 * Make the file list visible.
474 public void showFileList() {
475 fileList.updateFileCache(false, true /*clear selection*/);
480 * Make the file list visible.
483 public void showFileList(boolean update) {
484 TreeItem currentFolder = getFolders().getCurrent();
485 if (currentFolder != null) {
486 List<FileResource> files = null;
487 Object cachedObject = currentFolder.getUserObject();
488 if (cachedObject instanceof FolderResource) {
489 FolderResource folder = (FolderResource) cachedObject;
490 files = folder.getFiles();
491 } else if (cachedObject instanceof TrashResource) {
492 TrashResource folder = (TrashResource) cachedObject;
493 files = folder.getFiles();
496 getFileList().setFiles(files);
498 fileList.updateFileCache(update, true /*clear selection*/);
503 * Make the search results visible.
504 * @param query the search query string
506 public void showSearchResults(String query) {
507 searchResults.updateFileCache(query);
508 searchResults.updateCurrentlyShowingStats();
513 * Display the 'loading' indicator.
515 public void showLoadingIndicator() {
520 * Hide the 'loading' indicator.
522 public void hideLoadingIndicator() {
527 * A native JavaScript method to reach out to the browser's window and
528 * invoke its resizeTo() method.
530 * @param x the new width
531 * @param y the new height
533 public static native void resizeTo(int x, int y) /*-{
538 * A helper method that returns true if the user's list is currently visible
539 * and false if it is hidden.
541 * @return true if the user list is visible
543 public boolean isUserListVisible() {
544 return inner.getTabBar().getSelectedTab() == 1;
548 * Display an error message.
550 * @param msg the message to display
552 public void displayError(String msg) {
553 messagePanel.displayError(msg);
557 * Display a warning message.
559 * @param msg the message to display
561 public void displayWarning(String msg) {
562 messagePanel.displayWarning(msg);
566 * Display an informational message.
568 * @param msg the message to display
570 public void displayInformation(String msg) {
571 messagePanel.displayInformation(msg);
575 * Retrieve the folders.
577 * @return the folders
579 public Folders getFolders() {
584 * Retrieve the search.
593 * Retrieve the currentSelection.
595 * @return the currentSelection
597 public Object getCurrentSelection() {
598 return currentSelection;
602 * Modify the currentSelection.
604 * @param newCurrentSelection the currentSelection to set
606 public void setCurrentSelection(Object newCurrentSelection) {
607 currentSelection = newCurrentSelection;
611 * Retrieve the groups.
615 public Groups getGroups() {
620 * Retrieve the fileList.
622 * @return the fileList
624 public FileList getFileList() {
628 public SearchResults getSearchResults(){
629 return searchResults;
633 * Retrieve the topPanel.
635 * @return the topPanel
637 TopPanel getTopPanel() {
642 * Retrieve the clipboard.
644 * @return the clipboard
646 public Clipboard getClipboard() {
651 public StatusPanel getStatusPanel(){
657 * Retrieve the userDetailsPanel.
659 * @return the userDetailsPanel
661 public UserDetailsPanel getUserDetailsPanel() {
662 return userDetailsPanel;
666 * Retrieve the dragController.
668 * @return the dragController
670 public PickupDragController getDragController() {
671 return dragController;
674 public String getToken(){
678 public String getWebDAVPassword() {
679 return webDAVPassword;
682 public void removeGlassPanel(){
683 glassPanel.removeFromParent();
687 * Retrieve the currentUserResource.
689 * @return the currentUserResource
691 public UserResource getCurrentUserResource() {
692 return currentUserResource;
696 * Modify the currentUserResource.
698 * @param newUser the new currentUserResource
700 public void setCurrentUserResource(UserResource newUser) {
701 currentUserResource = newUser;
704 public static native void preventIESelection() /*-{
705 $doc.body.onselectstart = function () { return false; };
708 public static native void enableIESelection() /*-{
709 if ($doc.body.onselectstart != null)
710 $doc.body.onselectstart = null;
714 * @return the absolute path of the API root URL
716 public String getApiPath() {
717 Configuration conf = (Configuration) GWT.create(Configuration.class);
718 return GWT.getModuleBaseURL() + conf.apiPath();
721 public void refreshWebDAVPassword() {
722 Configuration conf = (Configuration) GWT.create(Configuration.class);
723 String domain = Window.Location.getHostName();
724 String path = Window.Location.getPath();
725 String cookie = conf.webdavCookie();
726 webDAVPassword = Cookies.getCookie(cookie);
727 Cookies.setCookie(cookie, "", null, domain, path, false);