com.sun.msv.scanner.dtd
Interface DTDEventListener

All Superinterfaces:
java.util.EventListener
All Known Implementing Classes:
DTDHandlerBase, DTDReader

public interface DTDEventListener
extends java.util.EventListener

All DTD parsing events are signaled through this interface.


Field Summary
static short CHOICE
           
static short CONTENT_MODEL_ANY
           
static short CONTENT_MODEL_CHILDREN
           
static short CONTENT_MODEL_EMPTY
           
static short CONTENT_MODEL_MIXED
           
static short OCCURENCE_ONCE
           
static short OCCURENCE_ONE_OR_MORE
           
static short OCCURENCE_ZERO_OR_MORE
           
static short OCCURENCE_ZERO_OR_ONE
           
static short SEQUENCE
           
static short USE_FIXED
           
static short USE_IMPLIED
           
static short USE_NORMAL
           
static short USE_REQUIRED
           
 
Method Summary
 void attributeDecl(java.lang.String elementName, java.lang.String attributeName, java.lang.String attributeType, java.lang.String[] enumeration, short attributeUse, java.lang.String defaultValue)
           
 void characters(char[] ch, int start, int length)
          Receive notification of character data.
 void childElement(java.lang.String elementName, short occurence)
           
 void comment(java.lang.String text)
          Receive notification that a comment has been read.
 void connector(short connectorType)
           
 void endCDATA()
          Receive notification that the CDATA section finished.
 void endContentModel(java.lang.String elementName, short contentModelType)
          receives notification that parsing of content model is finished.
 void endDTD()
          Receive notification of the end of a DTD.
 void endModelGroup(short occurence)
           
 void error(org.xml.sax.SAXParseException e)
           
 void externalGeneralEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
          Receive notification of an external parsed general entity declaration event.
 void externalParameterEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
          Receive notification of an external parameter entity declaration event.
 void fatalError(org.xml.sax.SAXParseException e)
           
 void ignorableWhitespace(char[] ch, int start, int length)
          Receive notification of ignorable whitespace in element content.
 void internalGeneralEntityDecl(java.lang.String name, java.lang.String value)
          Receive notification of a internal general entity declaration event.
 void internalParameterEntityDecl(java.lang.String name, java.lang.String value)
          Receive notification of a internal parameter entity declaration event.
 void mixedElement(java.lang.String elementName)
          receives notification of child element of mixed content model.
 void notationDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId)
          Receive notification of a Notation Declaration.
 void processingInstruction(java.lang.String target, java.lang.String data)
          Receive notification of a Processing Instruction.
 void setDocumentLocator(org.xml.sax.Locator loc)
           
 void startCDATA()
          Receive notification that a CDATA section is beginning.
 void startContentModel(java.lang.String elementName, short contentModelType)
          receives notification that parsing of content model is beginning.
 void startDTD(InputEntity in)
          Receive notification of the beginning of the DTD.
 void startModelGroup()
           
 void unparsedEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId, java.lang.String notationName)
          Receive notification of an unparsed entity declaration.
 void warning(org.xml.sax.SAXParseException err)
           
 

Field Detail

CHOICE

public static final short CHOICE
See Also:
Constant Field Values

CONTENT_MODEL_ANY

public static final short CONTENT_MODEL_ANY
See Also:
Constant Field Values

CONTENT_MODEL_CHILDREN

public static final short CONTENT_MODEL_CHILDREN
See Also:
Constant Field Values

CONTENT_MODEL_EMPTY

public static final short CONTENT_MODEL_EMPTY
See Also:
Constant Field Values

CONTENT_MODEL_MIXED

public static final short CONTENT_MODEL_MIXED
See Also:
Constant Field Values

OCCURENCE_ONCE

public static final short OCCURENCE_ONCE
See Also:
Constant Field Values

OCCURENCE_ONE_OR_MORE

public static final short OCCURENCE_ONE_OR_MORE
See Also:
Constant Field Values

OCCURENCE_ZERO_OR_MORE

public static final short OCCURENCE_ZERO_OR_MORE
See Also:
Constant Field Values

OCCURENCE_ZERO_OR_ONE

public static final short OCCURENCE_ZERO_OR_ONE
See Also:
Constant Field Values

SEQUENCE

public static final short SEQUENCE
See Also:
Constant Field Values

USE_FIXED

public static final short USE_FIXED
See Also:
Constant Field Values

USE_IMPLIED

public static final short USE_IMPLIED
See Also:
Constant Field Values

USE_NORMAL

public static final short USE_NORMAL
See Also:
Constant Field Values

USE_REQUIRED

public static final short USE_REQUIRED
See Also:
Constant Field Values
Method Detail

attributeDecl

public void attributeDecl(java.lang.String elementName,
                          java.lang.String attributeName,
                          java.lang.String attributeType,
                          java.lang.String[] enumeration,
                          short attributeUse,
                          java.lang.String defaultValue)
                   throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException
Receive notification of character data.

The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Note that some parsers will report whitespace using the ignorableWhitespace() method rather than this one (validating parsers must do so).

Parameters:
ch - The characters from the DTD.
start - The start position in the array.
length - The number of characters to read from the array.
Throws:
org.xml.sax.SAXException
See Also:
ignorableWhitespace(char[], int, int)

childElement

public void childElement(java.lang.String elementName,
                         short occurence)
                  throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

comment

public void comment(java.lang.String text)
             throws org.xml.sax.SAXException
Receive notification that a comment has been read.

Note that processing instructions are the mechanism designed to hold information for consumption by applications, not comments. XML systems may rely on applications being able to access information found in processing instructions; this is not true of comments, which are typically discarded.

Parameters:
text - the text within the comment delimiters.
Throws:
org.xml.sax.SAXException

connector

public void connector(short connectorType)
               throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

endCDATA

public void endCDATA()
              throws org.xml.sax.SAXException
Receive notification that the CDATA section finished.

Throws:
org.xml.sax.SAXException
See Also:
startCDATA()

endContentModel

public void endContentModel(java.lang.String elementName,
                            short contentModelType)
                     throws org.xml.sax.SAXException
receives notification that parsing of content model is finished.

Throws:
org.xml.sax.SAXException

endDTD

public void endDTD()
            throws org.xml.sax.SAXException
Receive notification of the end of a DTD. The parser will invoke this method only once.

Throws:
SAXException.
org.xml.sax.SAXException
See Also:
startDTD(com.sun.msv.scanner.dtd.InputEntity)

endModelGroup

public void endModelGroup(short occurence)
                   throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

error

public void error(org.xml.sax.SAXParseException e)
           throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

externalGeneralEntityDecl

public void externalGeneralEntityDecl(java.lang.String name,
                                      java.lang.String publicId,
                                      java.lang.String systemId)
                               throws org.xml.sax.SAXException
Receive notification of an external parsed general entity declaration event.

If a system identifier is present, and it is a relative URL, the parser will have resolved it fully before passing it through this method to a listener.

Parameters:
name - The entity name.
publicId - The entity's public identifier, or null if none was given.
systemId - The entity's system identifier.
Throws:
SAXException.
org.xml.sax.SAXException
See Also:
unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

externalParameterEntityDecl

public void externalParameterEntityDecl(java.lang.String name,
                                        java.lang.String publicId,
                                        java.lang.String systemId)
                                 throws org.xml.sax.SAXException
Receive notification of an external parameter entity declaration event.

If a system identifier is present, and it is a relative URL, the parser will have resolved it fully before passing it through this method to a listener.

Parameters:
name - The parameter entity name.
publicId - The entity's public identifier, or null if none was given.
systemId - The entity's system identifier.
Throws:
SAXException.
org.xml.sax.SAXException
See Also:
unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

fatalError

public void fatalError(org.xml.sax.SAXParseException e)
                throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws org.xml.sax.SAXException
Receive notification of ignorable whitespace in element content.

Validating Parsers must use this method to report each chunk of ignorable whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-validating parsers may also use this method if they are capable of parsing and using content models.

SAX parsers may return all contiguous whitespace in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Parameters:
ch - The characters from the DTD.
start - The start position in the array.
length - The number of characters to read from the array.
Throws:
org.xml.sax.SAXException
See Also:
characters(char[], int, int)

internalGeneralEntityDecl

public void internalGeneralEntityDecl(java.lang.String name,
                                      java.lang.String value)
                               throws org.xml.sax.SAXException
Receive notification of a internal general entity declaration event.

Parameters:
name - The internal general entity name.
value - The value of the entity, which may include unexpanded entity references. Character references will have been expanded.
Throws:
SAXException.
org.xml.sax.SAXException
See Also:
externalGeneralEntityDecl(java.lang.String, java.lang.String, java.lang.String)

internalParameterEntityDecl

public void internalParameterEntityDecl(java.lang.String name,
                                        java.lang.String value)
                                 throws org.xml.sax.SAXException
Receive notification of a internal parameter entity declaration event.

Parameters:
name - The internal parameter entity name.
value - The value of the entity, which may include unexpanded entity references. Character references will have been expanded.
Throws:
SAXException.
org.xml.sax.SAXException
See Also:
externalParameterEntityDecl(java.lang.String, java.lang.String, java.lang.String)

mixedElement

public void mixedElement(java.lang.String elementName)
                  throws org.xml.sax.SAXException
receives notification of child element of mixed content model. this method is called for each child element.

Throws:
org.xml.sax.SAXException

notationDecl

public void notationDecl(java.lang.String name,
                         java.lang.String publicId,
                         java.lang.String systemId)
                  throws org.xml.sax.SAXException
Receive notification of a Notation Declaration. Notation declarations are used by elements and entities for identifying embedded non-XML data.

Parameters:
name - The notation name, referred to by entities and elements.
publicId - The public identifier
systemId - The system identifier
Throws:
org.xml.sax.SAXException

processingInstruction

public void processingInstruction(java.lang.String target,
                                  java.lang.String data)
                           throws org.xml.sax.SAXException
Receive notification of a Processing Instruction. Processing instructions contain information meaningful to the application.

Parameters:
target - The target of the proceessing instruction which should have meaning to the application.
data - The instruction itself which should contain valid XML characters.
Throws:
org.xml.sax.SAXException

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator loc)

startCDATA

public void startCDATA()
                throws org.xml.sax.SAXException
Receive notification that a CDATA section is beginning. Data in a CDATA section is is reported through the appropriate event, either characters() or ignorableWhitespace.

Throws:
org.xml.sax.SAXException
See Also:
endCDATA()

startContentModel

public void startContentModel(java.lang.String elementName,
                              short contentModelType)
                       throws org.xml.sax.SAXException
receives notification that parsing of content model is beginning.

Parameters:
elementName - name of the element whose content model is going to be defined.
contentModelType - CONTENT_MODEL_EMPTY this element has EMPTY content model. This notification will be immediately followed by the corresponding endContentModel. CONTENT_MODEL_ANY this element has ANY content model. This notification will be immediately followed by the corresponding endContentModel. CONTENT_MODEL_MIXED this element has mixed content model. #PCDATA will not be reported. each child element will be reported by mixedElement method. CONTENT_MODEL_CHILDREN this elemen has child content model. The actual content model will be reported by childElement, startModelGroup, endModelGroup, and connector methods.
Throws:
org.xml.sax.SAXException

startDTD

public void startDTD(InputEntity in)
              throws org.xml.sax.SAXException
Receive notification of the beginning of the DTD.

Parameters:
in - Current input entity.
Throws:
org.xml.sax.SAXException
See Also:
endDTD()

startModelGroup

public void startModelGroup()
                     throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException

unparsedEntityDecl

public void unparsedEntityDecl(java.lang.String name,
                               java.lang.String publicId,
                               java.lang.String systemId,
                               java.lang.String notationName)
                        throws org.xml.sax.SAXException
Receive notification of an unparsed entity declaration. Unparsed entities are non-XML data.

Parameters:
name - The name of the unparsed entity.
publicId - The public identifier
systemId - The system identifier
notationName - The associated notation
Throws:
org.xml.sax.SAXException

warning

public void warning(org.xml.sax.SAXParseException err)
             throws org.xml.sax.SAXException
Throws:
org.xml.sax.SAXException


Copyright © 2001-2003 Sun Microsystems, Inc. Documenation generated April 26 2005.