java.util.EventListener
DTDHandlerBase
, TDTDReader
public interface DTDEventListener
extends java.util.EventListener
Modifier and Type | Field | Description |
---|---|---|
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 |
Modifier and Type | Method | Description |
---|---|---|
void |
attributeDecl(java.lang.String elementName,
java.lang.String attributeName,
java.lang.String attributeType,
java.lang.String[] enumeration,
short attributeUse,
java.lang.String defaultValue) |
For each entry in an ATTLIST declaration,
this event will be fired.
|
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) |
Connectors in one model group is guaranteed to be the same.
|
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) |
static final short CONTENT_MODEL_EMPTY
static final short CONTENT_MODEL_ANY
static final short CONTENT_MODEL_MIXED
static final short CONTENT_MODEL_CHILDREN
static final short USE_NORMAL
static final short USE_IMPLIED
static final short USE_FIXED
static final short USE_REQUIRED
static final short CHOICE
static final short SEQUENCE
static final short OCCURENCE_ZERO_OR_MORE
static final short OCCURENCE_ONE_OR_MORE
static final short OCCURENCE_ZERO_OR_ONE
static final short OCCURENCE_ONCE
void setDocumentLocator(org.xml.sax.Locator loc)
void processingInstruction(java.lang.String target, java.lang.String data) throws org.xml.sax.SAXException
target
- The target of the proceessing instruction
which should have meaning to the application.data
- The instruction itself which should contain
valid XML characters.org.xml.sax.SAXException
void notationDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId) throws org.xml.sax.SAXException
name
- The notation name, referred to by entities and
elements.publicId
- The public identifiersystemId
- The system identifierorg.xml.sax.SAXException
void unparsedEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId, java.lang.String notationName) throws org.xml.sax.SAXException
name
- The name of the unparsed entity.publicId
- The public identifiersystemId
- The system identifiernotationName
- The associated notationorg.xml.sax.SAXException
void internalGeneralEntityDecl(java.lang.String name, java.lang.String value) throws org.xml.sax.SAXException
name
- The internal general entity name.value
- The value of the entity, which may include unexpanded
entity references. Character references will have been
expanded.org.xml.sax.SAXException
externalGeneralEntityDecl(String, String, String)
void externalGeneralEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId) throws org.xml.sax.SAXException
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.
name
- The entity name.publicId
- The entity's public identifier, or null if
none was given.systemId
- The entity's system identifier.org.xml.sax.SAXException
unparsedEntityDecl(String, String, String, String)
void internalParameterEntityDecl(java.lang.String name, java.lang.String value) throws org.xml.sax.SAXException
name
- The internal parameter entity name.value
- The value of the entity, which may include unexpanded
entity references. Character references will have been
expanded.org.xml.sax.SAXException
externalParameterEntityDecl(String, String, String)
void externalParameterEntityDecl(java.lang.String name, java.lang.String publicId, java.lang.String systemId) throws org.xml.sax.SAXException
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.
name
- The parameter entity name.publicId
- The entity's public identifier, or null if
none was given.systemId
- The entity's system identifier.org.xml.sax.SAXException
unparsedEntityDecl(String, String, String, String)
void startDTD(InputEntity in) throws org.xml.sax.SAXException
in
- Current input entity.org.xml.sax.SAXException
endDTD()
void endDTD() throws org.xml.sax.SAXException
org.xml.sax.SAXException
startDTD(InputEntity)
void comment(java.lang.String text) throws org.xml.sax.SAXException
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.
text
- the text within the comment delimiters.org.xml.sax.SAXException
void characters(char[] ch, int start, int length) throws org.xml.sax.SAXException
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).
ch
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.org.xml.sax.SAXException
ignorableWhitespace(char[], int, int)
void ignorableWhitespace(char[] ch, int start, int length) throws org.xml.sax.SAXException
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.
ch
- The characters from the DTD.start
- The start position in the array.length
- The number of characters to read from the array.org.xml.sax.SAXException
characters(char[], int, int)
void startCDATA() throws org.xml.sax.SAXException
org.xml.sax.SAXException
endCDATA()
void endCDATA() throws org.xml.sax.SAXException
org.xml.sax.SAXException
startCDATA()
void fatalError(org.xml.sax.SAXParseException e) throws org.xml.sax.SAXException
org.xml.sax.SAXException
void error(org.xml.sax.SAXParseException e) throws org.xml.sax.SAXException
org.xml.sax.SAXException
void warning(org.xml.sax.SAXParseException err) throws org.xml.sax.SAXException
org.xml.sax.SAXException
void startContentModel(java.lang.String elementName, short contentModelType) throws org.xml.sax.SAXException
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. Possible call sequences are:
START := MODEL_GROUP MODEL_GROUP := startModelGroup TOKEN (connector TOKEN)* endModelGroup TOKEN := childElement | MODEL_GROUP
org.xml.sax.SAXException
void endContentModel(java.lang.String elementName, short contentModelType) throws org.xml.sax.SAXException
org.xml.sax.SAXException
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
DTD allows the same attributes to be declared more than once, and in that case the first one wins. I think this method will be only fired for the first one, but I need to check.
org.xml.sax.SAXException
void childElement(java.lang.String elementName, short occurence) throws org.xml.sax.SAXException
org.xml.sax.SAXException
void mixedElement(java.lang.String elementName) throws org.xml.sax.SAXException
org.xml.sax.SAXException
startContentModel(String, short)
void startModelGroup() throws org.xml.sax.SAXException
org.xml.sax.SAXException
void endModelGroup(short occurence) throws org.xml.sax.SAXException
org.xml.sax.SAXException
void connector(short connectorType) throws org.xml.sax.SAXException
IOW, you'll never see an event sequence like (a|b,c)
org.xml.sax.SAXException
Copyright © 2018 Oracle Corporation. All rights reserved.