listener.go

package axmlParser

type Listener interface {
	StartDocument()

	/**
	 * Receive notification of the end of a document.
	 */
	EndDocument()

	/**
	 * Begin the scope of a prefix-URI Namespace mapping.
	 *
	 * @param prefix
	 *            the Namespace prefix being declared. An empty string is used
	 *            for the default element namespace, which has no prefix.
	 * @param uri
	 *            the Namespace URI the prefix is mapped to
	 */
	StartPrefixMapping(prefix, uri string)

	/**
	 * End the scope of a prefix-URI mapping.
	 *
	 * @param prefix
	 *            the prefix that was being mapped. This is the empty string
	 *            when a default mapping scope ends.
	 * @param uri
	 *            the Namespace URI the prefix is mapped to
	 */
	EndPrefixMapping(prefix, uri string)

	/**
	 * Receive notification of the beginning of an element.
	 *
	 * @param uri
	 *            the Namespace URI, or the empty string if the element has no
	 *            Namespace URI or if Namespace processing is not being
	 *            performed
	 * @param localName
	 *            the local name (without prefix), or the empty string if
	 *            Namespace processing is not being performed
	 * @param qName
	 *            the qualified name (with prefix), or the empty string if
	 *            qualified names are not available
	 * @param atts
	 *            the attributes attached to the element. If there are no
	 *            attributes, it shall be an empty Attributes object. The value
	 *            of this object after startElement returns is undefined
	 */
	StartElement(uri, localName, qName string,
		atts []*Attribute)

	/**
	 * Receive notification of the end of an element.
	 *
	 * @param uri
	 *            the Namespace URI, or the empty string if the element has no
	 *            Namespace URI or if Namespace processing is not being
	 *            performed
	 * @param localName
	 *            the local name (without prefix), or the empty string if
	 *            Namespace processing is not being performed
	 * @param qName
	 *            the qualified XML name (with prefix), or the empty string if
	 *            qualified names are not available
	 */
	EndElement(uri, localName, qName string)

	/**
	 * Receive notification of text.
	 *
	 * @param data
	 *            the text data
	 */
	Text(data string)

	/**
	 * Receive notification of character data (in a <![CDATA[ ]]> block).
	 *
	 * @param data
	 *            the text data
	 */
	CharacterData(data string)

	/**
	 * Receive notification of a processing instruction.
	 *
	 * @param target
	 *            the processing instruction target
	 * @param data
	 *            the processing instruction data, or null if none was supplied.
	 *            The data does not include any whitespace separating it from
	 *            the target
	 * @throws org.xml.sax.SAXException
	 *             any SAX exception, possibly wrapping another exception
	 */
	ProcessingInstruction(target, data string)
}