SAX2 extension handler for DTD declaration events.
This module, both source code and documentation, is in the
Public Domain, and comes with NO WARRANTY.
This is an optional extension handler for SAX2 to provide
information about DTD declarations in an XML document. XML
readers are not required to support this handler.
Note that data-related DTD declarations (unparsed entities and
If you are using the declaration handler together with a lexical
handler, all of the events will occur between the
To set the DeclHandler for an XML reader, use the
If the reader does not support declaration events, it will throw a
or a
when you attempt to register the handler.
Since:
SAX 2.0
Version:
2.0beta
Method Summary
void
java.lang.String aName,
java.lang.String type,
java.lang.String valueDefault,
java.lang.String value)
Report an attribute type declaration.
void
java.lang.String model)
Report an element type declaration.
void
java.lang.String publicId,
java.lang.String systemId)
Report a parsed external entity declaration.
void
java.lang.String value)
Report an internal entity declaration.
Method Detail
elementDecl
public void elementDecl(java.lang.String name,
java.lang.String model)
Report an element type declaration.
The content model will consist of the string "EMPTY", the
string "ANY", or a parenthesised group, optionally followed
by an occurrence indicator. The model will be normalized so
that all whitespace is removed,and will include the enclosing
parentheses.
Only the effective (first) declaration for an attribute will
be reported. The type will be one of the strings "CDATA",
"ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY",
"ENTITIES", or "NOTATION", or a parenthesized token group with
the separator "|" and all whitespace removed.
Parameters:
eName - The name of the associated element.
aName - The name of the attribute.
type - A string representing the attribute type.
valueDefault - A string representing the attribute default
("#IMPLIED", "#REQUIRED", or "#FIXED") or null if
none of these applies.
value - A string representing the attribute's default value,
internalEntityDecl
public void internalEntityDecl(java.lang.String name,
java.lang.String value)
Report an internal entity declaration.
Only the effective (first) declaration for each entity
will be reported.
Parameters:
name - The name of the entity. If it is a parameter
externalEntityDecl
public void externalEntityDecl(java.lang.String name,
java.lang.String publicId,
java.lang.String systemId)
Report a parsed external entity declaration.
Only the effective (first) declaration for each entity
will be reported.
Parameters:
name - The name of the entity. If it is a parameter
entity, the name will begin with '%'.
publicId - The declared public identifier of the entity, or