001: package com.jclark.xml.parse.awt;
002:
003: import java.awt.AWTException;
004: import com.jclark.xml.parse.*;
005:
006: /**
007: * An extension of <code>Application</code> that restricts methods
008: * to throwing <code>AWTException</code>.
009: *
010: * @version $Revision: 1.2 $ $Date: 1998/06/10 09:43:54 $
011: */
012: public interface Application extends
013: com.jclark.xml.parse.base.Application {
014: /**
015: * Reports the start of the document.
016: * This is called once per well-formed document before any other methods.
017: */
018: void startDocument() throws AWTException;
019:
020: /**
021: * Reports the end of the prolog.
022: * Called before the start of the first element.
023: */
024: void endProlog(EndPrologEvent event) throws AWTException;
025:
026: /**
027: * Reports the start of an element.
028: * This includes both start-tags and empty elements.
029: */
030: void startElement(StartElementEvent event) throws AWTException;
031:
032: /**
033: * Reports character data.
034: */
035: void characterData(CharacterDataEvent event) throws AWTException;
036:
037: /**
038: * Reports the end of a element.
039: * This includes both end-tags and empty elements.
040: */
041: void endElement(EndElementEvent event) throws AWTException;
042:
043: /**
044: * Reports a processing instruction.
045: * Note that processing instructions can occur before or after the
046: * document element.
047: */
048: void processingInstruction(ProcessingInstructionEvent event)
049: throws AWTException;
050:
051: /**
052: * Reports the end of the document.
053: * Called once per well-formed document, after all other methods.
054: * Not called if the document is not well-formed.
055: */
056: void endDocument() throws AWTException;
057:
058: /**
059: * Reports a comment.
060: * Note that comments can occur before or after the
061: * document element.
062: */
063: void comment(CommentEvent event) throws AWTException;
064:
065: /**
066: * Reports the start of a CDATA section.
067: */
068: void startCdataSection(StartCdataSectionEvent event)
069: throws AWTException;
070:
071: /**
072: * Reports the end of a CDATA section.
073: */
074: void endCdataSection(EndCdataSectionEvent event)
075: throws AWTException;
076:
077: /**
078: * Reports the start of an entity reference.
079: * This event will be followed by the result of parsing
080: * the entity's replacement text.
081: * This is not called for entity references in attribute values.
082: */
083: void startEntityReference(StartEntityReferenceEvent event)
084: throws AWTException;
085:
086: /**
087: * Reports the start of an entity reference.
088: * This event follow's the result of parsing
089: * the entity's replacement text.
090: * This is not called for entity references in attribute values.
091: */
092: void endEntityReference(EndEntityReferenceEvent event)
093: throws AWTException;
094:
095: /**
096: * Reports the start of the document type declaration.
097: */
098: void startDocumentTypeDeclaration(
099: StartDocumentTypeDeclarationEvent event)
100: throws AWTException;
101:
102: /**
103: * Reports the end of the document type declaration.
104: */
105: void endDocumentTypeDeclaration(
106: EndDocumentTypeDeclarationEvent event) throws AWTException;
107:
108: /**
109: * Reports a markup declaration.
110: */
111: void markupDeclaration(MarkupDeclarationEvent event)
112: throws AWTException;
113: }
|