DOMImplementationRegistry JDK 1.6)

Description

publicfinal class DOMImplementationRegistry

A factory that enables applications to obtain instances of DOMImplementation.

Example:

  // get an instance of the DOMImplementation registry
  DOMImplementationRegistry registry =
       DOMImplementationRegistry.newInstance();
  // get a DOM implementation the Level 3 XML module
  DOMImplementation domImpl =
       registry.getDOMImplementation("XML 3.0");

This provides an application with an implementation-independent starting point. DOM implementations may modify this class to meet new security standards or to provide *additional* fallbacks for the list of DOMImplementationSources.

See also: DOMImplementation DOMImplementationSource

Methods

Hide/Show inherited methods

public void addSource (DOMImplementationSource s)

public DOMImplementation getDOMImplementation (String features)

Return the first implementation that has the desired features, or null if none is found.

Return the first implementation that has the desired
features, or null if none is found.
Returns: An implementation that has the desired features, or null if none found.
Parameters:
- features - A string that specifies which features are required. This is a space separated list in which each feature is specified by its name optionally followed by a space and a version number. This is something like: "XML 1.0 Traversal +Events 2.0"

public DOMImplementationList getDOMImplementationList (String features)

Return a list of implementations that support the desired features.

publicstatic DOMImplementationRegistry newInstance () throws ClassNotFoundException InstantiationException IllegalAccessException ClassCastException

Obtain a new instance of a DOMImplementationRegistry.

Obtain a new instance of a DOMImplementationRegistry.

The DOMImplementationRegistry is initialized by the
application or the implementation, depending on the context, by
first checking the value of the Java system property
org.w3c.dom.DOMImplementationSourceList and
the the service provider whose contents are at
"META_INF/services/org.w3c.dom.DOMImplementationSourceList"
The value of this property is a white-space separated list of
names of availables classes implementing the
DOMImplementationSource interface. Each class listed
in the class name list is instantiated and any exceptions
encountered are thrown to the application.
Returns: an initialized instance of DOMImplementationRegistry
Throws:
- ClassNotFoundException - If any specified class can not be found
- InstantiationException - If any specified class is an interface or abstract class
- IllegalAccessException - If the default constructor of a specified class is not accessible
- ClassCastException - If any specified class does not implement DOMImplementationSource