# Package uk.ac.starlink.votable.dom

Provides an extensible implementation of the `org.w3c.dom` API.

See: Description

- Class Summary
  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 |

## Package uk.ac.starlink.votable.dom Description

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