//==============================================================================
// XmlAttributeI.java
//------------------------------------------------------------------------------

package tribble.xml;


// System imports

import java.lang.Exception;
import java.lang.String;


// Local imports

// (None)


/*******************************************************************************
* XML element attribute.
*
* <p>
* Contains the name and value of an attribute of an XML element.
*
* <!------------------------------------------------------------------------ -->
* <p>
* <b> Example </b>
*
* <p>
* The following XML element:
* <pre>
*    &lt;item
*      Count="20" SKU="HG-52814(J)-F" Unit-Cost="149.95"&gt;
*      Oak business desk with cherry &amp;amp; chrome finish
*    &lt;/item&gt; </pre>
*
* <p>
* contains the following attributes:
* <pre>
*    <i>attribute</i> "Count", "20"
*    <i>attribute</i> "SKU", "HG-52814(J)-F"
*    <i>attribute</i> "Unit-Cost", "149.95" </pre>
*
* <!------------------------------------------------------------------------ -->
* @version	$Revision: 1.2 $ $Date: 2003/07/27 18:30:43 $
* @since	2003-04-13
* @author
*	David R. Tribble
*	(<a href="mailto:david@tribble.com">david@tribble.com</a>).
*	<br>
*	Copyright ©2003 by David R. Tribble, all rights reserved.
*	<br>
*	Permission is granted to freely use and distribute this source code
*	provided that the original copyright and authorship notices remain
*	intact.
*
* @see	XmlElementI
*/

public interface XmlAttributeI
    extends XmlItemI
{
// Identification

    /** Revision information. */
    static final String		REV =
        "@(#)tribble/xml/XmlAttributeI.java $Revision: 1.2 $ $Date: 2003/07/27 18:30:43 $\n";


// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// Public constants

    // (None)


// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// Public methods

    /***************************************************************************
    * Retrieve the name of this XML attribute.
    *
    * @return
    * Name of this element attribute.
    *
    * @since	1.1, 2003-04-13
    */

    public String getName();
        /*const*/


    /***************************************************************************
    * Retrieve the namespace name of this XML attribute.
    *
    * @return
    * Namespace prefix of this element attribute, which may be empty
    * (<tt>""</tt>) if the attribute has no namespace prefix.
    *
    * @since	1.2, 2003-07-27
    */

    public String getNamespace();
        /*const*/


    /***************************************************************************
    * Retrieve the value of this XML attribute.
    *
    * @return
    * Text value of this element attribute.
    * This will be an empty string (<tt>""</tt>) if the attribute has no value.
    *
    * @since	1.1, 2003-04-13
    */

    public String getValue();
        /*const*/
}

// End XmlAttributeI.java