org.apache.xerces.dom3.ls
Interface DOMImplementationLS

public interface DOMImplementationLS

DOMImplementationLS contains the factory methods for creating objects that implement the DOMBuilder (parser) and DOMWriter (serializer) interfaces.

An object that implements DOMImplementationLS is obtained by doing a binding specific cast from DOMImplementation to DOMImplementationLS. Implementations supporting the Load and Save feature must implement the DOMImplementationLS interface on whatever object implements the DOMImplementation interface.

See also the Document Object Model (DOM) Level 3 Abstract Schemas and Load and Save Specification.

Field Summary

static short	MODE_ASYNCHRONOUS Create an asynchronous DOMBuilder.
static short	MODE_SYNCHRONOUS Create a synchronous DOMBuilder.

Method Summary

DOMBuilder	createDOMBuilder(short mode) Create a new DOMBuilder.
DOMInputSource	createDOMInputSource() Create a new "empty" DOMInputSource.
DOMWriter	createDOMWriter() Create a new DOMWriter object.

Field Detail

MODE_SYNCHRONOUS

public static final short MODE_SYNCHRONOUS

Create a synchronous DOMBuilder.

MODE_ASYNCHRONOUS

public static final short MODE_ASYNCHRONOUS

Create an asynchronous DOMBuilder.

Method Detail

createDOMBuilder

public DOMBuilder createDOMBuilder(short mode)
                            throws org.w3c.dom.DOMException

Create a new DOMBuilder. The newly constructed parser may then be configured by means of its setFeature method, and used to parse documents by means of its parse method.

Parameters:

mode - The mode argument is either MODE_SYNCHRONOUS or MODE_ASYNCHRONOUS, if mode is MODE_SYNCHRONOUS then the DOMBuilder that is created will operate in synchronous mode, if it's MODE_ASYNCHRONOUS then the DOMBuilder that is created will operate in asynchronous mode.

Returns:

The newly created DOMBuilder object, this DOMBuilder is either synchronous or asynchronous depending on the value of the type argument.

Throws:

org.w3c.dom.DOMException - Raise a NOT_SUPPORTED_ERR exception if MODE_ASYNCHRONOUS is not supported.

createDOMWriter

public DOMWriter createDOMWriter()

Create a new DOMWriter object. DOMWriters are used to serialize a DOM tree back into an XML document.

Returns:

The newly created DOMWriter object.

createDOMInputSource

public DOMInputSource createDOMInputSource()

Create a new "empty" DOMInputSource.

Returns:

The newly created DOMBuilder object, this DOMBuilder is either synchronous or asynchronous depending on the value of the type argument.