# Package uk.ac.starlink.votable.dom

package uk.ac.starlink.votable.dom
Provides an extensible implementation of the `org.w3c.dom` API. Since the J2SE defines this only in terms of interfaces, it is difficult to extend the functionality of the provided DOM implementation. This package provides an extensible set of classes which allow one to subclass the default implementation and add functionality. The implementation provided does not do any of its own work, it delegates all the work to an existing DOM tree, which must be provided on construction of the `DelegatingDocument`. This tree can be obtained in any of the usual ways (for instance the classes in `javax.xml.parsers`).

When extending these classes, you need to take some care that the nodes released to the user are the delegating nodes and not the delegate ('base') nodes on which they are based. See `DelegatingDocument` for how to go about extending the implementation.

Since:
  14 Sep 2004
Author:
  Mark Taylor (Starlink)

Related Packages
Package
Description
uk.ac.starlink.votable
Classes for VOTable input and output.
uk.ac.starlink.votable.datalink
uk.ac.starlink.votable.soap
Classes providing custom serialization/deserialization of StarTables in JAX-RPC SOAP calls.
Classes
Class
Description
DelegatingAttr
DelegatingCDATASection
DelegatingCharacterData
DelegatingComment
DelegatingDocument
DOM Document implementation which delegates its operations to a base Document instance.
DelegatingDocumentFragment
DelegatingDocumentType
DelegatingElement
DelegatingEntity
DelegatingEntityReference
DelegatingNode
Node implementation which simply delegates all its methods to a base Node instance.
DelegatingNotation
DelegatingProcessingInstruction
DelegatingText