All Downloads are FREE. Search and download functionalities are using the official Maven repository.

javax.help.plaf.basic.BasicGlossaryNavigatorUI Maven / Gradle / Ivy

/*
 * @(#)BasicGlossaryNavigatorUI.java	1.8 06/10/30
 * 
 * Copyright (c) 2006 Sun Microsystems, Inc.  All Rights Reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 * 
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Sun designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Sun in the LICENSE file that accompanied this code.
 * 
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 * 
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 * 
 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
 * CA 95054 USA or visit www.sun.com if you need additional information or
 * have any questions.
 */

package javax.help.plaf.basic;

import javax.help.*;
import javax.help.plaf.HelpNavigatorUI;
import javax.help.plaf.HelpUI;
import javax.help.plaf.basic.BasicHelpUI;
import javax.help.plaf.basic.BasicIndexCellRenderer;
import javax.help.event.HelpModelListener;
import javax.help.event.HelpModelEvent;
import java.util.EventObject;
import java.util.Enumeration;
import java.util.Hashtable;
import java.util.Vector;
import javax.swing.*;
import javax.swing.plaf.ComponentUI;
import javax.swing.tree.*;
import javax.swing.event.*;
import java.awt.*;
import java.awt.event.*;
import java.io.Reader;
import java.io.Serializable;
import java.net.URL;
import java.net.URLConnection;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import javax.help.Map.ID;
import java.text.Collator;
import java.text.RuleBasedCollator;
import java.util.Locale;
import java.util.Stack;

/**
 * The default UI for JHelpNavigator of type Glossary.
 *
 * @author Roger D. Brinkley
 * @author Richard Gregor
 * @version   1.8     10/30/06
 */

public class BasicGlossaryNavigatorUI extends HelpNavigatorUI
implements HelpModelListener, TreeSelectionListener,
PropertyChangeListener, ActionListener, Serializable {
    protected JHelpGlossaryNavigator glossary;
    protected JScrollPane sp;
    protected DefaultMutableTreeNode topNode;
    protected JTree tree;
    protected JTextField searchField;
    protected RuleBasedCollator rbc;
    protected String oldText;
    protected DefaultMutableTreeNode currentFindNode;
    protected JHelpContentViewer viewer;
    
    /**
     * Creates UI
     */
    public static ComponentUI createUI(JComponent x) {
        return new BasicGlossaryNavigatorUI((JHelpGlossaryNavigator) x);
    }
    
    public BasicGlossaryNavigatorUI(JHelpGlossaryNavigator b) {
        ImageIcon icon = getImageIcon(b.getNavigatorView());
        if (icon != null) {
            setIcon(icon);
        } else {
	    setIcon(UIManager.getIcon("GlossaryNav.icon"));
	}
    }
    
    public void installUI(JComponent c) {
        debug("installUI");
        
        glossary = (JHelpGlossaryNavigator)c;
        HelpModel model = glossary.getModel();
        
        glossary.setLayout(new BorderLayout());
        glossary.addPropertyChangeListener(this);
        if (model != null) {
            //model.addHelpModelListener(this); // for our own changes
        }
        
        topNode = new DefaultMutableTreeNode();
        
        JLabel search = new JLabel(HelpUtilities.getString(HelpUtilities.getLocale(c),
        "index.findLabel"));
        searchField= new JTextField();
        search.setLabelFor(searchField);
        
        searchField.addActionListener(this);
        JPanel box = new JPanel();
        box.setLayout(new BoxLayout(box, BoxLayout.X_AXIS));
        box.add(search);
        box.add(searchField);
        
        glossary.add("North", box);
        
        tree = new JTree(topNode);
        TreeSelectionModel tsm = tree.getSelectionModel();
        tsm.addTreeSelectionListener(this);
        tree.setShowsRootHandles(true);
        tree.setRootVisible(false);
        
        setCellRenderer(glossary.getNavigatorView(), tree);
        
        sp = new JScrollPane();
        sp.getViewport().add(tree);
        
        JSplitPane splitPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT, false);
        splitPane.setOneTouchExpandable(true);
        
        splitPane.setTopComponent(sp);
        
        viewer = new JHelpContentViewer(model.getHelpSet());
        viewer.setSynch(false);
        splitPane.setBottomComponent(viewer);
        
        glossary.add("Center",splitPane);
        splitPane.setDividerLocation(180);
        
        reloadData();
    }
    
    /**
     * Sets the desired cell renderer on this tree.
     * This is exposed for redefinition
     * by subclases.
     */
    protected void setCellRenderer(NavigatorView view, JTree tree) {
        tree.setCellRenderer(new BasicIndexCellRenderer());
    }
    
    /**
     * Uninstalls UI
     */
    public void uninstallUI(JComponent c) {
        debug("uninstallUI");
        HelpModel model = glossary.getModel();
        
        glossary.removePropertyChangeListener(this);
        TreeSelectionModel tsm = tree.getSelectionModel();
        tsm.removeTreeSelectionListener(this);
        glossary.setLayout(null);
        glossary.removeAll();
        
        if (model != null) {
            model.removeHelpModelListener(this);
        }
        
        glossary = null;
    }
    
 
    public Dimension getPreferredSize(JComponent c) {
        
        return new Dimension(200,100);
        
    }
    
    public Dimension getMinimumSize(JComponent c) {
        return new Dimension(100,100);
    }
 
    public Dimension getMaximumSize(JComponent c) {
        return new Dimension(Short.MAX_VALUE, Short.MAX_VALUE);
    }
    
    private void reloadData() {
        debug("reloadData");
                
        // parse the glossary data into topNode
        GlossaryView view = (GlossaryView) glossary.getNavigatorView();
	loadData(view);
    }

    private void loadData(GlossaryView view) {

       if (view == null) {
            return;
        }
        
        // remove all children
        topNode.removeAllChildren();
        
        String mergeType = view.getMergeType();
        
        Locale locale = view.getHelpSet().getLocale();
        
        DefaultMutableTreeNode node = view.getDataAsTree();
        
	// Make sure the children are all handled correctly
	MergeHelpUtilities.mergeNodeChildren(mergeType, node);
        
        // This is a tricky one. As you remove the entries from one node to
        // another the list shrinks. So you can't use an Enumated list to do
        // the move.
        while (node.getChildCount() > 0) {
            topNode.add((DefaultMutableTreeNode) node.getFirstChild());
        }
        
        // add all subhelpsets
        addSubHelpSets(view.getHelpSet());        

        // reload the tree data
        ((DefaultTreeModel)tree.getModel()).reload();
        
        setVisibility(topNode);
    }
    
    /**
     * Reloads the presentation data using new help model. Changes the navigator if new model contains
     * view with the same name as former view
     **/
    private void reloadData(HelpModel model) {
        debug("reloadData in using new model");
        GlossaryView glossaryView = null;
        
        HelpSet newHelpSet = model.getHelpSet();
        GlossaryView oldView = (GlossaryView) glossary.getNavigatorView();
        String oldName = oldView.getName();
        NavigatorView[] navViews = newHelpSet.getNavigatorViews();
        for(int i = 0 ; i < navViews.length; i++){
            if((navViews[i].getName()).equals(oldName)){
                NavigatorView tempView = navViews[i];
                if(tempView instanceof GlossaryView){
                    glossaryView = (GlossaryView) tempView;
                    break;
                }
            }
        }
 
	loadData(glossaryView);
    }

    /** Adds subhelpsets
     *
     * @param hs The HelpSet which subhelpsets will be added
     */
    protected void addSubHelpSets(HelpSet hs){
	debug ("addSubHelpSets");
        for( Enumeration e = hs.getHelpSets(); e.hasMoreElements(); ) {
            HelpSet ehs = (HelpSet) e.nextElement();
            // merge views
            NavigatorView[] views = ehs.getNavigatorViews();
            for(int i = 0; i < views.length; i++){
                if(glossary.canMerge(views[i]))
                    merge(views[i]);
            }
            addSubHelpSets( ehs );
        }
    }

    /**
     * Expands entry path and entry itself( when entry is not empty) for specific id
     *
     * @param target The target of entry
     */
    
    private void expand(String target){
        debug("expand called");
        //find all nodes with certain id
        Enumeration nodes = findNodes(target).elements();
        DefaultMutableTreeNode node = null;
        
        while(nodes.hasMoreElements()){
            node = (DefaultMutableTreeNode)nodes.nextElement();
            debug("expandPath :"+node);
            if(node.getChildCount() > 0){
                DefaultMutableTreeNode child =(DefaultMutableTreeNode) node.getFirstChild();
                TreePath path = new TreePath(child.getPath());
                tree.makeVisible(path);
            }
            else{
                TreeNode[] treeNode = node.getPath();
                TreePath path = new TreePath(treeNode);
                //tree.scrollPathToVisible(path);
                tree.makeVisible(path);
            }
        }
    }    
    
    /**
     * Returns all nodes with certain id
     *
     * @param target The target of entry
     *
     */
    private Vector findNodes(String target){
        Enumeration nodes = topNode.preorderEnumeration();
        DefaultMutableTreeNode node = null;
        Vector nodeFound = new Vector();
        
        while(nodes.hasMoreElements()){
            node = (DefaultMutableTreeNode)nodes.nextElement();
            debug(" node :"+ node.toString());
            if(node != null){
                IndexItem indexItem = (IndexItem)node.getUserObject();
                if(indexItem == null)
                    debug("indexItem is null");
                else{
                    Map.ID id = indexItem.getID();
                    if(id != null){
                        debug("id name :"+id.id);
                        debug("target :"+target);
                        Map.ID itemID = null;
                        try{
                            itemID = Map.ID.create(target,glossary.getModel().getHelpSet());
                        }
                        catch(BadIDException exp){
                            System.err.println("Not valid ID :"+target );
                            break;
                        }
                        if(id.equals(itemID))
                            nodeFound.addElement(node);
                    }
                }
            }
        }
        
        return nodeFound;
    }
    
    /**
     * Collapses entry specified by id. If entry is empty collapses it's parent.
     *
     * @param target The target of entry
     */
    
    private void collapse(String target){
        Enumeration nodes = findNodes(target).elements();
        DefaultMutableTreeNode node = null;
        debug("collapse called");
        
        while(nodes.hasMoreElements()){
            node = (DefaultMutableTreeNode)nodes.nextElement();
            if(node.getChildCount() > 0){
                TreeNode[] treeNode = node.getPath();
                TreePath path = new TreePath(treeNode);
                tree.collapsePath(path);
                tree.collapseRow(tree.getRowForPath(path));
            }
            else{
                DefaultMutableTreeNode parent =(DefaultMutableTreeNode) node.getParent();
                TreePath path = new TreePath(parent.getPath());
                tree.collapseRow(tree.getRowForPath(path));
            }
        }
    }
    
    
    /**
     * Merges in the navigational data from another IndexView.
     */

    public void doMerge(NavigatorView view) {
	debug("merging data");
       
        Merge mergeObject = Merge.DefaultMergeFactory.getMerge(glossary.getNavigatorView(),view);
        if(mergeObject != null) {
            mergeObject.processMerge(topNode);
	}
        
    }

    /**
     * Merges in the navigational data from another TOCView.
     *
     * @param view A GlossaryView.  Note the actual argument is a NavigatorView type
     * so it replaces the correct NavigatorUI method.
     */
    
    public void merge(NavigatorView view) {
        debug("merging data");
	doMerge(view);

        //reload the tree data
	((DefaultTreeModel)tree.getModel()).reload(); 
	setVisibility(topNode);
    }

    /**
     * Removes the navigational data from another GlossaryView.
     *
     * @param view An GlossaryView.  Note the actual argument is a NavigatorView type
     * so it replaces the correct NavigatorUI method.
     */
    
    public void remove(NavigatorView view) {
        debug("removing "+view);
        
	remove(topNode, view.getHelpSet());
        
        // reload the tree data
        ((DefaultTreeModel)tree.getModel()).reload();
        setVisibility(topNode);
    }
    
    /**
     * Recursively removes all children of the node that have either hs or a HelpSet that
     * is included in hs as their HelpSet data.
     *
     * Recursion is stopped when a node is removed.  This is because of the
     * property of the merge mechanism.
     *
     * @param node The node from which to remove children.
     * @param hs The non-null HelpSet to use.
     */
    
    private void remove(DefaultMutableTreeNode node,
			HelpSet hs) {
	debug("remove("+node+", "+hs+")");

	// a simple node.children() does not work because the
	// enumeration is voided when a child is removed

	// getNextSibling() has a linear search, so we won't do that either

	// Collect all to be removed
	Vector toRemove = new Vector();
	
	for (Enumeration e = node.children();
	     e.hasMoreElements(); ) {
	    DefaultMutableTreeNode child
		= (DefaultMutableTreeNode) e.nextElement();
	    debug("  considering "+child);
	    IndexItem item = (IndexItem) child.getUserObject();
	    HelpSet chs = item.getHelpSet();
	    debug ("chs=" + chs + " hs.contains(chs)=" + hs.contains(chs));
	    if (chs != null &&
		hs.contains(chs)) {
		if (child.isLeaf()) {
		    // if the child has no children then just remove it
		    debug("  tagging for removal: "+child);
		    toRemove.addElement(child); // tag to be removed...
		} else {
		    // be carefull here. While the child hs is one to be
		    // removed it is possible that there are children that
		    // are not of this hs. Attempt to remove the 
		    // child's children first. If they're are any children left
		    // the change the hs to be the hs of the first child
		    remove(child, hs);
		    if (child.isLeaf()) {
			// no more children remove the child as well
			debug("  tagging for removal: "+child);
			toRemove.addElement(child); // tag to be removed...
		    } else {
			// nuts! There are children from different hs
			// change the hs of the IndexItem to be the hs of the
			// first child
			DefaultMutableTreeNode childOne = 
			    (DefaultMutableTreeNode) child.getFirstChild();
			IndexItem itemOne =  (IndexItem) childOne.getUserObject();
			item.setHelpSet(itemOne.getHelpSet());
			debug("  orphaned children - changing hs: "+child);
		    }
		}
	    } else {
		// the child doesn't need to be removed but possibly it's
		// children will
		remove(child, hs);
	    }
	}
	    
	// Now remove them
	for (int i=0; i




© 2015 - 2024 Weber Informatics LLC | Privacy Policy