pjs/grendel/ui/UnifiedMessageDisplayManager.java

/* -*- Mode: java; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License.  You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.  See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is the Grendel mail/news client.
 *
 * The Initial Developer of the Original Code is Netscape Communications
 * Corporation.  Portions created by Netscape are Copyright (C) 1997
 * Netscape Communications Corporation.  All Rights Reserved.
 *
 * Created: Will Scullin <scullin@netscape.com>,  3 Sep 1997.
 */

package grendel.ui;

import java.awt.BorderLayout;
import java.awt.Rectangle;
import java.awt.event.ActionEvent;
import java.util.Enumeration;

import com.sun.java.swing.BoxLayout;
import com.sun.java.swing.Icon;
import com.sun.java.swing.ImageIcon;
import com.sun.java.swing.JComponent;
import com.sun.java.swing.JFrame;
import com.sun.java.swing.JMenuBar;
import com.sun.java.swing.event.ChangeEvent;

import calypso.util.Preferences;
import calypso.util.PreferencesFactory;

import netscape.orion.toolbars.NSToolbar;
import netscape.orion.toolbars.ToolbarFactory;
import netscape.orion.toolbars.ToolBarLayout;
import netscape.orion.uimanager.AbstractUICmd;
import netscape.orion.uimanager.IUICmd;

import javax.mail.Store;
import javax.mail.Folder;
import javax.mail.Message;
import javax.mail.MessagingException;

import grendel.view.ViewedMessage;
import grendel.widgets.Splitter;
import grendel.widgets.StatusEvent;
import grendel.widgets.TreePath;

/**
 * The legendary three pane UI.
 */

public class UnifiedMessageDisplayManager extends MessageDisplayManager {
  UnifiedMessageFrame fMainFrame;

  public final static String SPLIT_TOP = "splitTop";
  public final static String SPLIT_LEFT = "splitLeft";
  public final static String SPLIT_RIGHT = "splitRight";
  public final static String STACKED = "stacked";

  /**
   * Displays a message given a Message object. If the message
   * is not in the currently selected folder, that folder will
   * be selected, loaded and displayed.
   */

  public void displayMessage(Message aMessage) {
    checkFrame();
    fMainFrame.display(aMessage.getFolder(), aMessage);
  }

  /**
   * Displays a folder given a folder object. If the message
   * being displayed is not in that folder, the message
   * display pane will be cleared.
   */

  public void displayFolder(Folder aFolder) {
    checkFrame();
    fMainFrame.display(aFolder, null);
  }

  /**
   * Displays folder given a Folder object and
   * selects and displays a message in that folder given a Message
   * object.
   */

  public void displayFolder(Folder aFolder, Message aMessage) {
    checkFrame();
    fMainFrame.display(aFolder, aMessage);
  }

  /**
   * Displays the master (A folder tree, for now). This should not
   * affect displayed folders or messages.
   */

  public void displayMaster() {
    checkFrame();
    fMainFrame.display(null, null);
  }

  /**
   * Displays the master with the given folder selected. If the
   * folder is not currently displayed, the folder will be loaded
   * in the folder message list pane, and the message pane will be
   * cleared.
   */

  public void displayMaster(Folder aFolder) {
    checkFrame();
    fMainFrame.display(aFolder, null);
  }

  void checkFrame() {
    if (fMainFrame == null) {
      fMainFrame = new UnifiedMessageFrame();
      fMainFrame.setVisible(true);
    }
    fMainFrame.toFront();
    fMainFrame.requestFocus();
  }
}

class UnifiedMessageFrame extends GeneralFrame {
  MasterPanel   fFolders = null;
  FolderPanel   fThreads = null;
  MessagePanel  fMessage = null;
  Splitter      splitter1 = null, splitter2 = null;
  String        fLayout = null;

  public UnifiedMessageFrame() {
    super("appNameLabel", "mail.multi_pane");

    PrefsDialog.CheckPrefs(this);

    fFolders = new MasterPanel();
    fThreads = new FolderPanel();
    fMessage = new MessagePanel();

    PanelListener listener = new PanelListener();

    fFolders.addMasterPanelListener(listener);
    fThreads.addFolderPanelListener(listener);
    fMessage.addMessagePanelListener(listener);

    Preferences prefs = PreferencesFactory.Get();
    String layout = prefs.getString("mail.multi_pane.layout",
                                    UnifiedMessageDisplayManager.SPLIT_TOP);


    layoutPanels(layout);

    fMenu = buildMenu("multiMain",
                      Util.MergeActions(actions,
                        Util.MergeActions(fFolders.getActions(),
                          Util.MergeActions(fThreads.getActions(),
                                            fMessage.getActions()))));

    getRootPane().setMenuBar(fMenu);

    NSToolbar masterToolBar = fFolders.getToolBar();
    NSToolbar folderToolBar = fThreads.getToolBar();
    NSToolbar messageToolBar = fMessage.getToolBar();

    fToolBar = Util.MergeToolBars(masterToolBar,
                                  Util.MergeToolBars(folderToolBar,
                                                     messageToolBar));

    fToolBar.addItem(ToolbarFactory.MakeINSToolbarItem(ToolBarLayout.CreateSpring(),
                                                       null));
    fToolBar.addItem(ToolbarFactory.MakeINSToolbarItem(fAnimation, null));
    fToolBarPanel.add(fToolBar);

    fStatusBar = buildStatusBar();
    fPanel.add(BorderLayout.SOUTH, fStatusBar);

    restoreBounds();
  }

  public void dispose() {
    saveBounds();

    Preferences prefs = PreferencesFactory.Get();

    String masterWeight = "1.0";
    String folderWeight = "2.0";
    String messageWeight = "2.0";
    String splitWeight = "1.0";

    if (fLayout.equals(UnifiedMessageDisplayManager.STACKED)) {
      masterWeight = splitter1.getWeight(fFolders).toString();
      folderWeight = splitter1.getWeight(fThreads).toString();
      messageWeight = splitter1.getWeight(fMessage).toString();
    } else if (fLayout.equals(UnifiedMessageDisplayManager.SPLIT_RIGHT)) {
      masterWeight = splitter1.getWeight(fFolders).toString();
      folderWeight = splitter2.getWeight(fThreads).toString();
      messageWeight = splitter2.getWeight(fMessage).toString();
      splitWeight = splitter1.getWeight(splitter2).toString();
    } else {
      masterWeight = splitter2.getWeight(fFolders).toString();
      folderWeight = splitter2.getWeight(fThreads).toString();
      messageWeight = splitter1.getWeight(fMessage).toString();
      splitWeight = splitter1.getWeight(splitter2).toString();
    }

    prefs.putString("mail.multi_pane.master_weight", masterWeight);
    prefs.putString("mail.multi_pane.folder_weight", folderWeight);
    prefs.putString("mail.multi_pane.message_weight", messageWeight);
    prefs.putString("mail.multi_pane.split_weight", splitWeight);

    prefs.putString("mail.multi_pane.layout", fLayout);

    fFolders.dispose();
    fThreads.dispose();
    fMessage.dispose();

    super.dispose();
  }

  public void display(Folder aFolder, Message aMessage) {
    if (aFolder != null) {
      fThreads.setFolder(aFolder);
      fMessage.setMessage(aMessage);
    }
  }

  void layoutPanels(String layout) {
    if (fLayout != null) {
      if (fLayout.equals(layout)) {
        return; // nothing to do
      }
      if (fLayout.equals(UnifiedMessageDisplayManager.STACKED)) {
        splitter1.removeAll();
      } else {
        splitter1.removeAll();
        splitter2.removeAll();
      }
      fPanel.remove(splitter1);
    }

    Preferences prefs = PreferencesFactory.Get();

    String masterWeight = prefs.getString("mail.multi_pane.master_weight", "1.0");
    String folderWeight = prefs.getString("mail.multi_pane.folder_weight", "2.0");
    String messageWeight = prefs.getString("mail.multi_pane.message_weight", "2.0");
    String splitWeight = prefs.getString("mail.multi_pane.split_weight", "1.0");

    if (layout.equals(UnifiedMessageDisplayManager.STACKED)) {
      splitter1 = new Splitter(Splitter.VERTICAL);
      splitter1.add(fFolders, new Float(masterWeight));
      splitter1.add(splitter1.createSeparator(4));
      splitter1.add(fThreads, new Float(folderWeight));
      splitter1.add(splitter1.createSeparator(4));
      splitter1.add(fMessage, new Float(messageWeight));

      fStackedLayoutAction.setSelected(IUICmd.kSelected);
    } else if (layout.equals(UnifiedMessageDisplayManager.SPLIT_LEFT)) {
      splitter1 = new Splitter(Splitter.HORIZONTAL);

      splitter2 = new Splitter(Splitter.VERTICAL);
      splitter2.add(fFolders, new Float(masterWeight));
      splitter2.add(splitter2.createSeparator(4));
      splitter2.add(fThreads, new Float(folderWeight));

      splitter1.add(splitter2, new Float(splitWeight));
      splitter1.add(splitter1.createSeparator(4));
      splitter1.add(fMessage, new Float(messageWeight));

      fSplitLeftLayoutAction.setSelected(IUICmd.kSelected);
    } else if (layout.equals(UnifiedMessageDisplayManager.SPLIT_RIGHT)) {

      splitter2 = new Splitter(Splitter.VERTICAL);
      splitter2.add(fThreads, new Float(folderWeight));
      splitter2.add(splitter2.createSeparator(4));
      splitter2.add(fMessage, new Float(messageWeight));

      splitter1 = new Splitter(Splitter.HORIZONTAL);
      splitter1.add(fFolders, new Float(masterWeight));
      splitter1.add(splitter1.createSeparator(4));
      splitter1.add(splitter2, new Float(splitWeight));

      fSplitRightLayoutAction.setSelected(IUICmd.kSelected);
    } else { // Default: SPLIT_TOP
      splitter1 = new Splitter(Splitter.VERTICAL);

      splitter2 = new Splitter(Splitter.HORIZONTAL);
      splitter2.add(fFolders, new Float(masterWeight));
      splitter2.add(splitter2.createSeparator(4));
      splitter2.add(fThreads, new Float(folderWeight));

      splitter1.add(splitter2, new Float(splitWeight));
      splitter1.add(splitter1.createSeparator(4));
      splitter1.add(fMessage, new Float(messageWeight));

      fSplitTopLayoutAction.setSelected(IUICmd.kSelected);
    }
    fPanel.add("Center", splitter1);

    invalidate();
    validate();

    fLayout = layout;
  }

  IUICmd fSplitLeftLayoutAction =
    new LayoutAction(UnifiedMessageDisplayManager.SPLIT_LEFT);
  IUICmd fSplitRightLayoutAction =
    new LayoutAction(UnifiedMessageDisplayManager.SPLIT_RIGHT);
  IUICmd fSplitTopLayoutAction =
    new LayoutAction(UnifiedMessageDisplayManager.SPLIT_TOP);
  IUICmd fStackedLayoutAction =
    new LayoutAction(UnifiedMessageDisplayManager.STACKED);

  IUICmd actions[] = { ActionFactory.GetExitAction(),
                       ActionFactory.GetNewMailAction(),
                       ActionFactory.GetComposeMessageAction(),
                       ActionFactory.GetPreferencesAction(),
                       ActionFactory.GetSearchAction(),
                       ActionFactory.GetRunFiltersAction(),
                       ActionFactory.GetShowTooltipsAction(),
                       fSplitLeftLayoutAction,
                       fSplitRightLayoutAction,
                       fSplitTopLayoutAction,
                       fStackedLayoutAction
  };


  class PanelListener implements MasterPanelListener, FolderPanelListener,
                                 MessagePanelListener
  {
    // FolderPanelListener

    public void loadingFolder(ChangeEvent aEvent) {
      // start animation
      fAnimation.start();
    }

    public void folderLoaded(ChangeEvent aEvent) {
      // stop animation
      fAnimation.stop();
    }

    public void folderStatus(StatusEvent aEvent) {
      setStatusText(aEvent.getStatus());
    }

    public void folderSelectionChanged(ChangeEvent aEvent) {
      TreePath path = null;
      Enumeration selection =
        ((FolderPanel) aEvent.getSource()).getSelection();

      if (selection.hasMoreElements()) {
        path = (TreePath) selection.nextElement();
      }
      if (path != null && !selection.hasMoreElements()) {
        // not multiple selection
        ViewedMessage node = (ViewedMessage) path.getTip();
        fMessage.setMessage(node.getMessage());
      } else {
        fMessage.setMessage(null);
      }
    }
    public void folderSelectionDoubleClicked(ChangeEvent aEvent) {
      TreePath path = null;
      Enumeration selection = ((FolderPanel)aEvent.getSource()).getSelection();

      MessageDisplayManager master = MultiMessageDisplayManager.Get();

      while (selection.hasMoreElements()) {
        path = (TreePath) selection.nextElement();
        if (path != null) {
          ViewedMessage node = (ViewedMessage) path.getTip();
          master.displayMessage(node.getMessage());
        }
      }
    }

    // MasterPanelListener

    public void masterSelectionChanged(ChangeEvent aEvent) {
      TreePath path = null;
      Enumeration selection =
        ((MasterPanel) aEvent.getSource()).getSelection();
      if (selection.hasMoreElements()) {
        path = (TreePath) selection.nextElement();
      }
      Object node = null;
      Folder folder = null;
      if (path != null && !selection.hasMoreElements()) {
        // not multiple selection
        node = path.getTip();
      }

      folder = MasterPanel.getFolder(node);

      if (folder != null) {
        try {
          if ((folder.getType() & Folder.HOLDS_MESSAGES) == 0) {
            folder = null;
          }
        } catch (MessagingException e) {
          folder = null;
        }
      }

      if (folder != null) {
        setTitle(folder.getName() +
                 fLabels.getString("folderSuffixFrameLabel"));
        fThreads.setFolder(folder);
      } else {
        setTitle(fLabels.getString("appNameLabel"));
        fThreads.setFolder(null);
      }
    }

    public void masterSelectionDoubleClicked(ChangeEvent aEvent) {
    }

    // MessagePanelListener

    public void loadingMessage(ChangeEvent aEvent) {
      startAnimation();
    }

    public void messageLoaded(ChangeEvent aEvent) {
      stopAnimation();
    }

    public void messageStatus(StatusEvent aEvent) {
      setStatusText(aEvent.getStatus());
    }
  }

  //
  // LayoutAction class
  //

  class LayoutAction extends AbstractUICmd {
    ImageIcon fIcon;
    public LayoutAction(String aAction) {
      super(aAction);
      setEnabled(true);

      fIcon = new ImageIcon(getClass().getResource("images/" +
                                                   aAction + ".gif"));
    }

    public void actionPerformed(ActionEvent aEvent) {
      layoutPanels(aEvent.getActionCommand());
    }

    public ImageIcon getEnabledIcon() {
      return fIcon;
    }
  }
}