/*
 * Copyright (c) 1998, 2021, Oracle and/or its affiliates. All rights reserved.
 * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */

package javax.swing.text.html.parser;

import java.util.Vector;
import java.util.Hashtable;
import java.util.Enumeration;
import java.io.*;

/**
 * This class defines the attributes of an SGML element
 * as described in a DTD using the ATTLIST construct.
 * An AttributeList can be obtained from the Element
 * class using the getAttributes() method.
 * <p>
 * It is actually an element in a linked list. Use the
 * getNext() method repeatedly to enumerate all the attributes
 * of an element.
 *
 * @see         Element
 * @author      Arthur Van Hoff
 *
 */
@SuppressWarnings({"serial"}) // Same-version serialization only
public final
class AttributeList implements DTDConstants, Serializable {

    /**
     * The attribute name
     */
    public String name;

    /**
     * The attribute type
     */
    public int type;

    /**
     * The possible attribute values
     */
    public Vector<?> values;

    /**
     * The attribute modifier
     */
    public int modifier;

    /**
     * The default attribute value
     */
    public String value;

    /**
     * The next attribute in the list
     */
    public AttributeList next;

    AttributeList() {
    }

    /**
     * Create an attribute list element.
     *
     * @param name  the attribute name
     */
    public AttributeList(String name) {
        this.name = name;
    }

    /**
     * Create an attribute list element.
     *
     * @param name      the attribute name
     * @param type      the attribute type
     * @param modifier  the attribute modifier
     * @param value     the default attribute value
     * @param values    the possible attribute values
     * @param next      the next attribute in the list
     */
    public AttributeList(String name, int type, int modifier, String value, Vector<?> values, AttributeList next) {
        this.name = name;
        this.type = type;
        this.modifier = modifier;
        this.value = value;
        this.values = values;
        this.next = next;
    }

    /**
     * {@return the attribute name}
     */
    public String getName() {
        return name;
    }

    /**
     * {@return the attribute type}
     * @see DTDConstants
     */
    public int getType() {
        return type;
    }

    /**
     * {@return the attribute modifier}
     * @see DTDConstants
     */
    public int getModifier() {
        return modifier;
    }

    /**
     * {@return possible attribute values}
     */
    public Enumeration<?> getValues() {
        return (values != null) ? values.elements() : null;
    }

    /**
     * {@return default attribute value}
     */
    public String getValue() {
        return value;
    }

    /**
     * {@return the next attribute in the list}
     */
    public AttributeList getNext() {
        return next;
    }

    /**
     * @return string representation
     */
    public String toString() {
        return name;
    }

    /**
     * Create a hashtable of attribute types.
     */
    static Hashtable<Object, Object> attributeTypes = new Hashtable<Object, Object>();

    static void defineAttributeType(String nm, int val) {
        Integer num = Integer.valueOf(val);
        attributeTypes.put(nm, num);
        attributeTypes.put(num, nm);
    }

    static {
        defineAttributeType("CDATA", CDATA);
        defineAttributeType("ENTITY", ENTITY);
        defineAttributeType("ENTITIES", ENTITIES);
        defineAttributeType("ID", ID);
        defineAttributeType("IDREF", IDREF);
        defineAttributeType("IDREFS", IDREFS);
        defineAttributeType("NAME", NAME);
        defineAttributeType("NAMES", NAMES);
        defineAttributeType("NMTOKEN", NMTOKEN);
        defineAttributeType("NMTOKENS", NMTOKENS);
        defineAttributeType("NOTATION", NOTATION);
        defineAttributeType("NUMBER", NUMBER);
        defineAttributeType("NUMBERS", NUMBERS);
        defineAttributeType("NUTOKEN", NUTOKEN);
        defineAttributeType("NUTOKENS", NUTOKENS);

        attributeTypes.put("fixed", Integer.valueOf(FIXED));
        attributeTypes.put("required", Integer.valueOf(REQUIRED));
        attributeTypes.put("current", Integer.valueOf(CURRENT));
        attributeTypes.put("conref", Integer.valueOf(CONREF));
        attributeTypes.put("implied", Integer.valueOf(IMPLIED));
    }

    /**
     * Converts an attribute name to the type
     *
     * @param nm an attribute name
     * @return the type
     */
    public static int name2type(String nm) {
        Integer i = (Integer)attributeTypes.get(nm);
        return (i == null) ? CDATA : i.intValue();
    }

    /**
     * Converts a type to the attribute name
     *
     * @param tp a type
     * @return the attribute name
     */
    public static String type2name(int tp) {
        return (String)attributeTypes.get(Integer.valueOf(tp));
    }
}
