Logo Search packages:      
Sourcecode: javahelp2 version File versions  Download package

FavoritesNode.java

/*
 * @(#)FavoritesNode.java     1.5 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;

import javax.swing.tree.*;
import java.beans.*;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
import java.util.Enumeration;
import java.io.ObjectOutputStream;
import java.io.ObjectInputStream;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;

/**
 * A class for Favorites node. This class forces none-folders to have children.
 *
 * @author Richard Gregor
 * @version   1.5     10/30/06
 */

00048 public class FavoritesNode extends DefaultMutableTreeNode  {
    /**
     * Header part of xml file
     */
00052     public static final String HEADER="<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"+
    "<!DOCTYPE favorites\n PUBLIC \""+FavoritesView.publicIDString+
    "\"\n        \"http://java.sun.com/products/javahelp/favorites_2_0.dtd\">\n"+
    "\n<favorites version=\"2.0\">\n";
    
    /**
     * XML element name
     */
00060     public static final String ELEMENT="favoriteitem";
    /**
     * Footer of xml document
     */
00064     public static final String FOOTER="</favorites>";
    /**
     * FavoritesItem userObject of this node
     */
00068     private FavoritesItem item;   
    /**
     * Creates a FavoritesNode for FavoritesItem.
     *
     * @param item The FavoritesItem
     */
00074     public FavoritesNode(FavoritesItem item) {
        super(item);
        this.item = item;
    }
    
    /**
     * Returns wheter node is allowed to have children or not.
     */
00082     public boolean getAllowsChildren() {
        return ((FavoritesItem) getUserObject()).isFolder();
    }
    
    /**
     * Adds the child node.
     *
     * @param child The DefaultMutableTreeNode with FavoritesItem as UserObject.
     */
00091     public void add(DefaultMutableTreeNode child) {
        super.add(child);
        FavoritesItem childItem = (FavoritesItem) child.getUserObject();
        FavoritesItem oldParent = childItem.getParent();
        FavoritesItem newParent = (FavoritesItem) getUserObject();
        newParent.add(childItem);        
    }
    
    /**
     * Removes the child node.
     *
     * @param child Node to remove.
     */
00104     public void remove(DefaultMutableTreeNode child) {
        super.remove(child);
        FavoritesItem childItem = (FavoritesItem) ((FavoritesNode) child).getUserObject();
        FavoritesItem ParentItem = (FavoritesItem) getUserObject();
        if (parent != null)
            ParentItem.remove(childItem);
    }
    /**
     * Returns the number of visible children
     *
     */
00115     public int getVisibleChildCount(){
        int count = 0;
        if( item == null)
            return 0;
        
        for(Enumeration en = item.getChildren().elements(); en.hasMoreElements();){
            FavoritesItem nItem =(FavoritesItem)en.nextElement();
            if(nItem.isVisible())
                count++;
        }
        return count;
    }
    /**
     * Returns the string representation of offset.
     */
00130     public String getOffset(){
        String parentOffset = null;
        String offset = null;
        
        FavoritesNode parent = (FavoritesNode)getParent();
        if(parent != null){
            parentOffset = parent.getOffset();
            offset = parentOffset + "  ";
        }else
            offset = "  ";
        
        return offset;
    }
    /**
     * Exports nodes descendants to the OutputStream
     *
     * @param out The OutputStream
     */
00148     public void export(OutputStream out) throws IOException{        
        OutputStreamWriter writer = new OutputStreamWriter(out);
        writer = exportHeader(out);
        //exportNode(writer);
        Enumeration chldn = children(); 
        if(!(chldn.equals(DefaultMutableTreeNode.EMPTY_ENUMERATION))){
            while(chldn.hasMoreElements()){
                FavoritesNode node = (FavoritesNode)chldn.nextElement();
                node.exportNode(writer);
            }
        }
        writer.write(FOOTER);
        //out.close();
        writer.close();
    }

    /**
     * Exports node and its descendants to the xml file according favorites.dtd.
     *
     * @param out The OutputStream
     */
00169     public void exportNode(OutputStreamWriter writer) throws IOException{
        TreeNode paren = getParent();        
        FavoritesItem item = (FavoritesItem)getUserObject();        
        writer.write(getOffset()+"<"+getXMLElement()+ " text=\""+item.getName()+"\" ");
        String target = item.getTarget();
        if(target != null)
            writer.write("target=\""+target+"\" ");
        String url = item.getURLSpec();
        if(url != null)
            writer.write("url=\""+url+"\"");
        String hstitle = item.getHelpSetTitle();
        if(hstitle != null)
            writer.write(" hstitle=\""+hstitle+"\"");
        Enumeration chldn = children(); 
        if(chldn.equals(DefaultMutableTreeNode.EMPTY_ENUMERATION))
            writer.write("/>\n");
        else{ 
            writer.write(">\n");
            Enumeration offspring = children.elements();
            while(offspring.hasMoreElements()){
                FavoritesNode off = (FavoritesNode)offspring.nextElement();
                debug("offspring: "+off);
                off.exportNode(writer);
            }
            writer.write(getOffset()+"</"+ELEMENT+">\n");
        }
        
     
    }
    
    /**
     * Exports header defined for this type of node to the OutputStream.
     *
     * @param out The OutputStream.
     */
00204     public OutputStreamWriter exportHeader(OutputStream out) throws IOException{
        //OutputStreamWriter writer = new OutputStreamWriter(out,"UTF-8")
        
        OutputStreamWriter writer = new OutputStreamWriter(out,"UTF-8");
        writer.write(HEADER);
        return writer;
    }
    
    /**
     * Returns the XML header string
     */
00215     public String getXMLHeader(){
        return HEADER;
    }
    /**
     * Returns the XML element string
     */
00221     public String getXMLElement(){
        return ELEMENT;
    }
    
    /**
     * Returns  the deep copy of node
     */
00228     public FavoritesNode getDeepCopy(){
        
      return new FavoritesNode((FavoritesItem)item.clone());
      /*
        FavoritesNode copy = null;
        ObjectOutputStream out = null;
        ObjectInputStream in = null;
        
        try{            
            ByteArrayOutputStream bOut = new ByteArrayOutputStream();
            out = new ObjectOutputStream(bOut);
            out.writeObject(this);
            out.flush();
            
            in = new ObjectInputStream(new ByteArrayInputStream(bOut.toByteArray()));            
            copy =(FavoritesNode) in.readObject();
            
            out.close();
            in.close();
        }catch(Exception e){
            System.err.println(e);
        }
        
        return copy;
      */

    }
    
    /**
     * Returns wheter node is visible or not
     */
00259     public boolean isVisible(){
        return item.isVisible();
    }
    
    /**
     * Sets visibility of node
     */
00266     public void setVisible(boolean vis){
        item.setVisible(vis);
    }
        
    /**
     * Debugging code
     */
00273     private static final boolean debug = false;
    private static void debug(String msg) {
      if (debug) {
          System.err.println("FavoritesNode: "+msg);
      }
    }
    
}

Generated by  Doxygen 1.6.0   Back to index