- API Note:
- The documentation comments for the get and set methods within this API are written as property definitions and are shared between both methods. These methods do not follow the standard Java SE specification format.
- Implementation Note:
- The JDK implementation of
LSSerializerfollows the Characters section of the XML Specification in handling characters output. In particular, the specification defined a character range that excluded the surrogate blocks. As a result, the JDK LSSerializer writes characters in the surrogate blocks as Character References. Character
0xf0 0x9f 0x9a 0xa9(Unicode code point U+1F6A9) for example will be written as
This behavior is different from what was in the class description of
LSSerializer. The relevant section is quoted below:
Within the character data of a document (outside of markup), any characters that cannot be represented directly are replaced with character references... Any characters that cannot be represented directly in the output character encoding are serialized as numeric character references
The JDK implementation does not follow this definition because it is not consistent with the XML Specification that defined an explicit character range with no association to the setting of the output character encoding.
Interface Summary Interface Description AttrThe
Attrinterface represents an attribute in an
CDATASectionCDATA sections are used to escape blocks of text containing characters that would otherwise be regarded as markup. CharacterDataThe
CharacterDatainterface extends Node with a set of attributes and methods for accessing character data in the DOM.
CommentThis interface inherits from
CharacterDataand represents the content of a comment, i.e., all the characters between the starting '
<!--' and ending '
Documentinterface represents the entire HTML or XML document.
DocumentFragmentis a "lightweight" or "minimal"
doctypeattribute whose value is either
DOMConfigurationinterface represents the configuration of a document and maintains a table of recognized parameters.
DOMErroris an interface that describes an error.
DOMErrorHandleris a callback interface that the DOM implementation can call when reporting errors that happens while processing XML data, or when doing some other processing (e.g. validating a document).
DOMImplementationinterface provides a number of methods for performing operations that are independent of any particular instance of the document object model.
DOMImplementationListinterface provides the abstraction of an ordered collection of DOM implementations, without defining or constraining how this collection is implemented.
DOMImplementationSourceThis interface permits a DOM implementer to supply one or more implementations, based upon requested features and versions, as specified in DOM Features. DOMLocator
DOMLocatoris an interface that describes a location (e.g.
DOMStringListinterface provides the abstraction of an ordered collection of
DOMStringvalues, without defining or constraining how this collection is implemented.
Elementinterface represents an element in an HTML or XML document.
ElementTraversalinterface is a set of read-only attributes which allow an author to easily navigate between elements in a document.
EntityThis interface represents a known entity, either parsed or unparsed, in an XML document. EntityReference
EntityReferencenodes may be used to represent an entity reference in the tree.
NamedNodeMapObjects implementing the
NamedNodeMapinterface are used to represent collections of nodes that can be accessed by name.
NameListinterface provides the abstraction of an ordered collection of parallel pairs of name and namespace values (which could be null values), without defining or constraining how this collection is implemented.
Nodeinterface is the primary datatype for the entire Document Object Model.
NodeListinterface provides the abstraction of an ordered collection of nodes, without defining or constraining how this collection is implemented.
NotationThis interface represents a notation declared in the DTD. ProcessingInstructionThe
ProcessingInstructioninterface represents a "processing instruction", used in XML as a way to keep processor-specific information in the text of the document.
Textinterface inherits from
CharacterDataand represents the textual content (termed character data in XML) of an
TypeInfointerface represents a type referenced from
Attrnodes, specified in the schemas associated with the document.
UserDataHandlerWhen associating an object to a key on a node using
Node.setUserData()the application can provide a handler that gets called when the node the object is associated to is being cloned, imported, or renamed.
Exception Summary Exception Description DOMExceptionDOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable).