Metacat

/**

 *        Name: BasicNode.java

 *     Purpose: A Class that represents an XML node and its contents

 *   Copyright: 2000 Regents of the University of California and the

 *              National Center for Ecological Analysis and Synthesis

 *     Authors: Matt Jones

 *

 *     Version: '$Id: BasicNode.java 135 2000-06-08 00:16:35Z jones $'

 */

package edu.ucsb.nceas.metacat;

import java.io.IOException;

import java.util.Hashtable;

import java.util.Enumeration;

import java.util.Vector;

/** A Class that represents an XML node and its contents */

public class BasicNode {

    private long	node_id;

    private String	tagname;

    private long	parent_id;

    private Hashtable	attributes;

    private int         childNum;

    private int         nodeIndex;

    private String      nodeType;

    private Vector	children;

    /** Construct a Basic Node */

    public BasicNode () {

      children = new Vector();

      attributes = new Hashtable(); 

      this.childNum = 0;

    }

    /** 

     * Construct a Basic Node 

     *

     * @param tagname the name of the node

     */

    public BasicNode (String tagname) {

      this();

      this.tagname = tagname;

    }

    /** 

     * Construct a Basic Node 

     *

     * @param tagname the name of the node

     * @param parent_id the id number of the parent node

     * @param nodeIndex - index of node among siblings in parent node

     *                    Every node initializes childNum to 0 when 

     *                    created and has interface incChildNum

     *                    when new child is created

     */

    public BasicNode (String tagname, long parent_id, int nodeIndex) {

      this();

      this.tagname = tagname;

      this.parent_id = parent_id;

      this.nodeIndex = nodeIndex;

    }

    /** Construct a Basic Node 

     *

     * @param node_id the id number of the node

     * @param tagname the name of the node

     * @param parent_id the id number of the parent node

     */

    public BasicNode (long node_id, String tagname, long parent_id, 

                         int nodeIndex) {

      this(tagname,parent_id,nodeIndex);

      this.node_id = node_id;

    }

    /** convert the node to a string representation for display */

/*  MAKE THIS AN ABSTRACT METHOD??????

    public String toString ()

    {

	StringBuffer value = new StringBuffer();

	value.append('<');

	value.append(getTagName());

	value.append(getAttributes().toString());

	value.append('>');

	return value.toString();

    }

*/

    /** Get the id of this node */

    public long getNodeID() 

    { 

      return node_id; 

    }

    /** Set the id of this node */

    public void setNodeID(long node_id) 

    { 

      this.node_id = node_id; 

    }

    /** Get the parent id of this node */

    public long getParentID() 

    { 

      return parent_id; 

    }

    /** Set the parent id of this node */

    public void setParentID(long parent_id) 

    { 

      this.parent_id = parent_id; 

    }

    /** Get the name of this node */

    public String getTagName() 

    { 

      return tagname; 

    }

    /** Set the name of this node */

    public void setTagName(String tagname) 

    { 

      this.tagname = tagname; 

    }

    /** Get the attributes as a string */

    public String getAttributes() {

      StringBuffer buf = new StringBuffer();

      String attName = null;

      String attValue = null;

      Enumeration attList = attributes.keys();

      while (attList.hasMoreElements()) {

        attName = (String)attList.nextElement();

        attValue = (String)attributes.get(attName);

        buf.append(" ").append(attName).append("=\"");

        buf.append(attValue).append("\"");        

      }

      return buf.toString();      

    }

    /** Add a new attribute to this node, or set its value */

    public void setAttribute(String attName, String attValue) {

      if (attName != null) {

        // Enter the attribute in the hash table

        attributes.put(attName, attValue);

      } else {

        System.err.println("Attribute name must not be null!");

      }

    }

    /** Get an attribute value by name */

    public String getAttribute(String attName) {

      return (String)attributes.get(attName);

    }

    /** Get nodeIndex of the node */

    public int getNodeIndex() {

      return this.nodeIndex;

    }

    /** Set the node index of this node */

    public void setNodeIndex(int nodeIndex) { 

      this.nodeIndex = nodeIndex; 

    }

    /** Get the type of this node */

    public String getNodeType() { 

      return nodeType; 

    }

    /** Set the type of this node */

    public void setNodeType(String type) { 

      this.nodeType = type; 

    }

    /** Add a child node to this node */

    public void addChildNode(BasicNode child) { 

      this.children.add(child);

    }

    /** Get the an enumeration of the children of this node */

    public Enumeration getChildren() { 

      return children.elements(); 

    }

    /** increase childNum when new child for the node is created */

    public int incChildNum() {

      return ++this.childNum;    

    }    

}