source: trunk/gli/src/org/greenstone/gatherer/cdm/Language.java@ 7365

/**
 *#########################################################################
 *
 * 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.
 *
 * Author: John Thompson, Greenstone Digital Library, University of Waikato
 *
 * Copyright (C) 1999 New Zealand Digital Library Project
 *
 * 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.
 *
 * 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.
 *
 * 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.
 *########################################################################
 */
package org.greenstone.gatherer.cdm;

/**************************************************************************************
 * Written:      08/05/02
 * Revised:      17/11/02 - Commented
 *               07/07/03 - DOM support
 **************************************************************************************/
import org.greenstone.gatherer.cdm.CollectionConfiguration;
import org.greenstone.gatherer.cdm.CollectionDesignManager;
import org.greenstone.gatherer.cdm.DOMProxyListEntry;
import org.greenstone.gatherer.msm.MSMUtils;
import org.w3c.dom.*;

/** A pretty unexciting extension of a two character string, in that it has a field which details if its the default language.
* @author John Thompson, Greenstone Digital Library, University of Waikato
* @version 2.1
*/
public class Language
    implements Comparable, DOMProxyListEntry {
    /** The Element this language entry is based upon. */
    private Element element = null;
    /** The two character code for this language. */
    private String code = null;
    /** The name of this language. */
    private String name = null;
 
    public Language() {
    }

    public Language(Element element) {
    this.element = element;
    }

    /** Constructor for a brand new language. */
    public Language(String code) {
    this.code = code;
    // Create the new element
    element = CollectionDesignManager.collect_config.document.createElement(CollectionConfiguration.LANGUAGE_ELEMENT);
    element.setAttribute(CollectionConfiguration.NAME_ATTRIBUTE, code);
    element.setAttribute(CollectionConfiguration.ASSIGNED_ATTRIBUTE, CollectionConfiguration.TRUE_STR);
    }

    /** Method to compare two languages for ordering purposes.
     * @param object the other language as an Object
     * @return an int which indicates the order between this language and the given one: < 0, 0 or > 0 for before, equal to or after respectively
     */
    public int compareTo(Object object) {
    return toString().compareTo(object.toString());
    }

    public DOMProxyListEntry create(Element element) {
    return new Language(element);
    }

    /** Method to test for the equality of two languages.
     * @param object The other language as an <strong>Object</strong>.
     * @return <i>true</i> if the languages are equal, <i>false</i> otherwise.
     */
    public boolean equals(Object object) {
    return (compareTo(object) == 0);
    }

    /** Method to retrieve the code of this language.
     * @return A <strong>String</strong> representing the two letter code.
     */
    public String getCode() {
    if(code == null && element != null) {
        code = element.getAttribute(CollectionConfiguration.NAME_ATTRIBUTE);
    }
    return code;
    }

    public Element getElement() {
    return element;
    }

    public String getName() {
    if(name == null) {
        String code = getCode();
        name = CollectionDesignManager.language_manager.getLanguageName(code);
    }
    return name;
    }

    public boolean isAssigned() {
    return (element != null && element.getAttribute(CollectionConfiguration.ASSIGNED_ATTRIBUTE).equals(CollectionConfiguration.TRUE_STR));
    }

    public void setAssigned(boolean value) {
    if(element != null) {
        element.setAttribute(CollectionConfiguration.ASSIGNED_ATTRIBUTE, (value ? CollectionConfiguration.TRUE_STR : CollectionConfiguration.FALSE_STR));
    }
    }

    public void setCode(String new_code) {
    code = new_code;
    // Set element
    if(element != null) {
        element.setAttribute(CollectionConfiguration.NAME_ATTRIBUTE, new_code);
    }
    // Reset name
    name = null;
    }

    public void setElement(Element new_element) {
    element = new_element;
    code = null;
    name = null;
    }

    /** Method to display the language code.
     * @return A <strong>String</strong> representing the language code.
     */
    public String toString() {
    return getName();
    }
}