source: trunk/gli/src/org/greenstone/gatherer/msm/ElementWrapper.java@ 4527

/**
 *#########################################################################
 *
 * A component of the Gatherer application, part of the Greenstone digital
 * library suite from the New Zealand Digital Library Project at the
 * University of Waikato, New Zealand.
 *
 * <BR><BR>
 *
 * Author: John Thompson, Greenstone Digital Library, University of Waikato
 *
 * <BR><BR>
 *
 * Copyright (C) 1999 New Zealand Digital Library Project
 *
 * <BR><BR>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * <BR><BR>
 *
 * This program 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 for more details.
 *
 * <BR><BR>
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *########################################################################
 */

 




/* GPL_HEADER */
package org.greenstone.gatherer.msm;
/**************************************************************************************
 * Title:        Gatherer
 * Description:  The Gatherer: a tool for gathering and enriching a digital collection.
 * Company:      The University of Waikato
 * Written:        /  /01
 * Revised:      03/10/02 - Commented
 **************************************************************************************/
import java.util.TreeSet;
import org.greenstone.gatherer.msm.MSMUtils;
import org.greenstone.gatherer.util.Utility;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
/** This class provides a convience wrapper around a DOM model Element to allow Components such as the MetadataTable to display this information properly. 
 * @author John Thompson
 * @version 2.3
 */
public class ElementWrapper 
    implements Comparable {
    /** The DOM element this wrapper is wrapped around. */
    private Element element = null;
    /** A string prefix identifying the metadata set namespace. */
    private String namespace = "";
    /** Constructor for elements with no namespace necessary.
     * @param element The DOM <strong>Element</strong> this is to be based on.
      */ 
    public ElementWrapper(Element element) {
    this.element = element;
    Element parent =  (Element)element.getParentNode();
    if (parent != null) {
        this.namespace = parent.getAttribute("namespace");
    }
    
    }
    /** Constructor.
      * @param element The DOM <strong>Element</strong> this is to be based on.

      * @param namespace_required <i>true</i> if this element wrapper should always attempt to show a namespace prefix (retrieving it from the DOM if necessary).
      * @deprecated
      */
    //  public ElementWrapper(Element element, boolean namespace_required) {
    //this(element);
    //  }

    public void addAttribute(String name, String value) {
    MSMUtils.addElementAttribute(element, name, "en", value);
    }

    public void addAttribute(String name, String language, String value) {
    MSMUtils.addElementAttribute(element, name, language, value);
    }

    /** Create a copy of this element wrapper.
      * @return A new <strong>ElementWrapper</strong> based on the same element as this one.
      */
    public ElementWrapper copy() {
    Element element_copy = (Element) element.cloneNode(true);
    return new ElementWrapper(element_copy);
    }
    /** Compare two element wrappers for ordering.
      * @param object An <strong>Object</strong> which is most likely another element wrapper to be compared with.
      * @return An <i>int</i> indicating order, -1, 0, 1 if this element wrapper is less than, equal to or greater than the given object.
      */
    public int compareTo(Object object) {
    return toString().compareTo(object.toString());
    }
    /** Decrement the number of occurances of this metadata element. 
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public void dec() {
    MSMUtils.setOccurance(element, -1);
    }
    /** Test if two ElementWrappers are equal.
      * @param object The <strong>Object</strong> to test against.
      */
    public boolean equals(Object object) {
    if(object instanceof ElementWrapper) {
        String our_full_name = MSMUtils.getFullName(element, namespace);
        String their_full_name = MSMUtils.getFullName(((ElementWrapper)object).getElement());
        return our_full_name.equals(their_full_name);
    }
    return toString().equals(object.toString());
    }
    /** Retrieve the attributes associated with the element this element wrapper is built around.
      * @return A <strong>TreeSet</strong> of the attributes.
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public TreeSet getAttributes() {
    return MSMUtils.getAttributes(element);
    }
    /** Retrieve the element this is wrapped around.
      * @return A DOM <strong>Element</strong> which represents a metadata element.
      */
    public Element getElement() {
    return element;
    }
    /** Retrieve the identity of this element (not necessary the same as this elements name). Identity is language and locale dependant.
      * @return The identity as a <strong>String</strong>.
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public String getIdentity() {
    return MSMUtils.getIdentifier(element);
    }
    /** Retrieve the name of this element. Name is unique.
      * @return The name as a <strong>String</strong>.
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public String getName() {
    return MSMUtils.getFullName(element, namespace);
    }
    /** Retrieve the namespace prefix for this element wrapper.
      * @return A <strong>String</strong> containing the namespace or "" if there is no namespace for this element.
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public String getNamespace() {
    if (!namespace.equals("")) {
        return namespace;
    }
    String name = getName();
    int pos;
    if((pos = name.indexOf(MSMUtils.NS_SEP)) != -1) {
        return name.substring(0, pos);
    }
    else {
        return "";
    }
    }
    /** Look for the occurances 'field' of the element and return it if found.
      * @return An <i>int</i> which matches the number in the occurances attribute of the element, or 0 if no such attribute.
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public int getOccurances() {
    return MSMUtils.getOccurances(element);
    }
    /** This method is essentially the same as getDescription() in that it does indeed return this metaelements description. However this method uses the Utility function formatHTMLWidth() to ensure the String can be displayed in a tool-tip window using html markup.
      * @return A String containing the HTML formatted versions of definition and content (comment).
      * @see org.greenstone.gatherer.msm.MSMUtils
      * @see org.greenstone.gatherer.util.Utility
      */
    public String getToolTip() {
    // Add HTML formatting
    return Utility.formatHTMLWidth(MSMUtils.getDescription(element), 60);
    }
    /** Increment the number of occurances of this metadata element. 
      * @see org.greenstone.gatherer.msm.MSMUtils
      */
    public void inc() {
    MSMUtils.setOccurance(element, 1);
    }

    public boolean isHierarchy() {
    return element.getAttribute("hierarchy").equalsIgnoreCase("true");
    }


    /** Removes an Attribute node from the element. */
    public boolean removeAttribute(String name, String language, String value)
    {
    // Find the attribute to remove
    for (Node n = element.getFirstChild(); n != null; n = n.getNextSibling()) {
        if (n.getNodeName().equals("Attribute")) {
        Element e = (Element) n;
        if (e.getAttribute("name").equals(name) &&
            e.getAttribute("language").equalsIgnoreCase(language) &&
            MSMUtils.getValue(e).equals(value)) {
            // Match found, so remove the attribute node and return
            element.removeChild(n);
            return true;
        }
        }
    }

    // No match found
    return false;
    }


    /** Set the value of the namespace required flag.
      * @param namespace_required The new value as a <i>boolean</i>.
      * @see org.greenstone.gatherer.msm.MSMUtils
      * @deprecated
      */
    public void setNamespaceRequired(boolean namespace_required) {
    }
    public String toString() {
    return MSMUtils.getFullIdentifier(element, namespace);
    }
}